Architecture

Architecture

Journiv consists of two main components:

• Backend: FastAPI-based REST API with SQLModel ORM, supporting SQLite (default) or PostgreSQL
• Frontend: Flutter web application (PWA) and mobile apps (iOS/Android) with offline-first architecture

API Documentation

Journiv provides a complete REST API with interactive documentation:

• Swagger UI: http://localhost:8000/docs - Interactive API testing and exploration
• ReDoc: http://localhost:8000/redoc - Clean, readable API reference
• OpenAPI Schema: http://localhost:8000/api/v1/openapi.json - Machine-readable OpenAPI 3.0 specification

The API supports authentication via JWT tokens and provides endpoints for all features including journals, entries, moods, prompts, analytics, media, and import/export.