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.
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:
- Clone the example into a new folder. This is your copy to change.
- Install its dependencies with
ttrek install -y. - Start the website with
ttrek run -script startand open it in your browser. - 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.