Skip to content

Configuration

1 min read193 words

Overview

Tiny 2027 separates configuration into clear, modular domains while maintaining 100% backward compatibility with existing configurations.

Configuration can be set globally in src/site.config.ts (theme defaults) or customized in your vault note at src/content/site/config.md.

Configuration Domains

1. Site Identity

Basic site and author metadata:

title: Field Notes
description: A small independent space for notes, essays, and experiments.
locale: en
author:
  name: John Doe
  url: https://fieldnotes.example
  avatar: /images/avatar.svg

2. Navigation

Header, footer, and social links:

headerLinks:
  - label: Blog
    url: /posts
  - label: Browse
    url: /browse
  - label: Docs
    url: /docs
  - label: Search
    url: /search
  - label: About
    url: /about

footerLinks:
  - label: Now
    url: /now
  - label: Colophon
    url: /colophon
  - label: RSS
    url: /rss.xml

socialLinks:
  - label: Mastodon
    url: https://mastodon.social/@fieldnotes
  - label: GitHub
    url: https://github.com/fieldnotes

footerCredits: Built with Tiny

3. Browse Engine

Multi-dimensional taxonomy indexing:

browse:
  dimensions:
    - key: tags
      slug: tags
      label: Tags
    - key: published
      slug: years
      label: Years
    - key: topic
      slug: topics
      label: Topics

4. SEO

Open Graph, Twitter cards, and title templating:

seo:
  siteUrl: https://fieldnotes.example
  defaultOgImage: /images/og-default.png
  titleTemplate: "%s | %s"
  twitterHandle: "@fieldnotes"

5. Theme

Control theme availability and initial mode:

theme:
  enabled: true
  default: system # 'system' | 'light' | 'dark'

6. Features

Feature switches for optional components and capabilities:

features:
  sourceGutter: true # Markdown source gutter
  backlinks: true    # Inbound reference discovery & badges
  math: true         # KaTeX build-time math
  search: true       # Static search indexing
  docs: true         # Documentation section
  toc: true          # Table of Contents

Control search availability:

search:
  enabled: true

8. Analytics

Privacy-respecting, zero-cookie analytics (disabled by default):

analytics:
  provider: null # 'plausible' | 'fathom' | 'umami' | null
  id: ""
  host: ""       # Optional custom proxy host

When provider is null or omitted, zero tracking scripts are emitted.

9. UI Text

Centralized user interface strings:

ui:
  skipToContent: Skip to content
  older: Older
  newer: Newer
  search: Search
  notFound: Page not found
  backHome: Go back home
  tableOfContents: Table of Contents
  inboundReferences: Inbound References
  writing: Writing
  allPosts: All posts

How Configuration Merging Works

  • Deep Merge on Object Domains: Settings in author, seo, theme, features, search, analytics, and ui merge deeply. Overriding a single property (e.g. theme.default: dark) preserves all sibling defaults.
  • Full Replacement on Arrays: Lists (headerLinks, footerLinks, socialLinks, browse.dimensions) are replaced entirely to provide full control over item ordering.
  • Backward Compatibility: Existing configuration files without the new domains continue to run without any modification.