README.md

Auto Marketplace

This repository contains the source code for the Auto Marketplace project, a seamless and intuitive platform for buying and selling vehicles online.

Features

1. Free Vehicle Listings: List your vehicle for free on our platform. Reach a wide audience of potential buyers without any cost.

2. Advanced Search Filters: Easily find the vehicle that suits your needs with advanced search filters. Filter by make, model, year, price range, and more.

3. Subscription and Notifications: Subscribe to specific criteria and receive notifications whenever new listings matching your interests are added. Stay informed without constantly checking the platform.

4. Simple and Intuitive User Experience: We prioritize a clean and user-friendly design to ensure a straightforward experience for both buyers and sellers. Navigate through the platform with ease.

Tools and Technologies

• Web Application: Next.js (App Router), TypeScript, Tailwind CSS & DaisyUI
• Backend (API service & cron jobs): Go
• API: gRPC
• Data Store: Xata
• Authentication: Auth0
• Deployment: Kubernetes, Helm, ArgoCD, Dockerhub
• E2E Testing: Playwright
• Infrastructure: AWS SES, AWS S3
• Other Tools: Pulumi, React-email, ImageKit, NX, Tilt, Devbox, Storybook, Thumbhash

Running Locally

You can run the application locally either using Kubernetes or by running commands directly. Follow these steps:

Prerequisites

1. Set Up Infrastructure: Follow the Pulumi guide to create the necessary infrastructure.
2. Initialize Xata: Follow the Xata guide to set up Xata.
3. Create .env File: Use the values from the previous steps to create a .env file based on the .env.example file in the root of the repository.
4. Load Environment Variables: Install direnv and run direnv allow to load the .envrc or .env file.
5. Install Devbox: Install Devbox and run devbox shell to install the required packages and tools. (Optionally, install the Devbox VSCode extension if you use VSCode).

Running with Kubernetes

1. Set Up Docker and Kubernetes: Make sure your Docker daemon and a local Kubernetes node (e.g., Minikube, Rancher) are running.
2. Start Application: Install Tilt and Run tilt up to deploy Targabay within local Kubernetes.

Running with Commands

1. Install Dependencies: Run pnpm i to install the dependencies.
2. Start Application: Run pnpm dev to start the API server and web app in development mode.
3. More Scripts: Check the package.json for other available scripts.

Contributing

We welcome contributions! If you'd like to contribute to the code or have questions about the project, please follow our contribution guidelines.

License

This project is licensed under the MIT License.

Contact

If you have any questions or feedback, feel free to reach out to us at a.kajendran@gmail.com.