Project

If hosting is active, you can view it here. The backend spins down with inactivity and may take up to a minute to start working again.

Description

This project is a beat store built with the following stack:

• Backend using Express.js
• Frontend built with Vite + React + TypeScript
• PostgreSQL database

Additional tools and libraries used:

• Tailwind CSS
• wavesurfer.js
• HeadlessUI

Currently, the project is hosted using free tiers of:

• AWS S3 (for file storage)
• Render (for the database, backend, and domain)

Key Functionalities

• User Authentication: Login and registration.
• Product Management: Display of all products with names, descriptions, and categories, along with a search feature.
• Product Details: Detailed view of individual products with options to add reviews.
• Shopping Cart: Add/remove products, calculate totals, and checkout functionality.
• Order History: View past orders and their details.
• Admin Panel: Two-level user permissions (admin can delete all reviews; users can only edit/delete their own).
• JWT Authentication: Secure login with JWT and refresh tokens.

The database schema is as follows:

Setup

To run the project locally, execute the following commands from the root directory:

cd vite-project
npm install
npm run dev

Then, in a new terminal instance:

cd vite-project/backend
npm install
npm run startdev

The startdev script automatically restarts the server when changes are made to server.js.

To connect to the database and AWS bucket, create a .env file inside vite-project/ with your credentials, e.g.:

PORT=2137
VITE_API_BASE_URL=http://localhost:2137

DB_USER=[your database username]
DB_HOST=[your database host URL]
DB_NAME=[your database name]
DB_PASSWORD=[your database password]
DB_PORT=[your database port]

VITE_AWS_ACCESS_KEY_ID=[your AWS access key]
VITE_AWS_SECRET_ACCESS_KEY=[your AWS secret key]
VITE_AWS_BUCKET_NAME=[your S3 bucket name]
VITE_AWS_REGION=[your S3 bucket region]

JWT_SECRET=some-secret-jwt