Enhancements

.github/ISSUE_TEMPLATE/bug_report.md

@@ -10,6 +10,7 @@ A clear and concise description of what the bug is.
 
 **To Reproduce**
 Steps to reproduce the behavior:
+
 1. Go to '...'
 2. Click on '....'
 3. Scroll down to '....'
@@ -22,9 +23,10 @@ A clear and concise description of what you expected to happen.
 If applicable, add screenshots to help explain your problem.
 
 **Environment (please complete the following information):**
- - OS: [e.g. macOS, Windows]
- - Browser [e.g. chrome, safari]
- - Version [e.g. 22]
+
+- OS: [e.g. macOS, Windows]
+- Browser [e.g. chrome, safari]
+- Version [e.g. 22]
 
 **Additional context**
 Add any other context about the problem here.

.github/PULL_REQUEST_TEMPLATE.md

@@ -12,6 +12,7 @@ about: Submit a pull request
 **Related issues:**
 
 **Checklist:**
+
 - [ ] Tests added/updated
 - [ ] Documentation updated
 - [ ] Linting and formatting pass

.github/dependabot.yml

@@ -1,6 +1,6 @@
 version: 2
 updates:
-  - package-ecosystem: "pip"
-    directory: "/"
-    schedule:
-      interval: "weekly"
+    - package-ecosystem: "pip"
+      directory: "/"
+      schedule:
+          interval: "weekly"

.github/workflows/test.yml

@@ -0,0 +1,34 @@
+name: Tests
+
+on:
+    pull_request:
+    push:
+        branches:
+            - main
+
+jobs:
+    playwright:
+        runs-on: ubuntu-latest
+        steps:
+            - name: Check out repository
+              uses: actions/checkout@v4
+
+            - name: Set up Python
+              uses: actions/setup-python@v5
+              with:
+                  python-version: "3.12"
+
+            - name: Set up Node
+              uses: actions/setup-node@v4
+              with:
+                  node-version: "20"
+                  cache: npm
+
+            - name: Install dependencies
+              run: npm ci
+
+            - name: Install Playwright browsers
+              run: npx playwright install --with-deps
+
+            - name: Run tests
+              run: npm test

CHANGELOG.md

@@ -4,7 +4,12 @@ All notable changes to this project will be documented in this file.
 
 ## [Unreleased]
 
+### 2026-06-09
+
+- **Roadmap PWA features:** Added offline SRS flashcards, streaks and achievements, placement testing, day quizzes, pinyin tone visuals, offline stroke-order playback, progress portability keys, static cache updates, CI, and Playwright coverage for the new retention/self-assessment/learning-depth flows.
+
 ### 2026-05-20
+
 - **Review & tooling:** Added review UI, starred phrases (`js/starred-phrases.js`), related stylesheet hooks, Playwright smoke tests (`tests/e2e`, `playwright.config.ts`), `package.json` / lockfile tooling, service worker registration path updates, `.gitignore` tweaks, `README`/workspace doc updates, and miscellaneous Flutter manifests/config touch-ups.
 - **Remove embedded video:** Stripped embedded YouTube usage from the PWA (video loaders, JSON, CSS/JS/HTML sections) and from the Flutter app (webview/youtube_player dependencies, `Lesson.videoId`, plugin registrations). README/Flutter README now describe bundled audio/transcripts instead of embedded streaming; removed obsolete internal strategy/instruction markdown files bundled with that cleanup.
 - **Hero:** Restored earlier hero layout and background image styling.
@@ -15,4 +20,5 @@ All notable changes to this project will be documented in this file.
 - Updated requirements.txt (see details in commit)
 
 ## [1.0.0] - 2025-07-25
+
 - Initial public release.

CODE_OF_CONDUCT.md

@@ -1,16 +1,20 @@
 # Contributor Covenant Code of Conduct
 
 ## Our Pledge
+
 We as members, contributors, and leaders pledge to make participation in our community a harassment-free experience for everyone, regardless of age, body size, visible or invisible disability, ethnicity, sex characteristics, gender identity and expression, level of experience, education, socio-economic status, nationality, personal appearance, race, religion, or sexual identity and orientation.
 
 ## Our Standards
+
 Examples of behavior that contributes to a positive environment:
+
 - Using welcoming and inclusive language
 - Being respectful of differing viewpoints
 - Gracefully accepting constructive criticism
 - Showing empathy towards others
 
 ## Enforcement
+
 Instances of abusive, harassing, or otherwise unacceptable behavior may be reported by contacting the project team at dbsectrainer@gmail.com. All complaints will be reviewed and investigated and will result in a response that is deemed necessary and appropriate to the circumstances.
 
 This Code of Conduct is adapted from the [Contributor Covenant](https://www.contributor-covenant.org/).

CONTRIBUTING.md

@@ -3,21 +3,25 @@
 Thank you for your interest in contributing! Please read the following guidelines to help us maintain a healthy and productive project.
 
 ## How to Contribute
+
 - Fork the repository and create your branch from `main`.
 - Write clear, concise commit messages.
 - Ensure your code follows our style guidelines.
 - Add tests for new features or bug fixes.
 - Submit a pull request with a clear description of your changes.
 
 ## Coding Standards
+
 - Use clear variable and function names.
 - Write docstrings/comments where helpful.
 - Follow PEP8 for Python code.
 
 ## Pull Request Process
+
 - Reference related issues in your PR description.
 - Ensure all tests pass before requesting review.
 - Be responsive to feedback and requested changes.
 
 ## Code of Conduct
+
 By participating, you agree to abide by our [Code of Conduct](CODE_OF_CONDUCT.md).