Tutorial: build a guestbook

In this tutorial you build a guestbook: a page where visitors leave messages. You start with a single file and finish with a structured, tested project backed by a database, with a JSON API and a production server.

Each step is a complete program you can run. The code shown here is the code in the repository’s docs/tutorial folder, and the test suite runs every step, so it is guaranteed to work.

• 1. Your first page
• 2. Components and props
• 3. State, events and forms
• 4. Styling and responsive layout
• 5. A database, a service and an API
• 6. Growing into a project
• 7. Testing
• 8. Deploying

You need Python 3.11 or newer:

$ python -m venv .venv
$ source .venv/bin/activate        # Windows: .venv\Scripts\activate
$ pip install "rational[db,testing]"