Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/Jason-AML/MonzaSport-Nextjs/llms.txt

Use this file to discover all available pages before exploring further.

This guide walks you through everything needed to run a fully functional Monza Motors development environment on your local machine. By the end you will have the Next.js dev server running with Supabase authentication, the Stripe checkout flow, and the Groq AI assistant all active and connected to your own service accounts.
1

Clone the repository

Clone the Monza Motors source code and move into the project directory.
git clone https://github.com/Jason-AML/MonzaSport-Nextjs.git && cd MonzaSport-Nextjs
2

Install dependencies

Install all required packages using your preferred package manager.
npm install
3

Create the environment file

Create a .env.local file in the project root and populate it with your credentials. See the Environment Variables reference for a full description of each key.
touch .env.local
Then open .env.local and add the following variables:
.env.local
NEXT_PUBLIC_SUPABASE_URL=your_supabase_url
NEXT_PUBLIC_SUPABASE_ANON_KEY=your_supabase_anon_key
SUPABASE_SERVICE_ROLE_KEY=your_service_role_key
NEXT_STRIPE_SECRET_KEY=your_stripe_secret_key
NEXT_PUBLIC_BASE_URL=http://localhost:3000
GROQ_API_KEY=your_groq_api_key
Head over to the Environment Variables page for a full breakdown of where to find each key and which variables are exposed to the browser.
4

Set up Supabase tables

Monza Motors requires four tables to exist in your Supabase project before the application will work correctly.
TablePurpose
vehiculosStores vehicle records (name, price, images, specs)
fabricasStores manufacturer / brand data linked to vehicles
messagesPersists AI chat message history per user
storedStores saved or favourited vehicles per user
Refer to the Supabase Setup guide for the full schema, RLS policies, and storage bucket configuration.
5

Start the development server

npm run dev
Next.js will compile the application and start a local server with hot-module replacement enabled.
6

Open the app

Navigate to http://localhost:3000 in your browser. You should see the Monza Motors home page with the navigation bar, footer, and floating action bar rendered.

Available Scripts

The following scripts are defined in package.json and available via your package manager.
ScriptCommandDescription
Dev servernpm run devStarts Next.js in development mode with HMR
Production buildnpm run buildCompiles and optimises the app for production
Start productionnpm run startRuns the compiled production build locally
Lintnpm run lintRuns ESLint across the project source files

Build docs developers (and LLMs) love