FastHTML Boilerplate

The FastHTML Boilerplate is a Vercel deployment template that takes a FastHTML project and deploys it to Vercel with zero configuration.

What is the FastHTML Boilerplate?

The FastHTML Boilerplate is a starting point for building and deploying FastHTML applications on Vercel. It is part of Vercel's framework boilerplates collection. The template provides a minimal FastHTML project structure that you can clone, extend, and deploy. FastHTML is a Python framework for creating HTML applications using HTMX and ASGI. This boilerplate handles the configuration needed for Vercel, so you can focus on writing application code.

Key Features

• Zero-configuration deployment — Deploy directly to Vercel using the "Deploy with Vercel" button or the Vercel CLI without manually configuring serverless functions.
• FastHTML framework — Built on FastHTML, which combines Python, HTMX, and ASGI to generate interactive HTML pages server-side.
• Local development server — Run python main.py to start a development server at http://0.0.0.0:5001 with automatic reloading on code changes.
• Simple dependency management — A requirements.txt file holds project dependencies, installed with pip install -r requirements.txt.
• Flexible deployment paths — Deploy via the Vercel CLI (vercel --prod) or through Vercel's Git integration with a simple git push.
• Live example — A working demo of the template is hosted at https://fasthtml-template.vercel.app.
• Official source — Maintained by Vercel as part of their framework boilerplate examples.

Who is it for?

• Python developers who want to build HTML apps without writing JavaScript, using FastHTML's Python-based approach.
• FastHTML learners who need a minimal, working project to experiment with HTMX and ASGI patterns.
• Teams deploying to Vercel who want a pre-configured FastHTML setup that handles serverless deployment details.
• Prototypers who want to quickly spin up a FastHTML application and get a live URL via Vercel.

What can you do with it?

• Rapid prototyping: Quickly stand up a FastHTML app and deploy it to Vercel to share a live demo link.
• Learning FastHTML: Study the project structure and modify main.py to see how HTMX attributes and ASGI routing work.
• Deployment testing: Use the CLI or Git integration to verify that a FastHTML project deploys correctly on Vercel's platform.

How does the template work?

To run locally, install dependencies with pip install -r requirements.txt, then start the server with python main.py. The server listens on port 5001 and reloads automatically. For production deployment, either install the Vercel CLI and run vercel --prod, or connect the repository to Vercel and push changes via Git.

FAQ

Is the FastHTML Boilerplate free to use?

The template itself is open source and free, hosted in Vercel's public example repositories. Deploying it to Vercel may incur costs depending on your Vercel plan, but the boilerplate requires no paid license.

What does the boilerplate include?

It includes a minimal FastHTML application with a main.py file, a requirements.txt file for dependencies, and Vercel configuration needed for deployment.

How do I deploy to Vercel?

You can use the "Deploy with Vercel" button, the Vercel CLI with vercel --prod, or connect the GitHub repository to Vercel's Git integration and push changes.

Where is the live example?

The template has a live demo at https://fasthtml-template.vercel.app.