GuildPass Dashboard

GuildPass is a web dashboard for managing access, passes, guilds/communities, members, and activity.

---

Features

• Dashboard overview with key stats
• Pass management
• Guild/community management
• Member management with wallet info
• Activity/audit log
• Settings page
• Mock data for easy local development

---

Tech Stack

• Next.js 14 – Full-stack React framework
• TypeScript – Type-safe code
• Tailwind CSS – Utility-first CSS
• pnpm – Fast, disk-efficient package manager
• Monorepo structure with packages/integration-client shared types

---

Prerequisites

• Node.js 18.17 or later
• pnpm (install via npm install -g pnpm)

---

Installation

# Clone or navigate to the project directory
cd guildpass-app

# Install all dependencies
pnpm install

---

Environment Variables

Copy .env.example to .env:

cp .env.example .env

For local development with mock data, no additional environment variables are required!

---

Development

Run the local development server:

pnpm dev

Then open http://localhost:3000 in your browser.

---

Production Build

Create an optimized production build:

pnpm build

Then start the production server:

pnpm start

---

Type Checking & Linting

• Type check all packages and apps: pnpm typecheck
• Run linter: pnpm lint

---

Project Structure

guildpass-app/
├── apps/
│   ├── dashboard/        # Main Next.js dashboard app (NEW!)
│   ├── discord-bot/      # Optional Discord bot integration (legacy)
│   └── docs/             # Docusaurus docs (legacy)
├── packages/
│   ├── integration-client/ # Shared types and API client
│   └── webhook-utils/      # Webhook verification utilities (optional)
├── .pnpmrc               # pnpm configuration
├── pnpm-workspace.yaml   # Monorepo workspace config
└── package.json          # Root package.json

---

Available Routes

• / – Landing page
• /dashboard – Overview with key stats
• /passes – Manage passes
• /guilds – Manage communities/guilds
• /members – Manage members
• /activity – View activity log
• /settings – App settings

---

Notes

• All data is currently mock data (see apps/dashboard/lib/mock-data.ts).
• The Discord bot (apps/discord-bot) is preserved as an optional integration and not required for the dashboard to function.
• The docs site (apps/docs) is also preserved as optional legacy documentation.

---

License

MIT — see LICENSE.