FanTracker

A local-first Flutter application to track Archive of Our Own (AO3) fanfiction. It scrapes fanfiction metadata directly on-device and manages reading progress and custom covers locally.

Features

• On-device parsing of AO3 work URLs (imports title, author, summary, tags, and stats).
• Local storage utilizing JSON serialization.
• Custom cover image uploads with fallback typographic cover generation.
• Statistics dashboard (track read counts and approximate words read).
• Library screen with searching, sorting, and filtering.
• Work detail editor for chapter progress, personal rating, and personal notes.

Getting Started

Prerequisites

• Flutter SDK (3.10.7 or later)
• Dart SDK (3.0.0 or later)

Run the Application

To run the application on your default device:

flutter run

To run specifically on Windows desktop:

flutter run -d windows

Run Tests

To run the widget tests:

flutter test