rss-reader/CLAUDE.md

RSS Reader Project Guidelines

Build & Run Commands

• Run demo mode: just run-local-demo
• Run with database: just run-local-persistant-db
• Run with Nix: just run-local-nix
• Migrations: just sqlx-prepare
• Production: cargo run -- -d database.sqlite -p port

Style Guidelines

• Imports: Group by source (std lib, external crates, internal modules)
• Naming: snake_case for variables/functions, CamelCase for types
• Documentation: Use /// doc comments for public items
• Error Handling: Use Result types with detailed error messages
• Types: Leverage Rust's type system fully, minimize unwrap()
• Formatting: Follow standard Rust formatting with 4-space indentation

Project Architecture

• Web framework: Rocket with SQLite database
• Templates: Tera templates
• Authentication: Argon2/bcrypt password hashing
• Frontend: HTML/CSS with Vite for asset bundling
• Feed handling: RSS/Atom parsing with feed-rs