{"id":22521745,"url":"https://github.com/al0olo/hiring-platform-frontend","last_synced_at":"2025-03-28T03:24:59.293Z","repository":{"id":264832111,"uuid":"894408841","full_name":"Al0olo/hiring-platform-frontend","owner":"Al0olo","description":null,"archived":false,"fork":false,"pushed_at":"2024-11-26T10:59:20.000Z","size":246,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-02-02T04:41:40.046Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"TypeScript","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/Al0olo.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}},"created_at":"2024-11-26T10:00:37.000Z","updated_at":"2024-11-26T10:59:24.000Z","dependencies_parsed_at":"2024-11-26T11:34:42.002Z","dependency_job_id":null,"html_url":"https://github.com/Al0olo/hiring-platform-frontend","commit_stats":null,"previous_names":["al0olo/hiring-platform-frontend"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Al0olo%2Fhiring-platform-frontend","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Al0olo%2Fhiring-platform-frontend/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Al0olo%2Fhiring-platform-frontend/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Al0olo%2Fhiring-platform-frontend/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Al0olo","download_url":"https://codeload.github.com/Al0olo/hiring-platform-frontend/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245962923,"owners_count":20701209,"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-12-07T05:12:47.299Z","updated_at":"2025-03-28T03:24:59.275Z","avatar_url":"https://github.com/Al0olo.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Hiring System Frontend\n\nA modern web application built with Next.js for managing user registrations. This application provides a clean and intuitive interface for creating and managing user profiles with various features and validations.\n\n## Features\n\n### User Registration\n- Full name validation with character limit\n- Date of birth picker\n- Location selection from predefined options\n- Multiple programming skills selection\n- Resume summary with character counter\n- Real-time form validation\n- Comprehensive error handling\n\n### User Management\n- View all registered users in a tabulated format\n- Search functionality across multiple fields\n- Detailed user view in modal\n- Skills displayed as tags\n- Responsive design for all screen sizes\n\n### UI/UX Features\n- Modern, clean interface\n- Form validation feedback\n- Loading states\n- Toast notifications\n- Responsive layout\n- Dark/Light mode support\n\n## Tech Stack\n\n- **Framework:** Next.js 14\n- **Styling:** Tailwind CSS\n- **Components:** shadcn/ui\n- **Form Handling:** React Hook Form\n- **Validation:** Zod\n- **HTTP Client:** Axios\n- **State Management:** React Hooks\n- **Icons:** Lucide React\n- **Notifications:** Sonner\n\n## Prerequisites\n\nBefore you begin, ensure you have installed:\n- Node.js (version 18 or later)\n- npm (version 8 or later)\n\n## Installation\n\n1. Clone the repository:\n```bash\ngit clone https://github.com/Al0olo/hiring-platform-frontend\ncd hiring-platform-frontend\n```\n\n2. Install dependencies:\n```bash\nnpm install --legacy-peer-deps\n```\n\n3. Create a `.env.local` file:\n```env\nNEXT_PUBLIC_API_URL=http://localhost:3001\n```\n\n4. Start the development server:\n```bash\nnpm run dev\n```\n\nThe application will be available at `http://localhost:3000`\n\n## Project Structure\n\n```\nsrc/\n├── app/\n│   ├── page.tsx                 # Landing page\n│   ├── new-user/\n│   │   └── page.tsx            # User registration form\n│   └── view-users/\n│       └── page.tsx            # Users list view\n├── components/\n│   ├── ui/                     # Reusable UI components\n│   └── shared/                 # Shared components\n├── services/\n│   └── api.ts                  # API service layer\n├── styles/\n│   └── globals.css             # Global styles\n└── types/\n    └── index.ts                # TypeScript definitions\n```\n\n## Available Scripts\n\n- `npm run dev` - Start development server\n- `npm run build` - Build for production\n- `npm start` - Start production server\n- `npm run lint` - Run ESLint\n- `npm run test` - Run tests\n\n## Environment Variables\n\n| Variable | Description | Default |\n|----------|-------------|---------|\n| NEXT_PUBLIC_API_URL | Backend API URL | http://localhost:3001 |\n\n## API Integration\n\nThe frontend communicates with a NestJS backend API. Ensure the backend server is running and accessible at the URL specified in your environment variables.\n\n### Available Endpoints:\n\n- `GET /users` - Fetch all users\n- `POST /users` - Create new user\n- `GET /users/:id` - Get user details\n\n## Form Validation Rules\n\n### Full Name\n- Required\n- Maximum 50 characters\n\n### Date of Birth\n- Required\n- Must be a valid date\n\n### Preferred Location\n- Required\n- Must be one of: Sydney, Melbourne, Brisbane, Adelaide, Perth\n\n### Programming Skills\n- At least one skill must be selected\n- Available options: React, Angular, C#, Java, Ruby, Python\n\n### Resume Summary\n- Required\n\n\n## Error Handling\n\nThe application includes comprehensive error handling:\n- Form validation errors\n- API request errors\n- Network errors\n- Loading states\n- User feedback via toast notifications\n\n## Browser Support\n\n- Chrome (latest)\n- Firefox (latest)\n- Safari (latest)\n- Edge (latest)\n\n## License\n\nThis project is licensed under the MIT License - see the LICENSE file for details\n\n## Acknowledgments\n\n- [Next.js](https://nextjs.org/)\n- [Tailwind CSS](https://tailwindcss.com/)\n- [shadcn/ui](https://ui.shadcn.com/)\n- [React Hook Form](https://react-hook-form.com/)","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fal0olo%2Fhiring-platform-frontend","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fal0olo%2Fhiring-platform-frontend","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fal0olo%2Fhiring-platform-frontend/lists"}