Technologies
============

Front-end
---------

.. list-table::
   :header-rows: 1
   :widths: 30 70

   * - Technology
     - Used for
   * - Flutter (Dart)
     - Cross-platform client applications (Android, iOS, Web, Desktop, e-ink UI).
   * - PowerSync
     - Offline-first data synchronization between local client storage and backend data sources.

Back-end
--------

.. list-table::
   :header-rows: 1
   :widths: 30 70

   * - Technology
     - Used for
   * - FastAPI (Python)
     - Backend API for authentication, library management, sync, and configuration endpoints.
   * - SQLAlchemy / asyncpg
     - Asynchronous PostgreSQL persistence.
   * - Alembic
     - Versioned database migrations.
   * - PowerSync
     - Self-hosted replication from PostgreSQL to client SQLite storage.
   * - Docker
     - Containerized local development and deployment packaging.

Storage
-------

.. list-table::
   :header-rows: 1
   :widths: 30 70

   * - Technology
     - Used for
   * - PostgreSQL
     - Primary relational storage for metadata (users, books, organization, progress, annotations).

Metadata
--------

.. list-table::
   :header-rows: 1
   :widths: 30 70

   * - Technology
     - Used for
   * - Google Books API
     - Optional external metadata lookup for books.
   * - Open Library API
     - Optional external metadata lookup for books.