An AI-powered exam seat finder and direction guide for Jahangirnagar University students
๐ Live Demo โข ๐ Documentation โข ๐ Report Bug โข โจ Request Feature
- ๐ Smart Search: Find exam seat details by roll number instantly
- ๐ Step-by-Step Directions: Detailed navigation to exam rooms with visual guides
- โฐ Real-Time Clock: Live time display with exam countdown timer
- ๐บ๏ธ Interactive Maps: Direct Google Maps integration with live preview
- ๐ฑ Fully Responsive: Optimized for all devices (mobile, tablet, desktop)
- ๐ Dark/Light Mode: Toggle between themes with smooth transitions
- ๐ฌ Personalized Advice: AI companion providing motivational support
- ๐ Real-Time Updates: Dynamic advice updates every 2 seconds
- ๐ฏ Context-Aware: Personalized messages based on student name and gender
- ๐ Emotional Support: Encouraging messages for exam success
- ๐ง Smart Guidance: Intelligent responses based on exam preparation
- โจ Smooth Animations: Micro-interactions and floating dot backgrounds
- ๐ Live Status Bar: Battery, network, weather, time, and date indicators
- ๐ญ Gender Detection: Smart student profile enhancement
- ๐ Exam Checklist: What to bring and what to avoid sections
- ๐ Success Preparation: Motivational cards and countdown timers
- ๐ค๏ธ Weather Integration: Current weather conditions for exam day
- โฑ๏ธ Live Clock: Real-time updates with timezone support
- ๐ Date Display: Current date with full formatting
- ๐ Device Status: Battery level and network status monitoring
- ๐ก Online/Offline Detection: Connection status with visual indicators
- Node.js (v18 or higher)
- npm or yarn
-
Clone the repository
git clone https://github.com/afrozaema/SeatFinder.git cd SeatFinder -
Install dependencies
npm install # or yarn install -
Start development server
npm run dev # or yarn dev -
Open your browser
http://localhost:5173
ju-seatfinder/
โโโ ๐ public/
โ โโโ ๐ centers.txt # Student data database
โ โโโ ๐ robots.txt # SEO robots configuration
โ โโโ ๐ sitemap.xml # SEO sitemap
โ โโโ ๐ site.webmanifest # PWA manifest
โ โโโ ๐ผ๏ธ favicon.svg # App icon
โโโ ๐ src/
โ โโโ ๐ App.tsx # Main application component
โ โโโ ๐ main.tsx # Application entry point
โ โโโ ๐ index.css # Global styles with animations
โ โโโ ๐ vite-env.d.ts # TypeScript definitions
โโโ ๐ package.json # Dependencies and scripts
โโโ ๐ tailwind.config.js # Tailwind CSS configuration
โโโ ๐ vite.config.ts # Vite configuration
โโโ ๐ tsconfig.json # TypeScript configuration
โโโ ๐ README.md # Project documentation
The student data is stored in public/centers.txt with the following format:
Roll|Name|Institution|Building|Room|Floor|ReportTime|StartTime|EndTime|Directions|MapURL
230417|Sadia Islam|NSU|Main Building|506|5th Floor|10:00 AM|12:00 PM|2:00 PM|Enter through Gate 2 โ Walk to Main Building โ Go to 5th Floor โ Room 506 on your right|https://www.google.com/maps?q=23.8156,90.4253
- Roll: Student roll number (unique identifier)
- Name: Full student name
- Institution: University/Institution code
- Building: Exam building name
- Room: Room number
- Floor: Floor information
- ReportTime: Exam reporting time
- StartTime: Exam start time
- EndTime: Exam end time
- Directions: Step-by-step navigation (separated by โ)
- MapURL: Google Maps link with coordinates
- Primary: Blue to Purple gradient (
from-blue-600 to-purple-600) - Secondary: Purple to Pink gradient (
from-purple-500 to-pink-500) - Success: Green shades (
green-50togreen-900) - Warning: Yellow to Orange gradient (
from-yellow-50 to-orange-50) - Error: Red shades (
red-50tored-900) - Info: Cyan to Blue gradient (
from-cyan-500 to-blue-500)
- Mobile:
< 640px(sm) - Optimized for phones - Tablet:
640px - 1024px(md) - Perfect for tablets - Desktop:
> 1024px(lg) - Full desktop experience
- Floating Dots: Multi-layer animated background patterns
- Micro-interactions: Hover effects and button animations
- Loading States: Smooth loading indicators
- Transitions: Seamless theme switching and state changes
Create a .env file in the root directory:
VITE_APP_TITLE=JU SeatFinder
VITE_API_BASE_URL=https://api.example.com
VITE_WEATHER_API_KEY=your_weather_api_keyThe project uses Tailwind CSS for styling. Configuration is in tailwind.config.js:
module.exports = {
content: ['./index.html', './src/**/*.{js,ts,jsx,tsx}'],
theme: {
extend: {
animation: {
'float': 'float 6s ease-in-out infinite',
'pulse-slow': 'pulse 3s ease-in-out infinite',
}
},
},
plugins: [],
}npm run build
# or
yarn build- Build the project:
npm run build - Upload the
distfolder to Netlify - Configure redirects for SPA routing
npm install -g vercel
vercel --prodnpm run build
npm run deploy- Uses student's first name for personalization
- 15+ unique motivational messages
- Updates every 2 seconds for dynamic experience
- Gender-aware messaging for better connection
- Confidence Boosters: "You are stronger than you think!"
- Preparation Reminders: "You've prepared well for this!"
- Stress Relief: "Take deep breaths and stay confident!"
- Success Motivation: "Your hard work will definitely pay off!"
- Exam Day Tips: "Remember to stay hydrated and focused!"
- Automatic message rotation every 2 seconds
- Live status indicator showing "Live" updates
- Smooth animations and transitions
- Context-aware advice based on exam timing
-
World Time API: Real-time clock and date
https://worldtimeapi.org/api/timezone/Asia/Dhaka -
Quotable API: Motivational quotes
https://api.quotable.io/random?tags=motivational,success -
Genderize API: Gender detection from names
https://api.genderize.io?name={firstName} -
OpenWeatherMap API: Weather information
https://api.openweathermap.org/data/2.5/weather?q=Dhaka -
Google Maps API: Interactive maps and directions
https://www.google.com/maps?q={latitude},{longitude}
// Search for a student by roll number
const rollNumber = "230417";
const student = centersData.find(s => s.roll === rollNumber);
if (student) {
console.log(`Found: ${student.name} in ${student.building} Room ${student.room}`);
}// Generate personalized advice
const firstName = studentData.name.split(' ')[0];
const randomAdvice = emaAdviceMessages[Math.floor(Math.random() * emaAdviceMessages.length)];
const personalizedAdvice = randomAdvice.replace('{name}', firstName);// Update live time every second
useEffect(() => {
const interval = setInterval(() => {
const now = new Date();
setLiveTime(now.toLocaleTimeString('en-US', {
hour: '2-digit',
minute: '2-digit',
second: '2-digit',
hour12: true
}));
}, 1000);
return () => clearInterval(interval);
}, []);npm run dev- Start development server with hot reloadnpm run build- Build for production with optimizationsnpm run preview- Preview production build locallynpm run lint- Run ESLint for code quality
- TypeScript: Strict mode enabled with comprehensive type checking
- ESLint: React and TypeScript rules for consistent code
- Prettier: Code formatting (recommended setup)
- Conventional Commits: Standardized commit messages
- Fork the repository
- Create a feature branch:
git checkout -b feature/amazing-feature - Commit changes:
git commit -m 'feat: add amazing feature' - Push to branch:
git push origin feature/amazing-feature - Open a Pull Request with detailed description
1. API Calls Failing
# Check network connection
ping google.com
# Verify API endpoints are accessible
curl https://worldtimeapi.org/api/timezone/Asia/Dhaka2. Data Not Loading
- Ensure
centers.txtis in thepublicfolder - Check file format and encoding (UTF-8)
- Verify data structure matches expected format
3. Responsive Issues
- Clear browser cache and cookies
- Check Tailwind CSS classes for responsive prefixes
- Test on different devices and browsers
4. Build Errors
# Update Node.js to latest LTS version
nvm install --lts
nvm use --lts
# Clear cache and reinstall dependencies
rm -rf node_modules package-lock.json
npm install
# Check TypeScript errors
npm run type-check5. Performance Issues
- Optimize images and assets
- Check for memory leaks in useEffect hooks
- Monitor API call frequency and implement caching
We welcome contributions! Please see our Contributing Guidelines for details.
- ๐ Bug Reports: Report issues and bugs with detailed reproduction steps
- โจ Feature Requests: Suggest new features with use cases
- ๐ Documentation: Improve documentation and examples
- ๐จ Design: UI/UX improvements and design suggestions
- ๐ป Code: Bug fixes, new features, and performance improvements
- ๐ Translations: Help translate the app to other languages
- Fork and clone the repository
- Install dependencies:
npm install - Create a feature branch:
git checkout -b feature/your-feature - Make your changes with proper testing
- Commit with conventional commit format
- Push and submit a pull request
- All PRs require at least one review
- Automated tests must pass
- Code coverage should not decrease
- Follow existing code style and patterns
- Update documentation if needed
This project is licensed under the MIT License - see the LICENSE file for details.
MIT License
Copyright (c) 2025 Afroza Akter Ema
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
- Jahangirnagar University - For inspiration and educational excellence
- React Team - For the amazing framework and ecosystem
- Tailwind CSS - For the utility-first CSS framework
- Lucide React - For beautiful and consistent icons
- Vite - For lightning-fast development experience
- TypeScript - For type safety and developer experience
- Netlify - For seamless deployment and hosting
- Open Source Community - For continuous inspiration and support
- ๐ฑ Progressive Web App (PWA): Offline support and app installation
- ๐ Push Notifications: Exam reminders and important updates
- ๐ Multi-language Support: Bengali and English language options
- ๐ Analytics Dashboard: Usage statistics and insights
- ๐ฏ Advanced Search: Filter by building, time, or institution
- ๐ Exam Notes: Personal notes and reminders feature
- ๐ฅ Student Community: Chat and discussion features
- ๐ฑ Mobile App: Native iOS and Android applications
- ๐ญ Custom Themes: Multiple color schemes and themes
- โจ Advanced Animations: More sophisticated micro-interactions
- ๐ฑ Better Mobile UX: Enhanced mobile-first design
- ๐จ Accessibility: WCAG 2.1 AA compliance
- ๐ผ๏ธ Visual Improvements: Better graphics and illustrations
- โก Performance: Code splitting and lazy loading
- ๐ Security: Enhanced data protection and privacy
- ๐ Monitoring: Error tracking and performance monitoring
- ๐งช Testing: Comprehensive test coverage
- ๐ Documentation: Interactive API documentation
๐ Ready to find your exam seat? Get Started Now!
โญ If this project helped you, please give it a star! โญ