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.
Flaxon documentation
Flaxon brings Python APIs, Teloce interfaces, TypeScript, modules, persistence, and administration into one full-stack application. Teloce compiles your HTML components and browser scripts; Flaxon serves the application and runs its Python features.
Start here
python -m pip install "flaxon[standard]"
flaxon new my-project
cd my-project
python -m pip install -e .
python management.py check
python management.py makemigrations
python management.py migrate
python management.py setup-admin
python management.py runserver
The default starter welcomes you at /, demonstrates a module-owned Python API from TypeScript, and includes a protected /admin. Try /server-page for the complete Jinax example, and run flaxon welcome or flaxon welcome-status for module-owned custom commands. Choose Flaxon + Jinax for server-rendered applications, Flaxon + Teloce for interactive interfaces, or combine them. There is no default administrator password. Read getting started for virtual environments, project files, command details, and deployment boundaries.
A complete learning path
- Build the server: routing, requests, validation, databases, and authentication.
- Build the interface: Teloce SPA, HTML components, typed APIs, and TypeScript.
- Organize features: modules, navigation, and admin/CMS.
- Ship responsibly: testing, security, production, and deployment.
Build a complete project manager
Follow the copy-and-paste ebook course.
Start with flaxon new project_manager, then build working authentication,
owned projects, tasks, a Teloce HTML SPA with scoped CSS and signals, staff Admin,
CMS help content, tests and Render deployment. Every chapter names the files to
create or replace and includes the complete code and verification commands.
Ten full-stack concept lessons
Work through the course overview, then follow these lessons:
- Lesson 1: Understand the page lifecycle
- Lesson 2: Build useful components and scoped styles
- Lesson 3: Connect writes to validated Python endpoints
- Lesson 4: Use TypeScript without sending types to browsers
- Lesson 5: Configure the document head and CDN resources
- Lesson 6: Add pages and direct-link navigation
- Lesson 7: Organize full-stack features with modules
- Lesson 8: Persist data and authorize every operation
- Lesson 9: Add live updates and test the full boundary
- Lesson 10: Build, deploy and maintain the complete application
Complete documentation directory
Use the guides for explanations, the API pages for reference, and the examples for working patterns. The directory below lists every Markdown document in this documentation tree, including older lessons and editor guides.
Foundations and operations
- Flaxon Admin Dashboard Guide
- Architecture
- Flaxon & Plugins - Quick Reference Cheat Sheet
- Flaxon CMS
- Configuration
- Contributing to Flaxon
- Deployment
- Flaxon ecosystem
- Getting started
- Getting started with Flaxon
- GraphQL API Example
- Installation
- Maintenance Guide
- Migration Guide
- Performance
- Philosophy
- Full-stack quick start
- Security
- Flaxon Technical Passport
- Flaxon Update Policy
Feature guides
- Admin and CMS Production Guide
- Flaxon Admin in Production
- Authentication
- Request performance and authentication migration
- Authorization
- Databases
- Debugging
- FastMCP Integration
- GraphQL API Example
- Jinax Templates
- Admin and CMS with microservices
- Middleware
- Mobile Development
- Modules Guide
- OpenAPI, Swagger UI, and ReDoc
- Plugins
- Optional Teloce plugins: PWA, forms, i18n, accessibility and head
- Pydantic Integration
- Requests
- Responses
- Routing
- Growing a Flaxon application
- Tasks
- Teloce Spa
- Teloce SSR and browser debugging
- Testing
- Validation
- WebSockets
API reference
- Admin and CMS API Reference
- Admin API Reference
- Application API
- GraphQL API Reference
- HTTP API
- Jinax API
- Routing API
- Security API
- Tasks API
- Teloce full-stack integration: API reference
- Testing API
- Validation API
- WebSocket API
Full-stack course
- Lesson 1: Understand the page lifecycle
- Lesson 2: Build useful components and scoped styles
- Lesson 3: Connect writes to validated Python endpoints
- Lesson 4: Use TypeScript without sending types to browsers
- Lesson 5: Configure the document head and CDN resources
- Lesson 6: Add pages and direct-link navigation
- Lesson 7: Organize full-stack features with modules
- Lesson 8: Persist data and authorize every operation
- Lesson 9: Add live updates and test the full boundary
- Lesson 10: Build, deploy and maintain the complete application
- Learn full-stack Flaxon in ten lessons
Worked examples
- Android Backend Example
- Basic API Example
- CMS Example
- Full Admin and CMS Example
- FastMCP Example
- Frontend Integration Examples
- GraphQL Example
- Jinax Website Example
- Large Application Example
- Mail Example
- Modules Example: Catalog and Orders
- OpenAPI API Example
- Pydantic API Example
- React frontend and API
- Flaxon + React example
- School portal: Admin plus Flaxon modules
- WebSocket Chat Example
- Flaxon WhatsApp-style Chat
Additional lessons and cheat sheets
- Admin and CMS Cheat Sheet
- Building Flaxon Plugins
- CLI Reference
- Flaxon Features
- Flaxon Cheat Sheet
- Industrial Admin Customization
- Deploying Flaxon Apps
- Building a Production App with Modules
- Teloce Integration Reference
- Flaxon VS Code Extension Cheat Sheet