https://github.com/unic/ai-developer-hub
https://github.com/unic/ai-developer-hub
Last synced: about 2 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/unic/ai-developer-hub
- Owner: unic
- Created: 2026-03-03T09:58:03.000Z (5 months ago)
- Default Branch: main
- Last Pushed: 2026-06-01T15:08:45.000Z (about 2 months ago)
- Last Synced: 2026-06-01T17:08:46.706Z (about 2 months ago)
- Language: TypeScript
- Homepage: https://ai-developer-hub-nu.vercel.app
- Size: 7.57 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 19
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# AI Developer Hub
A Next.js application for tracking AI tool budgets, managing licenses, and monitoring usage costs across your organisation.
## CI
Every pull request and push to `main` runs the full quality gate via **GitHub Actions** (`.github/workflows/ci.yml`):
| Job | What it checks |
|-----|----------------|
| **Lint & Typecheck** | ESLint (zero warnings) + TypeScript strict compilation |
| **Unit Tests** | Vitest unit test suite (`tests/unit/`) |
| **Build** | `next build` with stub environment variables |
Integration tests and E2E tests (Playwright) are defined as commented-out placeholders in the workflow file — see the inline comments for the secrets and infrastructure they require.
> **Branch protection**: To enforce these checks as merge requirements, enable *Require status checks to pass before merging* in **Settings → Branches → Branch protection rules** and add `Lint & Typecheck`, `Unit Tests`, and `Build` as required status checks.
## Getting started
### Prerequisites
- Node.js 20 (see `.nvmrc`)
- pnpm 10
- A [Neon](https://neon.tech) PostgreSQL database
### Environment variables
Copy `.env.local.example` to `.env.local` and fill in the values:
```bash
cp .env.local.example .env.local
```
See `.env.local.example` for the full list of required variables and where to obtain each one.
### Development
```bash
pnpm install
pnpm db:push # push schema to dev DB
pnpm db:seed # seed initial admin user
pnpm dev # start dev server at http://localhost:3000
```
### Quality checks
```bash
pnpm lint # ESLint
pnpm typecheck # TypeScript
pnpm test # Unit tests (Vitest)
pnpm build # Production build
```
### Database
```bash
pnpm db:generate # generate Drizzle migration files
pnpm db:migrate # apply migrations
pnpm db:push # push schema directly to dev DB (no migrations)
```