Files
basango/docs/architecture.md
2025-11-09 16:28:36 +02:00

29 lines
994 B
Markdown

Basango Architecture Map
Structure
- apps/
- crawler: Bun + TS crawler (sync/async workers)
- dashboard: Next.js 16 app
- mobile: Expo React Native app
- api-legacy, mobile-legacy: legacy reference apps
- packages/
- logger: `@basango/logger` (pino wrapper)
- db: `@basango/db` (Drizzle + Postgres)
- encryption: `@basango/encryption` (encryption utils)
- ui: `@basango/ui` (shared UI, package.json in `packages/ui/src`)
- tsconfig: `@basango/tsconfig` (shared TS configs)
Workspaces
- Root `package.json``"workspaces": ["apps/*", "packages/*"]`.
- Internal deps use `workspace:*` and are linked locally.
Build & Dev
- `bun run dev` → dev servers/workers via Turbo.
- `bun run build` → builds respecting dependency graph.
- `bun run typecheck`, `bun run lint`, `bun run format`.
Notes
- ESM-only codebase.
- Prefer named import `logger` from `@basango/logger`.
- If adding a new package, place in `apps/*` or `packages/*` and set a scoped name `@basango/<name>`.