Skip to content

Canvilled/zoo-dashboard

Repository files navigation

Zoo Dashboard

A comprehensive zoo management dashboard built with Next.js, featuring real-time animal status monitoring, authentication, and interactive UI components.

Getting Started

Prerequisites

  • Node.js 18+
  • pnpm (recommended) or npm/yarn

Installation

  1. Clone the repository:
git clone <repository-url>
cd zoo-dashboard
  1. Install dependencies:
pnpm install
  1. Set up environment variables:
cp example.env .env.local
  1. Run the development server:
pnpm dev
  1. Open http://localhost:3000 with your browser.

Docker Usage

Important: You must build the image first before running it with environment variables.

When using Docker, you can pass environment variables directly:

# Build first (only need to do this once)
docker build -t zoo-dashboard . --build-arg NEXTAUTH_URL=http://localhost:3000

# Run with environment variables
docker run -p 3000:3000 \
  -e NEXTAUTH_SECRET=your-secret-here \
  -e NEXTAUTH_URL=http://localhost:3000 \
  zoo-dashboard

Important: The NEXTAUTH_URL environment variable is required for authentication to work correctly. In Docker environments, this should match the URL where the application is accessible.

Or create a .env file and mount it:

# Build first (only need to do this once)
docker build -t zoo-dashboard . --build-arg NEXTAUTH_URL=http://localhost:3000

# Run with env file
docker run -p 3000:3000 --env-file .env zoo-dashboard

Example .env file for Docker:

NEXTAUTH_SECRET=your-secret-here
NEXTAUTH_URL=http://localhost:3000

Authentication

The application uses mock authentication for development purposes. You can log in with the following test accounts:

Admin Account

Keeper Account

Tech Stack

  • Framework: Next.js 15
  • Styling: Tailwind CSS + DaisyUI
  • Authentication: NextAuth.js
  • Icons: React Icons
  • Form Validation: Zod
  • Data Fetching: TanStack Query
  • Package Manager: pnpm

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published