A proof-of-concept full-stack app with user auth, CRUD features, and basic delivery-request workflows.

Live Demo

• Production URL (requires authentication): https://peerless-wheat.vercel.app/
• Demo Video: Watch the walkthrough

Background

Prototype for a peer-to-peer delivery service application intended only for demonstration purposes. Core functionalities include user account management, the ability to post, view, and delete delivery requests, as well as the capability for users to claim posted requests.

Project Structure

src/app/dashboard/available/page.tsx and src/app/dashboard/claimed/page.tsx serve the routes on dashboard/available/ and dashboard/claimed/, respectively. Each of them is made of React components that can be found in src/components.

Server actions can be found in src/actions and help perform CRUD operations in Next.js.

Unit and integration tests are run through Vitest by typing npm run test in the terminal. Each test lives in the same folder as its component for better association between test and application code. It's worth noting that all tests follow the AAA pattern.

Tech Stack

• Next.js
• React.js
• Tailwind CSS
• ShadCN UI
• Neon Postgres (database)
• Prisma
• Clerk (user account management)
• React Testing Library
• Vitest

Getting Started

First, clone the repository to your local machine:

git clone git@github.com:nchanyal/peerless.git

Second, install dependencies:

npm install

Third, add a .env file to the root of the project and fill the following:

DATABASE_URL=
NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY=
CLERK_SECRET_KEY=
UPLOADTHING_TOKEN=

Note:

• DATABASE_URL comes from Neon Postgres
• NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY and CLERK_SECRET_KEY come from Clerk
• UPLOADTHING_TOKEN comes from uploadThing

Fourth, run the development server:

npm run dev

Open http://localhost:3000 with your browser to see the result.

What I’d Improve Next

• UI polish
• Additional validations
• More test coverage