The official technical society website for CSVTU UTD-1 Bhilai - Where tech enthusiasts, coders, and innovators come together to explore, learn, and build the future.
Programmers' Paradise is a modern, responsive website built for the technical society of CSVTU UTD-1 Bhilai. The platform serves as a central hub for tech enthusiasts to discover events, join clubs, explore projects, and connect with like-minded individuals in the programming community.
- Dynamic Event Management - Browse upcoming workshops, hackathons, and tech talks
- Club Ecosystem - Explore specialized technical clubs and communities
- Project Showcase - Discover innovative student projects and contributions
- Resource Library - Access learning materials and technical resources
- Team Directory - Meet the team behind Programmers' Paradise
- Gallery - Visual highlights from events and activities
- Modern Design System - Built with Radix UI and shadcn/ui components
- Dark/Light Mode - Seamless theme switching with next-themes
- Responsive Design - Mobile-first approach with Tailwind CSS
- Type Safety - Full TypeScript implementation
- Form Handling - React Hook Form with Zod validation
- Interactive Charts - Data visualization with Recharts
- Smooth Animations - Enhanced UX with Tailwind animations
The website features dedicated pages for various technical clubs:
- π€ AI & ML Club - Artificial Intelligence and Machine Learning
- βοΈ Blockchain & Web3 - Decentralized technologies
- π» Competitive Programming - Algorithmic problem solving
- π MATLAB Club - Technical computing and analysis
- β‘ Nextronix - Next-generation electronics
- π’ PR & Outreach - Community engagement and communications
- Next.js 15.2.4 - React framework with App Router
- React 19 - Latest React with concurrent features
- TypeScript 5 - Type-safe development
- Tailwind CSS 3.4.17 - Utility-first CSS framework
- Radix UI - Unstyled, accessible UI primitives
- shadcn/ui - Re-usable component library
- Lucide React - Beautiful & consistent icons
- next-themes - Dark mode support
- React Hook Form - Performant forms with easy validation
- Zod - TypeScript-first schema validation
- @hookform/resolvers - Resolver for various validation libraries
- class-variance-authority - Component variant management
- clsx & tailwind-merge - Conditional className utilities
- cmdk - Command palette component
- date-fns - Date utility library
- embla-carousel-react - Carousel component
- recharts - Chart library for React
- sonner - Toast notifications
- vaul - Drawer component
- Node.js 18+
- npm, yarn, or pnpm package manager
-
Clone the repository
git clone https://github.com/yourusername/programmers-paradise.git cd programmers-paradise
-
Install dependencies
# Using npm npm install # Using yarn yarn install # Using pnpm pnpm install
-
Start the development server
# Using npm npm run dev # Using yarn yarn dev # Using pnpm pnpm dev
-
Open your browser Navigate to http://localhost:3000 to see the application.
programmers-paradise/
βββ app/ # Next.js App Router
β βββ globals.css # Global styles
β βββ layout.tsx # Root layout
β βββ page.tsx # Home page
β βββ about/ # About page
β βββ blog/ # Blog section
β βββ clubs/ # Club pages
β β βββ ai-ml/
β β βββ blockchain-web3/
β β βββ competitive-programming/
β β βββ matlab/
β β βββ nextronix/
β β βββ pr-outreach/
β βββ contact/ # Contact page
β βββ events/ # Events section
β βββ gallery/ # Photo gallery
β βββ join/ # Membership page
β βββ projects/ # Projects showcase
β βββ resources/ # Learning resources
β βββ team/ # Team directory
βββ components/ # Reusable components
β βββ ui/ # shadcn/ui components
β βββ site-header.tsx # Main navigation
β βββ site-footer.tsx # Footer component
β βββ theme-provider.tsx # Theme context
β βββ theme-toggle.tsx # Dark mode toggle
βββ hooks/ # Custom React hooks
βββ lib/ # Utility functions
βββ public/ # Static assets
βββ styles/ # Additional styles
The project uses a comprehensive set of UI components built on top of Radix UI:
- Layout: Card, Separator, Aspect Ratio
- Navigation: Navigation Menu, Breadcrumb, Pagination
- Forms: Input, Textarea, Select, Checkbox, Radio Group
- Feedback: Alert, Toast, Progress, Skeleton
- Overlay: Dialog, Sheet, Popover, Tooltip
- Data Display: Table, Badge, Avatar, Accordion
- Interactive: Button, Toggle, Slider, Tabs
# Development
npm run dev # Start development server
npm run build # Build for production
npm run start # Start production server
npm run lint # Run ESLint
# Package Management
npm install # Install dependencies
- Hero section with call-to-action
- Featured upcoming events
- Quick access to major sections
- Interactive club showcase
- Event listings with filtering
- Registration capabilities
- Event details and schedules
- Past events archive
- Individual club pages with detailed information
- Member spotlights and achievements
- Club-specific events and projects
- Joining instructions
- Student project showcases
- Technology stack details
- Live demos and GitHub links
- Collaborative opportunities
- Learning materials and tutorials
- Technical documentation
- Career guidance resources
- Industry insights
The website follows a consistent design system with:
- Typography: Inter font family for optimal readability
- Color Palette: CSS custom properties for theming
- Spacing: Tailwind CSS spacing scale
- Components: Consistent component variants using CVA
- Responsive Design: Mobile-first breakpoints
- Accessibility: WCAG 2.1 AA compliance with Radix UI
The application supports both light and dark themes with:
- System preference detection
- Manual theme switching
- Persistent theme selection
- Smooth transitions between themes
- Responsive design for all screen sizes
- Touch-friendly interactive elements
- Optimized navigation for mobile devices
- Progressive Web App (PWA) ready architecture
We welcome contributions to Programmers' Paradise! Here's how you can help:
- Fork the repository
- Create a feature branch:
git checkout -b feature/amazing-feature
- Commit your changes:
git commit -m 'Add amazing feature'
- Push to the branch:
git push origin feature/amazing-feature
- Open a Pull Request
- Follow TypeScript best practices
- Maintain component consistency with the design system
- Write meaningful commit messages
- Test your changes across different devices
- Update documentation when necessary
This project is licensed under the MIT License - see the LICENSE file for details.
Chhattisgarh Swami Vivekanand Technical University, Unit of Technology and Development-1, Bhilai is a premier technical institution committed to excellence in engineering education and research.
- Email: programmers.paradise@csvtu.ac.in
- Location: CSVTU UTD-1, Bhilai, Chhattisgarh, India
- Website: programmers-paradise.vercel.app
- Built with v0.dev for rapid prototyping
- UI components by shadcn/ui
- Icons by Lucide
- Deployment on Vercel
Made with β€οΈ by the Programmers' Paradise Team
π Building the future, one line of code at a time π