~/projects/fluently

SOFTWARE2026

Fluently

A browser-based study tool for AP US History, presenting a curated set of facts as a searchable timeline, list, and flashcard study mode.

TIMELINE
Mar 2026 – Apr 2026
TEAM
Solo
CONTEXT
Personal project
Fluently’s timeline view: AP US History terms laid out as color-coded bars from 1500 to today.
120APUSH facts
9units covered

Overview

Fluently is a static, client-side study tool for AP US History. It presents a curated dataset of historical terms and events — who, what, where, when, and why — across three views: an interactive timeline, a searchable/filterable list, and a flashcard-style study mode.

Features

  • Interactive timeline (via vis-timeline) plotting events by year, including BCE dates
  • Searchable, filterable list view across all fact fields
  • Flashcard study mode
  • Filtering by APUSH unit, with a distinct color per unit
  • Unit toggle to show/hide specific units on the timeline
  • Data pipeline scripts that clean and convert source CSVs into the site’s JSON dataset

How it works

The site is a static HTML/CSS/vanilla JavaScript app with no backend; each page (timeline, list, study) fetches data/facts.json at load time and renders its view client-side. The dataset itself is built offline from source CSV files using a small set of Python scripts (clean_csv.py, parse_dates.py, build_json.py) that normalize terms and resolve approximate/BCE dates into sortable year ranges.