• People can register as job seekers, build their profiles, and look for jobs matching their skill sets.
• Users can upload their existing resumes. If they do not have one, they should be able to fill out a form and have a resume built for them.
• People can apply directly to posted jobs.
• Companies can register, post jobs, and search job seeker profiles.
• Multiple representatives from a company should be able to register and post jobs.
• Company representatives can view a list of job applicants and can contact them, initiative an interview, or perform some other action related to their post.
• Registered users should be able to search for jobs and filter the results based on location, required skills, salary, experience level, etc

• React - Frontend UI Library
• Vite - Frontend Tooling
• Express - Backend Framework
• Typescript – Language
• Tailwind – CSS
• MongoDB - Database
• Mogoose - Database ODM
• Axios - Promise based Http Client
• Formik - Form handler
• Zustand - State Management

Here's what you need to be able to run Job Portal:

• Node.js (version>=18.18.0)
• Docker

git clone [email protected]:drbarzaga/job-portal.git
cd job-portal

You need to create a .env file inside the client folder, and define the following env variables there:

VITE_API_URL=http://localhost:5555/api/v1

You need to create a .env file inside the server folder, and define the following env variables there:

PORT=5555  #API -> http://localhost:5555
NODE_ENV=development
JWT_SECRET=yourJwtSecret
MONGO_URL=mongodb://localhost:27017/job-portal #With docker use this mongodb://job-portal-mongo:27017/job-portal

docker-compose up

Using npm

npm install
npm run install:all
npm run dev

Using yarn

yarn install
yarn run install:all
yarn run dev

If you're going to run the application locally, make sure you have MongoDB installed on your computer and add the MONGO_URL environment variable to the server's .env file.

Visit http://localhost:5137 in your browser.

Job Portal is an open-source project and we welcome contributions from the community.

If you'd like to contribute, please fork the repository and make changes as you'd like. Pull requests are warmly welcome.