Tota logo

Docs

Getting started

  • Overview
  • Commands
  • Configuration

Usage

  • Pages
  • Posts
  • Front matter
  • Templates
  • Assets
  • Deployment

Overview

Tota is an elegantly simple static-site generator written in Dart. Perfect for personal websites, side-projects, blogs, documentation, and more.


Install

It only takes a few seconds to install Tota. Simply activate it with pub, the package manager for Dart.

pub global activate tota

Of course, if you don't already have Dart installed, you must install it first (a simple procedure in its own right).


Directory structure

Running tota init inside an empty directory will create the following approximate directory structure.

.
├── assets
│   └── styles.css
├── pages
│   └── index.md
├── posts
│   └── hello-world.md
└── templates
    ├── base.mustache
    └── _partials
        └── head.mustache

pages

Contains your site's main content. Markdown files in this directory will be processed into HTML and saved in the public directory.

posts

Contains content intended to become blog posts. Similar to pages, Markdown files will be processed into HTML and saved in the public directory, but under a nested posts directory.

templates

Contains the Mustache HTML templates that wrap your site's content. You can create re-usable components, like navigation or footers, in the _partials directory to avoid repeating them in every page.

assets

Stores all static content (JavaScript, CSS, images). This directory is copied over as-is to the public directory when Tota builds your site.


Next steps

  • Commands
Tota logo

Tota is a static-site generator made by @izolate.


© 2025 Tota. MIT license.

Site links

  • house Home
  • open book Docs
  • question mark Articles

Open source

  • Pub
  • GitHub
  • File an issue
  • Edit this site