Skip to content

SN7k/SillySites

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

57 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

πŸŽͺ SillySites

Serious About Silly

A playful platform for developers to showcase their creative, fun, and experimental web projects.


SillySites Mockup


✨ Features

🎨 Developer Portal

Submit and manage your creative web projects with ease

πŸ‘€ Public Gallery

Browse and explore an endless collection of silly sites

πŸ† Leaderboard

Track top developers and popular projects in real-time

⚑ Real-time Updates

Live like counts and site rankings that update instantly

πŸ›‘οΈ Admin Dashboard

Powerful admin panel to review and approve submissions


πŸ› οΈ Tech Stack

Frontend Magic ✨

React TypeScript Vite TailwindCSS Framer

Backend Power πŸ’ͺ

Node.js Express MongoDB Redis JWT Docker


πŸ“‚ Project Structure

πŸŽͺ SillySites/
β”‚
β”œβ”€β”€ 🎨 Silly/          # Public-facing website (The fun stuff!)
β”œβ”€β”€ πŸ‘¨β€πŸ’» Devs/           # Developer portal (Your creative hub)
β”œβ”€β”€ πŸ›‘οΈ Admin/          # Admin dashboard (Command center)
└── βš™οΈ backend/        # API server (The brain)

πŸš€ Getting Started

πŸ“‹ Prerequisites

Before diving in, make sure you have:

  • πŸ“¦ Node.js (v18 or higher)
  • πŸƒ MongoDB
  • πŸ”΄ Redis (optional, for caching)

πŸ’» Installation

1️⃣ Clone the repository

git clone https://github.com/SN7k/SillySites.git
cd SillySites

2️⃣ Backend Setup

cd backend
npm install
cp .env.example .env
# πŸ”§ Configure your environment variables
npm run dev

3️⃣ Frontend Applications

🎨 Public Site

cd Silly
npm install
npm run dev

πŸ‘¨β€πŸ’» Developer Portal

cd Devs
npm install
npm run dev

πŸ›‘οΈ Admin Dashboard

cd Admin
npm install
npm run dev

πŸ” Environment Variables

Create a .env file in the backend directory:

PORT=5000
MONGODB_URI=your_mongodb_connection_string
JWT_SECRET=your_jwt_secret
REDIS_URL=your_redis_url (optional)
NODE_ENV=development

πŸ“œ Available Scripts

Backend βš™οΈ

Command Description
npm run dev πŸ”₯ Start development server
npm run build πŸ“¦ Build for production
npm start πŸš€ Run production server
npm test πŸ§ͺ Run tests

Frontend ✨

Command Description
npm run dev πŸ”₯ Start development server
npm run build πŸ“¦ Build for production
npm run preview πŸ‘€ Preview production build

🌐 API Endpoints

Endpoint Description
/api/public 🌍 Public site endpoints
/api/dev πŸ‘¨β€πŸ’» Developer portal endpoints
/api/admin πŸ›‘οΈ Admin management endpoints

🀝 Contributing

We love contributions! πŸ’– Feel free to submit a Pull Request.

  1. 🍴 Fork the project
  2. 🌿 Create your feature branch (git checkout -b feature/AmazingFeature)
  3. πŸ’Ύ Commit your changes (git commit -m 'Add some AmazingFeature')
  4. πŸ“€ Push to the branch (git push origin feature/AmazingFeature)
  5. πŸŽ‰ Open a Pull Request

πŸ“„ License

This project is licensed under the MIT License - see the LICENSE file for details.


πŸ‘¨β€πŸ’» Author

Shombhunath Karan

πŸ™ Acknowledgments

✨ Built with modern web technologies
πŸ’‘ Inspired by the creative web development community
🎨 Designed for developers who love to experiment and have fun


⭐ Star this repo if you find it interesting!