stripstream/project-intelligence/living-notes.md

Living Notes

Purpose: Development notes, TODOs, and temporary information. Last Updated: 2026-02-27

Quick Reference

• Update When: Adding dev notes, tracking issues
• Audience: Developers

---

Current Focus

• Performance optimization (see PLAN_OPTIMISATION_PERFORMANCES.md)
• Reducing bundle size
• Image optimization

---

Development Notes

Service Layer

All business logic lives in src/lib/services/. API routes are thin wrappers.

API Error Handling

Use AppError class from @/utils/errors. Always include error code from ERROR_CODES.

Component Patterns

• UI components: src/components/ui/ (Radix + Tailwind)
• Feature components: src/components/*/ (by feature)
• Use cva for variant props
• Use cn from @/lib/utils for class merging

Types

• Komga types: src/types/komga/
• App types: src/types/

Database

• Prisma schema: prisma/schema.prisma
• MongoDB connection: src/lib/prisma.ts

---

Known Issues

• Large libraries may be slow to load (pagination helps)
• Offline storage limited by device space

---

Future Ideas

• Add more reader modes
• User collections/tags
• Reading statistics
• Better caching strategy

---

Related Files

• technical-domain.md - Code patterns
• decisions-log.md - Architecture decisions