{"id":30344523,"url":"https://github.com/brittojo7n/pernstackproject-jobportal","last_synced_at":"2025-10-14T06:10:19.980Z","repository":{"id":308000311,"uuid":"1031191192","full_name":"brittojo7n/PERNStackProject-JobPortal","owner":"brittojo7n","description":"A portal aimed at job seekers and recruiters built with React, Node.js, and PostgreSQL.","archived":false,"fork":false,"pushed_at":"2025-08-10T06:44:49.000Z","size":602,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2025-08-18T12:50:43.615Z","etag":null,"topics":["database","express","express-js","expressjs","job","job-portal","job-portal-website","job-search","jobsearch","nodejs","nodemailer","pern-stack","postgres","postgresql","postgresql-database","react","react-hooks","react-router","server","website"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/brittojo7n.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-08-03T07:57:36.000Z","updated_at":"2025-08-10T06:44:52.000Z","dependencies_parsed_at":"2025-08-05T20:31:08.183Z","dependency_job_id":null,"html_url":"https://github.com/brittojo7n/PERNStackProject-JobPortal","commit_stats":null,"previous_names":["brittojo7n/assignment-jobportal","brittojo7n/pernstackproject-jobportal"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/brittojo7n/PERNStackProject-JobPortal","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/brittojo7n%2FPERNStackProject-JobPortal","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/brittojo7n%2FPERNStackProject-JobPortal/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/brittojo7n%2FPERNStackProject-JobPortal/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/brittojo7n%2FPERNStackProject-JobPortal/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/brittojo7n","download_url":"https://codeload.github.com/brittojo7n/PERNStackProject-JobPortal/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/brittojo7n%2FPERNStackProject-JobPortal/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279018121,"owners_count":26086280,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-14T02:00:06.444Z","response_time":60,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["database","express","express-js","expressjs","job","job-portal","job-portal-website","job-search","jobsearch","nodejs","nodemailer","pern-stack","postgres","postgresql","postgresql-database","react","react-hooks","react-router","server","website"],"created_at":"2025-08-18T12:42:58.215Z","updated_at":"2025-10-14T06:10:19.974Z","avatar_url":"https://github.com/brittojo7n.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n  \u003cbr /\u003e\n  \u003ch1\u003e\n    Job Portal - Full-Stack (PERN) Application\n  \u003c/h1\u003e\n  \u003cstrong\u003eA Job Portal Website built with Express, React, Node and PostgreSQL.\u003c/strong\u003e\n  \u003cbr /\u003e\n  \u003cbr /\u003e\n\u003c/div\u003e\n\n## 🚀 Introduction\n\nThis project is a complete, full-stack web application designed to be a modern and intuitive platform for the job market. It connects applicants with recruiters through a seamless and feature-rich interface. The application supports distinct user roles, secure authentication, and a robust set of functionalities for managing job postings and applications from start to finish. The entire UI is built with a sleek, dark-themed \"glassmorphism\" aesthetic for an elegant user experience.\n\n## ✨ Key Features\n\nThe application is divided into two primary user roles, each with a tailored set of features:\n\n#### 👨‍💻 **For Applicants (Job Seekers)**\n\n* **Modern UI:** A sleek, dark-themed \"glassmorphism\" interface for an elegant user experience.\n* **Job Discovery:** Browse and search for job listings with a real-time, client-side search bar.\n* **Secure Authentication:** Create an account and log in securely using JWT.\n* **Apply with Ease:** Apply for jobs with a simple form and resume upload.\n* **Application Tracking:** View the status of all submitted applications (Pending, Shortlisted, Rejected) in a personal dashboard.\n* **Saved Jobs:** Bookmark interesting jobs to a personal list and remove them when no longer needed.\n* **Withdraw Applications:** The ability to withdraw a submitted application.\n\n#### 💼 **For Recruiters**\n\n* **Recruiter Dashboard:** A powerful, two-panel dashboard to manage job postings and view applicants.\n* **Post \u0026 Manage Jobs:** Create new job listings with detailed descriptions.\n* **Applicant Management:** Select a job posting to view a detailed list of all applicants.\n* **Update Status:** Easily update the status of any application to keep candidates informed.\n* **Full Control:** View full details or delete job postings directly from the dashboard.\n\n---\n\n## 🛠️ Tech Stack\n\nThis project is built with a modern and robust set of technologies:\n\n| Frontend | Backend | Database | ORM | UI Library |\n| :---: | :---: | :---: | :---: | :---: |\n| ![React][React.js] | ![Node.js][Node.js] | ![PostgreSQL][PostgreSQL] | ![Sequelize][Sequelize] | ![Material-UI][Material-UI] |\n| **React** | **Node.js / Express** | **PostgreSQL** | **Sequelize** | **Material-UI** |\n\n[React.js]: https://img.shields.io/badge/React-20232A?style=for-the-badge\u0026logo=react\u0026logoColor=61DAFB\n[Node.js]: https://img.shields.io/badge/Node.js-339933?style=for-the-badge\u0026logo=nodedotjs\u0026logoColor=white\n[PostgreSQL]: https://img.shields.io/badge/PostgreSQL-316192?style=for-the-badge\u0026logo=postgresql\u0026logoColor=white\n[Sequelize]: https://img.shields.io/badge/Sequelize-52B0E7?style=for-the-badge\u0026logo=sequelize\u0026logoColor=white\n[Material-UI]: https://img.shields.io/badge/Material--UI-0081CB?style=for-the-badge\u0026logo=mui\u0026logoColor=white\n\n---\n\n## ⚙️ Getting Started\n\nFollow these instructions to get a copy of the project up and running on your local machine for development and testing purposes.\n\n### Prerequisites\n\nYou will need the following software installed on your machine:\n\n* [Node.js](https://nodejs.org/en/) (which includes npm)\n* [PostgreSQL](https://www.postgresql.org/download/)\n* [Git](https://git-scm.com/downloads)\n\n### Installation \u0026 Setup\n\n**1. Clone the repository:**\n\n```bash\ngit clone \u003cyour-repository-url\u003e\ncd job-portal\n```\n\n**2. Backend Setup:**\n\n```bash\n# Navigate to the server directory\ncd server\n\n# Install dependencies\nnpm install\n\n# Create a PostgreSQL database with the name you will specify in the .env file (e.g., job_portal_dev)\n\n# Create a .env file in the /server directory\n# Copy the contents from .env.example below and fill in your details\ntouch .env\n```\n\n`server/.env.example`\n\nYou can find it inside the folder rename it to `.env` and config it properly.\n\n```conf\nPORT=5000\nDB_USER=postgres\nDB_PASSWORD=your_postgres_password\nDB_NAME=your_postgres_db\nDB_HOST=localhost\nDB_PORT=5432\n\nJWT_SECRET=use_any_256_bit_alpha_numeric_string\n\n# For nodemailer use Google Mail with App Password\nEMAIL_USER=example@mail.com\nEMAIL_PASS=app_password\n```\n\n**3. Frontend setup**\n\n```bash\n# Navigate to the client directory from the root folder\ncd ../client\n\n# Install dependencies\nnpm install\n```\n\n`client/.env`\n\nThis is already present. Ensure it looks like this.\n\n```conf\nREACT_APP_API_URL=http://localhost:5000/api\n```\nRunning the Application\nYou will need to run two terminals simultaneously.\n\n1. In the first terminal, start the Backend Server:\n\n```bash\ncd server\nnpm start\n```\n\nThe backend will be running on http://localhost:5000.\n\n2. In the second terminal, start the Frontend Client:\n\n```bash\ncd client\nnpm start\n```\n\nThe frontend application will open automatically in your browser at `http://localhost:3000`.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbrittojo7n%2Fpernstackproject-jobportal","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbrittojo7n%2Fpernstackproject-jobportal","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbrittojo7n%2Fpernstackproject-jobportal/lists"}