Ecosyste.ms: Awesome

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

Awesome Lists | Featured Topics | Projects

https://github.com/ndrxwsh/car-scout

Car Scout is a full-stack Next.js application for searching, viewing, and favoriting cars. It features secure user authentication, a responsive design, and integrates PostgreSQL with Prisma ORM.
https://github.com/ndrxwsh/car-scout

nextjs14 prisma tailwindcss typescript vercel

Last synced: 18 days ago
JSON representation

Car Scout is a full-stack Next.js application for searching, viewing, and favoriting cars. It features secure user authentication, a responsive design, and integrates PostgreSQL with Prisma ORM.

Awesome Lists containing this project

README

        

# Car Scout

Car Scout is a web application that allows users to search for cars, view detailed information, and save their favorite cars. The application provides a user-friendly interface for exploring various car brands, models, and specifications.

## Features

- **Car Search:** Users can search for cars by various criteria such as brand, model, year, and price.
- **Car Details:** Each car listing provides detailed information including brand, model, color, price, year of manufacture, engine type, transmission, and range (for electric cars).
- **Favorites:** Users can add cars to their favorites list for easy access later.

## Technologies Used

- **Frontend & Backend:** Built with [Next.js](https://nextjs.org), which provides both server-side rendering and static site generation.
- **Database:** [PostgreSQL](https://www.postgresql.org) with [Prisma ORM](https://www.prisma.io) for database interactions and migrations.
- **Styling:** [Tailwind CSS](https://tailwindcss.com) for responsive and customizable styling.

## Installation

1. Clone the repository:

```bash
git clone [email protected]:ndrxwsh/car-scout.git
cd car-scout
```

2. Install dependencies:

```bash
npm install
```

3. Set up environment variables:

- Create a `.env` file in the root of the project.
- Add the following environment variables:
```bash
DATABASE_URL=postgresql://car-scout_owner:[email protected]/car-scout?sslmode=require
```

4. Run database migrations:

```bash
npx prisma migrate dev
```

5. Start the development server:
```bash
npm run dev
```

## Usage

- **Search for Cars:** Use the search bar and filters to find cars by specific criteria.
- **View Details:** Click on any car to see detailed information about it.
- **Add to Favorites:** Save cars to your favorites by clicking the "Add to Favorites" button.