Welcome

GAX - Crow-Powered Static Site Generator

Itachi doesn't install. He summons.

GAX is a minimal, fast, and brutal static site generator written in Go. No dependencies, no npm, no javascript runtime.

Philosophy

1. Kuchiyose no Jutsu (Summoning) - Clone and build. git clone + go build.

2. Sharingan (The Eye) - One config.yaml sees everything.

3. Karasu Bunshin (Crow Clones) - Every content/*.md is a crow clone that flies to dist/.

4. Crow Legion (Collections) - Group crows into legions (blog, projects, etc).

5. Kotoamatsukami (Control) - Data and templates control the reality without touching content.

6. Amaterasu (Release) - Black flame that never dies. dist/ is immortal static.

Installation

git clone https://github.com/mesinkasir/gax
go build -o gax ./cmd/gax
./gax --help

Project Structure

.
├── config.yaml          # Sharingan - site config
├── content/
│   ├── index.md         # Homepage (frontmatter = data)
│   ├── about.md
│   └── blog/            # Crow Legion
│       ├── hello.md
│       └── itachi.md
├── data/
│   └── menu.yaml        # Chakra - global data
├── templates/
│   ├── layouts/base.gax # Base layout
│   └── partials/
├── public/              # Static assets (copied to dist)
└── dist/                # Truth that remains (output)

Config Example - config.yaml

title: GAX Site
url: https://gax.dev
description: Built with crows

Content Example - content/index.md

---
title: Home
layout: layouts/base.gax
url: /

amaterasu:
  kicker: ITACHI'S LEGACY
  title: SIX SEALS HE LEFT
  subtitle: BEFORE THE CLAN FELL
  files:
    - name: config.yaml
      note: eye
  seals:
    - id: I
      title: KUCHIYOSE NO JUTSU
      body:
        - text: "Summon, don't install."
---

Your markdown content here...

Template Engine - GAX Template (.gax)

GAX uses its own engine similar to Liquid:

Variables:

{{title}}
{{config.title}}
{{amaterasu.kicker}}
{{f.name}}

For Loops (Supports Nested):

{% for f in amaterasu.files %}
  {{f.name}} - {{f.note}}
{% endfor %}

{% for seal in amaterasu.seals %}
  {% for p in seal.body %}
    {{p.text}}
  {% endfor %}
{% endfor %}

If / Else:

{% if seal.active %}
  
{{seal.title}}
{% else %}
  
{{seal.title}}
{% endif %}

Includes:

{% include "partials/header.gax" %}

Commands

gax build              # Build to dist/
gax serve              # Serve dist/ at :3000 with live reload
gax new post my-post   # Create new content

Why GAX?

• Zero Dependency: Single binary.
• Fast: Written in Go, builds 1000+ pages in milliseconds.
• Flexible: Frontmatter supports nested list and maps (files, seals, body).
• Hackable: Simple render/ and parser/ you can modify.

---

Built by mesinkasir. Released with crows. Free.

"People's lives don't end when they die. It ends when they lose faith." - Itachi

---