Files
aethera/AGENTS.md
Evan Reichard 9b77a473b7
All checks were successful
continuous-integration/drone/push Build is passing
chore(dev): run backend with air
2026-05-02 16:29:10 -04:00

36 lines
1.2 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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`.
```bash
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 packagespecific instructions:
- **frontend/** — `@frontend/AGENTS.md`
- **backend/** — `@backend/AGENTS.md`