Open-source dashboard for mobile app growth — deep links, messaging campaigns, revenue tracking, and audience analytics.

Grovs helps mobile developers grow their apps by providing a single dashboard to manage deep links, send targeted push notifications, track revenue, and understand their audience. Self-host it or connect it to the Grovs managed backend.

Tech Stack

• Next.js 15 (App Router)
• React 19
• TypeScript 5 (strict mode)
• Tailwind CSS 4
• shadcn/ui (new-york style)

Prerequisites

• Node.js 20+
• npm 10+

Setup

1. Clone the repository:

   git clone https://github.com/grovs-io/dashboard.git
   cd dashboard

2. Install dependencies:

   npm install

3. Create your environment file:

   cp .env.example .env.local

   Fill in the required values (see .env.example for documentation).

4. Start the development server:

   npm run dev

   Open http://localhost:3001.

Docker

You can also run the dashboard using Docker:

cp .env.example .env.local
docker compose up --build

The app will be available at http://localhost:3036. See docker-compose.yml for configuration options.

Project Structure

src/
├── app/                     # Next.js App Router pages
│   └── (protected)/         # Auth-required pages
├── api/                     # API service functions (async/await)
├── components/
│   ├── ui/                  # shadcn/ui primitives
│   ├── layout/              # App chrome (sidebar, header, nav)
│   ├── common/              # Shared utility components
│   └── auth/                # Auth-related components
├── context/                 # React Context providers
├── hooks/                   # Custom React hooks
├── lib/                     # Utilities (API client, storage, helpers)
└── constants/               # App constants
ee/                          # Enterprise Edition (revenue, audit log, SSO/SCIM) — see license below
├── api/ hooks/ components/ types/ constants/   # mirror src/, imported as @ee/*
└── app/                     # page bodies re-exported by routes under src/app/(protected)/

Enterprise Edition

The features under ee/ are switched on with NEXT_PUBLIC_GROVS_EE=true at build time. Without it the core edition runs unchanged and the enterprise screens stay hidden.

• Revenue tracking — IAP revenue metrics, per-link and per-campaign revenue columns, revenue setup steps
• Audit log — Tamper-evident audit log explorer with SIEM export tokens
• Enterprise SSO and SCIM — Per-instance OIDC connection with verified email domains and SCIM provisioning settings

Production use of enterprise features requires a subscription. See ee/LICENSE.

Environment Variables

See .env.example for all available configuration options.

Required: NEXT_PUBLIC_API_URL, NEXT_PUBLIC_CLIENT_ID, CLIENT_SECRET

Optional: Firebase, Chatwoot, PostHog, GTM (features gracefully disable when not configured)

Scripts

Command	Description
npm run dev	Start dev server (port 3001, Turbopack)
npm run build	Production build
npm run lint	Run ESLint
npm test	Run unit tests (Vitest)
npm run test:watch	Run tests in watch mode
npm run test:coverage	Run tests with coverage report
npm start	Start production server

Contributing

See CONTRIBUTING.md for development guidelines.

Security

See SECURITY.md for our vulnerability disclosure policy.

License

Grovs uses a dual license model:

• Core (MIT) — Everything outside the ee/ directory is licensed under the MIT License. You can freely use, modify, and distribute it.
• Enterprise — The ee/ directory contains enterprise features (revenue tracking, audit log, enterprise SSO and SCIM) under the Grovs Enterprise License. Production use of enterprise features requires a valid subscription.