Birdseye Documentation

Welcome to the Birdseye Admin Dashboard documentation. Birdseye is not just another template; it is a premium, production-ready full-stack ecosystem engineered for enterprise scale. Designed with meticulous attention to detail, it bridges the gap between stunning frontend aesthetics and a highly secure, performant backend architecture.

Birdseye comes packed with everything you need to launch a production-grade SaaS application or enterprise internal tool. Our light-theme focused UI provides maximum clarity and data legibility.

Birdseye utilizes a modern monorepo structure. Unlike traditional setups where the frontend and backend live in entirely separate repositories, Birdseye unifies them using Turborepo. This approach is highly favored by industry leaders because it allows you to manage the client and server side-by-side, sharing scripts, types, and ensuring version parity across your entire stack.

birdseye-themeforest/
├── apps/                 # The core applications
│   ├── admin/            # React 19 Client Dashboard (Frontend)
│   │   ├── src/
│   │   │   ├── components/ # Scalable UI and Layout wrappers
│   │   │   ├── pages/      # Application views (Analytics, Users, etc.)
│   │   │   ├── store/      # Zustand state slices
│   │   │   └── utils/      # Helpers and Hooks
│   │   ├── package.json
│   │   └── vite.config.ts
│   └── api/              # Node.js Express Server (Backend)
│       ├── controllers/  # Route business logic (Auth, Users, Stripe)
│       ├── models/       # Mongoose schemas (MongoDB)
│       ├── routes/       # Express endpoint definitions
│       ├── server.ts     # Main entry point
│       └── package.json
├── turbo.json            # Turborepo pipeline configuration
└── pnpm-workspace.yaml   # Workspace dependency mapping

The workspace acts as a single source of truth. Running a command like build at the root level tells Turborepo to analyze the dependency graph and build apps/admin and apps/api intelligently, leveraging cached assets to drastically reduce build times.

Prerequisites

• Node.js: v18.0.0 or higher.
• Database: A MongoDB cluster (MongoDB Atlas recommended).
• Accounts: Stripe, Firebase, Cloudinary, and ImageKit accounts for full functionality.

Step 1: Unzip the Package

Extract the downloaded ThemeForest ZIP file and open the root directory (birdseye-themeforest) in your preferred code editor (e.g., VS Code).

Step 2: Install Dependencies

Birdseye is configured to use pnpm by default for maximum speed and strict dependency resolution. However, we have ensured compatibility across all major package managers. Choose the one that fits your workflow:

The Express server requires several environmental keys to function correctly. Navigate to apps/api/, duplicate .env.example, and rename it to .env.

The React 19 Client requires its own configuration to connect to the backend and external APIs. Navigate to apps/admin/, duplicate .env.example, and rename it to .env.

Once your dependencies are installed and both .env files are configured, starting the development environment is incredibly simple thanks to Turborepo. Depending on your chosen package manager, run the corresponding command from the root directory:

pnpm dev    # Or npm run dev, yarn dev, bun dev

This single command will intelligently start both the Express backend API and the Vite React frontend in parallel. You will see output from both processes in your terminal.

Deploying a monorepo is straightforward once you understand how the two pieces—frontend and backend—connect in production.