InventoryManager — NimbusTech Demo Store

A full-stack portfolio demo: a fictional consumer electronics storefront ("NimbusTech") with a public shop and an authenticated admin area for managing inventory and orders. Built with Next.js (App Router), Prisma + PostgreSQL, and NextAuth.

Features

• Public storefront — browse products by category, search, view product detail pages, add items to a cart (persisted in localStorage), and check out.
• Checkout flow — placing an order validates stock, creates the order and order items, and decrements product stock in a single database transaction.
• Admin area (/admin, requires login) — dashboard with revenue/order stats and low-stock alerts, full product CRUD, and order status management.
• Auth — credentials-based admin login (NextAuth.js), route-protected via middleware.
• API routes — REST endpoints for products and orders, validated with Zod.

Tech stack

• Next.js 16 (App Router, TypeScript, React 19)
• Prisma 7 + PostgreSQL (via the pg driver adapter)
• NextAuth.js v5 (Credentials provider, JWT sessions)
• Tailwind CSS v4
• Zod for input validation

Getting started

Requires a PostgreSQL database (e.g. a free Neon or Vercel Postgres instance). Copy .env.example to .env and set DATABASE_URL to its connection string, then:

npm install
npx prisma migrate dev
npx prisma db seed
npm run dev

Open http://localhost:3000.

npm install automatically generates the Prisma client (postinstall script). npm run dev starts the app at http://localhost:3000.

Demo admin login

Seeded by prisma/seed.ts (credentials configurable via .env):

Email:    admin@nimbustech.demo
Password: NimbusAdmin123!

Sign in at /login, then manage inventory at /admin.

Environment variables

Copy .env.example to .env and adjust as needed:

Variable	Purpose
DATABASE_URL	PostgreSQL connection string
AUTH_SECRET	Secret used by NextAuth to sign session tokens
ADMIN_EMAIL	Email for the demo admin user created by the seed script
ADMIN_PASSWORD	Password for the demo admin user created by the seed script

Generate a secret with:

node -e "console.log(require('crypto').randomBytes(32).toString('base64'))"

Useful scripts

Command	Description
npm run dev	Start the dev server
npm run build	Production build
npm run lint	Run ESLint
npm run db:migrate	Create/apply a Prisma migration
npm run db:seed	Re-seed demo data (categories, products, admin)
npm run db:reset	Drop, re-migrate, and re-seed the database
npm run db:studio	Open Prisma Studio to browse the database

Project structure

prisma/               Prisma schema, migrations, seed script
src/
  app/                 Routes (App Router)
    products/          Storefront: listing + product detail
    cart/, checkout/    Client-side cart and checkout flow
    orders/[id]/        Order confirmation page
    login/              Admin login (server action + NextAuth)
    admin/              Auth-gated admin dashboard, products, orders
    api/                REST routes for products, orders, and NextAuth
  components/
    storefront/         Header, cart provider/button, product cards, filters
    admin/               Product form, data tables, status controls
    ui/                  Small shared primitives (Button, Input, Badge)
  lib/                  Prisma client, auth config, Zod schemas, formatting
  proxy.ts              Route protection for /admin/* (Next.js middleware)

Notes

This is a demo project: no real payments are processed, images are placeholder URLs, and there is no email delivery. Scope is intentionally kept to what's needed to demonstrate a working full-stack CRUD app with auth.