Welcome to CircusPrime, the most vibrant, energetic, and playful social network where every interaction feels like part of an amazing circus performance! Step right up and join a community that celebrates wonder, excitement, and connection through bold colors, playful animations, and engaging interactions.
- 🎭 Performance-Driven Social: Every post, comment, and connection is a chance to showcase your unique personality
- 🎨 Vibrant Design: Bold colors, playful animations, and engaging interactions that bring joy to your digital experience
- 🤹 Community-Focused: Build meaningful relationships in a space that celebrates creativity and self-expression
- 🎪 Circus-Themed Experience: From the big top to the center ring, every feature is designed with circus magic in mind
- The Big Top Feed: Share your thoughts, photos, and videos in our main performance space
- Troupe Connections: Connect with fellow performers and build your circus family
- Ring Networks: Join specialized communities based on your interests and talents
- Performance Profiles: Showcase your unique personality with customizable profiles
- Vibrant Color Palette: Bold, energetic colors that spark joy and creativity
- Playful Animations: Smooth, delightful animations that make every interaction feel magical
- Responsive Design: Seamless experience across all devices - from phone to desktop
- Dark/Light Themes: Choose your preferred performance lighting
- Real-time Updates: Instant notifications and live interactions
- Media Sharing: Share photos, videos, and creative content
- Advanced Search: Find performers, networks, and content with ease
- Privacy Controls: Manage your audience and control your performance visibility
- React 19 - Latest React with concurrent features for smooth performance
- TypeScript - Type-safe development for reliable code
- Vite - Lightning-fast build tool and development server
- Tailwind CSS - Utility-first CSS with custom circus-themed styling
- Framer Motion - Smooth animations and delightful interactions
- Redux Toolkit - Predictable state management
- React Router - Seamless navigation between performance spaces
- Node.js - Powerful server-side JavaScript runtime
- Express.js - Fast, unopinionated web framework
- MongoDB - Flexible NoSQL database for dynamic content
- Prisma - Modern database toolkit with type safety
- JWT - Secure authentication and authorization
- Cloudinary - Cloud-based media management and optimization
- Node.js 18+
- MongoDB database
- npm or yarn package manager
-
Clone the Repository
git clone https://github.com/spykelionel/connectr.git cd circusprime -
Backend Setup
cd backend npm install cp .env.example .env # Configure your environment variables npm run dev
-
Frontend Setup
cd frontend npm install npm run dev -
Access the Application
- Frontend: http://localhost:3000
- Backend API: http://localhost:3001
circusprime/
├── frontend/ # React frontend application
│ ├── src/
│ │ ├── components/ # Reusable UI components
│ │ ├── pages/ # Page components
│ │ ├── features/ # Redux slices and state management
│ │ ├── services/ # API services and RTK Query
│ │ └── lib/ # Utility functions
│ └── public/ # Static assets
├── backend/ # Node.js backend application
│ ├── src/
│ │ ├── modules/ # Feature modules
│ │ ├── middleware/ # Express middleware
│ │ └── utils/ # Utility functions
│ └── prisma/ # Database schema and migrations
└── docs/ # Documentation
CircusPrime is built on the principle that social networking should be fun, engaging, and visually delightful. Our design system draws inspiration from the magic of the circus:
- Bold Colors: Vibrant palettes that capture the energy of a circus performance
- Playful Animations: Smooth transitions and delightful micro-interactions
- Community Focus: Every feature is designed to bring people together
- Accessibility: Ensuring everyone can enjoy the circus, regardless of ability
We welcome performers of all skill levels to join our circus! Here's how you can contribute:
- Fork the Repository
- Create a Feature Branch:
git checkout -b feature/amazing-new-trick - Commit Your Changes:
git commit -m 'Add some amazing new trick' - Push to the Branch:
git push origin feature/amazing-new-trick - Open a Pull Request
- Follow the existing code style and conventions
- Write meaningful commit messages
- Add tests for new features
- Update documentation as needed
- Ensure accessibility standards are met
npm run dev- Start development servernpm run build- Build for productionnpm run preview- Preview production buildnpm run lint- Run ESLint
npm run dev- Start development server with hot reloadnpm run build- Build for productionnpm run start- Start production servernpm run test- Run test suite
VITE_API_URL=http://localhost:3001
VITE_APP_NAME=CircusPrimePORT=3001
MONGODB_URI=mongodb://localhost:27017/circusprime
JWT_SECRET=your-jwt-secret
CLOUDINARY_CLOUD_NAME=your-cloudinary-name
CLOUDINARY_API_KEY=your-cloudinary-key
CLOUDINARY_API_SECRET=your-cloudinary-secret- User authentication and profiles
- Social feed with posts and interactions
- Connection management
- Network/community creation
- Real-time notifications
- Media sharing capabilities
- Live streaming performances
- Virtual circus games and activities
- Advanced content creation tools
- Mobile app (React Native)
- AI-powered content recommendations
- Virtual reality experiences
Join our vibrant community of performers and creators:
- Discord: Join our circus troupe
- Twitter: @CircusPrime
- Instagram: @CircusPrime
- Website: circusprime.com
This project is licensed under the MIT License - see the LICENSE file for details.
- Circus Community: Inspired by the magic and wonder of circus performers worldwide
- Open Source Contributors: Thank you to all the amazing developers who make this possible
- Design Inspiration: Drawing from the vibrant world of circus arts and performance
Step right up and join the greatest show on the internet! 🎪✨
CircusPrime - Where Every Day is a Performance!