base

README

Base (github.com/fastygo/base)

Semantic headless templ primitives — no ui-* presets and no Tailwind/class opinions in-kit. Caller supplies styling via Class and Attrs only. Styled molecules (Variant, ui-*, ui8px policy) belong in github.com/fastygo/ui8kit; product compositions live in apps (internal/ui/..., fastygo add roadmap).

Imports are one package per atom so go mod vendor trims to what your graph uses.

Semver tagged releases track doc.go's Version (mirrors annotated tags). Pre-1.0 policy: MINOR may add atoms or props (docs/versioning.md).

Install

go get github.com/fastygo/base@v0.1.0

Minimal example

package main

import (
  "context"
  "os"

  "github.com/fastygo/base/button"
)

func main() {
  _ = button.Button(button.ButtonProps{Class: "my-trigger"}, "OK").Render(context.Background(), os.Stdout)
}

Generate templ output after editing .templ files:

go generate ./...

Packages

See docs/packages.md for links and notes.

Tooling & CI

bash ./scripts/preflight.sh           # templ generate via go generate, vet, build, test
PREFLIGHT_RUN_RACE=1 bash ./scripts/preflight.sh
bash ./scripts/release.sh <semver>    # bumps doc.go Version + tag vX.Y.Z

Docs

Doc	Topic
design-principles.md	Headless contract
packages.md	Atom catalogue
versioning.md	Releases & semver
integration.md	Layering Base → UI8Kit → app

License

MIT — see LICENSE.

Documentation

Overview

Package base is the root module identity for github.com/fastygo/base.

This module provides per-atom subpackages — import them directly instead of importing base:

import "github.com/fastygo/base/button"

Base is semantics-only headless primitives: slots for Class / Attrs, no presets. Styled molecules live in github.com/fastygo/ui8kit.

Prefer github.com/fastygo/ui8kit when you need Variant, ui-* classes on top of primitives.

Packages

See docs/packages.md(/docs/packages.md) or [README](README.md) for the atom list.

Compatibility

Pre-1.0: APIs are semver-advertised with tags (vX.Y.Z) but MINOR may add atoms or props; deprecations noted in changelog.

Index

• Constants

Constants

const Version = "0.1.0"

Version matches annotated git tags (v0.M.P). Updated by scripts/release.sh via scripts/cmd/set-version.