hyperflask 0.1.6

Full stack web framework

---

Full stack Python web framework to build websites and web apps with as little boilerplate as possible

⚠️ This is a work in progress project which is not functionnal yet ⚠️

hyperflask.dev • Get started • Docs • Example apps

A Flask-based (very) opiniated Python web framework where all the tech choices have been made. Hyperflask combines multiple Flask extensions and frontend libraries into a seamless experience.

This project is part of the Hyperflask Stack.

Features and technologies:

• Web framework built on top of Flask as a set of extensions
• File-based and/or app-based routing
• A new file format combining python code in frontmatter and html templates to define routes
• SQL focused ORM with sqlorm, optimized for sqlite
• Modern asset pipeline using esbuild and tailwindcss
• Deep integration with htmx
• Easily create reusable backend and frontend components, compatible with Storybookf
• Build frontend components using Web Components, Alpine.js, Stimulus and more. Mix technologies at will.
• Component library based on daisyUI with icons from Bootstrap Icons
• Seamless reactivity between frontend and backend
• Authentication and user management with social logins and MFA
• Static content collections to easily create blogs and manage static content
• File management with built-in image manipulation and S3 integration
• Template based emails with mjml support
• Background tasks using dramatiq
• Push support for realtime pages using server-sent events
• I18n using gettext
• Easily create REST APIs and automatically generate documentation
• Static, hybrid or dynamic modes for content serving
• Observable with OpenTelemetry

Hyperflask-Start should be used to create new projects:

• Dev environment based on Development Containers
• Optimized for VScode with breakpoint debugging for frontend and backend
• Mailpit for email testing
• Deployments using Hyperflask-Deploy

Project status

Hyperflask is being actively developed and is not yet ready to be used.

Checkout the list of all the projects developed as part of the Hyperflask Stack and their current development status on the Hyperflask Github organization homepage.

Status overview:

Feature	Status
Core experience (start project, dev, deploy)	🚧
File based routing with mix code page format	✅
ORM	✅
Assets pipeline	✅
Component system + component library	🚧 (component system almost done, need to create macros for daisyui)
SSE push	✅
Collections	🚧 (finalizing)
Upload files	🚧 (missing S3 improvements)
Emails	🚧
User management and auth	🚧
Static site generation	❌
I18n	🚧 (finalizing)
PWA	❌
Runner	✅

Flask extensions

Hyperflask itself is minimal and mostly a collection of Flask extensions seamlessly integrated together.

A good part of these extensions is developed as part of the Hyperflask project. Checkout the Hyperflask organization page for a list of all these projects.

Name	Description
Flask-Apispec-Hyper	Flask-Apispec fork with updates and fixes
Flask-Assets-Pipeline	Modern asset pipeline using esbuild
Flask-Babel-Hyper	Flask-Babel fork with additional utilities
Flask-Collections	Manage collections of static content
Flask-Configurator	File based configuration
Flask-DebugToolbar	Debug Toolbar
Flask-Dramatiq	Background tasks powered by Dramatiq
Flask-File-Routes	File-based routing with a new file format combining python and jinja template in a single file
Flask-Files	Fsspec based files management (upload, storage and image manipulation)
Frozen-Flask	Generate a static website from your Flask app
Flask-Geo	Geolocation using Maxmind
Htmx-Flask	HTMX integration for Flask
Flask-Login	User session management
Flask-Mailman	Send emails
Flask-Mailman-Templates	Email templates for Flask-Mailman
Flask-Mercure-SSE	Push events via server-sent events using the Mercure protocol
Flask-Observability	Observable Flask apps with OpenTelemetry, logging and more
Flask-SQLORM	Flask integration of sqlorm
Flask-Super-Macros	Better macro management for Jinja
Flask-Talisman	HTTP security headers for Flask
Flask-WTF	WTForms integration

Using without Hyperflask-Start

1. Create your project directory: mkdir example-project && cd example-project
2. Create and activate a virtualenv: python -m venv .venv && source .venv/bin/activate
3. pip install hyperflask
4. Create a pages directory: mkdir pages
5. Create your index page: echo "hello world" > pages/index.html
6. Start a development server using hyperflask dev