Welcome to Arvan UIArvan Docs

Getting started

Install dependencies, run the app, and find your way around.

Arvan is a Next.js App Router app with a shared UI kit, feature-based domain code, and DummyJSON as the backend. These guides live under /docs/guides next to the component and token playgrounds.

Requirements

  • Node.js 20+
  • npm (lockfile is npm-based)

Install & run

npm install
npm run dev

Open http://localhost:3000. Useful entry points:

  • / — landing
  • /login — sign in (DummyJSON users)
  • /dashboard/articles — articles CRUD (auth required)
  • /docs — this documentation

Scripts

  • npm run dev — development server
  • npm run build / npm start — production
  • npm run lint — ESLint
  • npm test — Vitest watch mode
  • npm run test:run — single Vitest run (CI)

Environment

The DummyJSON base URL defaults to https://dummyjson.com. Override with:

DUMMYJSON_BASE_URL=https://dummyjson.com

No local database is required. Auth tokens are stored in httpOnly cookies after login.

Demo credentials

Use any valid DummyJSON user (for example emilys / emilyspass). You can also sign in with the user's email when it resolves via the users API.