Grada

Grada helps wholesale teams move from scattered spreadsheets and manual follow-ups to a clean, reliable operations flow.

From catalog to PO to final documents, Grada keeps your team faster, more accurate, and easier to scale.

Why Teams Use Grada

• Ship POs and documents faster with less back-and-forth
• Reduce manual data entry and avoid costly formatting mistakes
• Standardize workflows across catalog, purchasing, and dispatch
• Keep operations audit-friendly with structured records and history

Core Product Areas

• Smart Catalog: organize products, attributes, and reusable data
• PO Builder: generate buyer-ready PO files in the exact required format
• Received PO Processing: upload marketplace POs, review parsed lines, confirm quickly
• Dispatch Documents: generate barcode labels, invoices, and packing lists
• Ops Settings and Admin: keep rules, defaults, and visibility in one place

Product walkthrough: docs/current-product-features.md

Quick Start

Prerequisites

• Node.js 20+
• pnpm 9+
• Python 3.11+

1. Install dependencies

pnpm install

2. Create local env files

cp apps/web/.env.example apps/web/.env
cp apps/api/.env.example apps/api/.env
cp apps/jobs/.env.example apps/jobs/.env

3. Set minimum env values

apps/web/.env

NEXT_PUBLIC_API_URL=http://127.0.0.1:8000

apps/api/.env

OPENAI_API_KEY=your_key_here
FRONTEND_ORIGINS=http://localhost:3000,http://127.0.0.1:3000

Use either DB mode:

• Fast local mode: DATABASE_URL=sqlite:///./kira.db
• Docker parity mode: DATABASE_URL=postgresql+psycopg://postgres:postgres@localhost:5432/kira

4. Run API (Terminal A)

cd apps/api
python -m venv .venv
source .venv/bin/activate
pip install -e .[dev]
uvicorn app.main:app --reload --host 0.0.0.0 --port 8000

5. Run Web (Terminal B, repo root)

pnpm --filter @kira/web dev --hostname 0.0.0.0 --port 3000

Open http://localhost:3000

Local Stack with Docker (Optional)

docker compose up --build

This starts:

• Postgres on 5432
• Redis on 6379
• API on 8000
• Web on 3000

Useful Commands

Repo root:

pnpm dev
pnpm build
pnpm lint
pnpm test
pnpm format
pnpm format:check

API checks:

cd apps/api
.venv/bin/ruff check .
.venv/bin/pytest

Web checks:

cd apps/web
pnpm lint
pnpm test

Monorepo Structure

• apps/web: Next.js frontend
• apps/api: FastAPI backend
• apps/jobs: worker scaffold for future separation
• packages/shared: shared TypeScript package
• docs/adr: architecture decisions

Notes

• API route groups are under /api/v1
• API starts an in-process worker for parsing and PDF generation jobs
• Local files are stored under apps/api/static/ unless object storage is configured
• API details: apps/api/README.md