Getting Started

Installation

Step-by-step guide to getting Haze Dashboard running on your local machine.

Prerequisites

Before you begin, make sure you have the following installed:

  • Node.js 18+ Download Node.js
  • npm, pnpm, or yarn— npm ships with Node.js
  • A code editor VS Code with the official TypeScript / Tailwind extensions is recommended

Step 1: Clone the Repository

Clone the repository and navigate to the project directory:

git clone <repository-url>
cd haze-dashboard-next

If you downloaded a zip file, extract it and cd into the extracted directory instead.

Step 2: Install Dependencies

Install all project dependencies using your preferred package manager:

# npm
npm install

# or pnpm
pnpm install

# or yarn
yarn install

This installs Next.js, React, Tailwind CSS v4, Unovis, Zustand, and all other dependencies.

Step 3: Start the Development Server

npm run dev

The application is available at http://localhost:3000. Next.js provides Fast Refresh so changes to components and styles appear instantly without a full page reload.

Unlike traditional backends, there is no database to configure. All data comes from mock route handlers that return JSON — the dashboard is fully functional out of the box.

Step 4: Build for Production

When you are ready to deploy, create an optimized production build:

npm run build

This creates a production-ready build in the .next/ directory. Start the production server with npm run start.

Available Commands

CommandDescription
npm run devStart the Next.js development server with Fast Refresh
npm run buildCreate an optimized production build
npm run startRun the production build locally
npm run lintRun the configured linter

Demo Credentials

The template ships with three demo users, each with a different role and permission set:

RoleEmailPassword
Adminadmin@haze.devpassword
Editoreditor@haze.devpassword
Viewerviewer@haze.devpassword

Tip

Auto-login — the template automatically logs in as the Admin user in development. You can switch users from the auth pages or by modifying the initial user in src/stores/auth.ts.

Next Steps

Now that you have the project running, explore the Folder Structure to understand how the codebase is organized.