How subhasundardass/nodra-workspace works
Nodra is a TypeScript data/application framework, with apps/todo as its TanStack Start example application. The main documented workflow is a user interacting with the app UI, which invokes server functions in-process; the app initializes Nodra and uses its ORM against PostgreSQL to handle documents. The framework also provides metadata and lifecycle processing, permissions, views, reporting, file storage, jobs, workflows, events, and app-scoped CLI capabilities. Workflow links follow README documentation; unsampled implementation details are not expanded into unsupported call edges.
Main entry points: crud.ts ORM CRUD · connection.ts PostgreSQL · methods.ts Server methods · auth.ts Function auth
Components 19
Todo application
- Todo UI routes
apps/todo/src/routes/index.tsx - Server methods
apps/todo/src/server/methods.ts - Function auth
apps/todo/src/server/auth.ts - Nodra app
apps/todo/src/server/nodra-app.ts
Document framework
- DocType registry
packages/nodra/src/core/doctype/registry.ts - Documents and validation
packages/nodra/src/core/document/document.ts - ORM CRUD
packages/nodra/src/orm/crud.ts - Permissions
packages/nodra/src/permissions/permission.ts - Hooks and events
packages/nodra/src/hooks/registry.ts
Framework capabilities
- Workflow execution
packages/nodra/src/workflow/executor.ts - View service
packages/nodra/src/core/view/service.ts - Reports
packages/nodra/src/reports/executor.ts - Search and export
packages/nodra/src/api/advanced-query.ts - File storage
packages/nodra/src/files/storage.ts - Job worker
packages/nodra/src/jobs/worker.ts - App CLI commands
packages/nodra/src/cli/app-commands.ts
Persistence
- PostgreSQL
packages/nodra/src/database/connection.ts - SQL query builder
packages/nodra/src/database/query-builder.ts
Other components
- User
Connections 20
- User → Todo UI routes: uses
- Todo UI routes → Server methods: invokes functions
- Server methods → Function auth: uses middleware
- Server methods → Nodra app: gets app
- Nodra app → DocType registry: loads metadata
- Server methods → ORM CRUD: calls CRUD
- ORM CRUD → Documents and validation: creates and updates
- ORM CRUD → DocType registry: uses metadata
- ORM CRUD → PostgreSQL: queries
- Function auth → Permissions: checks access
- Function auth → ORM CRUD: loads user and roles
- ORM CRUD → SQL query builder: builds SQL
- SQL query builder → PostgreSQL: executes queries
- Documents and validation → Hooks and events: runs lifecycle hooks
- Workflow execution → Documents and validation: executes transitions
- View service → DocType registry: validates views
- Reports → PostgreSQL: runs report queries
- Search and export → PostgreSQL: searches and exports
- Job worker → PostgreSQL: queue persistence
- App CLI commands → PostgreSQL: runs migrations