- Repo: ciitm-frontend on GitHub
- Live Site: Grow Rich Mindset
- Made by: NexGenStudioDev (Abhishek Kumar)
- License: Personal Contributor License v1.0
A comprehensive educational website built for CIITM Dhanbad with modern architecture, real-time features, and complete institutional management system. The platform provides seamless experience for students, administrators, and staff with advanced features like online admissions, payment processing, and dynamic content management.
- Online Admission Process - Complete admission workflow with form validation
- Student Dashboard - Personalized dashboard for students
- Fee Management - Online fee payment with Razorpay integration
- Grade & Academic Records - Track academic performance and records
- Parent Information Management - Comprehensive parent/guardian data
- Multi-Role Login System - Separate access for students and admins
- Google OAuth Integration - Quick login with Google accounts
- Protected Routes - Role-based access control
- Password Recovery - Forgot password and reset functionality
- Secure Session Management - JWT token-based authentication
- Dynamic Dashboard - Real-time data visualization and analytics
- Student Management - View, search, and manage student records
- Course Management - Create and manage educational courses
- Content Management - Update website content dynamically
- Payment Tracking - Monitor fee payments and generate reports
- Gallery Management - Upload and organize institutional images
- Contact Management - Handle inquiries and contact requests
- Album System - Create and manage photo albums
- Image Gallery - Responsive image gallery with lightbox
- Dynamic Content - Admin can update all website content
- Testimonial System - Collect and manage student testimonials
- Razorpay Gateway - Secure online payment processing
- Fee Calculation - Automatic fee calculation and tracking
- Payment History - Comprehensive payment records
- Receipt Generation - Digital payment receipts
- Socket.IO Integration - Real-time data updates
- Live Notifications - Instant updates and alerts
- Real-time Dashboard - Live data synchronization
- Responsive Design - Works on all devices and screen sizes
- Modern UI/UX - Clean and intuitive interface
- Smooth Animations - GSAP-powered animations
- SEO Optimized - React Helmet for meta tags and SEO
- Fast Loading - Optimized performance with lazy loading
- βοΈ React 18.3.1 - Modern React with hooks and functional components
- π¨ Tailwind CSS 3.4.17 - Utility-first CSS framework
- π Redux Toolkit - State management
- π Vite - Fast build tool and development server
- π± React Router DOM - Client-side routing
- π React Hook Form - Form handling and validation
- π Socket.IO Client - Real-time communication
- π‘ Axios - HTTP client for API calls
- π JWT Authentication - Secure authentication
- β¨ GSAP - Professional animations
- π Swiper.js - Modern touch slider
- π’ React Slick - Carousel component
- π¨ React Icons - Icon library
- π« React Spinners - Loading animations
- π³ React Razorpay - Payment gateway integration
- π React Toastify - Toast notifications
- π― SweetAlert2 - Beautiful alert dialogs
- π§Ή DOMPurify - XSS protection
- π Yup & Zod - Schema validation
- π§ ESLint - Code linting
- π Prettier - Code formatting
- π¦ PostCSS - CSS processing
- ποΈ SWC - Fast compilation
src/
βββ π assets/ # Static assets (images, icons)
β βββ images/ # Image assets
β βββ logo.svg # App logo
βββ π components/ # Reusable components
β βββ π Atoms/ # Basic UI components
β β βββ Button/ # Button components
β β βββ Input/ # Input components
β β βββ Dropdown/ # Dropdown components
β β βββ ...
β βββ π Molecules/ # Combined atom components
β β βββ Cards/ # Card components
β β βββ Loader/ # Loading components
β β βββ Admin/ # Admin-specific molecules
β βββ π Organisms/ # Complex components
β β βββ NavBar/ # Navigation components
β β βββ Footer/ # Footer components
β β βββ SideBar/ # Sidebar components
β β βββ Admin/ # Admin organisms
β βββ π Templates/ # Page templates
β β βββ Admin/ # Admin page templates
β β βββ home/ # Home page sections
β β βββ about/ # About page sections
β β βββ ...
β βββ π Auth/ # Authentication components
β βββ π Protected/ # Protected route components
βββ π pages/ # Page components
β βββ π Admin/ # Admin pages
β β βββ DashboardPage.jsx
β β βββ StudentPage.jsx
β β βββ FeePay.jsx
β β βββ ...
β βββ Home.jsx
β βββ About.jsx
β βββ ...
βββ π store/ # Redux store and slices
β βββ appStore.js # Main store configuration
β βββ AuthSlice.js # Authentication state
β βββ homeSlice.js # Home page state
β βββ ...
βββ π hooks/ # Custom React hooks
β βββ useHomeUi.js # Home page data fetching
β βββ useAbout.js # About page data fetching
β βββ useAlbum.js # Album data management
β βββ ...
βββ π utils/ # Utility functions
β βββ apiUrl.js # API configuration
β βββ constants.js # API endpoints
βββ π validation/ # Form validation schemas
βββ π service/ # API service functions
βββ π config/ # Configuration files
βββ socket.mjs # Socket.IO configuration
Before running this project, make sure you have the following installed:
- Node.js (v18 or higher)
- npm or yarn
- Git
-
Clone the repository
git clone https://github.com/Coder-Studies/ciitm-frontend.git cd ciitm-frontend
-
Install dependencies
npm install
-
Environment Setup Create a
.env
file in the root directory and add:VITE_BACKEND_URL=your_backend_url VITE_RAZORPAY_KEY_ID=your_razorpay_key
-
Start development server
npm run dev
-
Build for production
npm run build
Script | Description |
---|---|
npm run dev |
Start development server with hot reload |
npm run build |
Build the project for production |
npm run preview |
Preview the production build locally |
npm run lint |
Run ESLint for code quality checks |
npm run format |
Format code using Prettier |
- Atomic Design Pattern - Components organized as Atoms, Molecules, Organisms, and Templates
- Functional Components - Modern React with hooks
- Custom Hooks - Reusable logic for data fetching and state management
- Higher-Order Components - Protected routes and authentication
- Redux Toolkit - Centralized state management
- Slice Pattern - Modular state slices for different features
- Real-time Updates - Socket.IO integration for live data
- Axios Interceptors - Centralized HTTP client configuration
- Custom Hooks - Data fetching and caching
- Error Handling - Comprehensive error management
- Socket.IO - Real-time communication
vite.config.js
- Vite build tool configurationtailwind.config.js
- Tailwind CSS customizationeslint.config.js
- ESLint rules and pluginspostcss.config.js
- PostCSS processing
vercel.json
- Vercel deployment settings with API proxyingpackage.json
- Dependencies and build scripts
- Base URL: Configurable via environment variables
- Authentication: JWT token-based with automatic refresh
- Real-time: Socket.IO for live updates
- Error Handling: Centralized error management
// Authentication
POST /api/v1/auth/login
POST /api/v1/auth/Admin/SignUp
// Student Management
GET /api/v1/students
POST /api/v1/students/create
PUT /api/v1/students/:id
// Payment Processing
POST /api/create/payment
POST /api/pay/verify
// Content Management
GET /api/v1/frontend
POST /api/v1/admin/course/create
GET /api/v1/albums
- JWT token-based authentication
- Role-based access control (Student/Admin)
- Protected routes for sensitive areas
- Automatic token refresh
- DOMPurify for XSS prevention
- Form validation with Yup/Zod schemas
- HTTPS enforcement in production
- Secure cookie handling
- Razorpay PCI-compliant payment processing
- Server-side payment verification
- Encrypted payment data transmission
- Mobile: 350px and up
- Tablet: 1000px and up
- Desktop: 1200px and up
- Mobile-first approach
- Touch-friendly interface
- Optimized images and assets
- Smooth animations and transitions
- Lazy Loading - Components loaded on demand
- Code Splitting - Chunked bundles for faster loading
- Tree Shaking - Unused code elimination
- Minification - Compressed production builds
- Image Optimization - WebP format and responsive images
- Bundle Analysis - Optimized bundle sizes
- Caching Strategies - Browser and CDN caching
- ESLint - Code linting and best practices
- Prettier - Consistent code formatting
- TypeScript-ready - Type safety preparation
- Real-time error tracking
- Performance metrics monitoring
- User experience optimization
- Git-based version control
- Semantic commit messages
- Feature branch workflow
- Pull request reviews
- Automated testing on commits
- Continuous integration ready
{
"react": "^18.3.1",
"react-dom": "^18.3.1",
"@reduxjs/toolkit": "^2.5.0",
"react-redux": "^9.2.0",
"react-router-dom": "^7.0.2"
}
{
"tailwindcss": "^3.4.17",
"react-icons": "^5.5.0",
"gsap": "^3.12.7",
"swiper": "^11.2.1"
}
{
"axios": "^1.7.9",
"socket.io-client": "^4.8.1",
"react-razorpay": "^3.0.1"
}
We welcome contributions to improve the CIITM Frontend project! Here's how you can contribute:
- Fork the repository
- Create a feature branch (
git checkout -b feature/amazing-feature
) - Make your changes
- Commit your changes (
git commit -m 'Add some amazing feature'
) - Push to the branch (
git push origin feature/amazing-feature
) - Open a Pull Request
- Follow the existing code style and conventions
- Write clear and descriptive commit messages
- Test your changes thoroughly
- Update documentation if necessary
- Ensure your code passes all linting checks
- π§ Email: [email protected]
- π GitHub Issues: Report bugs or request features
- π¬ Discussions: Join our community discussions
- πΌ LinkedIn: Connect with the developer
- π¦ Twitter: Follow for updates
- π Facebook: Join our community
- β Complete authentication system
- β Student management dashboard
- β Payment integration with Razorpay
- β Real-time features with Socket.IO
- β Responsive design implementation
- β Admin panel with full CRUD operations
- π§ Email notification system
- π Advanced analytics dashboard
- π± Mobile app development
- π Push notification support
- React Team - For the amazing React framework
- Tailwind CSS - For the utility-first CSS framework
- Vercel - For excellent deployment platform
- Open Source Community - For the incredible libraries and tools
This project was built to modernize educational institute management and provide a seamless experience for students and administrators.
- π― Purpose: Educational Institute Management System
- π Development Time: Ongoing
- ποΈ Architecture: React + Redux + Socket.IO
- π¨ Design System: Atomic Design Pattern
- π± Responsive: Mobile-First Approach
- π Security: JWT + Role-Based Access
- π³ Payment: Razorpay Integration
- π Performance: Optimized for Speed
This project uses a special license to protect the code and allow fair use.
- Read and learn from the code
- Contribute to this project
- Show your accepted work in your portfolio (with credit)
- Host this project on your own website or server
- Sell or use the code for paid work, startups, or companies
- Use it in teaching, courses, bootcamps, or training platforms without permission
- Copy or publish the whole project or parts of it somewhere else
- You can only show what you personally made
- You must say itβs part of ciitm-frontend by Coder-Studies
- You must link to the original repo: https://github.com/Coder-Studies/ciitm-frontend
- You cannot host or deploy the full project
If someone breaks the license:
- A DMCA complaint may be filed
- Hosting platforms like GitHub or Netlify may be notified
- Legal steps may be taken if needed
- This code is shared as-is β the author is not responsible for any issues or losses caused by using it
For questions, permission, or legal concerns, reach out:
- GitHub: Coder-Studies