HireHub is a comprehensive job search platform that connects job seekers with employers through a modern, multi-platform application. The project consists of three main components: a Node.js backend API, a React Native mobile app, and a Next.js web application.
π± Mobile App: Download on Google Play
π Web Application: Visit Website
HireHub provides a seamless job search experience with:
- Real-time job listings from multiple sources
- Cross-platform accessibility (Mobile app + Web)
- Advanced job filtering by categories and locations
- Direct job application capabilities
- User authentication with Google Sign-In
- Push notifications for new job opportunities
HireHub-app/
βββ api/ # Backend API (Node.js + Express + Firebase)
βββ mobile/ # React Native Mobile App (Expo)
βββ web/ # Next.js Web Application
- Runtime: Node.js with ES modules
- Framework: Express.js
- Database: Firebase Firestore
- Job Data: JSearch API (RapidAPI)
- Scheduling: Node-cron for automated updates
- Authentication: Firebase Auth
- Framework: React Native with Expo
- Navigation: Expo Router (file-based routing)
- Authentication: Google Sign-In, Clerk
- UI Components: Custom components with Poppins font
- Push Notifications: Firebase Cloud Messaging
- State Management: React hooks
- Styling: React Native Linear Gradient
- Framework: Next.js 14
- Styling: Tailwind CSS
- Deployment: Vercel-ready
- Responsive Design: Mobile-first approach
- Node.js (v14 or higher)
- npm or yarn
- Expo CLI (for mobile development)
- Firebase project
- JSearch API key (RapidAPI)
cd api
npm install
cp env.example .env
# Configure your .env file with Firebase and API keys
npm run devEnvironment Variables (api/.env):
FIREBASE_API_KEY=your_firebase_api_key
FIREBASE_AUTH_DOMAIN=your_project_id.firebaseapp.com
FIREBASE_PROJECT_ID=your_project_id
FIREBASE_STORAGE_BUCKET=your_project_id.appspot.com
FIREBASE_MESSAGING_SENDER_ID=your_messaging_sender_id
FIREBASE_APP_ID=your_app_id
FIREBASE_MEASUREMENT_ID=your_measurement_id
JOB_SEARCH_API=your_job_search_api_key
PORT=3000cd mobile
npm install
# Configure Google Services for Android
npm startFor Android Build:
# Add SHA certificates to Firebase
cd android
./gradlew signingReport
npm run androidcd web
npm install
npm run dev- Multi-category job browsing: Frontend, Backend, DevOps, App Development, AI/ML, UI Design, FullStack
- Real-time job updates: Automated data fetching from JSearch API
- Advanced filtering: By location, job type, and category
- Job details: Comprehensive job information with company details
- Cross-platform: Native mobile app + responsive web interface
- Authentication: Secure Google Sign-In integration
- Push notifications: Stay updated with new job opportunities
- Offline support: Cached job data for offline browsing
- Real-time data sync: Firebase Firestore integration
- Automated job updates: Cron-based data refresh
- Scalable architecture: Microservices approach
- Modern UI/UX: Custom design with Poppins typography
- Create a Firebase project at Firebase Console
- Enable Firestore Database and Authentication
- Configure Google Sign-In
- Set up Firebase Cloud Messaging for push notifications
- Add your Firebase configuration to environment files
- Sign up for RapidAPI
- Subscribe to JSearch API
- Get your API key
- Add the key to your backend environment variables
- Configure Google Services for Android
- Set up SHA certificates for Firebase
- Configure Expo for development and production builds
{
Category: string; // Job category (Frontend, Backend, etc.)
Company: string; // Company name
JobPublisher: string; // Job board publisher
Link: string; // Application link
Role: string; // Job title
Logo?: string; // Company logo URL
Location?: string; // Job location
About: string; // Job description
Id: string; // Unique job ID
Type: string; // Employment type
}- Deploy to platforms like Heroku, Railway, or DigitalOcean
- Set environment variables in your hosting platform
- Configure cron jobs for automated data updates
- Android: Build APK/AAB using EAS Build
- iOS: Build using EAS Build for App Store
- Web: Deploy Expo web build to hosting platforms
- Deploy to Vercel (recommended for Next.js)
- Configure environment variables
- Set up custom domain if needed
cd api
npm testcd mobile
npm run testcd web
npm run lintWe welcome contributions from the community! Please follow these steps:
- Fork the repository
- Create a feature branch (
git checkout -b feature/amazing-feature) - Make your changes and commit them (
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
- Add appropriate tests for new features
- Update documentation for any API changes
- Ensure cross-platform compatibility
- Email: [email protected]
- Issues: GitHub Issues
- Documentation: Check individual component READMEs for detailed setup instructions
- Enhanced mobile app with Expo Router
- Improved job search functionality
- Added push notifications
- Updated UI/UX with modern design
- Cross-platform compatibility improvements
- Initial release with basic job search
- Firebase integration
- Google Sign-In authentication
- Multi-category job browsing
- Advanced job search filters
- Job application tracking
- Company profiles and reviews
- Resume builder integration
- Interview scheduling
- Salary insights and comparisons
- Multi-language support
- Dark mode theme
Built with β€οΈ by Ajay maurya