Usage & configuration overview
Operate and configure a running THE HCLAB deployment.
This section covers day-two operations: environment reference, access control, maintenance, and background processing.
Quick links
| Topic | When you need it |
|---|---|
| Environment variables | Adding or rotating secrets |
| Roles & permissions | Onboarding staff or researchers |
| Maintenance mode | Planned downtime |
| Background jobs | Cron setup and exports |
Configuration sources
| Source | Contents |
|---|---|
.env / Vercel env |
Secrets and feature flags |
prisma/schema.prisma |
Data model |
src/lib/site.ts |
Public navigation |
src/lib/docs-nav.ts |
Documentation structure |
src/lib/roles.ts |
Role group definitions |
Changing public navigation
Header nav is defined in src/lib/site.ts (headerNav). Footer links use footerNavLinks in the same file.
Changing documentation
- Edit Markdown under
content/docs/<section>/<page>.md - Update
src/lib/docs-nav.tsif adding/removing pages or sections - Deploy — docs are static at build time via
generateStaticParams
Getting help
- Admin dashboard — platform analytics at
/admin - Event log —
/admin/eventsfor research and system events - Prisma Studio —
npm run db:studiofor direct data inspection (dev/staging only)