Flaxon 0.3.0 and Teloce-Py 0.3.0 are available on PyPI. Release instructions are maintained on this site; source links identify the framework snapshot. Check version and upgrade guidance.
Learn full-stack Flaxon in ten lessons
For a complete application from CLI generation through deployment, start with the Project Manager ebook. The lessons below explain individual full-stack concepts and remain useful as reference.
Build a Taskboard, then explore other ways to use the same Python application: interactive Teloce pages, server-rendered Jinax pages, feature modules, API clients and live interfaces. The lessons use readable Python and TypeScript, explicit file names and checks you can perform yourself.
Flaxon owns HTTP, validation, authentication, persistence integration and
WebSockets. Teloce compiles .html/.vel components and runs their reactive
interface in the browser. MinifyJS optimizes production JavaScript. These are
different jobs: TypeScript cannot replace server validation, and a browser router
cannot authorize a database operation.
Start with the quick start. Each lesson explains which files
to change. Code marked as a fragment extends the earlier app; it is not a separate
complete application. The course example
provides a runnable .html interface with TypeScript helpers. The
CDN converter provides a .vel variant.
| Lesson | What you learn |
|---|---|
| 1. Understand the page lifecycle | Python app, HTML component, build and browser lifecycle |
| 2. Build useful components and scoped styles | Props, events, slots, directives, scoped CSS and teardown |
| 3. Connect writes to validated Python endpoints | Typed fetch helpers, validation and readable error handling |
| 4. Use TypeScript without sending types to browsers | Shared types, standalone .ts files and transpilation limits |
| 5. Configure the document head and CDN resources | Optional metadata, local assets, CDN loading and script ordering |
| 6. Add pages and direct-link navigation | Client pages, dynamic parameters, server fallback and Jinax alternative |
| 7. Organize full-stack features with modules | Feature modules, routers, services and browser route mapping |
| 8. Persist data and authorize every operation | Database transactions, authentication, authorization and uploads |
| 9. Add live updates and test the full boundary | WebSockets, subscriptions, signals and integration tests |
| 10. Build, deploy and maintain the complete application | Builds, tasks, API contracts, extensions and deployment |
Complete reference coverage
Ten lessons teach application patterns; the references below cover the broader API surface without pretending that every optional integration belongs in one starter app. Use the relevant guide when adding that capability.
| Flaxon area | Reference | Lesson |
|---|---|---|
| Application, HTTP verbs, response types, static files, lifecycle | Application, HTTP, Responses | 1, 3, 5, 10 |
| Parameters, query/body/form parsing, schemas, Pydantic | Routing, Requests, Validation, Pydantic | 3, 8 |
| Modules, routers, services, scaling | Modules, Scaling | 7 |
| Jinax, inheritance, macros, filters, templates | Jinax | 6 |
| Sessions, JWT, API keys, permissions, middleware, CSRF | Authentication, Authorization, Security, Middleware | 8 |
| Database adapters, transactions, repositories, migrations | Databases | 8 |
| WebSockets, rooms, heartbeat, disconnects | WebSockets | 9 |
| Tasks, workers, queues, retries and schedules | Tasks | 10 |
| OpenAPI, GraphQL, Admin/CMS | OpenAPI, GraphQL, Admin, CMS | 10 |
| ASGI mounting, FastMCP, plugins, mobile integrations | FastMCP, Plugins, Ecosystem | 10 |
| Testing, debugging, logs, health and metrics | Testing, Debugging, Deployment | 9, 10 |
| Teloce area | Lesson | Upstream reference |
|---|---|---|
| .html/.vel components, props, events, slots, imports | 1, 2 | Components |
| Directives, models, classes, text/HTML binding | 2 | Syntax |
| Data, computed, watch, signals, effects, batching | 2, 9 | Reactivity |
| TypeScript components and helper modules | 3, 4 | TypeScript |
| Browser pages and routing | 6, 7 | Flaxon Teloce API |
| Lifecycle, teardown, runtime modules | 2, 9 | Runtime |
| Scoped CSS, compiler options, assets, production optimization | 2, 5, 10 | Compiler, MinifyJS |
| Standalone runtime for server HTML, plugins and tooling | 6, 10 | Standalone, Plugins |
TypeScript support depends on the installed Teloce version. Its transpiler removes supported type syntax; it is not a full semantic type checker. Browser HMR, automatic SSR and automatic account/database setup are not implied by full-stack.
Project manager recording course
For a complete backend-first project built from the CLI, follow the 15-chapter project manager ebook. Each step identifies a file to create, a whole-file replacement, or an exact existing block to replace. It includes code, commands, what to say, expected results, troubleshooting and chapter recovery instructions.
The course uses published Flaxon 0.3.0 and Teloce-Py 0.3.0, with current ORM APIs, Python migrations and management.py commands. Follow chapter 1 for installation.
Flaxon full-stack examples use .html Teloce single-file components. app.use_teloce() compiles them; request.compile() serves their browser application shell. See lesson 13 for the complete data-teloce-link routing workflow.
Next: build the complete guessing-game SPA with Admin and Render deployment