5292298f22eb5d6563ff33caa1586e6d8cb53e94
NGO Toolkit Lab
AI-powered grant writing tools for NGOs. 4 tools: Logframe Generator, Funder Rewriter, SMART Indicators, Theory of Change.
Setup
# Install dependencies
bun install
# Copy env and fill in values
cp .env.example .env
# Run database migration
bun run db:migrate
# Start dev server
bun dev
Environment Variables
See .env.example for all required variables:
DATABASE_URL— PostgreSQL connection stringOPENAI_API_KEY— OpenAI API keyAUTH0_*— Auth0 configuration for admin routesLEMONSQUEEZY_*— Payment processing
Database
Schema is in lib/db/schema.sql. Run manually or use the migration script:
psql $DATABASE_URL < lib/db/schema.sql
# or
bun run db:migrate
Docker
docker compose up -d
Routes
| Route | Description |
|---|---|
/ |
Hub — 4 tool cards |
/logframe |
Logframe Generator |
/funder-rewriter |
Funder Rewriter |
/smart-indicators |
SMART Indicators |
/theory-of-change |
Theory of Change |
/admin |
Dashboard (Auth0 protected) |
/admin/config |
Configuration editor |
/admin/leads |
Leads table |
API Routes
POST /api/[tool]/generate-draft— Generate initial draftPOST /api/[tool]/improve-section— Improve a section (paid)POST /api/[tool]/validate— Quality assessment (paid)POST /api/[tool]/finalize— Produce final version (paid)POST /api/payment/create-checkout— Create LemonSqueezy checkoutPOST /api/payment/webhook— LemonSqueezy webhook handlerGET/POST /api/admin/config— Admin config managementGET /api/admin/leads— Paginated leadsGET /api/admin/metrics— Dashboard metricsPOST /api/export/[format]— Export (docx/excel/pdf/copy)
Description
Languages
TypeScript
98.6%
JavaScript
0.7%
Dockerfile
0.4%
CSS
0.3%