Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/Codefied-CodePix/KaroCar-platform/llms.txt

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

The customer app is the self-service portal for KaroCar end users. It provides the interface through which customers manage their bookings, review past orders, update account details, and access all KaroCar consumer-facing services. Built with Next.js 16 and Tailwind CSS v4, the portal delivers a responsive, dark-mode-aware experience. The homepage (app/page.tsx) renders the Customer Dashboard heading as the authenticated entry point for end users.

​
Tech Stack

Next.js 16.2.7

App Router with server components for fast, SEO-friendly page rendering and nested route layouts.

React 19.2.4

Latest stable React with concurrent features for responsive, data-driven dashboard views.

Tailwind CSS v4

Utility-first CSS with the v4 PostCSS engine, dark-mode support, and monorepo-consistent styling.

TypeScript 5

Full type safety across booking models, API responses, and component props.

​
Directory Structure

apps/customer/
├── app/
│   ├── layout.tsx    # Root layout with Geist font
│   ├── page.tsx      # Customer Dashboard homepage
│   └── globals.css   # Global styles
├── public/           # Static assets
├── package.json
├── next.config.ts
└── tsconfig.json
The app/page.tsx renders the Customer Dashboard heading and introductory copy. Additional routes such as /bookings, /profile, and /history are expected to be added under app/ following Next.js App Router conventions.

​
Package Configuration

The customer app does not depend on any internal workspace UI packages — its component set is built locally within the app. 
{
  "name": "customer",
  "version": "0.1.0",
  "private": true,
  "scripts": {
    "dev": "next dev",
    "build": "next build",
    "start": "next start",
    "lint": "eslint"
  },
  "dependencies": {
    "next": "16.2.7",
    "react": "19.2.4",
    "react-dom": "19.2.4"
  },
  "devDependencies": {
    "@tailwindcss/postcss": "^4",
    "@types/node": "^20",
    "@types/react": "^19",
    "@types/react-dom": "^19",
    "eslint": "^9",
    "eslint-config-next": "16.2.7",
    "tailwindcss": "^4",
    "typescript": "^5"
  }
}

​
Development Commands

turbo dev --filter=customer
Use turbo dev --filter=customer to run only the customer portal. Since this app has no upstream workspace package dependencies, it starts immediately — ideal for working on booking flows and user-facing features without loading the entire platform.
Next.js starts on port 3000 by default. When running alongside other apps in the monorepo, the customer app will be assigned the next available port. Check the terminal output for the exact URL.

​
Building & Starting

turbo build --filter=customer && turbo start --filter=customer
1

Install dependencies

Run pnpm install from the monorepo root to ensure all workspace packages and node_modules are in place.
2

Build the customer app

Run turbo build --filter=customer. Turbo caches the output so unchanged pages are not rebuilt.
3

Start the production server

Run turbo start --filter=customer and open the printed URL to verify the Customer Dashboard loads correctly.

​
Linting

pnpm --filter customer lint

Auth App

The centralised authentication service customers sign in through.

Web App

The public-facing site where customers first discover KaroCar.

Vendor App

The vendor-facing counterpart that manages the listings customers browse.

Local Setup

Step-by-step guide to running the full platform stack locally.

Build docs developers (and LLMs) love

Get started for freeTalk to us