{"id":19468818,"url":"https://github.com/ndevu12/remotejobs","last_synced_at":"2025-02-25T14:27:18.333Z","repository":{"id":258801641,"uuid":"868104438","full_name":"Ndevu12/RemoteJobs","owner":"Ndevu12","description":"Remote Job website","archived":false,"fork":false,"pushed_at":"2024-10-23T07:09:22.000Z","size":213,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"develop","last_synced_at":"2025-01-08T04:51:19.590Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://remotewor.netlify.app/","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Ndevu12.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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}},"created_at":"2024-10-05T13:43:30.000Z","updated_at":"2024-10-23T07:09:26.000Z","dependencies_parsed_at":"2025-01-08T23:46:03.712Z","dependency_job_id":null,"html_url":"https://github.com/Ndevu12/RemoteJobs","commit_stats":null,"previous_names":["ndevu12/remotejobs"],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Ndevu12%2FRemoteJobs","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Ndevu12%2FRemoteJobs/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Ndevu12%2FRemoteJobs/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Ndevu12%2FRemoteJobs/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Ndevu12","download_url":"https://codeload.github.com/Ndevu12/RemoteJobs/tar.gz/refs/heads/develop","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":240682925,"owners_count":19840596,"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","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":[],"created_at":"2024-11-10T18:44:07.437Z","updated_at":"2025-02-25T14:27:18.286Z","avatar_url":"https://github.com/Ndevu12.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# RemoteJobs# RemoteJobs\n\nRemoteJobs is a web application designed to help users find and apply for remote job opportunities. The application allows companies to post job listings and users to browse and apply for these jobs.\n\n## Table of Contents\n\n- [Features](#features)\n- [Installation](#installation)\n- [Usage](#usage)\n- [API Endpoints](#api-endpoints)\n- [Contributing](#contributing)\n- [License](#license)\n\n## Features\n\n- **Job Listings**: Browse remote job opportunities posted by various companies.\n- **Job Application**: Apply for jobs directly through the platform.\n- **Company Profiles**: Companies can create profiles and post job listings.\n- **User Profiles**: Users can create profiles, upload resumes, and track their job applications.\n- **Search and Filter**: Search and filter job listings based on various criteria such as location, job type, and company.\n\n## N.B: All APIs are not implemented.\n\n## Installation\n\nTo get started with RemoteJobs, follow these steps:\n\n1. **Clone the repository**:\n   ```bash\n   git clone https://github.com/yourusername/remotejobs.git\n   cd remotejobs\n   ```\n\n2. **Install dependencies**:\n\n```bash\nyarn install\n```\n\n3. **Set up environment variables**: \n\nCreate a .env file in the root directory and add the necessary environment variables:\n\n```bash\nREACT_APP_API_BASE_URL=http://localhost:3000\n```\n\n4. **Start the development server:**\n\n```bash\nyarn build\n```\n\n5. **Run the backend server**: Navigate to the backend directory and start the server\n\n```bash\ncd backend\nyarn install\nyarn dev\n```\n\n## Usage\n\nOnce the application is up and running, you can access it at http://localhost:3000.\n\n### For Users\n\n1. **Sign Up**: Create a new account.\n2. **Browse Jobs**: Browse the available job listings.\n3. **Apply for Jobs**: Apply for jobs that match your skills and interests.\n4. **Track Applications**: Track the status of your job applications.\n\n### For Recruiters\n\n1. **Sign Up**: Create a new company account.\n2. **Create Profile**: Set up your company profile.\n3. **Post Jobs**: Post new job listings.\n4. **Manage Applications**: Review and manage applications from potential candidates.\n\n## API Endpoints\n\n### Authentication\n\n- **POST /auth/signup**: Register a new user or company.\n- **POST /auth/login**: Log in a user or company.\n\n### Jobs\n\n- **GET /jobs**: Retrieve a list of job listings.\n- **POST /jobs**: Create a new job listing (company only).\n- **GET /job/:id**: Retrieve details of a specific job listing.\n- **PUT /jobs/:id**: Update a job listing (company only).\n- **DELETE /jobs/:id**: Delete a job listing (company only).\n\n\n## Applications\n\n- **POST /apply/new**: Apply for a job (user only) with a new CV.\n- **POST /apply/exis**: Apply for a job (user only) with the existing CV.\n- **GET /applications**: Retrieve a list of applications (user only).\n- **GET /applications/:id**: Retrieve details of a specific application (user only).\n\n## Contributing\n\nWe welcome contributions to the RemoteJobs project! To contribute, follow these steps:\n\n1. **Fork the repository**.\n2. **Create a new branch**:\n\n```bash\ngit checkout -b feature/your-feature-name\n```\n\n3. **Make your changes**.\n4. **Commit your changes**:\n\n```bash\ngit commit -m 'Add some feature'\n```\n\n5. **Push to the branch**:\n\n```bash\ngit push origin feature/your-feature-name\n```\n\n6. **Create a pull request**.\n\n## License\n\nThis project is licensed under the MIT License. See the LICENSE file for details.\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fndevu12%2Fremotejobs","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fndevu12%2Fremotejobs","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fndevu12%2Fremotejobs/lists"}