folkugat-web/AGENTS.md

Development Commands

Build/Lint/Test

• Run development server: JWT_SECRET=12345 uvicorn folkugat_web.main:app --reload --reload-include "*.html" --host 0.0.0.0
• Build for production: ./build.sh

Code Style Guidelines

Python

• Type hints: Use strict typing with from typing import and custom types from folkugat_web.typing
• Imports: Standard library first, third-party, then local imports. Use absolute imports for local modules.
• Naming: snake_case for variables/functions, PascalCase for classes, UPPER_CASE for constants
• Error handling: Use Result[ResultT, ErrorT] pattern from utils for service functions
• Async: Use async/await for I/O operations, FastAPI endpoints are async

Frontend

• CSS: Use Tailwind CSS classes with custom brown/beige theme
• Templates: Jinja2 templates in folkugat_web/assets/templates/
• Static files: Organized in folkugat_web/assets/static/

Architecture

• Structure: api/routes/, config/, dal/, fragments/, model/, services/
• Database: SQLite with custom DAL layer in dal/sql/
• Authentication: JWT-based with cookie storage