geistesblitze2/README.md

geistesblitze2

geistesblitze was a small web application I created to accompany an article for the German Linux Magazin in 2014 about Flask, when the release of version 1.0 was supposedly approaching.

Flask 1.0 was actually released four years later, and since version 2.0 that was released in 2021, I wanted to turn it into a modern single page application, but the options to achieve this never convinced me.

I didn't want to separate such a simple application into a backend and a frontend and add a whole ecosystem (Javascript) to accomplish the task.

I recently discovered htmx and geistesblitze2 shows how to integrate Flask and htmx and achieve a single page application, without having to write a single line of Javascript.

I presented this project at PyCon Bolivia 2022, in December 2022.

The presentation, Flask y htmx is available in this repository.

To run the project, you need to clone the repository:

$ git clone https://git.rico-schmidt.name/ernesto/geistesblitze2.git

If you don't have Poetry installed, you can use the official installer.

Then, change into the geistesblitze2 directory and install the project. This will create a virtual environment.

$ cd geistesblitze2
$ poetry install --no-root

Then, you need to create the database and the tables:

$ poetry run flask create-all

And, finally, you can start the application:

$ poetry run flask run

The application is now running on http://127.0.0.1:5000