half-orm-gen

⚠️ Alpha — not for production.
This project is under active development. APIs, generated code structure, and CLI commands may change without notice between releases. Do not use in production environments.

A halfORM extension that generates a Litestar or FastAPI REST API and a frontend backoffice (SvelteKit 5 or Angular) from your half-orm-dev project.

Installation

pip install half-orm-gen

---

API

# Litestar
half_orm gen api --litestar
litestar --app ho_api/app:application run --reload

# FastAPI
half_orm gen api --fastapi
uvicorn ho_api.app:application --reload

---

Frontend backoffice

# SvelteKit 5
half_orm gen frontend --svelte
cd ho_frontend/svelte && npm install && npm run dev

# Angular
half_orm gen frontend --angular
cd ho_frontend/angular && npm install && npm start

---

Contributing

We are looking for contributors with expertise in:

• Angular — improve generated components, routing, and state management
• SvelteKit — improve generated stores, layouts, and page components
• Litestar — improve the dynamic runtime, middleware, and OpenAPI integration
• FastAPI — improve the dynamic runtime and Pydantic integration

See CONTRIBUTING.md for how to set up a development environment and the areas where help is most needed.

---

Documentation

Backend

• Litestar architecture — runtime, CRUD_ACCESS, role system, WebSocket
• Authorization — JWT, roles, /ho_access, /ho_setup
• CRUD access — access model, verbs, field access, @ho_api_filter, @tools.api_*
• What goes in a relation class — class vs. ho_api/custom/, the escape hatch
• FastAPI architecture — status/parity with Litestar

Frontend (shared)

• Frontend architecture — silo pattern, access map, live updates
• Generated frontend code — file layout, regenerated vs scaffolded
• ResourceSilo reference — full reactive API, one silo per app

Angular

• Silo architecture — signals, data flow, deduplication
• Access control — reactive buttons, FK auto-resolve, dynamic roles, simulation

Svelte

• Silo architecture — runes, data flow, deduplication
• Access control — reactive buttons, FK auto-resolve, dynamic roles

---

See also

• half-orm — the PostgreSQL ORM at the core
• half-orm-dev — the development framework