An open API service indexing awesome lists of open source software.

https://github.com/prisriorg/job-potal


https://github.com/prisriorg/job-potal

nextjs nextjs15-typescript

Last synced: 3 months ago
JSON representation

Awesome Lists containing this project

README

        

# Job Portal

A modern, responsive job portal built with Next.js, Framer Motion, and Tailwind CSS. This application connects job seekers with employers through an intuitive, animated interface.

![Job Portal Preview](public/job-portal-preview.png)

## โœจ Features

- **Modern UI/UX** - Stunning animations and transitions using Framer Motion
- **Responsive Design** - Works seamlessly on devices of all sizes
- **Job Search** - Advanced search functionality to find the perfect position
- **Interactive Elements** - Dynamic components that respond to user interaction
- **Employer & Seeker Focused** - Dual functionality for both job posters and seekers
- **Accessibility** - Built with accessibility in mind

## ๐Ÿš€ Tech Stack

- [Next.js 15](https://nextjs.org/) - React framework with App Router
- [React 19](https://react.dev/) - UI component library
- [TypeScript](https://www.typescriptlang.org/) - Type-safe JavaScript
- [Tailwind CSS](https://tailwindcss.com/) - Utility-first CSS framework
- [Framer Motion](https://www.framer.com/motion/) - Animation library
- [React Icons](https://react-icons.github.io/react-icons/) - Icon library

## ๐Ÿ“ฆ Installation

1. Clone the repository
```bash
git clone https://github.com/yourusername/job-portal.git
cd job-portal
```
2. Install dependencies
```bash
npm install
# or
yarn install
# or
bun install
```
3. Run the development server
```bash
npm install
# or
yarn install
# or
bun install
```
4. Open http://localhost:3000 in your browser

## ๐Ÿ—๏ธ Project Structure
```bash
job-portal/
โ”œโ”€โ”€ public/ # Static assets
โ”œโ”€โ”€ src/
โ”‚ โ”œโ”€โ”€ app/ # Next.js App Router
โ”‚ โ”‚ โ”œโ”€โ”€ page.tsx # Landing page
โ”‚ โ”‚ โ””โ”€โ”€ ... # Other pages
โ”‚ โ”œโ”€โ”€ components/ # Reusable components
โ”‚ โ””โ”€โ”€ styles/ # Global styles
โ””โ”€โ”€ ... # Config files
```
## ๐Ÿ’ป Usage
### For Job Seekers
- Create a profile to showcase your skills and experience
- Search for jobs using filters like location, salary range, and job type
- Apply directly to jobs with your profile
- Track application status in real-time
### For Employers
- Post job listings with comprehensive details
- Search for candidates that match your requirements
- Review applications and contact potential employees
- Manage your company profile

## ๐Ÿงช Testing
### Run the test suite:
```bash
npm test
# or
yarn test
# or
bun test
```

## ๐Ÿšข Deployment
The easiest way to deploy this application is using Vercel, the platform from the creators of Next.js:

Deploy with Vercel

## ๐Ÿ“„ License
This project is licensed under the MIT License - see the LICENSE file for details.

## ๐Ÿค Contributing
Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add some amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

## ๐Ÿ“ž Contact
If you have any questions or feedback, please reach out:
Email: [email protected]