← Browse

Build websites with ttrek

Start with a working website and make it your own. Each example comes with a design, sample content, and the Tcl code that connects it all. Use ttrek clone to get your own copy, then follow its guide to install, run, and customize it.

Choose your starting point

Example What you can build How you write
Personal site A homepage, journal, and personal notebook Edit Markdown files in your text editor
Community site A gathering place with accounts, discussions, a shared notebook, and a journal Sign in to post and edit through the browser

Start with the personal site for the simplest introduction. You can write a page and see it in your browser without setting up accounts or a site database. Choose the community site when you want other people to join and contribute.

Your own corner of the web

The personal site gives your projects and writing a home. Introduce yourself, keep a journal of what you are learning, and collect useful notes in one place.

You will learn how to clone an example, start a local server, change the design, and add pages using ordinary Markdown files. It is a good first project for getting comfortable with ttrek.

Build your personal website →

A place for people to gather

The community site brings people and shared writing together. Use it as a starting point for a club, a neighborhood group, or a project with contributors. Members can create accounts, start discussions, reply, and improve notebook pages and journal entries.

The guide walks through creating a test account, trying the site as a member and a visitor, changing its identity, and keeping its data between runs.

Build your community website →

How the examples work

Every guide follows the same small set of steps:

  1. Clone the example into a new folder. This is your copy to change.
  2. Install its dependencies with ttrek install -y.
  3. Start the website with ttrek run -script start and open it in your browser.
  4. Make it yours by changing the writing, name, colors, and layout.

The guides explain each command and show you what to try next. Follow Getting started to install ttrek and the build tools, then pick an example above.

This catalog will grow as more website examples become available.