A comprehensive web application designed to address the declining enrollment in government degree colleges in Jammu & Kashmir by providing personalized career guidance to students after Class 10/12.
- Issue: 40-50% decline in government college enrollment in J&K
- Root Cause: Students lack career awareness and guidance about subject selection after 12th
- Target Users: Students aged 16-20 in J&K region who completed Class 10/12
- Goal: Increase government college enrollment through informed decision-making
- Framework: React.js with Vite + TypeScript
- Styling: Tailwind CSS + Shadcn/ui components
- State Management: Zustand
- Charts: Recharts for data visualization
- Maps: Google Maps API integration
- Runtime: Node.js with Express.js + TypeScript
- Database: PostgreSQL with Prisma ORM
- Authentication: JWT tokens
- Deployment: Vercel (frontend) + Railway (backend)
- Registration with email, phone, class level, location
- JWT-based login/logout
- Editable user profiles
- Protected routes for dashboard and assessments
- 30+ comprehensive questions covering interests, learning styles, personality traits
- Multi-step quiz with progress tracking
- Intelligent scoring algorithm
- Detailed results with career recommendations
- Interactive flowcharts showing educational pathways
- Comprehensive course database (Science, Arts, Commerce, Vocational)
- Career prospects and salary information
- Success statistics and growth opportunities
- 20+ J&K government colleges database
- Location-based search with Google Maps
- Advanced filtering and comparison tools
- Detailed college information and facilities
- AI-driven course and college suggestions
- Compatibility scoring based on assessments
- Location-aware recommendations
- Personalized dashboard with career journey tracking
- Academic calendar with important dates
- Admission deadlines and scholarship windows
- Email and push notifications
- Customizable reminder settings
- Study materials and exam preparation guides
- Scholarship information database
- Success stories and career guidance articles
- Alumni testimonials
- Progressive Web App (PWA) features
- Responsive design for all screen sizes
- Offline functionality for assessments
- Push notifications for mobile devices
- Users and authentication
- Assessment questions and results
- Colleges and courses mapping
- Career paths and recommendations
- Notifications and timeline events
- User interactions and bookmarks
- Clean and modern interface
- Blue (#3B82F6) and green (#10B981) color scheme
- Mobile-first responsive design
- Intuitive navigation with visual learning elements
- Fast loading with optimized performance
- User registration and retention rates
- Assessment completion rates
- College inquiry generation
- Feature usage statistics
- Government college enrollment impact
- Node.js (v18 or higher)
- PostgreSQL database
- Google Maps API key
- Clone the repository
git clone <repository-url>
cd digital_web- Install frontend dependencies
cd frontend
npm install- Install backend dependencies
cd ../backend
npm install- Set up environment variables
# Copy and configure environment files
cp .env.example .env- Set up database
npx prisma migrate dev
npx prisma db seed- Start development servers
# Backend (Terminal 1)
cd backend
npm run dev
# Frontend (Terminal 2)
cd frontend
npm run devAPI documentation is available at /api/docs when running the backend server.
# Run frontend tests
cd frontend
npm test
# Run backend tests
cd backend
npm test- Frontend: Deployed on Vercel
- Backend: Deployed on Railway
- Database: PostgreSQL on Railway
This project is developed for Smart India Hackathon 2025.
Developed for addressing the educational challenges in Jammu & Kashmir region.