Tota logo

Docs

Getting started

  • Overview
  • Commands
  • Configuration

Usage

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

Configuration

While Tota ships with sensible defaults to allow for zero-configuration use, it also allows you to override settings by using environment variables prefixed with TOTA_*.


Site

The HTML tags in <head> will be populated from this config.

NameDescription
TOTA_URLThe website URL (protocol and domain).
TOTA_TITLEThe title of the website.
TOTA_DESCRIPTIONShort description of the website.
TOTA_AUTHORThe default post author.
TOTA_LANGUAGEThe language of the website in ISO 639-1 format. Default is en.


Directory

You are permitted to choose your own directory names in your Tota project, as long as you update the following settings.

NameDescription
TOTA_PUBLIC_DIRContains all generated and publicly-accessible files.
TOTA_PAGES_DIRContains the source files for pages.
TOTA_POSTS_DIRContains the source files for posts. Also used in the URL as the blog sub-directory.
TOTA_TEMPLATES_DIRContains the mustache HTML template files.
TOTA_ASSETS_DIRContains non-page static files (JavaScript, CSS, etc.)


Posts

These settings relate only to posts.

NameDescriptionDefault
TOTA_DATE_FORMATThe date format. Read Dart's intl package docs for formatting options.yMMMd


Deploy

These settings are used to manage deployments.

NameDescription
TOTA_NETLIFY_SITEThe name of the site on Netlify.
TOTA_NETLIFY_TOKENNetlify personal access token.
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