features.md

HatMax Features

Core

Package	Description
app	Application lifecycle management (Startable, Stoppable interfaces)
config	Environment-based configuration loading
log	Structured logging with slog

Web

Package	Description
web	Chi router helpers, response utilities, flash messages
htmx	HTMX primitives (triggers, actions, targets, swaps), response headers, template helpers
middleware	Request ID, role-based access, rate limiting, locale detection, static cache, telemetry
render	Template FuncMap utilities, i18n integration
ui	UI kit with HTMX-first components (Chip, Label, Button, Alert, Flash, Toast, Link, Form, Table, Nav)
format	Formatting utilities (Price, Number) for templates
modal	Modal dialog configuration
pagination	Generic pagination (Result[T])
i18n	Internationalization with YAML translation files
settings	Runtime key-value configuration with schema validation

Auth & Security

Package	Description
auth	Authentication service, middleware, context helpers
crypto	PASETO v4 tokens, AES-256-GCM encryption, Argon2id hashing, TOTP/MFA with QR codes and backup codes

Data

Package	Description
db	PostgreSQL connection (pgx/v5), migrations
model	Base types (ID, timestamps), password hashing, roles, nullable UUID utilities
validation	Field validation (fluent API), error handling
seed	Database seeding with tracking, symbolic references (Ref/RefMap)
slug	URL-friendly slug generation with Unicode support

Media

Package	Description
image	Image management, variants (original, large, medium, thumbnail)
image/local	Local filesystem storage
image/s3	AWS S3 storage
image/stdprocessor	Image resizing with stdlib

Infrastructure

Package	Description
mailer	Email delivery (SMTP, SendGrid, AWS SES)
pubsub	Publish/subscribe messaging
scheduler	Job scheduling with pluggable storage, concurrent workers, dynamic settings
telemetry	Request counting, crash collection, settings schemas
testhelper	Testing utilities
fake	Test doubles (mailer, telemetry)