aethera/AGENTS.md

Aethera Monorepo

This repository is a monorepo with two main packages that can be built and run independently.

Directory Structure

├── frontend/        # TypeScript + Alpine.js + Tailwind CSS client
├── backend/         # Go HTTP server with embedded frontend assets
├── Makefile         # Orchestrates frontend → backend build pipeline
├── Dockerfile       # Multi-stage Docker build
├── .drone.yml       # CI pipeline (tests + Docker publish)
├── flake.nix        # Nix dev shell (Go, Bun, LSPs, linters)
└── …

Build Pipeline

The frontend builds to frontend/public/dist/, then make frontend copies the full frontend/public/ tree into backend/web/static/ where it gets embedded into the Go binary via //go:embed.

make all        # Build frontend + backend
make frontend   # Build frontend, copy to backend/web/static/
make backend    # Build Go binary (requires frontend assets)
make dev        # Run frontend watcher + backend hot reload via air
make tests      # Run Go tests
make docker     # Build Docker image

Package Details

See package‑specific instructions:

• frontend/ — @frontend/AGENTS.md
• backend/ — @backend/AGENTS.md