commit 352a3d5e88f7a695b21107673021356aeb567afd
Author: kaivalya <kaivalya@uber.space>
Date:   Thu Jun 18 13:06:57 2026 +0200

    Initial commit

diff --git a/.claude/scheduled_tasks.lock b/.claude/scheduled_tasks.lock
new file mode 100644
index 0000000..9c7686a
--- /dev/null
+++ b/.claude/scheduled_tasks.lock
@@ -0,0 +1 @@
+{"sessionId":"5ade3667-a4e8-4863-b973-cb39073bdd6a","pid":5817,"procStart":"18931","acquiredAt":1781606447105}
\ No newline at end of file
diff --git a/.claude/settings.json b/.claude/settings.json
new file mode 100644
index 0000000..bcda697
--- /dev/null
+++ b/.claude/settings.json
@@ -0,0 +1,52 @@
+{
+  "permissions": {
+    "allow": [
+      "Read",
+      "Glob",
+      "Grep",
+      "Edit",
+      "Write",
+      "MultiEdit",
+      "Bash(git *)",
+      "Bash(ls *)",
+      "Bash(echo *)",
+      "Bash(cat *)",
+      "Bash(grep *)",
+      "Bash(head *)",
+      "Bash(tail *)",
+      "Bash(find *)",
+      "Bash(sort *)",
+      "Bash(sed *)",
+      "Bash(awk *)",
+      "Bash(xargs *)",
+      "Bash(mkdir *)",
+      "Bash(cd *)",
+      "Bash(curl *)",
+      "Bash(nohup *)",
+      "Bash(sleep *)",
+      "Bash(seq *)",
+      "Bash(kill *)",
+      "Bash(pkill *)",
+      "Bash(lsof *)",
+      "Bash(true *)",
+      "Bash(break *)",
+      "Bash(npm run *)",
+      "Bash(npx prettier*)",
+      "Bash(python *)",
+      "Bash(python3 *)",
+      "Bash(pip *)",
+      "Bash(./venv/bin/python *)",
+      "Bash(cd tests && .venv/bin/python *)",
+      "Bash(cd *)"
+    ],
+    "ask": ["WebFetch", "WebSearch", "Bash(git push*)", "Bash(curl *)"],
+    "deny": [
+      "Read(*.env)",
+      "Read(*.env.*)",
+      "Glob(*.env)",
+      "Glob(*.env.*)",
+      "Grep(*.env)",
+      "Grep(*.env.*)"
+    ]
+  }
+}
diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
new file mode 100644
index 0000000..593ad7a
--- /dev/null
+++ b/.github/workflows/ci.yml
@@ -0,0 +1,84 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  lint-format:
+    name: Lint & Format
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '22'
+          cache: 'npm'
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Check formatting (Prettier)
+        run: npm run format:check
+
+      - name: Lint (ESLint)
+        run: npm run lint
+
+  build:
+    name: Build
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '22'
+          cache: 'npm'
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Build production bundle
+        run: npm run build
+
+  test:
+    name: Tests (${{ matrix.browser }})
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        browser: [firefox, chromium]
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '22'
+          cache: 'npm'
+
+      - name: Install Node dependencies
+        run: npm ci
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.11'
+          cache: 'pip'
+          cache-dependency-path: tests/requirements.txt
+
+      - name: Install Python dependencies
+        run: pip install -r tests/requirements.txt
+
+      - name: Install Playwright browsers
+        run: python -m playwright install --with-deps ${{ matrix.browser }}
+
+      - name: Run tests
+        run: python -m pytest tests/ --browser ${{ matrix.browser }} -v
+        env:
+          CI: true
diff --git a/.gitignore b/.gitignore
new file mode 100644
index 0000000..fd5a7d7
--- /dev/null
+++ b/.gitignore
@@ -0,0 +1,37 @@
+# Dependencies
+node_modules/
+
+# Build output
+dist/
+dev-dist/
+
+# SQLite WASM (copied from node_modules at build time)
+public/sqlite3.wasm
+public/sqlite3-opfs-async-proxy.js
+
+# Python venv
+tests/.venv/
+__pycache__/
+.pytest_cache/
+
+# Logs
+*.log
+
+# Editor
+.idea/
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Environment
+.env
+.env.local
+.env.*.local
+
+# temp files
+tmp/
+
+# Hugo build output
+website/public/
+website/resources/
diff --git a/.prettierignore b/.prettierignore
new file mode 100644
index 0000000..9fffa8c
--- /dev/null
+++ b/.prettierignore
@@ -0,0 +1,4 @@
+dist/
+node_modules/
+public/sqlite3-opfs-async-proxy.js
+website/layouts/
diff --git a/.prettierrc b/.prettierrc
new file mode 100644
index 0000000..0965e7e
--- /dev/null
+++ b/.prettierrc
@@ -0,0 +1,6 @@
+{
+  "semi": false,
+  "singleQuote": true,
+  "trailingComma": "all",
+  "printWidth": 100
+}
diff --git a/AGENTS.md b/AGENTS.md
new file mode 100644
index 0000000..0158850
--- /dev/null
+++ b/AGENTS.md
@@ -0,0 +1,121 @@
+# Agents Rules
+
+## Project Overview
+
+TrainUs is a fitness tracking progressive web application built with:
+
+- **Frontend**: Vue 3 (Composition API) + Vue Router
+- **Database**: SQLite WASM (client-side, in-browser)
+- **Build tool**: Vite 7
+- **Styling**: Custom CSS + Bootstrap Icons
+- **i18n**: i18next + i18next-vue (English, French & Danish)
+- **Tests**: Playwright (Python) with pytest
+- **Formatting**: Prettier
+
+## Project Structure
+
+```
+src/                  # All application source code
+  components/         # Reusable Vue components
+  composables/        # Vue composables (shared logic)
+  db/                 # SQLite WASM database layer
+  i18n/               # Internationalization config and translations
+  router/             # Vue Router configuration
+  styles/             # CSS styles
+  utils/              # Utility functions
+  views/              # Page-level Vue components
+  App.vue             # Root component
+  main.js             # Application entry point
+public/               # Static assets served as-is
+tests/                # Playwright (Python) test suite
+  conftest.py         # Pytest fixtures (Vite dev server, browser config)
+  test_step*.py       # Test files per feature step
+docs/                 # Non-website documentation
+  tutorials/          # Step tutorials (EN & FR)
+  tutorials/codelabs/ # Google Codelabs format (EN & FR)
+  decisions-log.md    # Decision log
+  plan.md             # Feature plan and progress tracking
+  specification.md    # Project specification
+website/              # Hugo project site (docs + blog), two separate sections
+                       # by audience, each with its own nav entry
+  content/docs/       # User docs ("Documentation" in nav). Diataxis split,
+                       # both languages: demarrage-rapide/ (tutorial),
+                       # guides-pratiques.{en,fr}.md (how-to), user-guide/
+                       # (reference), comprendre.{en,fr}.md (explanation).
+  content/developers/ # Contributor docs ("Developers"/"Développeurs" in nav):
+                       # technical.en.md, technical.fr.md
+  content/blog/       # Blog posts (news, release announcements)
+```
+
+## Build & Run Commands
+
+- `npm run dev` -- Start Vite dev server
+- `npm run build` -- Production build to `dist/`
+- `npm run preview` -- Preview production build
+- `npm run format` -- Format code with Prettier
+- `npm run format:check` -- Check formatting
+
+## Plan
+
+- Prepare a step-by-step plan to implement one feature at a time (do not rush the full application in one shot)
+- Validate the plan with me before doing anything
+- Validation is required between each step
+
+## Code
+
+Respect these principles:
+
+- KISS (Keep It Simple, Stupid)
+- SOLID (Single Responsibility, Open/Closed, Liskov Substitution, Interface Segregation, Dependency Inversion)
+- DRY (Don't Repeat Yourself)
+- Minimal impact: prefer small, focused changes over large refactors
+- All application source code goes in `src/`
+- All new Vue components use Composition API with `<script setup>`
+- Use existing composables and utilities before creating new ones
+
+## Documentation
+
+- Keep the decision log updated in `docs/decisions-log.md` with date, decision, and rationale
+- Use Mermaid diagrams to illustrate architecture and flows (prefer: flowchart, sequence diagram, state diagram)
+- `README.md` at project root presents an overview of the application and how to get started
+- All documentation files go in `docs/`
+- **Technical Documentation** (`website/content/developers/`, "Developers"/"Développeurs" nav entry):
+  - Technical overview (`technical.en.md`): what the app does, tech stack, global architecture
+  - Description of each feature with rationale (why this approach, what was considered and rejected)
+- **User Documentation** (`website/content/docs/`, "Documentation" nav entry):
+  - Diataxis-style split, in both English and French: `demarrage-rapide/`
+    (tutorial), `guides-pratiques.{en,fr}.md` (how-to), `user-guide/`
+    (reference — kept this name across languages so the bundle pairs as a
+    Hugo translation), `comprendre.{en,fr}.md` (explanation). Text-based
+    preferred, screenshots where they clarify a screen or flow.
+- **Tutorials & Codelabs (for each step):**
+  - A tutorial in `docs/tutorials/` explaining what was done (commands, key files, code snippets)
+  - Both in English (`_en` suffix) and French (`_fr` suffix)
+  - Tutorials and codelabs are optional — only generate when explicitly requested
+
+## Tests
+
+- Tests are written using Playwright in Python (see `tests/requirements.txt` for dependencies)
+- The Vite dev server starts automatically via the `app_url` fixture in `tests/conftest.py` on port 5199
+- Test files follow the naming convention `test_step<N>_<feature_name>.py`
+- Tests are documented with a short description per test function
+- **Browser targets**: Firefox (primary), Chromium (must also pass)
+- Test both "green" paths (happy flow) and "red" paths (bad inputs, edge cases, error states)
+- All test files go in `tests/`
+- The dev server is stopped automatically by the pytest fixture after tests complete
+
+## Schema Version
+
+- **Do NOT increment `SCHEMA_VERSION` without asking first.**
+- In-place schema changes (adding columns directly in `SCHEMA_SQL`) are acceptable as long as the app has not been released to users.
+- A version bump is only needed once a schema has been deployed — at that point, a migration script must accompany the bump. Ask before doing either.
+
+## Definition of Done
+
+Before a step is considered complete, all of the following must be true:
+
+- [ ] Code implemented in `src/`
+- [ ] `docs/plan.md` updated to track what is done and what remains
+- [ ] Documentation updated (`website/content/developers/technical.en.md`, `website/content/docs/user-guide/index.en.md`, `docs/decisions-log.md`)
+- [ ] Tests written and passing on both Firefox and Chromium
+- [ ] Manual validation by the user before moving to the next step
diff --git a/CLAUDE.md b/CLAUDE.md
new file mode 100644
index 0000000..43c994c
--- /dev/null
+++ b/CLAUDE.md
@@ -0,0 +1 @@
+@AGENTS.md
diff --git a/LICENSE.md b/LICENSE.md
new file mode 100644
index 0000000..bc16720
--- /dev/null
+++ b/LICENSE.md
@@ -0,0 +1,660 @@
+# GNU AFFERO GENERAL PUBLIC LICENSE
+
+Version 3, 19 November 2007
+
+Copyright (C) 2007 Free Software Foundation, Inc.
+<https://fsf.org/>
+
+Everyone is permitted to copy and distribute verbatim copies of this
+license document, but changing it is not allowed.
+
+## Preamble
+
+The GNU Affero General Public License is a free, copyleft license for
+software and other kinds of works, specifically designed to ensure
+cooperation with the community in the case of network server software.
+
+The licenses for most software and other practical works are designed
+to take away your freedom to share and change the works. By contrast,
+our General Public Licenses are intended to guarantee your freedom to
+share and change all versions of a program--to make sure it remains
+free software for all its users.
+
+When we speak of free software, we are referring to freedom, not
+price. Our General Public Licenses are designed to make sure that you
+have the freedom to distribute copies of free software (and charge for
+them if you wish), that you receive source code or can get it if you
+want it, that you can change the software or use pieces of it in new
+free programs, and that you know you can do these things.
+
+Developers that use our General Public Licenses protect your rights
+with two steps: (1) assert copyright on the software, and (2) offer
+you this License which gives you legal permission to copy, distribute
+and/or modify the software.
+
+A secondary benefit of defending all users' freedom is that
+improvements made in alternate versions of the program, if they
+receive widespread use, become available for other developers to
+incorporate. Many developers of free software are heartened and
+encouraged by the resulting cooperation. However, in the case of
+software used on network servers, this result may fail to come about.
+The GNU General Public License permits making a modified version and
+letting the public access it on a server without ever releasing its
+source code to the public.
+
+The GNU Affero General Public License is designed specifically to
+ensure that, in such cases, the modified source code becomes available
+to the community. It requires the operator of a network server to
+provide the source code of the modified version running there to the
+users of that server. Therefore, public use of a modified version, on
+a publicly accessible server, gives the public access to the source
+code of the modified version.
+
+An older license, called the Affero General Public License and
+published by Affero, was designed to accomplish similar goals. This is
+a different license, not a version of the Affero GPL, but Affero has
+released a new version of the Affero GPL which permits relicensing
+under this license.
+
+The precise terms and conditions for copying, distribution and
+modification follow.
+
+## TERMS AND CONDITIONS
+
+### 0. Definitions.
+
+"This License" refers to version 3 of the GNU Affero General Public
+License.
+
+"Copyright" also means copyright-like laws that apply to other kinds
+of works, such as semiconductor masks.
+
+"The Program" refers to any copyrightable work licensed under this
+License. Each licensee is addressed as "you". "Licensees" and
+"recipients" may be individuals or organizations.
+
+To "modify" a work means to copy from or adapt all or part of the work
+in a fashion requiring copyright permission, other than the making of
+an exact copy. The resulting work is called a "modified version" of
+the earlier work or a work "based on" the earlier work.
+
+A "covered work" means either the unmodified Program or a work based
+on the Program.
+
+To "propagate" a work means to do anything with it that, without
+permission, would make you directly or secondarily liable for
+infringement under applicable copyright law, except executing it on a
+computer or modifying a private copy. Propagation includes copying,
+distribution (with or without modification), making available to the
+public, and in some countries other activities as well.
+
+To "convey" a work means any kind of propagation that enables other
+parties to make or receive copies. Mere interaction with a user
+through a computer network, with no transfer of a copy, is not
+conveying.
+
+An interactive user interface displays "Appropriate Legal Notices" to
+the extent that it includes a convenient and prominently visible
+feature that (1) displays an appropriate copyright notice, and (2)
+tells the user that there is no warranty for the work (except to the
+extent that warranties are provided), that licensees may convey the
+work under this License, and how to view a copy of this License. If
+the interface presents a list of user commands or options, such as a
+menu, a prominent item in the list meets this criterion.
+
+### 1. Source Code.
+
+The "source code" for a work means the preferred form of the work for
+making modifications to it. "Object code" means any non-source form of
+a work.
+
+A "Standard Interface" means an interface that either is an official
+standard defined by a recognized standards body, or, in the case of
+interfaces specified for a particular programming language, one that
+is widely used among developers working in that language.
+
+The "System Libraries" of an executable work include anything, other
+than the work as a whole, that (a) is included in the normal form of
+packaging a Major Component, but which is not part of that Major
+Component, and (b) serves only to enable use of the work with that
+Major Component, or to implement a Standard Interface for which an
+implementation is available to the public in source code form. A
+"Major Component", in this context, means a major essential component
+(kernel, window system, and so on) of the specific operating system
+(if any) on which the executable work runs, or a compiler used to
+produce the work, or an object code interpreter used to run it.
+
+The "Corresponding Source" for a work in object code form means all
+the source code needed to generate, install, and (for an executable
+work) run the object code and to modify the work, including scripts to
+control those activities. However, it does not include the work's
+System Libraries, or general-purpose tools or generally available free
+programs which are used unmodified in performing those activities but
+which are not part of the work. For example, Corresponding Source
+includes interface definition files associated with source files for
+the work, and the source code for shared libraries and dynamically
+linked subprograms that the work is specifically designed to require,
+such as by intimate data communication or control flow between those
+subprograms and other parts of the work.
+
+The Corresponding Source need not include anything that users can
+regenerate automatically from other parts of the Corresponding Source.
+
+The Corresponding Source for a work in source code form is that same
+work.
+
+### 2. Basic Permissions.
+
+All rights granted under this License are granted for the term of
+copyright on the Program, and are irrevocable provided the stated
+conditions are met. This License explicitly affirms your unlimited
+permission to run the unmodified Program. The output from running a
+covered work is covered by this License only if the output, given its
+content, constitutes a covered work. This License acknowledges your
+rights of fair use or other equivalent, as provided by copyright law.
+
+You may make, run and propagate covered works that you do not convey,
+without conditions so long as your license otherwise remains in force.
+You may convey covered works to others for the sole purpose of having
+them make modifications exclusively for you, or provide you with
+facilities for running those works, provided that you comply with the
+terms of this License in conveying all material for which you do not
+control copyright. Those thus making or running the covered works for
+you must do so exclusively on your behalf, under your direction and
+control, on terms that prohibit them from making any copies of your
+copyrighted material outside their relationship with you.
+
+Conveying under any other circumstances is permitted solely under the
+conditions stated below. Sublicensing is not allowed; section 10 makes
+it unnecessary.
+
+### 3. Protecting Users' Legal Rights From Anti-Circumvention Law.
+
+No covered work shall be deemed part of an effective technological
+measure under any applicable law fulfilling obligations under article
+11 of the WIPO copyright treaty adopted on 20 December 1996, or
+similar laws prohibiting or restricting circumvention of such
+measures.
+
+When you convey a covered work, you waive any legal power to forbid
+circumvention of technological measures to the extent such
+circumvention is effected by exercising rights under this License with
+respect to the covered work, and you disclaim any intention to limit
+operation or modification of the work as a means of enforcing, against
+the work's users, your or third parties' legal rights to forbid
+circumvention of technological measures.
+
+### 4. Conveying Verbatim Copies.
+
+You may convey verbatim copies of the Program's source code as you
+receive it, in any medium, provided that you conspicuously and
+appropriately publish on each copy an appropriate copyright notice;
+keep intact all notices stating that this License and any
+non-permissive terms added in accord with section 7 apply to the code;
+keep intact all notices of the absence of any warranty; and give all
+recipients a copy of this License along with the Program.
+
+You may charge any price or no price for each copy that you convey,
+and you may offer support or warranty protection for a fee.
+
+### 5. Conveying Modified Source Versions.
+
+You may convey a work based on the Program, or the modifications to
+produce it from the Program, in the form of source code under the
+terms of section 4, provided that you also meet all of these
+conditions:
+
+- a) The work must carry prominent notices stating that you modified
+  it, and giving a relevant date.
+- b) The work must carry prominent notices stating that it is
+  released under this License and any conditions added under
+  section 7. This requirement modifies the requirement in section 4
+  to "keep intact all notices".
+- c) You must license the entire work, as a whole, under this
+  License to anyone who comes into possession of a copy. This
+  License will therefore apply, along with any applicable section 7
+  additional terms, to the whole of the work, and all its parts,
+  regardless of how they are packaged. This License gives no
+  permission to license the work in any other way, but it does not
+  invalidate such permission if you have separately received it.
+- d) If the work has interactive user interfaces, each must display
+  Appropriate Legal Notices; however, if the Program has interactive
+  interfaces that do not display Appropriate Legal Notices, your
+  work need not make them do so.
+
+A compilation of a covered work with other separate and independent
+works, which are not by their nature extensions of the covered work,
+and which are not combined with it such as to form a larger program,
+in or on a volume of a storage or distribution medium, is called an
+"aggregate" if the compilation and its resulting copyright are not
+used to limit the access or legal rights of the compilation's users
+beyond what the individual works permit. Inclusion of a covered work
+in an aggregate does not cause this License to apply to the other
+parts of the aggregate.
+
+### 6. Conveying Non-Source Forms.
+
+You may convey a covered work in object code form under the terms of
+sections 4 and 5, provided that you also convey the machine-readable
+Corresponding Source under the terms of this License, in one of these
+ways:
+
+- a) Convey the object code in, or embodied in, a physical product
+  (including a physical distribution medium), accompanied by the
+  Corresponding Source fixed on a durable physical medium
+  customarily used for software interchange.
+- b) Convey the object code in, or embodied in, a physical product
+  (including a physical distribution medium), accompanied by a
+  written offer, valid for at least three years and valid for as
+  long as you offer spare parts or customer support for that product
+  model, to give anyone who possesses the object code either (1) a
+  copy of the Corresponding Source for all the software in the
+  product that is covered by this License, on a durable physical
+  medium customarily used for software interchange, for a price no
+  more than your reasonable cost of physically performing this
+  conveying of source, or (2) access to copy the Corresponding
+  Source from a network server at no charge.
+- c) Convey individual copies of the object code with a copy of the
+  written offer to provide the Corresponding Source. This
+  alternative is allowed only occasionally and noncommercially, and
+  only if you received the object code with such an offer, in accord
+  with subsection 6b.
+- d) Convey the object code by offering access from a designated
+  place (gratis or for a charge), and offer equivalent access to the
+  Corresponding Source in the same way through the same place at no
+  further charge. You need not require recipients to copy the
+  Corresponding Source along with the object code. If the place to
+  copy the object code is a network server, the Corresponding Source
+  may be on a different server (operated by you or a third party)
+  that supports equivalent copying facilities, provided you maintain
+  clear directions next to the object code saying where to find the
+  Corresponding Source. Regardless of what server hosts the
+  Corresponding Source, you remain obligated to ensure that it is
+  available for as long as needed to satisfy these requirements.
+- e) Convey the object code using peer-to-peer transmission,
+  provided you inform other peers where the object code and
+  Corresponding Source of the work are being offered to the general
+  public at no charge under subsection 6d.
+
+A separable portion of the object code, whose source code is excluded
+from the Corresponding Source as a System Library, need not be
+included in conveying the object code work.
+
+A "User Product" is either (1) a "consumer product", which means any
+tangible personal property which is normally used for personal,
+family, or household purposes, or (2) anything designed or sold for
+incorporation into a dwelling. In determining whether a product is a
+consumer product, doubtful cases shall be resolved in favor of
+coverage. For a particular product received by a particular user,
+"normally used" refers to a typical or common use of that class of
+product, regardless of the status of the particular user or of the way
+in which the particular user actually uses, or expects or is expected
+to use, the product. A product is a consumer product regardless of
+whether the product has substantial commercial, industrial or
+non-consumer uses, unless such uses represent the only significant
+mode of use of the product.
+
+"Installation Information" for a User Product means any methods,
+procedures, authorization keys, or other information required to
+install and execute modified versions of a covered work in that User
+Product from a modified version of its Corresponding Source. The
+information must suffice to ensure that the continued functioning of
+the modified object code is in no case prevented or interfered with
+solely because modification has been made.
+
+If you convey an object code work under this section in, or with, or
+specifically for use in, a User Product, and the conveying occurs as
+part of a transaction in which the right of possession and use of the
+User Product is transferred to the recipient in perpetuity or for a
+fixed term (regardless of how the transaction is characterized), the
+Corresponding Source conveyed under this section must be accompanied
+by the Installation Information. But this requirement does not apply
+if neither you nor any third party retains the ability to install
+modified object code on the User Product (for example, the work has
+been installed in ROM).
+
+The requirement to provide Installation Information does not include a
+requirement to continue to provide support service, warranty, or
+updates for a work that has been modified or installed by the
+recipient, or for the User Product in which it has been modified or
+installed. Access to a network may be denied when the modification
+itself materially and adversely affects the operation of the network
+or violates the rules and protocols for communication across the
+network.
+
+Corresponding Source conveyed, and Installation Information provided,
+in accord with this section must be in a format that is publicly
+documented (and with an implementation available to the public in
+source code form), and must require no special password or key for
+unpacking, reading or copying.
+
+### 7. Additional Terms.
+
+"Additional permissions" are terms that supplement the terms of this
+License by making exceptions from one or more of its conditions.
+Additional permissions that are applicable to the entire Program shall
+be treated as though they were included in this License, to the extent
+that they are valid under applicable law. If additional permissions
+apply only to part of the Program, that part may be used separately
+under those permissions, but the entire Program remains governed by
+this License without regard to the additional permissions.
+
+When you convey a copy of a covered work, you may at your option
+remove any additional permissions from that copy, or from any part of
+it. (Additional permissions may be written to require their own
+removal in certain cases when you modify the work.) You may place
+additional permissions on material, added by you to a covered work,
+for which you have or can give appropriate copyright permission.
+
+Notwithstanding any other provision of this License, for material you
+add to a covered work, you may (if authorized by the copyright holders
+of that material) supplement the terms of this License with terms:
+
+- a) Disclaiming warranty or limiting liability differently from the
+  terms of sections 15 and 16 of this License; or
+- b) Requiring preservation of specified reasonable legal notices or
+  author attributions in that material or in the Appropriate Legal
+  Notices displayed by works containing it; or
+- c) Prohibiting misrepresentation of the origin of that material,
+  or requiring that modified versions of such material be marked in
+  reasonable ways as different from the original version; or
+- d) Limiting the use for publicity purposes of names of licensors
+  or authors of the material; or
+- e) Declining to grant rights under trademark law for use of some
+  trade names, trademarks, or service marks; or
+- f) Requiring indemnification of licensors and authors of that
+  material by anyone who conveys the material (or modified versions
+  of it) with contractual assumptions of liability to the recipient,
+  for any liability that these contractual assumptions directly
+  impose on those licensors and authors.
+
+All other non-permissive additional terms are considered "further
+restrictions" within the meaning of section 10. If the Program as you
+received it, or any part of it, contains a notice stating that it is
+governed by this License along with a term that is a further
+restriction, you may remove that term. If a license document contains
+a further restriction but permits relicensing or conveying under this
+License, you may add to a covered work material governed by the terms
+of that license document, provided that the further restriction does
+not survive such relicensing or conveying.
+
+If you add terms to a covered work in accord with this section, you
+must place, in the relevant source files, a statement of the
+additional terms that apply to those files, or a notice indicating
+where to find the applicable terms.
+
+Additional terms, permissive or non-permissive, may be stated in the
+form of a separately written license, or stated as exceptions; the
+above requirements apply either way.
+
+### 8. Termination.
+
+You may not propagate or modify a covered work except as expressly
+provided under this License. Any attempt otherwise to propagate or
+modify it is void, and will automatically terminate your rights under
+this License (including any patent licenses granted under the third
+paragraph of section 11).
+
+However, if you cease all violation of this License, then your license
+from a particular copyright holder is reinstated (a) provisionally,
+unless and until the copyright holder explicitly and finally
+terminates your license, and (b) permanently, if the copyright holder
+fails to notify you of the violation by some reasonable means prior to
+60 days after the cessation.
+
+Moreover, your license from a particular copyright holder is
+reinstated permanently if the copyright holder notifies you of the
+violation by some reasonable means, this is the first time you have
+received notice of violation of this License (for any work) from that
+copyright holder, and you cure the violation prior to 30 days after
+your receipt of the notice.
+
+Termination of your rights under this section does not terminate the
+licenses of parties who have received copies or rights from you under
+this License. If your rights have been terminated and not permanently
+reinstated, you do not qualify to receive new licenses for the same
+material under section 10.
+
+### 9. Acceptance Not Required for Having Copies.
+
+You are not required to accept this License in order to receive or run
+a copy of the Program. Ancillary propagation of a covered work
+occurring solely as a consequence of using peer-to-peer transmission
+to receive a copy likewise does not require acceptance. However,
+nothing other than this License grants you permission to propagate or
+modify any covered work. These actions infringe copyright if you do
+not accept this License. Therefore, by modifying or propagating a
+covered work, you indicate your acceptance of this License to do so.
+
+### 10. Automatic Licensing of Downstream Recipients.
+
+Each time you convey a covered work, the recipient automatically
+receives a license from the original licensors, to run, modify and
+propagate that work, subject to this License. You are not responsible
+for enforcing compliance by third parties with this License.
+
+An "entity transaction" is a transaction transferring control of an
+organization, or substantially all assets of one, or subdividing an
+organization, or merging organizations. If propagation of a covered
+work results from an entity transaction, each party to that
+transaction who receives a copy of the work also receives whatever
+licenses to the work the party's predecessor in interest had or could
+give under the previous paragraph, plus a right to possession of the
+Corresponding Source of the work from the predecessor in interest, if
+the predecessor has it or can get it with reasonable efforts.
+
+You may not impose any further restrictions on the exercise of the
+rights granted or affirmed under this License. For example, you may
+not impose a license fee, royalty, or other charge for exercise of
+rights granted under this License, and you may not initiate litigation
+(including a cross-claim or counterclaim in a lawsuit) alleging that
+any patent claim is infringed by making, using, selling, offering for
+sale, or importing the Program or any portion of it.
+
+### 11. Patents.
+
+A "contributor" is a copyright holder who authorizes use under this
+License of the Program or a work on which the Program is based. The
+work thus licensed is called the contributor's "contributor version".
+
+A contributor's "essential patent claims" are all patent claims owned
+or controlled by the contributor, whether already acquired or
+hereafter acquired, that would be infringed by some manner, permitted
+by this License, of making, using, or selling its contributor version,
+but do not include claims that would be infringed only as a
+consequence of further modification of the contributor version. For
+purposes of this definition, "control" includes the right to grant
+patent sublicenses in a manner consistent with the requirements of
+this License.
+
+Each contributor grants you a non-exclusive, worldwide, royalty-free
+patent license under the contributor's essential patent claims, to
+make, use, sell, offer for sale, import and otherwise run, modify and
+propagate the contents of its contributor version.
+
+In the following three paragraphs, a "patent license" is any express
+agreement or commitment, however denominated, not to enforce a patent
+(such as an express permission to practice a patent or covenant not to
+sue for patent infringement). To "grant" such a patent license to a
+party means to make such an agreement or commitment not to enforce a
+patent against the party.
+
+If you convey a covered work, knowingly relying on a patent license,
+and the Corresponding Source of the work is not available for anyone
+to copy, free of charge and under the terms of this License, through a
+publicly available network server or other readily accessible means,
+then you must either (1) cause the Corresponding Source to be so
+available, or (2) arrange to deprive yourself of the benefit of the
+patent license for this particular work, or (3) arrange, in a manner
+consistent with the requirements of this License, to extend the patent
+license to downstream recipients. "Knowingly relying" means you have
+actual knowledge that, but for the patent license, your conveying the
+covered work in a country, or your recipient's use of the covered work
+in a country, would infringe one or more identifiable patents in that
+country that you have reason to believe are valid.
+
+If, pursuant to or in connection with a single transaction or
+arrangement, you convey, or propagate by procuring conveyance of, a
+covered work, and grant a patent license to some of the parties
+receiving the covered work authorizing them to use, propagate, modify
+or convey a specific copy of the covered work, then the patent license
+you grant is automatically extended to all recipients of the covered
+work and works based on it.
+
+A patent license is "discriminatory" if it does not include within the
+scope of its coverage, prohibits the exercise of, or is conditioned on
+the non-exercise of one or more of the rights that are specifically
+granted under this License. You may not convey a covered work if you
+are a party to an arrangement with a third party that is in the
+business of distributing software, under which you make payment to the
+third party based on the extent of your activity of conveying the
+work, and under which the third party grants, to any of the parties
+who would receive the covered work from you, a discriminatory patent
+license (a) in connection with copies of the covered work conveyed by
+you (or copies made from those copies), or (b) primarily for and in
+connection with specific products or compilations that contain the
+covered work, unless you entered into that arrangement, or that patent
+license was granted, prior to 28 March 2007.
+
+Nothing in this License shall be construed as excluding or limiting
+any implied license or other defenses to infringement that may
+otherwise be available to you under applicable patent law.
+
+### 12. No Surrender of Others' Freedom.
+
+If conditions are imposed on you (whether by court order, agreement or
+otherwise) that contradict the conditions of this License, they do not
+excuse you from the conditions of this License. If you cannot convey a
+covered work so as to satisfy simultaneously your obligations under
+this License and any other pertinent obligations, then as a
+consequence you may not convey it at all. For example, if you agree to
+terms that obligate you to collect a royalty for further conveying
+from those to whom you convey the Program, the only way you could
+satisfy both those terms and this License would be to refrain entirely
+from conveying the Program.
+
+### 13. Remote Network Interaction; Use with the GNU General Public License.
+
+Notwithstanding any other provision of this License, if you modify the
+Program, your modified version must prominently offer all users
+interacting with it remotely through a computer network (if your
+version supports such interaction) an opportunity to receive the
+Corresponding Source of your version by providing access to the
+Corresponding Source from a network server at no charge, through some
+standard or customary means of facilitating copying of software. This
+Corresponding Source shall include the Corresponding Source for any
+work covered by version 3 of the GNU General Public License that is
+incorporated pursuant to the following paragraph.
+
+Notwithstanding any other provision of this License, you have
+permission to link or combine any covered work with a work licensed
+under version 3 of the GNU General Public License into a single
+combined work, and to convey the resulting work. The terms of this
+License will continue to apply to the part which is the covered work,
+but the work with which it is combined will remain governed by version
+3 of the GNU General Public License.
+
+### 14. Revised Versions of this License.
+
+The Free Software Foundation may publish revised and/or new versions
+of the GNU Affero General Public License from time to time. Such new
+versions will be similar in spirit to the present version, but may
+differ in detail to address new problems or concerns.
+
+Each version is given a distinguishing version number. If the Program
+specifies that a certain numbered version of the GNU Affero General
+Public License "or any later version" applies to it, you have the
+option of following the terms and conditions either of that numbered
+version or of any later version published by the Free Software
+Foundation. If the Program does not specify a version number of the
+GNU Affero General Public License, you may choose any version ever
+published by the Free Software Foundation.
+
+If the Program specifies that a proxy can decide which future versions
+of the GNU Affero General Public License can be used, that proxy's
+public statement of acceptance of a version permanently authorizes you
+to choose that version for the Program.
+
+Later license versions may give you additional or different
+permissions. However, no additional obligations are imposed on any
+author or copyright holder as a result of your choosing to follow a
+later version.
+
+### 15. Disclaimer of Warranty.
+
+THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY
+APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT
+HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT
+WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT
+LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+A PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND
+PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE PROGRAM PROVE
+DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, REPAIR OR
+CORRECTION.
+
+### 16. Limitation of Liability.
+
+IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
+WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MODIFIES AND/OR
+CONVEYS THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES,
+INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES
+ARISING OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT
+NOT LIMITED TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR
+LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM
+TO OPERATE WITH ANY OTHER PROGRAMS), EVEN IF SUCH HOLDER OR OTHER
+PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
+
+### 17. Interpretation of Sections 15 and 16.
+
+If the disclaimer of warranty and limitation of liability provided
+above cannot be given local legal effect according to their terms,
+reviewing courts shall apply local law that most closely approximates
+an absolute waiver of all civil liability in connection with the
+Program, unless a warranty or assumption of liability accompanies a
+copy of the Program in return for a fee.
+
+END OF TERMS AND CONDITIONS
+
+## How to Apply These Terms to Your New Programs
+
+If you develop a new program, and you want it to be of the greatest
+possible use to the public, the best way to achieve this is to make it
+free software which everyone can redistribute and change under these
+terms.
+
+To do so, attach the following notices to the program. It is safest to
+attach them to the start of each source file to most effectively state
+the exclusion of warranty; and each file should have at least the
+"copyright" line and a pointer to where the full notice is found.
+
+        <one line to give the program's name and a brief idea of what it does.>
+        Copyright (C) <year>  <name of author>
+
+        This program is free software: you can redistribute it and/or modify
+        it under the terms of the GNU Affero General Public License as
+        published by the Free Software Foundation, either version 3 of the
+        License, or (at your option) any later version.
+
+        This program is distributed in the hope that it will be useful,
+        but WITHOUT ANY WARRANTY; without even the implied warranty of
+        MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+        GNU Affero General Public License for more details.
+
+        You should have received a copy of the GNU Affero General Public License
+        along with this program.  If not, see <https://www.gnu.org/licenses/>.
+
+Also add information on how to contact you by electronic and paper
+mail.
+
+If your software can interact with users remotely through a computer
+network, you should also make sure that it provides a way for users to
+get its source. For example, if your program is a web application, its
+interface could display a "Source" link that leads users to an archive
+of the code. There are many ways you could offer source, and different
+solutions will be better for different programs; see section 13 for
+the specific requirements.
+
+You should also get your employer (if you work as a programmer) or
+school, if any, to sign a "copyright disclaimer" for the program, if
+necessary. For more information on this, and how to apply and follow
+the GNU AGPL, see <https://www.gnu.org/licenses/>.
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..d920542
--- /dev/null
+++ b/README.md
@@ -0,0 +1,254 @@
+# TrainUs
+
+A local-first PWA fitness training application. Plan, track, and execute your workouts entirely on your device — no server needed.
+
+> [!WARNING]  
+> IA has been massively used.  
+> I have the technical skills to carry out this kind of project, but not the time. The rise of AI tools changed the equation: what would have taken me months of evenings and weekends became achievable. AI didn’t replace expertise — it made possible what wasn’t, purely due to time constraints. It was also an opportunity to learn how to work with these tools, which is a benefit in itself: I got to test and compare quite a few models and assistants throughout the development.
+
+## Tech Stack
+
+- **Vue 3** + **Vite** — reactive UI framework with fast build tooling
+- **SQLite WASM** with **OPFS** — client-side database persistence
+- **i18next** — internationalization (English, French & Danish)
+- **Chart.js** — workout statistics
+- **vite-plugin-pwa** + Workbox — offline support and install prompt
+- **Playwright** (Python) — end-to-end testing
+
+## Getting Started
+
+### Prerequisites
+
+- Node.js ≥ 18
+- Python ≥ 3.10 (for tests)
+
+### Development
+
+```bash
+npm install
+npm run dev        # dev server at http://localhost:5173
+npm run lint       # ESLint (src/)
+npm run format     # Prettier (auto-fix)
+npm run format:check  # Prettier (check only)
+```
+
+The dev server runs at `http://localhost:5173` with COOP/COEP headers enabled (precautionary; the SAH-pool VFS used by this app does not strictly require them). The Playwright test suite runs its own instance on port 5199 instead (see `tests/README.md`).
+
+> **Note:** OPFS persistence requires a modern browser (Firefox 111+, Chrome 102+, Safari 16.4+) and does not work in private browsing mode. If OPFS is unavailable, the app displays a compatibility error.
+
+### Build
+
+```bash
+npm run build
+```
+
+Produces a static `dist/` folder ready for deployment.
+
+### Deploy
+
+TrainUs uses a single deployment: copy the `dist/` folder to the site root, replacing the previous build (no per-version folders). User data is preserved across updates — it lives at a stable OPFS location, and a startup migration step applies any schema changes.
+
+TrainUs is a static site — it works on any web server or CDN. COOP/COEP headers are not required for the SAH-pool VFS used here, but are recommended for defense-in-depth and may be required if the VFS is ever changed:
+
+#### Nginx
+
+```nginx
+location / {
+    add_header Cross-Origin-Opener-Policy "same-origin";
+    add_header Cross-Origin-Embedder-Policy "require-corp";
+}
+```
+
+#### Apache
+
+```apache
+<IfModule mod_headers.c>
+    Header always set Cross-Origin-Opener-Policy "same-origin"
+    Header always set Cross-Origin-Embedder-Policy "require-corp"
+</IfModule>
+```
+
+#### Caddy
+
+```caddy
+header {
+    Cross-Origin-Opener-Policy "same-origin"
+    Cross-Origin-Embedder-Policy "require-corp"
+}
+```
+
+#### Netlify (`public/_headers`)
+
+```
+/*
+  Cross-Origin-Opener-Policy: same-origin
+  Cross-Origin-Embedder-Policy: require-corp
+```
+
+#### Vercel (`vercel.json`)
+
+```json
+{
+  "headers": [
+    {
+      "source": "/(.*)",
+      "headers": [
+        { "key": "Cross-Origin-Opener-Policy", "value": "same-origin" },
+        { "key": "Cross-Origin-Embedder-Policy", "value": "require-corp" }
+      ]
+    }
+  ]
+}
+```
+
+#### Preview production build locally
+
+```bash
+npm run preview
+```
+
+Serves `dist/` at `http://localhost:4173` with the correct headers (injected by Vite).
+
+### Tests
+
+#### Setup (first time)
+
+```bash
+cd tests
+python -m venv .venv
+.venv/bin/pip install -r requirements.txt
+.venv/bin/playwright install firefox chromium
+```
+
+#### Running tests
+
+| Command                        | Browsers           | Mode                         |
+| :----------------------------- | :----------------- | :--------------------------- |
+| npm run test                   | firefox            | sequential                   |
+| npm run test:chromium          | chromium           | sequential                   |
+| npm run test:parallel          | firefox + chromium | parallel                     |
+| npm run test:parallel:firefox  | firefox            | parallel                     |
+| npm run test:parallel:chromium | chromium           | parallel                     |
+| npm run test:parallel:n        | firefox + chromium | parallel, fixed worker count |
+
+```bash
+# Sequential — Firefox only (simple)
+npm run test
+# or: cd tests && .venv/bin/python -m pytest --browser firefox -v
+
+# Parallel — both browsers, all CPU cores (fastest)
+npm run test:parallel
+
+# Parallel — Firefox only, all CPU cores
+npm run test:parallel:firefox
+
+# Parallel — both browsers, limited to N workers (default 4)
+WORKERS=2 npm run test:parallel:n
+
+# Via shell script — both browsers, auto workers
+./tests/run_parallel.sh
+
+# Via shell script — Firefox only, 4 workers
+PYTEST_WORKERS=4 PYTEST_BROWSERS="firefox" ./tests/run_parallel.sh
+
+# Single test file, Firefox only
+cd tests && .venv/bin/python -m pytest test_step2_settings.py --browser firefox -v
+
+# Single test file in parallel via shell script
+./tests/run_parallel.sh test_step3_exercises.py
+```
+
+### Website
+
+The project site (docs + blog) is a Hugo static site under `website/`.
+
+#### Prerequisites
+
+- [Hugo](https://gohugo.io/installation/) ≥ 0.123 extended edition
+
+#### Development
+
+```bash
+npm run site:dev   # Hugo dev server at http://localhost:1313 (with drafts)
+```
+
+#### Build
+
+```bash
+npm run site:build   # Minified output in website/public/
+```
+
+#### Deploy
+
+The site is a static folder — copy `website/public/` to any web host. Before building for production, set two values in `website/hugo.toml`:
+
+```toml
+baseURL = "https://yourdomain.example/trainus/"   # full URL to the site root
+
+[params]
+  appUrl = "https://yourdomain.example/app/"      # leave empty to show "Coming soon"
+```
+
+No special server headers are required for the website itself (COOP/COEP are only needed for the app).
+
+## Documentation
+
+You can access the website [here](https://kaivalya.eu/projects/trainUs).
+
+### Project
+
+- [Technical Documentation](website/content/developers/technical.en.md) -- Architecture, tech stack, data model, and feature details
+- [User Documentation](website/content/docs/user-guide/index.en.md) -- How each feature works from the user's perspective
+- [Implementation Plan](docs/plan.md) -- Step-by-step feature plan and progress tracking
+- [Decisions Log](docs/decisions-log.md) -- All design decisions with rationale
+
+## Credits
+
+### Icons
+
+The app icon is [Mighty Force](https://game-icons.net/1x1/delapouite/mighty-force.html) by [Delapouite](https://delapouite.com), sourced from [game-icons.net](https://game-icons.net) and licensed under [CC BY 3.0](https://creativecommons.org/licenses/by/3.0/). Thank you for making such a great icon library freely available!
+
+UI icons are provided by [Bootstrap Icons](https://icons.getbootstrap.com), licensed under MIT.
+
+### Third-Party Software
+
+| Package                                                                                                                    | License              |
+| -------------------------------------------------------------------------------------------------------------------------- | -------------------- |
+| [Vue 3](https://github.com/vuejs/core)                                                                                     | MIT                  |
+| [Vue Router](https://github.com/vuejs/router)                                                                              | MIT                  |
+| [Vite](https://github.com/vitejs/vite)                                                                                     | MIT                  |
+| [@vitejs/plugin-vue](https://github.com/vitejs/vite-plugin-vue)                                                            | MIT                  |
+| [vite-plugin-pwa](https://github.com/vite-pwa/vite-plugin-pwa)                                                             | MIT                  |
+| [Workbox](https://github.com/GoogleChrome/workbox) (bundled by vite-plugin-pwa)                                            | Apache-2.0           |
+| [@sqlite.org/sqlite-wasm](https://sqlite.org/wasm/doc/trunk/index.md)                                                      | Apache-2.0           |
+| [Bootstrap Icons](https://icons.getbootstrap.com)                                                                          | MIT                  |
+| [Mighty Force](https://game-icons.net/1x1/delapouite/mighty-force.html) by [Delapouite](https://delapouite.com) (app icon) | CC BY 3.0            |
+| [Chart.js](https://github.com/chartjs/Chart.js)                                                                            | MIT                  |
+| [vue-chartjs](https://github.com/apertureless/vue-chartjs)                                                                 | MIT                  |
+| [DOMPurify](https://github.com/cure53/DOMPurify)                                                                           | Apache-2.0 / MPL-2.0 |
+| [marked](https://github.com/markedjs/marked)                                                                               | MIT                  |
+| [i18next](https://github.com/i18next/i18next)                                                                              | MIT                  |
+| [i18next-vue](https://github.com/i18next/i18next-vue)                                                                      | MIT                  |
+| [Prettier](https://github.com/prettier/prettier)                                                                           | MIT                  |
+| [Playwright](https://github.com/microsoft/playwright)                                                                      | Apache-2.0           |
+| [pytest](https://github.com/pytest-dev/pytest)                                                                             | MIT                  |
+| [pytest-playwright](https://github.com/microsoft/playwright-python)                                                        | Apache-2.0           |
+| [pytest-xdist](https://github.com/pytest-dev/pytest-xdist)                                                                 | MIT                  |
+
+## License
+
+TrainUs — an open, local-first, offline-capable fitness tracking application where you can create and share your own training sessions.
+Copyright (C) 2026 [David Florance](http://kaivalya.eu)
+
+This program is free software: you can redistribute it and/or modify
+it under the terms of the GNU Affero General Public License as
+published by the Free Software Foundation, either version 3 of the
+License, or (at your option) any later version.
+
+This program is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+GNU Affero General Public License for more details.
+
+You should have received a copy of the GNU Affero General Public License
+along with this program. If not, see <http://www.gnu.org/licenses/>.
diff --git a/docs/decisions-log.md b/docs/decisions-log.md
new file mode 100644
index 0000000..904e2c7
--- /dev/null
+++ b/docs/decisions-log.md
@@ -0,0 +1,764 @@
+# Decisions Log
+
+Record of architectural and technical decisions made during development.
+
+## 2026-06-18 — Clear (×) button added to list search fields
+
+**Decision:** Added a clear button inside the search input on the four list views with a search bar (`ExerciseListView`, `ComboListView`, `SessionListView`, `CollectionsView`). The button (Bootstrap `bi-x-lg` icon) only renders when the field has a value, sits absolutely positioned inside the input (`padding-right` added to make room), and on click empties `searchQuery` and refocuses the input via a new `clearSearch()` function in each view. The click handler uses `@mousedown.prevent` instead of `@click` so the button doesn't steal focus from the input first (which would otherwise fire `onSearchBlur` while the field still holds its old, non-empty value). Added a shared i18n key `common.clearSearch` (EN/FR/DA) for its `title`/`aria-label` rather than per-entity keys, since the action is identical across all four views. Each view gets its own `data-testid="<entity>-search-clear"` to match the existing per-view `data-testid` convention for the search bar/input/toggle. The pattern is duplicated across the four `.vue` files rather than extracted into a shared component, consistent with how the rest of the search bar (debounce, toggle, blur-to-close) is already duplicated there.
+
+**Rationale:** Requested by the user as a small UX improvement — clearing the field previously required selecting and deleting the text manually, or toggling search off and back on (which also closes the bar). `@mousedown.prevent` was chosen over reordering the blur/clear logic because it's the standard idiom for "clear button inside a focused input" and avoids a state-machine edge case where blur could close the search bar before the field is cleared.
+
+## 2026-06-16 — "Add a New Theme" how-to now covers all supported languages
+
+**Decision:** Fixed `website/content/developers/how-to-guides.{en,fr}.md`'s "Add a New Theme" recipe, which only had the new contributor add the theme's display label to `en.json` and `fr.json` — missing `da.json`, even though Danish is a real, shipped language (same gap just fixed elsewhere in "Add a New Language", see the entry above). Merged the two language-specific steps into one ("add the display label in every supported language"), added the `da.json` example, noted that `i18next`'s `fallbackLng: 'en'` (from `src/i18n/index.js`) means a missing label degrades to English silently rather than erroring, and added a step in the smoke-test checklist to verify the label in all three languages before considering the theme done. Renumbered the touch-point list and step headings accordingly (6 steps → 5).
+
+**Rationale:** A theme contributed by following the old recipe would ship with a Danish UI silently showing an English theme name — a real, easy-to-miss gap given `fallbackLng` doesn't surface it as an error. Caught by the user immediately after the equivalent fix to "Add a New Language".
+
+## 2026-06-16 — Corrected language-count and COOP/COEP claims in developer docs
+
+**Decision:** Fixed two inaccuracies in `website/content/developers/how-to-guides.{en,fr}.md` and `technical.{en,fr}.md`, both inherited unchanged from the pre-split single-page `technical.en.md`:
+
+1. "Add a New Language" used Danish (`da`) as the worked example for a language being added, with an `// ← new` comment — misleading, since `da` is already a real, shipped locale (`src/i18n/locales/da.json`, registered in `src/i18n/index.js`, and selectable today in Settings per `src/views/SettingsView.vue`). Reworked the recipe to use Spanish (`es`) as the example instead, and added a note up front that TrainUs already ships three languages (English, French, Danish), not just the EN/FR pair the project website itself emphasizes. Also corrected the Reference page's "Available settings" table, which still listed the language selector as "(English / Français)" only.
+2. "Deploy TrainUs" stated the COOP/COEP headers **must** be present "or the browser blocks OPFS access" — contradicted by the same reference page's own §2 ("Does not require COOP/COEP headers") and by the R17 README correction (2026-06-12, see below). Reworded to match README's accurate framing: not strictly required by the `opfs-sahpool` VFS actually used, recommended as defense-in-depth, and the dev server already sets them as a precaution.
+
+**Rationale:** Both inaccuracies were latent in the original single-page `technical.en.md` and simply carried forward during the Diataxis split rather than introduced by it; the user caught them after reading the new how-to pages. Fixed in both languages since both were translated from the same (incorrect) source text.
+
+## 2026-06-16 — French developer documentation ported to the EN Diataxis split
+
+**Decision:** Ported the four-page developer docs Diataxis split (see the "English developer documentation split Diataxis-style" entry below) to French, completing the deferred follow-up: `getting-started.fr.md` (tutorial, slug `demarrage-rapide`), `how-to-guides.fr.md` (how-to, slug `guides-pratiques`), `technical.fr.md` (reference — replaced the old "moved to EN" stub with the full translated content, title changed from "Documentation technique" to "Référence" and weight corrected from 5 to 3 to match the EN page's position, mirroring `user-guide/index.fr.md`'s "Référence" title), `understanding-the-architecture.fr.md` (explanation, slug `comprendre-l-architecture`). Basenames match the EN files for Hugo's translation pairing (confirmed via the language switcher rendering correctly on each page); French-friendly URLs come from `slug:` front matter, the same technique used for the EN user-docs port. Internal cross-page anchors (e.g. `technical.fr.md#1-architecture`, `how-to-guides.fr.md#déployer-trainus`) were verified against Hugo's actual generated heading IDs after a full `hugo --minify` build — no `REF_NOT_FOUND` and no broken anchors.
+
+**Rationale:** The English split was done first specifically because the project already had two real how-to documents in English; with that done and validated, finishing the French side closes out the deferred TODO in `docs/website-plan.md` §8.1 and brings developer docs to parity with user docs (both now fully bilingual, 4-page Diataxis splits).
+
+## 2026-06-16 — English developer documentation split Diataxis-style
+
+**Decision:** Restructured the English developer documentation from a single page (`website/content/developers/technical.en.md`) into a four-page Diataxis split, mirroring the structure already used for user docs: `getting-started.en.md` (tutorial — new content: prerequisites, clone/install/dev, a one-line-per-folder tour of `src/`, running the Playwright suite, and one small guided edit to close the dev loop before sending the reader to the how-to page), `how-to-guides.en.md` (how-to — four recipes: "Add a New Language" and "Add a New Theme" ported from the pre-existing `docs/how-to-add-a-language.md` and `docs/how-to-add-a-theme.md`, plus two new recipes, "Deploy TrainUs" extracted from the old §7 and "Add a Database Migration" synthesized from the old §2/§6 narrative into actual steps), `technical.en.md` (reference — kept the filename/weight-3 slot, trimmed of rationale prose and the deploy header recipes, otherwise unchanged: tech stack, project structure, schema, ER diagram, composables, the full §3 feature-by-feature description, routing, i18n, versioning, build commands, Annex A), and `understanding-the-architecture.en.md` (explanation — new: why no backend, why SQLite runs in a Worker, why the `opfs-sahpool` VFS with no fallback, why the migration system is designed the way it is, plus a condensed pass over a handful of notable per-feature design decisions — the save dialog vs. native picker, partial logs on exit, asymmetric side-flip strategies, per-combo-type rounds calculation — and the content-width-cap rationale). The two superseded `docs/how-to-add-a-*.md` files were replaced with "moved to the website" stubs, matching the existing pattern for `docs/technical-documentation.md` / `docs/user-documentation.md` (whose own stub was also corrected — it still pointed at the pre-split `website/content/docs/technical.en.md` path). `docs/release-procedure.md` and `AGENTS.md`'s Definition of Done checklist had the same stale path and were updated to `website/content/developers/technical.en.md` / `website/content/docs/user-guide/index.en.md`.
+
+French (`technical.fr.md`) is **not** restructured in this step — the user explicitly asked to start with English, since the existing how-to content was already English-only. Porting the split to French is left for later, the reverse order of how the user docs split was done (FR first, then EN).
+
+**Rationale:** The user-docs Diataxis split improved discoverability enough that the same treatment was requested for developer docs. Reusing the two pre-existing, real how-to documents as the seed for the how-to page (rather than writing recipes from scratch) kept the content grounded in material the project owner had already written and validated, and matches the precedent of `docs/technical-documentation.md`/`docs/user-documentation.md` being retired into stubs once their content moved to the website.
+
+## 2026-06-16 — English user documentation ported to the FR Diataxis split
+
+**Decision:** Restructured the English user documentation from a single page (`user-guide.en.md`) into the same four-page Diataxis split already used for French (see the 2026-06-16 "French user documentation split Diataxis-style" entry below): `demarrage-rapide/index.en.md` (tutorial — what TrainUs is, local-first principles and trade-offs, GUI overview, the two modes; also kept the browser-requirements and PWA-install note that used to open the old single-page guide, since that's tutorial-appropriate content), `guides-pratiques.en.md` (how-to — same six recipes as the FR page, written natively rather than translated literally), `user-guide/index.en.md` (reference — the existing EN content reordered to match the FR section order, with the EMOM/AMRAP/TABATA combo screenshots and a Markdown cheat-sheet appendix added, both previously FR-only), and `comprendre.en.md` (explanation — why local-first, JSON vs SQLite, import behaviour, timer logic). The reference page kept the `user-guide` bundle name (no language-specific renaming) so it still pairs as a Hugo translation with `user-guide/index.fr.md`; the other three pages also share their basename with the FR files for the same reason, but get an English-friendly rendered URL via `slug:` front matter (`/en/docs/getting-started/`, `/en/docs/how-to-guides/`, `/en/docs/understanding-trainus/`) instead of inheriting the French words. Screenshots are genuinely English-UI captures (not reused FR images) — generated via `scripts/screenshots/all_pages.py --lang en` and `scripts/screenshots/combo_timers.py --lang en`, which already supported a `--lang` flag added during the FR work specifically for this future EN port.
+
+**Rationale:** The FR rewrite's decision log explicitly deferred this ("English documentation is **not** restructured ... porting it to the same split is left for later"); the user asked for that follow-up now that they're happy with the FR result. Reusing the FR page structure (rather than re-deriving an EN-specific organization) keeps the two languages structurally interchangeable, which matters for the lang-switcher and for anyone maintaining both versions going forward. English slugs were chosen over French-derived ones because the rendered URL is user-facing and worth getting right, while the underlying filename is purely an internal pairing mechanism Hugo already required to match.
+
+## 2026-06-16 — Corrected user-guide claims about delete cascade behaviour
+
+**Decision:** Fixed `website/content/docs/user-guide.en.md` and `website/content/docs/user-guide/index.fr.md`: the "Deleting a Session" section wrongly claimed execution history is "preserved" with a "missing session reference" after deleting a session — that described the `ON DELETE SET NULL` alternative considered (and rejected) in R15 of `docs/improvement-plan.md`, not the cascade behaviour actually shipped. Corrected both pages to state that deleting a session also permanently deletes its execution history, and that the confirmation dialog shows the affected count beforehand. Also added the equivalent missing detail to "Deleting an Exercise" (EN had no mention of history impact at all; FR already had a partial note, now aligned with the same confirm-count wording). No code changed — `src/db/schema.js` keeps `ON DELETE CASCADE` on `execution_log.session_id` and `execution_log_item.exercise_id`, confirmed still in effect via a live Playwright/Firefox check against the actual app.
+
+**Rationale:** R15 (`docs/improvement-plan.md`, implemented, see `docs/plan.md` R15 row) chose the "minimum" fix — count-aware confirm dialogs (`exercises.deleteConfirmWithHistory` / `sessions.deleteConfirmWithHistory`) — over the more invasive `SET NULL` schema change, but the user-guide was never updated to match and kept describing the rejected option. Leaving it as-is would mislead users into believing deleted sessions' history survives.
+
+---
+
+## 2026-06-16 — Separate user docs and developer docs into two Hugo sections
+
+**Decision:** Replaced the `audience: "user"|"contributor"` front matter tag (added earlier the same day, see entry below) with an actual structural split: contributor docs moved from `website/content/docs/` to a new `website/content/developers/` section (`technical.fr.md`, `technical.en.md`, unchanged content), each with its own top-level nav entry — "Documentation" / "Développeurs" (FR) and "Documentation" / "Developers" (EN) in `hugo.toml`. The `audience` field is now redundant (the section itself is the signal) and was removed from all six docs/developers pages. The shared list rendering (sort by weight, front-matter description, top-level heading preview) was extracted from `layouts/docs/list.html` into `layouts/partials/doc-list.html` so the new `layouts/developers/list.html` doesn't duplicate it. `content/docs/_index.*.md` descriptions were updated to drop the now-inaccurate "technical reference" mention; new `content/developers/_index.fr.md` / `_index.en.md` were added.
+
+**Rationale:** A front-matter tag with no visible effect doesn't actually separate the two audiences for a visitor — landing on `/docs/` still mixed user guides with technical/architecture content under one menu link. Two sections with distinct nav entries make the split obvious without requiring readers to know the tag exists. Nothing was deployed yet, so breaking the old `/docs/technical...` URLs has no cost.
+
+---
+
+## 2026-06-16 — French user documentation split Diataxis-style
+
+**Decision:** Rewrote the French user documentation (previously a stub redirecting to the English page) as four pages under `website/content/docs/`: `demarrage-rapide/` (tutorial — local-first principles, GUI overview, the two modes), `guides-pratiques.fr.md` (how-to — sending a session to a friend, importing JSON, backing up data, syncing two devices, Yoga/running tips), `user-guide/` (reference — kept this filename for continuity with `user-guide.en.md`; full screen-by-screen description, keyboard shortcuts, a Markdown cheat-sheet table), and `comprendre.fr.md` (explanation — why local-first, JSON vs SQLite, how EMOM/AMRAP/TABATA timers work). Added `audience: "user"` / `"contributor"` front matter on all docs pages as a foundation for future audience tagging (no visual badge built yet). The two pages with screenshots (`demarrage-rapide/`, `user-guide/`) are Hugo leaf bundles (`index.fr.md` + images alongside) so image references stay relative, avoiding the `baseURL` prefix bug that affects absolute `/static/...` paths. `website/layouts/docs/list.html` already sorts by `.Pages.ByWeight`, so the five FR docs pages order correctly without further changes. English documentation is **not** restructured — `user-guide.en.md` stays a single page; porting it to the same split is left for later.
+
+Screenshots were generated with `scripts/screenshots/all_pages.py` (fixed: it hung on the native `window.confirm()` shown when leaving an in-progress execution screen — added a `page.on("dialog", ...)` auto-accept handler; also added a `--lang en|fr` flag so screenshots can be captured in either UI language) and a new `scripts/screenshots/combo_timers.py` script (seeds an EMOM and a TABATA combo to capture the EMOM/TABATA running screens and the TABATA rest screen, none of which `all_pages.py` covers since it only seeds an AMRAP combo).
+
+**Rationale:** `docs/specification.md`'s "Réécriture Documentation" chapter asked for a Diataxis-inspired structure distinguishing contributor vs. user docs, and explicitly requested the two new how-to guides (backup, device sync) plus combo timer screenshots including the TABATA rest screen. Page bundles were chosen over `static/` to sidestep a known baseURL bug rather than fix it as part of an unrelated doc change. The reference page kept the `user-guide` filename (vs. renaming to something Diataxis-flavored) to preserve the Hugo translation pairing with `user-guide.en.md` and avoid touching `AGENTS.md`'s named deliverable.
+
+---
+
+## 2026-06-12 — Single deployment + startup DB migration (Step 16)
+
+**Decision:** Replaced the "versioned deployments with isolated data" model. The latest build is deployed alone at the site root, the OPFS database lives at a stable location (`.trainus` directory, no app-version suffix), and schema changes are applied by an automatic migration step at startup. The `RELEASES` registry (`src/db/releases.js`) is the single source of truth: `adaptScript` was renamed `migrationScript` (one SQL script per `schemaVersion` bump) and is shared by the startup migration and the restore-adaptation pipeline. Each migration runs in a transaction together with its `schema_version` stamp; on failure it rolls back and the app shows a blocking error. Before any migration runs, a blocking screen forces the user to download a backup — the Update button is enabled only after the download. A DB newer than the app (`dbVersion > SCHEMA_VERSION`) fails safe with a blocking `DB_NEWER_THAN_APP` error, data untouched. Existing `.trainus-x.y.z` directories are orphaned on purpose (nothing has shipped). `SCHEMA_VERSION` stays at 1.
+
+**Rationale:** OPFS is _origin_-scoped, not path-scoped, so versioned deployment folders never truly isolated data — they only added deployment complexity while orphaning user data on every release, even without a schema change. The restore pipeline already paid the migration-code cost; reusing its scripts for startup migration removes the manual backup/restore UX on updates. Transactions guarantee a failed migration leaves the DB at the previous version; the forced pre-migration backup covers semantic corruption.
+
+---
+
+## 2026-06-09 — License display: dialog instead of dedicated page
+
+**Decision:** Replaced the `/license` route and `LicenseView.vue` page with a stacked modal approach. The About dialog now shows the notice text inline (rendered as Markdown from `src/assets/notice.md?raw`) and an added **License: GNU AGPL v3** row. Clicking "View License" opens `LicenseDialog.vue` on top of the About dialog; closing it returns to About without any navigation.
+
+**Rationale:** A full page navigation broke the "About" context and was disproportionate for legal text. A stacked modal keeps the user in place, matches the existing modal pattern, and the full license text is still bundled offline via `src/assets/license.md?raw`.
+
+---
+
+## 2026-06-08 — License: GNU AGPL v3
+
+**Decision:** The project is licensed under the **GNU Affero General Public License v3 (AGPL v3)**. The full license text is in `LICENSE.md` at the repository root and `src/assets/license.md` (bundled offline via Vite `?raw`). The copyright notice is in `notice.md` / `src/assets/notice.md`. Contact: trainus.steadfast012@passmail.net.
+
+**Rationale:** AGPL v3 ensures that any modified version of the app served over a network must also publish its source. Bundling both files into the JS build guarantees offline availability, consistent with the PWA-first philosophy.
+
+---
+
+## 2026-06-08 — About dialog added to Settings
+
+**Decision:** Added an **About TrainUs** card at the bottom of the Settings page. Clicking it opens `AboutDialog.vue`, a modal that displays the app version (`__APP_VERSION__`), the DB schema version (`SCHEMA_VERSION`), the author (David Florance), placeholder links for the repository and website, and a disabled "View License" button with a "License to be determined." note.
+
+**Rationale:** Centralises version and authorship information in a discoverable place without cluttering the main UI. Placeholder links and the disabled license button provide the correct structure now so they can be filled in once the repository is published and a license is chosen, requiring only a URL swap rather than a structural change.
+
+---
+
+## 2026-06-07 — EMOM repetitions semantics corrected
+
+**Decision:** For EMOM combo items in a session, `repetitions` now means **total duration in minutes** (not number of rounds). The queue builder computes `totalRounds = floor(repetitions / numExercises)`, so each exercise still occupies exactly one 60-second slot and the total execution time equals `repetitions` minutes. The session form now labels the field **Duration (min)** for EMOM items, consistent with AMRAP.
+
+**Rationale:** The previous behaviour (`totalRounds = repetitions`) made the total EMOM duration grow with the number of exercises in the combo, which was counter-intuitive and inconsistent with how AMRAP works. Users think in minutes when setting up a timed workout. The new formula keeps the interface label and the actual timer duration consistent.
+
+---
+
+## 2026-06-07 — Home page: history section, inline exercise summaries, HTML export
+
+**Decision:**
+
+- Increased recent sessions from 3 to 4.
+- Added a **History section** below recent sessions: all execution logs loaded at mount, grouped by calendar day (descending), filtered client-side by two date pickers (default last 30 days). No extra DB query on filter change.
+- Each session card (recent and history) now shows an inline compact summary of exercises performed (reps, weight, timing) and a **play button (▶)** to re-execute.
+- Added a **HTML export button** in the action bar (visible only when data exists) via `useHtmlExport.js`. The generated file is fully self-contained: app icon embedded as base64, inline CSS, no external dependencies. Play buttons, navigation links, and date pickers are excluded from the export.
+
+**Rationale:** The history section turns the home page into a lightweight training journal without a dedicated log view. Client-side filtering avoids extra DB queries on every date change. The HTML export provides a shareable, printable snapshot of activity that works in any browser without the app.
+
+---
+
+## 2026-06-02 — Add Danish locale
+
+**Decision:** Added Danish (`da`) as a supported UI language, with a full translation of all keys in `src/i18n/locales/da.json`, registered in `src/i18n/index.js`, and selectable via the Settings language dropdown.
+
+**Rationale:** Demonstrates the language addition workflow described in `docs/how-to-add-a-language.md` and broadens the app's reach to Danish speakers.
+
+---
+
+## 2026-06-02 — Test fixture strategy for import/export tests
+
+**Decision:** Static JSON files in `tests/fixtures/` for cross-user scenarios with fixed IDs; dynamic construction (via `page.evaluate`) for same-user roundtrip scenarios.
+
+**Rationale:** Cross-user tests require known, stable UUIDs so assertions can reference them directly — a static file is self-documenting and removes multi-line `json.dumps` blocks from test code. Same-user roundtrip tests need the live `user_uuid` from the browser DB at test time, so they must be built dynamically. Two fixture files: `cross_user_id_collision.json` (extracted from the existing combo FK test) and `cross_user_full.json` (exercises + combo + session with both exercise and combo items + collection + execution log, all referencing fixture UUIDs in the `facade00-*` range).
+
+---
+
+## 2026-05-31 — Add TrainUs theme
+
+**Decision:** Add a third theme ("TrainUs") that uses the app logo colours — blue `#1E7FC0` (navbar, primary button, input border) and teal `#12A892` (action bar, hover state, success colour) — on a light blue-tinted background.
+
+**Rationale:** Provides a branded colour experience beyond the generic light/dark pair, matching the visual identity already present in the SVG icon.
+
+---
+
+## 2026-05-26 — Step 10: PWA Finalization & Polish
+
+### Service worker: vite-plugin-pwa (Workbox) over hand-rolled sw.js
+
+- **Context:** The original `public/sw.js` used `self.__APP_VERSION__` which Vite never substitutes in a plain static file, causing the cache name to always fall back to `1.0.0`. No precaching meant the app did not work offline.
+- **Decision:** Replace with `vite-plugin-pwa` + Workbox. `registerType: 'autoUpdate'` silently activates new SW versions. `maximumFileSizeToCacheInBytes: 10 MB` to cover `sqlite3.wasm`. `manifest: false` to keep our hand-authored `public/manifest.json`.
+- **Rationale:** Workbox handles content-hash-based cache busting automatically; the app shell and WASM binary are all precached at install time, enabling true offline support.
+
+### Install prompt: composable singleton + action bar button
+
+- **Context:** The `beforeinstallprompt` event must be captured at page load, before it fires.
+- **Decision:** Module-level event listeners in `useInstallPrompt.js` (singleton ref `canInstall`). `InstallPrompt.vue` teleports a download icon + dismiss × into the action bar when `canInstall` is true; dismissed for the session only (no persistence needed).
+- **Rationale:** Singleton ensures the event is captured regardless of when the composable is called. Session-only dismiss avoids noisy storage writes; user will see it again on next visit if they haven't installed.
+
+### Accessibility scope: targeted, not exhaustive
+
+- **Context:** "ARIA labels, keyboard nav, focus management" could mean auditing every component.
+- **Decision:** Focus on critical flows — navigation, all forms, execution stepper, modal dialogs. Every icon-only actionbar button across all views also gets `aria-label` (mechanical addition of 1 attribute per button).
+- **Rationale:** Screen reader coverage for the flows a user actually executes is more valuable than a theoretical full audit. Full ARIA audit deferred to Step 11.
+
+## 2026-05-26 — Step 9: Statistics
+
+### Chart library: Chart.js 4 + vue-chartjs 5
+
+- **Context:** Plan specified Chart.js via vue-chartjs; needed Vue 3 Composition API support.
+- **Decision:** `chart.js@^4` + `vue-chartjs@^5`. Registered only the needed Chart.js components (tree-shaking) in `StatsView.vue` rather than globally.
+- **Rationale:** vue-chartjs 5 is the Vue 3-compatible major version; registering locally avoids side effects in other routes that don't use charts.
+
+### Streak calculation: UTC midnight for date comparison
+
+- **Context:** SQLite `DATE(started_at)` extracts the UTC calendar date from ISO-8601 timestamps. JavaScript `new Date().setHours(0,0,0,0)` uses local time, creating a mismatch in non-UTC timezones.
+- **Decision:** Use `setUTCHours(0,0,0,0)` and `toISOString().slice(0,10)` for streak iteration.
+- **Rationale:** Ensures the JS streak walk and the SQLite date grouping use the same calendar boundary; avoids streak being under-reported by one day in timezones ahead of UTC.
+
+### Volume metric: reps × weight
+
+- **Context:** Need a single "effort" number per session to chart over time.
+- **Decision:** Volume = `SUM(reps_done × weight_used)` for completed items. Bodyweight exercises (weight=0) contribute 0, so the chart only shows weight-bearing volume.
+- **Rationale:** Standard fitness volume definition; keeps the metric meaningful. Users can still track bodyweight frequency via the Frequency chart.
+
+### Statistics export: deferred to Step 9b
+
+- **Context:** User requested statistics export be planned.
+- **Decision:** Defer CSV/summary export to Step 9b; not included in Step 9.
+- **Rationale:** Step 9 scope is already substantial; export logic is independent and can be added without touching existing stats code.
+
+## 2026-03-10 — Initial Decisions
+
+### Framework: Vue 3 + Vite
+
+- **Context:** App has complex CRUD forms, reactive i18n/theme, timers, drag-reorder, charts.
+- **Decision:** Vue 3 with Composition API over Vanilla JS.
+- **Rationale:** Vanilla JS would require reinventing reactivity and component lifecycle. Vue provides reactive data binding, composables, and a rich ecosystem while staying lightweight.
+
+### i18n: i18next + i18next-vue
+
+- **Context:** Spec requires multi-language support, easy to translate.
+- **Decision:** Use i18next (open-source, MIT) rather than a custom solution.
+- **Rationale:** Proven library with JSON locale files, pluralization, interpolation, reactive Vue integration.
+
+### Database: Official SQLite WASM + OPFS
+
+- **Context:** Spec requires SQLite with OPFS persistence, local-first.
+- **Decision:** Official SQLite WASM build with OPFS VFS.
+- **Rationale:** Best maintained, native OPFS support, Apache-licensed.
+
+### App version strategy
+
+- **Context:** Need version at build time (OPFS namespacing, SW) and runtime (export metadata).
+- **Decision:** Source of truth in `package.json`, injected by Vite `define`, stored in DB `settings` on init.
+
+### Single user per device
+
+- **Context:** Spec says one user per device.
+- **Decision:** No `users` table. UUID + name stored in `settings` key/value table.
+
+### Charts: Chart.js via vue-chartjs
+
+- **Context:** Statistics page needs progression, volume, frequency charts.
+- **Decision:** Chart.js — good balance of features (~60KB gzipped) and ease of use.
+
+### Routing: Hash mode
+
+- **Context:** App deployed as static files, no server-side routing control.
+- **Decision:** Vue Router with `createWebHashHistory()`.
+- **Rationale:** Hash routes (`#/home`) work without server configuration.
+
+### ID collision on import: UUID prefix
+
+- **Context:** Users exchange data files; IDs may collide.
+- **Decision:** When imported entity ID exists and belongs to a different user (by UUID), prefix imported ID with source user's short UUID (first 8 chars).
+
+---
+
+## 2026-03-13 — Step 1: Database Layer
+
+### OPFS VFS: SAH Pool over standard OPFS
+
+- **Context:** Two OPFS VFS options available: standard `opfs` VFS (requires sub-worker + SharedArrayBuffer) and `opfs-sahpool` (SyncAccessHandle pool).
+- **Decision:** Use `opfs-sahpool` VFS.
+- **Rationale:** Highest performance, works on all major browsers since March 2023, no COOP/COEP requirement (though we have them), simpler architecture (no sub-worker). Trade-off: no concurrent connections, which is fine for a single-user PWA.
+
+### Worker-based architecture
+
+- **Context:** OPFS APIs are only available in Web Worker threads.
+- **Decision:** Run SQLite in a dedicated Web Worker (`src/db/worker.js`), communicate from main thread via `postMessage()` with Promise-based wrappers.
+- **Rationale:** Clean separation of concerns, non-blocking main thread, required by OPFS.
+
+### Table naming: `collection` instead of `group`
+
+- **Context:** `GROUP` is a SQL reserved keyword. Originally named `grp`, but that was confusing.
+- **Decision:** Rename `grp` → `collection` and `group_session` → `collection_session`.
+- **Rationale:** `collection` clearly describes a set of sessions without SQL keyword conflicts.
+
+### WASM file serving strategy
+
+- **Context:** The `sqlite3.wasm` binary must be accessible at a known URL for the worker to load it.
+- **Decision:** Copy to `public/` via a Vite plugin (`copySqliteWasm`), serve at `/sqlite3.wasm`. Added to `.gitignore`.
+- **Rationale:** Works identically in dev and production. No complex asset pipeline needed.
+
+### Repository + composable pattern
+
+- **Context:** Need CRUD access from Vue components through an async worker-based DB.
+- **Decision:** Two layers — repositories (pure async CRUD) and composables (reactive `ref` wrappers).
+- **Rationale:** Repositories are reusable outside Vue (e.g., import/export). Composables provide reactive state for components. Clean separation per SOLID.
+
+### No in-memory fallback — block app if OPFS unavailable
+
+- **Context:** Originally the worker fell back to `:memory:` if OPFS was unavailable, meaning data would be silently lost on browser close.
+- **Decision:** Remove the fallback. If OPFS init fails, propagate the error and display a full-screen error message asking the user to update their browser or exit private browsing.
+- **Rationale:** Silent data loss is worse than a clear error. OPFS is supported on all major browsers since March 2023 (Firefox 111, Chrome 102, Safari 16.4). The only realistic failure cases are private browsing mode or very outdated browsers.
+
+### Loading screen during DB initialization
+
+- **Context:** Database initialization is async and may take a moment.
+- **Decision:** Block the app with a spinner overlay until the DB is ready. Three states: loading → ready → error.
+- **Rationale:** Prevents users from interacting with the app before data is available.
+
+### Rename `asymmetric_mode` to `alternate`
+
+- **Context:** The `asymmetric_mode` TEXT field was vague. The intent is a boolean: should the exercise alternate sides at each repetition?
+- **Decision:** Replace `asymmetric_mode TEXT` with `alternate INTEGER NOT NULL DEFAULT 0` (boolean, 0/1).
+- **Rationale:** Simpler, clearer semantics. Boolean stored as INTEGER per SQLite convention.
+
+### COMBO type: added NONE
+
+- **Context:** Combos can be SUPERSET, CIRCUIT, or EMOM, but standalone exercises (not grouped) also appear as session items.
+- **Decision:** Add `'NONE'` as a valid combo type.
+- **Rationale:** Allows a "combo" of a single exercise, simplifying session item management — every item is a combo reference.
+
+### Session item repetitions
+
+- **Context:** A session may include the same combo/exercise multiple times (e.g., 3 rounds of a circuit).
+- **Decision:** Add `repetitions INTEGER NOT NULL DEFAULT 1` to `session_item`.
+- **Rationale:** Avoids duplicating rows for repeated items. Keeps data normalized.
+
+### Home page: activity summary instead of collection list
+
+- **Context:** Originally the Home page was the collection list.
+- **Decision:** Home shows last 3 executed sessions and session counts for the last 7/30 days.
+- **Rationale:** More useful landing page — quick overview of recent activity.
+
+### Collections get their own page
+
+- **Context:** Collections were displayed on the Home page.
+- **Decision:** Move collections to a dedicated route (`#/collections`) with its own nav link.
+- **Rationale:** Cleaner information architecture. Home focuses on activity summary.
+
+---
+
+## 2026-03-15 — Step 2: Settings
+
+### Settings page: v-model for select elements
+
+- **Context:** Using `:value` binding on `<select>` elements did not properly update the selected option when the reactive value changed.
+- **Decision:** Switch to `v-model` for all form inputs (select, text input).
+- **Rationale:** Vue 3's `v-model` handles two-way binding on native form elements correctly. `:value` alone doesn't reliably drive `<select>` option selection.
+
+### App shell: guard content behind DB readiness
+
+- **Context:** The `<div class="content">` section (containing `<router-view>`) was outside the `v-if/v-else` chain in `App.vue`, so views mounted before the DB was ready. This caused `onMounted` hooks in views to fail when calling DB queries.
+- **Decision:** Wrap both `<nav>` and `<div class="content">` inside a `<template v-else>` block, so the entire app shell only renders after DB initialization completes.
+- **Rationale:** Prevents race conditions where components query the DB before it's ready. The loading overlay already covers the screen during initialization.
+
+### Settings startup restoration in main.js
+
+- **Context:** Language and theme settings must be applied before the first render to avoid a flash of default values.
+- **Decision:** Read `language` and `theme` from the DB during the `db.init()` promise chain, before setting `data-db-ready`. Apply `i18next.changeLanguage()` and `data-theme` attribute before the Vue app renders.
+- **Rationale:** Eliminates visual flash of English text or light theme when the user has a different preference. Settings are available synchronously when components mount.
+
+### Code formatting: Prettier
+
+- **Context:** No code formatter was configured. Inconsistent formatting across files.
+- **Decision:** Add Prettier with `semi: false`, `singleQuote: true`, `trailingComma: "all"`, `printWidth: 100`.
+- **Rationale:** Enforces consistent formatting automatically. No semicolons and single quotes align with Vue ecosystem conventions. `format:check` script can be used in CI.
+
+### Export/Import: disabled placeholder
+
+- **Context:** Settings page needed Export/Import buttons, but the feature is planned for Step 7.
+- **Decision:** Show disabled buttons with a "coming soon" message.
+- **Rationale:** Establishes the UI structure early without implementing the feature prematurely.
+
+---
+
+## 2026-03-25 — Step 3b Planning: Exercise JSON Export/Import
+
+### New step: Step 3b — Exercise JSON Export/Import
+
+- **Context:** Exercise management (Step 3) would benefit from immediate export/import capability. Waiting until Step 7 (full data export) delays useful functionality. Exercises have no foreign key dependencies, making them the simplest entity to start with.
+- **Decision:** Add Step 3b after Step 3 to build the JSON export/import infrastructure on exercises first. The full metadata envelope format is implemented now (`appName`, `appVersion`, `schemaVersion`, `exportDate`, `exportedBy`). Step 7 then extends this to all entities.
+- **Rationale:** Incremental validation of the export/import pattern on the simplest entity. Infrastructure is reusable in Step 7 without rewriting.
+
+### ID collision strategy: suffix on title instead of UUID prefix on ID
+
+- **Context:** Original plan (Step 7) prefixed the internal ID with the source user's 8-char UUID on collision. This breaks alphabetical ordering of entity titles and is not visible to the user in the UI.
+- **Decision:** On collision with a different user (`created_by` differs), generate a fresh UUID and rename the title to `"Original Title from SUFFIX"`. The suffix is prompted to the user, pre-filled with the exporter's `name` from JSON metadata. Same-user collisions offer Replace/Skip instead.
+- **Rationale:** User-visible naming, preserves alphabetical sort order, flexible suffix, clear data provenance. Distinguishing same-user (Replace/Skip) from different-user (suffix) avoids unnecessary prompts for re-imports.
+
+### Export/Import UI: three locations
+
+- **Context:** Need to decide where export/import controls are placed in the UI.
+- **Decision:** Wire buttons into three locations: exercise list view (bulk), exercise detail view (single export), and Settings page (with entity filter dialog — only "Exercises" active in Step 3b, others disabled with "Coming soon").
+- **Rationale:** List view covers bulk operations, detail view enables sharing a single exercise, Settings page provides a centralized data management hub that scales to all entities in Step 7.
+
+### Download Database (raw SQLite file)
+
+- **Context:** Users need a way to back up their data as a raw database file.
+- **Decision:** Add a "Download Database" button that exports the SQLite database using `sqlite3_js_db_export()` and triggers a browser download of the `.sqlite3` file.
+- **Rationale:** Simple, reliable backup mechanism. The exported file is a standard SQLite database that can be restored or inspected with any SQLite tool.
+
+### Restore Database: `sqlite3_deserialize` over `sqlite3_js_db_import`
+
+- **Context:** Need to import a `.sqlite3` file back into the running OPFS database. The obvious choice `sqlite3_js_db_import` does not exist in sqlite-wasm v3.51.2-build7.
+- **Decision:** Use `sqlite3.capi.sqlite3_deserialize()` to load the uploaded file into a temporary `:memory:` DB, then validate and copy table by table into the production DB.
+- **Rationale:** `sqlite3_deserialize` is available through the CAPI and works reliably. Loading into `:memory:` first allows full validation before touching production data.
+- **Implementation notes:** Requires manual WASM heap allocation: `wasm.alloc(n)` + `wasm.heap8u().set(bytes, ptr)` + deserialize with `FREEONCLOSE | RESIZEABLE` flags.
+
+### Restore Database: validation pipeline with version compatibility
+
+- **Context:** Restoring arbitrary files into the production DB is risky — the file could be corrupted, incomplete, or from an incompatible schema version.
+- **Decision:** Multi-step validation pipeline: (1) deserialize into `:memory:`, (2) check required tables, (3) compare schema versions, (4) run compatibility check with potential adapt scripts, (5) table-by-table copy inside a transaction.
+- **Rationale:** Each step catches a specific failure mode with a clear error code. The transaction ensures atomicity — if any table fails to copy, the entire operation is rolled back.
+
+### Release registry (`src/db/releases.js`)
+
+- **Context:** Need to track schema compatibility between database versions for the restore flow.
+- **Decision:** A `RELEASES` array where each entry declares `schemaVersion`, `appVersion`, `dbBreak` (boolean), and `adaptScript` (SQL or null). A `checkCompatibility()` function walks the release history to determine if migration is possible.
+- **Rationale:** Single source of truth for version compatibility. The `dbBreak` flag provides an explicit signal for breaking schema changes. Adapt scripts allow incremental migration without rejecting slightly older databases.
+
+### Restore UI: in-place update instead of page reload
+
+- **Context:** After a successful database restore, the UI needs to reflect the restored data (e.g., username, language, theme).
+- **Decision:** After restore, re-fetch settings from the DB and apply language/theme changes in-place. No `window.location.reload()`.
+- **Rationale:** Page reload would lose the restore report. In-place update provides better UX — the user sees the report and the restored settings simultaneously.
+
+### Restore report with translated error codes
+
+- **Context:** The restore flow can fail in multiple ways (invalid file, incomplete DB, incompatible version, etc.).
+- **Decision:** Return a structured report object from the worker and display it in a dedicated card with translated error codes.
+- **Rationale:** Specific error messages help users understand what went wrong. Translation keys follow the pattern `settings.restoreErrorCodes.{CODE}` for easy i18n.
+
+---
+
+## 2026-03-27 — Step 2b: Schema Hardening & Documentation Restructuring
+
+### UNIQUE constraints on entity titles
+
+- **Context:** Entity tables (`exercise`, `combo`, `session`, `collection`) allowed duplicate titles, which would cause confusion in lists and during import/export collision resolution.
+- **Decision:** Add `UNIQUE` constraint on `exercise.title`, `combo.title`, `session.title`, and `collection.label` directly in the schema (no version bump — app not yet released).
+- **Rationale:** Enforces data integrity at the database level. Prevents the need for application-level deduplication logic. Since the app hasn't been released yet, this is a safe in-place change.
+
+### Suffix table for import disambiguation
+
+- **Context:** When importing data from another user, title collisions need resolution. The chosen strategy appends a suffix to imported titles (e.g., `"Push-ups [JD]"`). Need to persist the mapping between external user UUIDs and their assigned suffixes.
+- **Decision:** Add a `suffix` table: `user_uuid TEXT PRIMARY KEY, user_name TEXT NOT NULL, suffix TEXT NOT NULL UNIQUE`. This is part of the v1 schema (no version bump).
+- **Rationale:** Persisting suffixes ensures consistency across multiple imports from the same user. The UNIQUE constraint on `suffix` prevents two users from having the same tag. The table also serves as a registry of known external users.
+
+### Documentation file renaming
+
+- **Context:** `docs/technical-overview.md` and `docs/user-guide.md` had names that didn't match the conventions described in `AGENTS.md` (`technical-documentation.md`, `user-documentation.md`).
+- **Decision:** Rename the files to match the canonical names and update all references across the project (README.md, AGENTS.md, .opencode/ configs, commands).
+- **Rationale:** Consistent naming reduces confusion when the project conventions reference `technical-documentation.md` but the actual file is `technical-overview.md`.
+
+### README documentation section with bilingual tutorial links
+
+- **Context:** The README had a minimal documentation section with only 4 links and no reference to tutorials or codelabs.
+- **Decision:** Restructure the section into "Project" (all doc files with descriptions) and "Tutorials" (table with en/fr links for each step).
+- **Rationale:** Makes all documentation discoverable from the README. Bilingual links using `(en / fr)` format are concise and match the project's dual-language approach.
+
+---
+
+## 2026-03-28 — Step 3: Exercise Management (Edit Mode)
+
+### Action bar buttons via Vue Teleport with `defer`
+
+- **Context:** The action bar is defined in `App.vue` but individual views need to inject their own buttons (New, Search, Edit, Delete, Back).
+- **Decision:** Add a `<div id="actionbar-actions">` target in `App.vue`. Views use `<Teleport to="#actionbar-actions" defer>` to inject buttons.
+- **Rationale:** Keeps the action bar shell in `App.vue` while letting each view own its buttons. The `defer` attribute (Vue 3.5+) is critical — it resolves the Teleport target in the next render cycle, avoiding the race condition where the target doesn't exist yet when the component mounts within a `v-else` block.
+
+### Validation utility module
+
+- **Context:** Exercise form needs field validation (required, min value, URL format). Future entity forms will need the same validators.
+- **Decision:** Create `src/utils/validation.js` with reusable validation functions (`validateRequired`, `validateMin`, `validateUrl`) that return i18n error keys.
+- **Rationale:** DRY approach — validators are decoupled from components and return translation keys instead of hardcoded strings, making them language-independent. Reusable across all future entity forms.
+
+### Three exercise views instead of one
+
+- **Context:** Exercises need list, create/edit, and detail views. Could use a single view with conditional rendering or multiple dedicated views.
+- **Decision:** Three separate views: `ExerciseListView.vue` (list + search), `ExerciseFormView.vue` (create/edit, distinguished by route name), `ExerciseDetailView.vue` (read-only + media).
+- **Rationale:** Single Responsibility Principle. Each view has one purpose. The form view handles both create and edit via `route.name` check, reducing duplication while keeping concerns separate.
+
+### Search with debounced reactive filtering
+
+- **Context:** Exercise search needs to filter the list as the user types.
+- **Decision:** Use a `watch` on the search query with a 250ms `setTimeout` debounce, calling the repository's `search()` method (server-side SQL `LIKE` filter).
+- **Rationale:** Debouncing prevents excessive database queries on every keystroke. The SQL `LIKE` query is performed in the worker thread, keeping the main thread responsive. Clearing the search input triggers `fetchAll()` to restore the full list.
+
+### YouTube video embedding with privacy-enhanced mode
+
+- **Context:** Exercise detail view needs to display videos. YouTube URLs are the most common video format users will paste.
+- **Decision:** Extract YouTube video IDs from various URL formats (`youtube.com/watch?v=`, `youtu.be/`) and embed using `youtube-nocookie.com` (privacy-enhanced mode). Non-YouTube URLs get a link fallback.
+- **Rationale:** Privacy-enhanced mode avoids third-party cookies. The fallback link ensures any video URL is accessible even if it's not YouTube.
+
+---
+
+## 2026-03-30 — Step 3b: Exercise JSON Export/Import
+
+### JSON envelope format for export/import
+
+- **Context:** Need a structured format for exporting and importing exercise data that can be extended to all entity types.
+- **Decision:** Extensible metadata+data envelope: `{ metadata: { appName, appVersion, schemaVersion, exportDate, exportedBy }, data: { exercises: [...] } }`. Designed to be extended for all entity types in Step 7.
+- **Rationale:** Clean separation of metadata and payload. The envelope carries provenance information (who exported, when, which version) enabling validation and collision detection on import.
+
+### Reusable ModalDialog component
+
+- **Context:** Export/import flows require multiple dialogs (import confirmation, export filter, collision resolution).
+- **Decision:** Created first reusable Vue component (`src/components/ModalDialog.vue`) for all dialogs: import, export filter, collision resolution. Consistent pattern for future dialogs.
+- **Rationale:** DRY approach — a single modal component with slots avoids duplicating dialog boilerplate across views. Establishes a consistent UX pattern for all future dialogs.
+
+### Import collision strategy implementation
+
+- **Context:** When importing exercises, ID or title collisions may occur between the local database and the imported data.
+- **Decision:** Same-user: Replace/Skip per item with batch Replace All/Skip All. Different-user: suffix-based title disambiguation with `[SUFFIX]` pattern, new UUID on ID collision, update-in-place for same external user same ID.
+- **Rationale:** Distinguishing same-user from different-user collisions provides the right level of control. Same-user imports are likely re-imports (Replace/Skip is sufficient). Different-user imports need disambiguation to preserve both versions.
+
+### Suffix rename cascade
+
+- **Context:** When a user renames a suffix assigned to an external user, all titles containing the old suffix must be updated consistently across all entity types.
+- **Decision:** Renaming a suffix uses SQL `REPLACE()` across exercise, combo, session, and collection tables in a single operation, keeping titles consistent.
+- **Rationale:** A single SQL operation per table ensures atomicity and consistency. Using `REPLACE()` avoids loading all entities into memory for string manipulation.
+
+---
+
+## 2026-04-21 — Database Creation Date & Centralized Date Formatting
+
+### `db_created_at` setting for backup reminder fallback and stats display
+
+- **Context:** The backup reminder (Step 3c) showed immediately on fresh databases because `last_backup_at` was absent, treating "never backed up" as stale. This was jarring for new users who just installed the app. Additionally, the Statistics page needed a way to show when the user started using TrainUs.
+- **Decision:** Store `db_created_at` (ISO-8601 UTC timestamp) on first launch in the `settings` table. The backup reminder uses `db_created_at` as a fallback when `last_backup_at` is absent, giving new users a grace period equal to the reminder interval (default 7 days). The Statistics page displays "You are using TrainUs since [date]" using this value.
+- **Rationale:** Provides a sensible grace period for new users while still reminding them to back up after a reasonable time. The creation date is also useful information for the user to see in Statistics.
+
+### Centralized `dateFormatter.js` utility
+
+- **Context:** Date formatting was scattered across components (`SettingsView`, `ImportDialog`, `backupFilename.js`) with inconsistent approaches — manual padding, `toLocaleString()`, `toLocaleDateString()`, and ISO string slicing. Adding date formatting to StatsView would have added yet another implementation.
+- **Decision:** Create `src/utils/dateFormatter.js` with two pure functions: `formatDate(date, lang?)` for date-only and `formatDateTime(date, lang?)` for date + time. Both accept an optional `lang` parameter (falling back to `i18next.language`), returning `DD/MM/YYYY` (French) or `MM/DD/YYYY` (English). Components pass the reactive language ref as the second argument to ensure date formatting updates immediately on language switch.
+- **Rationale:** DRY — single source of truth for date formatting. Consistent behavior across all components. The optional `lang` parameter enables reactive updates without requiring the utility to depend on i18next directly (it's a fallback, not a requirement).
+
+---
+
+## 2026-04-20 — Step 3c: Backup Filename & Reminder
+
+### Backup filename: versioned timestamp pattern
+
+- **Context:** Manual database downloads used a static filename (`trainus-{version}.sqlite3`), making it impossible to distinguish between backups or sort them chronologically.
+- **Decision:** Rename to `trainus-{version}-backup-YYYYMMDD-HHhMMmSSs.sqlite3` using local time. Letters `h`, `m`, `s` replace colons for filesystem compatibility (Windows does not allow colons in filenames).
+- **Rationale:** Sortable, version-stamped, and filesystem-safe. Local time is more intuitive for users than UTC in filenames.
+
+### Backup reminder: persistent warning button
+
+- **Context:** Users may forget to back up their data, especially after making significant changes.
+- **Decision:** Add a non-intrusive warning button in the action bar that appears when no backup exists or the last backup is older than a configurable threshold (default 7 days). The button is not dismissible — it persists until a backup is made or the threshold is adjusted.
+- **Rationale:** A persistent reminder ensures the user is never left without a visible prompt to back up. Removing the dismiss option avoids the risk of users permanently ignoring the reminder.
+
+### No automatic backups
+
+- **Context:** Could implement scheduled or event-driven automatic backups stored in OPFS.
+- **Decision:** Keep backups manual-only. The Download / Restore buttons from Step 2 remain the only backup mechanism.
+- **Rationale:** Avoids surprise downloads, OPFS quota concerns, and complexity. Users control when and where backups are saved (browser Downloads folder).
+
+### "Click = success" assumption for download tracking
+
+- **Context:** Browsers do not expose a reliable "download completed" event for anchor-based downloads.
+- **Decision:** Treat `a.click()` as success and set `last_backup_at` immediately after. If the export throws before `a.click()`, the timestamp is not updated.
+- **Rationale:** Pragmatic approach. The download is triggered synchronously, and the user's save action is the best available signal of success. Logged as a known limitation.
+
+### Shared state in useBackupStatus composable
+
+- **Context:** The backup reminder needs to be visible across all pages, mounted once in `App.vue`.
+- **Decision:** Use module-level `ref` variables for `lastBackupAt`, `backupReminderDays`, and `dismissed` state, shared across all calls to `useBackupStatus()`.
+- **Rationale:** Ensures a single source of truth for backup status across the entire app. The composable provides reactive state that updates consistently regardless of which component calls it.
+
+---
+
+## 2026-05-01 — Step 4: Combo Management
+
+### Combo type NONE for plain supersets
+
+- **Context:** Combos can be EMOM, AMRAP, or TABATA, but users also need plain grouped sets (supersets) without a timed format.
+- **Decision:** Add `'NONE'` as the default combo type. Combos with type NONE behave as plain ordered exercise groups.
+- **Rationale:** Avoids forcing users to choose a timed format when they just want to group exercises. A single neutral type keeps the data model consistent.
+
+### Per-combo exercise reps and weight stored in junction table
+
+- **Context:** Each exercise in a combo may need different reps and weight (e.g., 12 push-ups followed by 8 squats at 50 kg).
+- **Decision:** Store `default_reps` and `default_weight` on the `combo_exercise` junction row, not on the exercise itself.
+- **Rationale:** The junction table is the natural place for combo-specific parameters. Exercise defaults remain unchanged and are used as fallback when no combo context exists.
+
+### `setExercises()` replace-all strategy
+
+- **Context:** Updating exercises in a combo requires handling reordering, additions, and removals simultaneously.
+- **Decision:** `comboRepository.setExercises()` deletes all existing `combo_exercise` rows for the combo and re-inserts the provided array in order.
+- **Rationale:** Simpler than diffing the old and new sets. The operation is wrapped in a single transaction, so it's atomic and fast for the small number of exercises a combo typically contains.
+
+---
+
+## 2026-05-11 — Step 7: Full Import / Export
+
+### Extend JSON envelope to all entity types
+
+- **Context:** Step 3b built the export/import infrastructure for exercises only. Step 7 extends it to combos, sessions, collections, execution logs, and settings.
+- **Decision:** Add `combos`, `sessions`, `collections`, `executionLogs`, and `settings` arrays to the `data` section of the JSON envelope. The format is backward-compatible — single-entity exercise files continue to work with the legacy flow.
+- **Rationale:** One envelope format for all entities. Consumers only need to handle the keys that are present.
+
+### Cross-entity reference remapping on import
+
+- **Context:** When an entity's ID changes during import (new UUID generated due to collision), all entities that reference it must also be updated.
+- **Decision:** After resolving all ID mappings, update `combo_exercise.exercise_id`, `session_item.item_id`, `collection_session.session_id`, `execution_log.session_id`, and `execution_log_item.exercise_id` in a single pass before committing.
+- **Rationale:** Without remapping, importing an exercise that gets a new ID would break any combos or sessions that reference it by the original ID.
+
+### Settings import with identity exclusions
+
+- **Context:** Importing settings from another user's export should not overwrite the local user's identity.
+- **Decision:** Always skip `user_uuid`, `app_version`, `db_created_at`, and `last_backup_at` during settings import. Import `user_name`, `language`, `theme`, and `backup_reminder_days`.
+- **Rationale:** UUID and creation date identify the local database. Overwriting them would corrupt provenance tracking for future exports.
+
+### Execution log import: session-dependent
+
+- **Context:** Execution logs reference sessions by ID. If the session doesn't exist in the target database, the log is meaningless.
+- **Decision:** Execution logs are imported only if the referenced session exists locally or was imported in the same batch.
+- **Rationale:** Orphaned execution logs would appear in the history without a matching session, breaking the UI. Silently skipping them is preferable to importing garbage data.
+
+### Generalized suffix strategy across all entity types
+
+- **Context:** The suffix system (Step 3b) was designed for exercises. With full export/import, the same collision strategy must apply to combos, sessions, and collections.
+- **Decision:** Apply the same `[SUFFIX]` disambiguation to all entity types that have a title/label field. The suffix is prompted once per external user and reused across all entity types from that user in the same import.
+- **Rationale:** A consistent UX regardless of which entity types are in the imported file. One suffix prompt per user keeps the dialog simple.
+
+---
+
+## 2026-05-05 — Step 4b: Combo Exercise Reps & Weight
+
+### Per-exercise reps and weight in combos
+
+- **Context:** Combos allow grouping exercises, but all exercises in a combo shared the same default reps and weight from the exercise definition. Users need different reps/weight for each exercise within a combo (e.g., 12 reps of push-ups followed by 8 reps of squats with 50kg).
+- **Decision:** Add `default_reps` (INTEGER, default 1) and `default_weight` (REAL, default 0.0) columns to the `combo_exercise` junction table. These override the exercise's own defaults when the combo is used. No schema version bump since the app has not been released yet.
+- **Rationale:** Allows flexible per-exercise configuration within combos while keeping the exercise definitions unchanged. The junction table is the natural place for combo-specific exercise parameters.
+
+### Renamed "series" to "reps" in combo context
+
+- **Context:** The original plan used "series" (sets) for the count of exercise repetitions within a combo. This was potentially confusing since "series" has a specific meaning in fitness (a group of repetitions), and the exercise table already uses "reps" for repetitions.
+- **Decision:** Rename `default_series` to `default_reps` throughout the combo feature. The field represents the number of repetitions for each exercise within the combo, consistent with the exercise table's terminology.
+- **Rationale:** Consistency with existing terminology. "Reps" is more universally understood in fitness contexts and aligns with the exercise table's `default_reps` field.
+
+---
+
+## 2026-05-11 — Initialize Database Feature
+
+### Initialize DB: delete all data and reinitialize defaults
+
+- **Context:** Users need a way to completely reset the database to its initial state without reinstalling the app or manually clearing browser storage.
+- **Decision:** Add an "Initialize Database" button in Settings that deletes all data from all tables and reinitializes default settings (UUID, user name, language, theme). A confirmation dialog with a mandatory checkbox ensures the user understands the action is irreversible. After confirmation, the page reloads to reflect the fresh state.
+- **Rationale:** Simpler than deleting the OPFS directory and reinitializing the worker. Deleting table contents preserves the database connection and schema, then `_initDefaults()` recreates the essential settings. The checkbox confirmation prevents accidental data loss.
+
+### Initialize DB: table deletion order respects foreign keys
+
+- **Context:** Tables have foreign key relationships that must be respected when deleting data.
+- **Decision:** Delete tables in dependency order: child tables first (`execution_log_item`, `execution_log`, `collection_session`, `session_item`, `combo_exercise`), then parent tables (`suffix`, `collection`, `session`, `combo`, `exercise`), and finally `settings`. Foreign keys are temporarily disabled during the operation.
+
+---
+
+## 2026-05-11 — Step 6: Collection Management & Home Page
+
+### Collection form: session selector with ordered list
+
+- **Context:** Collections need to group sessions in a specific order. Users need to add, remove, and reorder sessions.
+- **Decision:** CollectionFormView uses a dropdown to select sessions, an "Add Session" button, and an ordered list with move up/down/remove controls. The same session cannot be added twice to a collection.
+- **Rationale:** Mirrors the pattern from SessionFormView (exercise/combo selector) and ComboFormView (exercise selector), maintaining consistency across the app. Preventing duplicate sessions avoids confusion in execution order.
+
+### Collection list: session count badge
+
+- **Context:** Users should see at a glance how many sessions a collection contains.
+- **Decision:** `collectionRepository.getAll()` performs a COUNT query on `collection_session` for each collection, returning a `sessionCount` field displayed as a badge on the card.
+- **Rationale:** A lightweight COUNT query is more efficient than loading all session data for the list view. The badge provides useful context without requiring the user to open the detail view.
+
+### Home page: stat cards + recent sessions list
+
+- **Context:** The Home page should provide a quick overview of training activity.
+- **Decision:** Two stat cards (sessions in last 7 days, sessions in last 30 days) and a list of the 3 most recent execution logs with session titles and dates.
+- **Rationale:** Stat cards give at-a-glance metrics. Recent sessions provide quick access to re-execute or review. The 3-session limit keeps the page concise while still showing meaningful history.
+
+### Home page: execution logs as the data source
+
+- **Context:** Need to determine which sessions have been "executed" for the Home page.
+- **Decision:** Use the `execution_log` table as the source of truth. `getRecent(3)` returns the 3 most recent logs with session titles via JOIN. `getCountSince(isoDate)` counts logs since a given date.
+- **Rationale:** Execution logs are already created when sessions are executed (Step 8). The Home page reads from existing data without requiring new tables or fields.
+
+---
+
+## 2026-05-11 — Step 5: Session Management
+
+### Session items: weight column added to session_item
+
+- **Context:** Sessions need per-item weight configuration, similar to how combos have per-exercise reps and weight. The `session_item` table already had `repetitions` but no weight field.
+- **Decision:** Add `weight REAL NOT NULL DEFAULT 0.0` to `session_item` table. No schema version bump since the app has not been released yet.
+- **Rationale:** Allows users to specify the weight for each exercise or combo within a session, overriding the exercise's default weight. Consistent with the combo exercise pattern.
+
+## 2026-05-26 — Step 8: Execution Mode
+
+### Flat queue model for session execution
+
+- **Context:** A session can contain exercises and combos. Combos can have multiple rounds (`repetitions` on the session item). Execution needs to step through each item in order, expanding combos into individual exercise steps.
+- **Decision:** Build a flat array of step objects at execution start. A combo with N rounds and M exercises expands into N×M steps. The composable manages a `currentIndex` cursor.
+- **Rationale:** A flat queue is simple to iterate, easy to inspect for "next step" preview, and straightforward to splice when adding extra rounds. Alternatives (tree structure, recursive state machine) added complexity without benefit.
+
+### Final-round screen only at the last round
+
+- **Context:** Combos have multiple rounds. Between rounds the experience should feel continuous; only after the last exercise of the last round should the user see options.
+- **Decision:** Each step carries `isFinalComboStep: boolean`. Only when this flag is true does pressing Done show the final-round screen instead of auto-advancing.
+- **Rationale:** Auto-advancing between non-final rounds reduces interruptions. The final-round pause allows the user to decide to continue, add another round, or exit.
+
+### Prefill from most recent execution log
+
+- **Context:** Users benefit from seeing their previous reps/weight when re-running a session.
+- **Decision:** On execution start, query the most recent `execution_log` for the session and build a map `exerciseId → {reps_done, weight_used, side}`. Steps prefill from this map, falling back to session item defaults.
+- **Rationale:** Per-session history is more accurate than per-exercise history — a session may use the same exercise at different weights in different sessions.
+
+### Schema: combo_id and round_number added to execution_log_item (in-place)
+
+- **Context:** Statistics (Step 9) need to distinguish exercise log entries that came from combos vs. standalone, and to know which round they came from.
+- **Decision:** Add nullable `combo_id TEXT` and `round_number INTEGER` columns to `execution_log_item` directly in SCHEMA_SQL. No version bump — the app has not been released.
+- **Rationale:** In-place schema changes are acceptable before any release. Schema version bumps (and the migration system they require) are reserved for changes made after a version has been deployed to users.
+
+### Session items: polymorphic JOIN for titles
+
+- **Context:** `session_item` references either an exercise or a combo via `item_id` + `item_type`. Getting item titles requires joining with the correct table.
+- **Decision:** `getItems()` in `sessionRepository` executes two separate queries (one joining with `exercise`, one joining with `combo`) and merges the results sorted by position.
+- **Rationale:** SQLite doesn't support conditional JOINs on different tables in a single query. Two queries are simple, efficient, and easy to maintain.
+- **Rationale:** Prevents foreign key constraint violations. Disabling foreign keys during the bulk delete is safe since all tables are being cleared atomically.
+
+### Markdown rendering in description fields
+
+- **Date:** 2026-06-02
+- **Context:** Users wanted richer formatting in exercise, combo, and session descriptions.
+- **Decision:** Use `marked` (GFM parser) + `DOMPurify` (HTML sanitizer) to render descriptions as HTML in the three detail views. Descriptions are **not** shown in list views (removed for cleaner cards). A "Basic Markdown supported" hint appears next to the description label in all three form views.
+- **Rationale:** `marked` is lightweight and defaults to GFM. `DOMPurify` is required when using `v-html` to prevent XSS. The hint says "basic" rather than "GitHub Flavored Markdown" because some GFM extensions (e.g., alerts) are not supported by `marked` out of the box.
+
+### Schema: status column added to execution_log (in-place, R4-B)
+
+- **Date:** 2026-06-12
+- **Context:** `exit()` and route-abandon both terminate a session early, but the log was indistinguishable from a completed session. Stats counted all started sessions regardless of completion.
+- **Decision:** Add `status TEXT NOT NULL DEFAULT 'completed' CHECK(status IN ('completed','aborted'))` to `execution_log` in-place (no version bump — pre-release).
+- **Rationale:** Honest data model. Stats queries filter `WHERE status = 'completed'`. An aborted session where 0 exercises were done should not count as a "workout".
+
+### ESLint added (R8)
+
+- **Date:** 2026-06-12
+- **Context:** Only Prettier was configured. Bugs like duplicate object keys (`no-dupe-keys`) shipped silently.
+- **Decision:** Flat ESLint config with `@eslint/js` recommended + `eslint-plugin-vue/flat/recommended` + `eslint-config-prettier`. `vue/no-v-html` disabled globally — all `v-html` uses go through `renderMarkdown()` (DOMPurify).
+- **Rationale:** Vue-specific rules catch unused refs and missing `:key`s. Prettier config ensures no formatting conflicts.
+
+### LIKE wildcard escaping in search (R10)
+
+- **Date:** 2026-06-12
+- **Context:** All repository `search()` methods passed user input directly into `LIKE '%…%'`. Searching for `100%` matched everything starting with `100`; `Push_up` couldn't be found with a literal underscore.
+- **Decision:** Add `escapeLike(s)` utility (escapes `\`, `%`, `_`) and append `ESCAPE '\\'` to all LIKE clauses.
+- **Rationale:** Minimal change; correct semantics. The parameterization already prevented injection; this fixes result correctness.
+
+### JSON import: title conflicts folded into the Replace/Skip screen
+
+- **Date:** 2026-06-16
+- **Context:** Import conflict detection was `id`-only. An imported item whose title matched an existing item with a _different_ id either failed silently (same-user) or only offered a forced rename (cross-user, after suffixing) — no Replace/Skip choice, and same-batch references to the conflicting imported id (e.g. a combo's `exercise_id`) were never redirected.
+- **Decision:** Detect title conflicts (different id, same title) during analysis and bucket them into the same `sameUserCollisions` array as id conflicts, so the existing Replace/Skip UI (including batch Replace All/Skip All) handles both without new screens. Resolve same-user collisions against `collision.existing.id` instead of `collision.imported.id` so Replace updates the existing row in place and Skip redirects same-batch references to it via the existing `idMap` mechanism. For cross-user imports, the suffixed-title conflict (almost always a re-import from the same external user) now resolves the same way instead of forcing a rename.
+- **Decision:** Removed `analyzeExercises`, `applySameUserImport`, `applyDifferentUserImport`, and `checkTitleConflict` from `useJsonImport.js`, and the "legacy exercise-only" branch in `ImportDialog.vue`. These turned out to be dead code: the apply step already always went through `applyAllImport`, and `analyzeAll` already produces an identical analysis shape for exercise-only envelopes.
+- **Rationale:** Reusing the existing collision UI avoids inventing a parallel "merge" concept the backlog explicitly wanted to avoid. Deleting confirmed-dead code prevents the next reader (the backlog text itself cited the dead `applySameUserImport` as if it were live) from being misled about which code path actually runs.
+
+### Save filename prompt on every disk save
+
+- **Date:** 2026-06-16
+- **Context:** All file downloads (JSON exports, the home HTML export, the SQLite backup) saved silently under an auto-generated name with no chance to rename before saving.
+- **Decision:** Add a custom Vue modal (`SaveFileDialog.vue`, mounted once in `App.vue`) that prompts for a filename — prefilled with the previous auto-generated default, text-selected, with a fixed/read-only extension — before any download fires. Backed by a singleton composable `useSaveFilePrompt.js` (`promptFilename(defaultFilename)` → `Promise<string|null>`, `null` on cancel). The three existing download chokepoints (`downloadJson`, `downloadBackup`, the local `downloadHtml` in `useHtmlExport.js`) call it and no-op on cancel, so no view-level call site changed. The forced pre-migration backup screen goes through the same dialog; cancelling it leaves the Update button disabled.
+- **Rationale:** A native `showSaveFilePicker()` dialog was rejected — unsupported in Firefox, the project's primary test browser. Fixing the extension (rather than letting the whole filename be edited) avoids users accidentally producing a file the app can't recognize by type. Centralizing the prompt in the 3 existing low-level download functions, instead of at each of the ~15 export-button call sites, kept the change minimal-impact.
+- **Found/fixed along the way:** `ModalDialog`'s `z-index: 1000` sat below the blocking `.db-overlay`'s `z-index: 9999`, so the dialog was unclickable when opened from the migration screen — bumped to `10000`. `useJsonExport.js`'s `downloadJson` calls, and the `onExportAll`/`onExportHtml` view handlers, weren't awaited — added `await` throughout since the call now blocks on user input.
+
+### Export respects active search filter and bundles referenced entities
+
+- **Date:** 2026-06-18
+- **Context:** Two related export bugs. (1) Clicking export on the exercises/combos/sessions/collections list views always exported every row, ignoring an active search filter — exporting the unfiltered list when the user clearly intended to export just the matches. (2) Exporting a single combo/session/collection (or a filtered list of them), or using the Settings export-filter dialog with a partial selection, only included lightweight FK references (id/title) to the exercises/combos/sessions it depends on, not the full entities — so importing that file on a device that didn't already have those dependencies left dangling references (e.g. a session item pointing at an exercise that was never imported).
+- **Decision:** `exportAllExercises/Combos/Sessions/Collections` now take an optional `query` and use the corresponding `search`/new `searchWithExercises`/`searchWithItems`/`searchWithSessions` repository method when one is active; the four list views pass their current trimmed search query. Added `collectComboDependencies`/`collectSessionDependencies`/`collectCollectionDependencies` helpers in `useJsonExport.js` that walk the nested FK references to fetch full dependent entities, used by `exportCombo(s)`, `exportSession(s)`, `exportCollection(s)`, and cascaded into `exportByFilter` (collections → sessions → combos → exercises) so a partial checkbox selection still produces a self-contained, importable file.
+- **Rationale:** Matches user intent (export = "what I'm looking at") and makes every export entry point produce a file that imports correctly standalone, without changing the import side at all — existing collision detection already handles re-importing entities that turn out to already exist locally.
+
+### COOP/COEP headers clarification (R17)
+
+- **Date:** 2026-06-12
+- **Context:** README and technical docs stated that COOP/COEP headers were "required" for OPFS. The SAH-pool VFS (`opfs-sahpool`) does not use `SharedArrayBuffer` and does not require these headers.
+- **Decision:** Update README and technical docs to say headers are "not required" for the SAH-pool VFS, kept as a precaution.
+- **Rationale:** Accurate documentation prevents unnecessary server configuration burden for deployers.
diff --git a/docs/plan.md b/docs/plan.md
new file mode 100644
index 0000000..9e01a32
--- /dev/null
+++ b/docs/plan.md
@@ -0,0 +1,879 @@
+# TrainUs — Implementation Plan (v3)
+
+> **Last updated:** 2026-06-09
+> **Status:** Step 15 complete — all steps done; GNU AGPL v3 license + notice added; license shown via stacked modal in About dialog
+
+## Overview
+
+Greenfield PWA fitness app using **Vue 3 + Vite**, SQLite WASM (official) on OPFS, **i18next** (+ vue-i18next), Chart.js. Single user per device. English (default) + French. Version sourced from `package.json`, injected by Vite at build time, stored in DB. Two modes: Edit (CRUD) and Execution (timers, logging). Single deployment (latest version at site root) with a stable database location and automatic startup migration.
+
+## Steps
+
+### Step 0 — Project Scaffolding & Infrastructure
+
+**Status:** Done
+
+- Initialize Vue 3 + Vite project in `src/`
+- Configure Vite: dev server with `Cross-Origin-Opener-Policy` / `Cross-Origin-Embedder-Policy` headers, build output to `dist/`, inject app version via `define` from `package.json`
+- Set up folder structure: `src/components/`, `src/composables/`, `src/db/`, `src/i18n/`, `src/styles/`, `src/views/`, `src/router/`, `src/utils/`
+- Port CSS from sample into `src/styles/` — CSS variable system, add dark mode variable set
+- Integrate Bootstrap Icons (via `bootstrap-icons` npm package)
+- Set up Vue Router (hash mode): `#/home`, `#/exercises`, `#/combos`, `#/sessions`, `#/stats`, `#/settings`
+- Create app shell layout component: sidebar nav (desktop ≥ 700px) / bottom nav (mobile), action bar, `<router-view>` content area — faithful to sample
+- Set up **i18next** + **vue-i18next**: `src/i18n/locales/en.json`, `src/i18n/locales/fr.json`, reactive language switching
+- Create `manifest.json` (PWA) with app name, icons placeholder, versioned start URL
+- Set up basic service worker (precache shell)
+- Write initial `README.md`, create `docs/technical-documentation.md`, `docs/decisions-log.md`
+- Set up Playwright Python project in `tests/` with `conftest.py`, targeting Firefox
+
+**Verification:** `npm run dev` serves the app, responsive shell renders, routes switch views, i18n renders English keys, Playwright can launch in Firefox
+
+---
+
+### Step 1 — Database Layer (SQLite WASM + OPFS)
+
+**Status:** Done
+
+- Integrate official SQLite WASM build
+- Create `src/db/database.js` — initializes SQLite in a Web Worker with OPFS VFS, namespaces DB file by app version (e.g., `trainus-1.0.0.sqlite3`)
+- SQL schema: `exercise`, `combo`, `combo_exercise`, `session`, `session_item`, `collection`, `collection_session`, `settings` (key/value), `execution_log`, `execution_log_item`, `schema_version`
+- On first launch: generate UUID, store `user_uuid`, `user_name`, `app_version`, `db_created_at` in `settings` table
+- Repository layer (`src/db/repositories/`) — one per entity with `create`, `getById`, `getAll`, `update`, `delete`, `search`
+- Vue composables (`src/composables/`) wrapping repositories for reactive data in components
+
+**Verification:** Playwright tests — DB initializes, UUID + app version persisted, CRUD records, data survives reload
+
+---
+
+### Step 2 — Settings
+
+**Status:** Done
+
+- Create `SettingsView.vue` at `#/settings`
+- **Language selector:** dropdown (English / French) — calls i18next `changeLanguage()`, persisted in `settings` table, loaded at startup
+- **User name editor:** text input, persisted in `settings`
+- **UUID display:** read-only info field
+- **Dark/light mode toggle:** switches CSS variable set on `<html>`, persisted in `settings`
+- **Download Database:** export raw SQLite file via `sqlite3_js_db_export()`
+- **Restore Database:** file picker → confirm dialog → validation pipeline (deserialize into `:memory:` → check required tables → version compatibility → adapt scripts if needed → table-by-table copy in transaction) → spinner during process → detailed report card (success with table/row counts, or translated error codes)
+- **Release registry** (`src/db/releases.js`): tracks schema versions and breaking changes for restore compatibility
+- Placeholder sections for Export/Import (wired in Step 7)
+
+**Verification:** Playwright tests — change language (all labels update reactively), change name (persists on reload), toggle theme (colors switch), red path: empty name rejected, download DB, restore flow (round-trip), restore with invalid file, restore with incomplete DB, cancel dialog aborts restore
+
+---
+
+### Step 2b — Schema Hardening & Documentation Restructuring
+
+**Status:** Done
+
+- **Schema changes (in-place, no version bump — not yet released):**
+  - Add `UNIQUE` constraint on `exercise.title`, `combo.title`, `session.title`, `collection.label`
+  - Add `suffix` table: `user_uuid TEXT PRIMARY KEY`, `user_name TEXT NOT NULL`, `suffix TEXT NOT NULL UNIQUE` — registry of known external users for import disambiguation
+- **Documentation restructuring:**
+  - Rename `docs/technical-overview.md` → `docs/technical-documentation.md`; enrich with full DB schema (ER diagram), architecture details, data flows
+  - Rename `docs/user-guide.md` → `docs/user-documentation.md`
+  - Update all references across project files: `README.md`, `AGENTS.md`, `docs/plan.md`, `.opencode/` config files
+  - Rewrite `README.md` Documentation section: link all docs and all tutorials/codelabs with short descriptions; bilingual links use `(en / fr)` format
+
+**Verification:** Playwright tests — UNIQUE constraints enforced, suffix table exists, all doc links resolve correctly
+
+---
+
+### Step 3 — Exercise Management (Edit Mode)
+
+**Status:** Done
+
+- `ExerciseListView.vue`: card/list display, search bar (reactive filter by title)
+- `ExerciseFormView.vue`: form with all fields (title, description, asymmetric toggle + sub-option, image URLs, video URLs, default reps, default weight) — uses `v-model` bindings
+- `ExerciseDetailView.vue`: read-only, embedded images/videos (iframe for YouTube)
+- Routes: `#/exercises`, `#/exercises/new`, `#/exercises/:id`, `#/exercises/:id/edit`
+- Input validation (title required, reps ≥ 0, weight ≥ 0, URL format)
+- Action bar: New, Search buttons (via Vue Teleport with `defer`)
+- Validation utility module (`src/utils/validation.js`)
+- i18n keys for all labels, validation messages, and form elements (EN + FR)
+
+**Verification:** Playwright tests — create, view, edit, delete, search, validation rejects bad input — 17 tests passing on Firefox and Chromium
+
+---
+
+### Step 3b — Exercise JSON Export/Import
+
+**Status:** Done
+
+- **JSON envelope format:** `{ metadata: { appName, appVersion, schemaVersion, exportDate, exportedBy: { name, uuid } }, data: { exercises: [...] } }` — extensible for all entities in Step 7
+- **Export service** (`src/composables/useJsonExport.js`): builds envelope, serializes selected entity arrays
+- **Import service** (`src/composables/useJsonImport.js`): parses envelope, validates `appName` + `schemaVersion`, detects ID collisions, applies import
+- **Export features:**
+  - Exercise list view: "Export" action bar button — exports all exercises
+  - Exercise detail view: "Export" button — exports single exercise
+  - Settings page: enable "Export Data" button with entity filter dialog (checkboxes per entity type; only "Exercises" active, others disabled with "Coming soon")
+  - Downloaded file: `trainus-exercises-YYYY-MM-DD.json`
+- **Import features:**
+  - Exercise list view: "Import" action bar button — file picker for `.json`
+  - Settings page: enable "Import Data" button — same file picker
+  - Import flow: parse → validate envelope → preview summary ("X exercises from NAME on DATE") → collision detection → result report
+- **ID collision strategy:**
+  - **No collision:** insert directly
+  - **Same user** (`created_by` = local `user_uuid`):
+    - Different ID: import as new exercise
+    - Same ID: show confirmation dialog with export date ("Overwrite 'Exercise X'? Exported on DATE") — options: Replace / Skip / Replace All / Skip All (batch)
+    - If an update causes a title conflict with a different existing exercise: prompt user to enter a new title
+  - **Different user** (`created_by` ≠ local `user_uuid`):
+    - If user UUID exists in `suffix` table: inform user the existing suffix will be used
+    - If user UUID not in `suffix` table: prompt for a new suffix (pre-filled with exporter's name), validate uniqueness against existing suffixes, save `(user_uuid, user_name, suffix)` to `suffix` table
+    - Same `created_by` as existing object AND same ID: treat as update (no new ID generated)
+    - Different `created_by` from existing object AND same ID: generate a new UUID for import
+    - Title format: `"Original Title [SUFFIX]"` — if this title is already taken, prompt user to enter a new base title (suffix is always appended)
+  - Single dialog handles all collisions: grouped by type, batch actions (Replace All / Skip All), one suffix input per external user
+- **Settings — Suffix management:**
+  - New section in Settings: list all entries from `suffix` table (user name, UUID, suffix)
+  - Edit suffix: changing a suffix updates all titles containing `[OLD_SUFFIX]` to `[NEW_SUFFIX]` across `exercise`, `combo`, `session`, and `collection` tables
+- **i18n:** all new labels in `en.json` / `fr.json`
+
+**Verification:** Playwright tests — export/import round-trip, same-user collision (replace + skip + batch Replace All / Skip All), different-user collision (suffix prompt, title with [SUFFIX], new ID generated), update from same external user (no new ID), title conflict prompts, suffix rename cascades to titles, invalid file rejection, Settings suffix management, Settings page export filter, single exercise export from detail view
+
+---
+
+### Step 3c — Backup Filename & Reminder
+
+**Status:** Done
+
+Scope is deliberately minimal: no automatic backups, no OPFS-stored backups, no schema change. The manual Download / Restore buttons from Step 2 remain the only backup mechanism. This step only:
+
+1. Renames the downloaded file so each manual backup is unique, sortable, and carries the app version.
+2. Tracks when the user last downloaded (or restored) a backup.
+3. Adds a non-intrusive warning indicator reminding the user to back up after a configurable number of days.
+
+- **Filename convention:** manual DB download renamed from `trainus-{version}.sqlite3` to `trainus-{version}-backup-YYYYMMDD-HHhMMmSSs.sqlite3` using local time (example for `1.0.0` at 2026-03-23 15:24:06 local → `trainus-1.0.0-backup-20260323-15h24m06s.sqlite3`). Letters `h`, `m`, `s` replace the Windows-invalid colon.
+- **New settings keys (no schema change; uses existing `settings` key/value table):**
+  - `last_backup_at` — ISO-8601 UTC timestamp (`...Z`). Set on successful Download **and** on successful Restore. Absent = never backed up.
+  - `backup_reminder_days` — integer stored as string, default `"7"`. User-configurable in Settings (valid range 1–365).
+  - `db_created_at` — ISO-8601 UTC timestamp set on first launch. Used as fallback for backup reminder when `last_backup_at` is absent, so fresh databases don't immediately show a stale warning. Also displayed on the Statistics page.
+- **Backup reminder indicator:**
+  - Warning-styled button, leftmost in the action bar (`#actionbar-actions`), visible on every page when `now - last_backup_at > backup_reminder_days` OR when `last_backup_at` is absent.
+  - Icon: `bi-exclamation-triangle-fill`. Tooltip: "Last backup {{days}} day(s) ago — click to back up" or "No backup yet — click to create one" (translated).
+  - Click: navigate to `#/settings` and focus/scroll the Database section.
+  - A secondary `×` dismisses the reminder for the current session only (not persisted). Reloads re-show it if still stale.
+  - Hidden entirely when backup is fresh.
+- **Settings UI additions (Database section):**
+  - Display "Last backup: {{localDateTime}}" or "Never backed up".
+  - Number input "Remind me every N days" (1–365; default 7) with inline validation.
+- **i18n:** new EN + FR keys under `settings.backup.*` and `backup.reminder.*`.
+- **New files:**
+  - `src/utils/backupFilename.js` — pure `formatBackupFilename(version, date)`.
+  - `src/composables/useBackupStatus.js` — reactive `lastBackupAt`, `daysSinceBackup`, `isStale`, `dismissed`, `markBackedUp()`, `dismiss()`.
+  - `src/components/BackupReminder.vue` — teleported warning button.
+  - `tests/test_step3c_backup.py` — Playwright tests (Firefox + Chromium).
+- **Modified files:**
+  - `src/views/SettingsView.vue` — use new filename, set `last_backup_at` on Download/Restore success, render Database section additions.
+  - `src/App.vue` — mount `<BackupReminder>` once at app level so it teleports into each page's action bar.
+  - `src/i18n/locales/en.json`, `fr.json` — new translation keys.
+
+**Verification:** Playwright tests — download uses new filename pattern, `last_backup_at` set on download, reminder appears after threshold, reminder hidden when fresh, reminder hidden after dismiss within same session, reminder reappears on reload if still stale, clicking reminder navigates to Settings, Settings shows last backup date, changing `backup_reminder_days` re-evaluates reminder visibility, restore updates `last_backup_at` to now, invalid threshold rejected, filename is filesystem-safe (no colons, zero-padded), download failure does not update `last_backup_at`.
+
+---
+
+### Step 4 — Combo Management (Edit Mode)
+
+**Status:** Done
+
+- `ComboListView.vue`, `ComboFormView.vue`, `ComboDetailView.vue`
+- Type picker (EMOM / AMRAP / TABATA / NONE), exercise selector (pick from existing, reorder with up/down buttons), timer config (varies by type: duration for EMOM/AMRAP, rounds for TABATA)
+- Routes: `#/combos`, `#/combos/new`, `#/combos/:id`, `#/combos/:id/edit`
+- `comboRepository` updated with `createWithId` and `replaceAll` for import support
+
+**Verification:** Playwright tests — create combo with exercises, reorder, type change, validation, edit, delete, search
+
+---
+
+### Step 4b — Combo Exercise Reps & Weight
+
+**Status:** Done
+
+Add `default_reps` and `default_weight` fields to exercises within combos. Each exercise in a combo has its own reps count and weight, shown in edit mode and used as defaults during execution.
+
+- **Schema migration:**
+  - Add `default_reps INTEGER NOT NULL DEFAULT 1` and `default_weight REAL NOT NULL DEFAULT 0.0` columns to `combo_exercise` table
+  - Increment `SCHEMA_VERSION` from 1 to 2
+  - Add migration script for existing databases (`ALTER TABLE combo_exercise ADD COLUMN ...`)
+- **Repository changes (`src/db/repositories/comboRepository.js`):**
+  - Update `setExercises()` to accept array of objects `{ exerciseId, position, defaultReps, defaultWeight }` instead of plain IDs
+  - Update `getExercises()` to return `default_reps` and `default_weight` columns alongside existing fields
+- **ComboFormView.vue:**
+  - Add inline reps and weight inputs per exercise in the ordered list
+  - Reps: number input, default 1, validation ≥ 1
+  - Weight: number input, default 0.0, validation ≥ 0
+  - Display format in list: exercise title + "× {reps}" + " @ {weight}kg" (or just title if both are defaults)
+- **ComboDetailView.vue:**
+  - Display reps and weight for each exercise in the list (e.g., "3 × 50 kg" format next to exercise name)
+- **i18n (`en.json` / `fr.json`):**
+  - `combos.form.reps` / `combos.form.repsLabel`
+  - `combos.form.weight` / `combos.form.weightLabel`
+  - `combos.exercise.repsWeight` — display format string
+  - Validation messages for reps < 1 and weight < 0
+- **Import/Export impact:**
+  - `useJsonExport.js`: include `default_reps` and `default_weight` in combo exercise export data
+  - `useJsonImport.js`: handle these fields on import (no special collision logic needed)
+- **Modified files:**
+  - `src/db/schema.js` — add columns, bump version
+  - `src/db/repositories/comboRepository.js` — update `setExercises` and `getExercises`
+  - `src/views/ComboFormView.vue` — add reps/weight inputs per exercise
+  - `src/views/ComboDetailView.vue` — display reps/weight
+  - `src/composables/useJsonExport.js` — include new fields
+  - `src/composables/useJsonImport.js` — handle new fields
+  - `src/i18n/locales/en.json`, `fr.json` — new translation keys
+
+**Verification:** Playwright tests — create combo with exercises and set reps/weight (saved correctly), edit combo and change reps/weight (updated), detail view displays reps/weight, validation rejects reps < 1 and weight < 0, export/import round-trip preserves reps/weight values
+
+---
+
+### Step 5 — Session Management (Edit Mode)
+
+**Status:** Done
+
+- `SessionListView.vue`, `SessionFormView.vue`, `SessionDetailView.vue`
+- Ordered list of items (add exercise OR combo), reorder with up/down buttons
+- **Per-item reps and weight:** each session item has its own `repetitions` (already in schema) and a new `weight` field, similar to combo exercises. These override the exercise's defaults when the session is executed.
+  - Add `weight REAL NOT NULL DEFAULT 0.0` to `session_item` table (in-place, no version bump — not yet released)
+  - Inline weight input per item in the form (number input, default 0.0, validation ≥ 0)
+  - Display format in list: item title + "× {reps}" + " @ {weight}kg" (or just title if both are defaults)
+- Routes: `#/sessions`, `#/sessions/new`, `#/sessions/:id`, `#/sessions/:id/edit`
+- **Repository changes (`src/db/repositories/sessionRepository.js`):**
+  - Update `setItems()` to accept array of objects `{ itemId, itemType, position, repetitions, weight }`
+  - Update `getItems()` to return `weight` alongside existing fields, with titles from JOIN queries
+- **Import/Export impact:**
+  - `useJsonExport.js`: include `weight` in session item export data
+  - `useJsonImport.js`: handle this field on import
+- **i18n (`en.json` / `fr.json`):**
+  - `sessions.form.weight` / `sessions.form.weightLabel`
+  - `sessions.item.repsWeight` — display format string
+  - Validation message for weight < 0
+
+**Verification:** Playwright tests — create session with exercises/combos and set reps/weight (saved correctly), edit session and change reps/weight (updated), detail view displays reps/weight, validation rejects weight < 0, export/import round-trip preserves reps/weight values
+
+---
+
+### Step 6 — Collection Management & Home Page
+
+**Status:** Done
+
+- `CollectionsView.vue` (at `#/collections`), `CollectionFormView.vue`, `CollectionDetailView.vue`
+- Label + ordered list of sessions, reorder with up/down buttons
+- Routes: `#/collections`, `#/collections/new`, `#/collections/:id`, `#/collections/:id/edit`
+- `HomeView.vue` (at `#/home`): stat cards for sessions in last 7/30 days, last 4 executed sessions with inline exercise summaries and play buttons, history section grouped by day with date filter (default last 30 days)
+- `collectionRepository.getAll()` enriched with `sessionCount` via JOIN query
+- App.vue `navKeyMap` updated to map collection sub-routes to `collections` nav key
+- `useHtmlExport.js`: generates a self-contained HTML export of the home page (embedded icon, stats, recent sessions, filtered history — no play buttons or links); triggered by an action bar button visible when data exists
+
+**Verification:** Playwright tests — CRUD collections, add/reorder/remove sessions, search, validation, duplicate label rejected, navigate to session from collection detail, home empty state, home shows recent 4 sessions, home shows correct 7-day and 30-day counts, history grouped by day, history date filter, play button on recent card, HTML export button present/absent — 23 tests passing on Firefox and Chromium
+
+---
+
+### Step 7 — Import / Export (Full Data)
+
+**Status**: Done
+
+**What was implemented**:
+
+- Extended JSON envelope `data` to include all entity types: `combos`, `sessions`, `collections`, `executionLogs`, `settings`
+- Cross-entity reference remapping on import: ID collision resolution updates all referencing entities (`combo_exercise.exercise_id`, `session_item.item_id`, `collection_session.session_id`, `execution_log.session_id`, `execution_log_item.exercise_id`)
+- Enabled all entity checkboxes in Settings export filter dialog (combos, sessions, collections, execution logs, settings)
+- Added export/import buttons to combo, session, and collection list + detail views
+- Generalized suffix collision strategy to all entity types (title/label field)
+- Full export: all entities + settings in one JSON file (`trainus-full-YYYY-MM-DD.json`)
+- Single entity export from detail views (combo, session, collection)
+- "Export All Data" button in Settings for one-click full export
+- ImportDialog generalized to handle multiple entity types with collision resolution per entity type
+- Repository additions: `createWithId`, `replaceAll`, `getAllWithX` for combo, session, collection, executionLog
+
+**Decisions made**:
+
+- Settings import excludes `user_uuid`, `app_version`, `db_created_at`, `last_backup_at` to preserve local identity
+- Execution logs are imported only if the referenced session exists (or was imported in the same batch)
+- Suffix is applied once per external user and affects all entity types from that user
+- Import dialog detects multi-entity envelopes and uses the new generalized flow; single-entity exercise files use the legacy flow for backward compatibility
+
+**What remains**:
+
+- Manual validation by the user
+- Some tests need refinement for Firefox browser compatibility
+
+**Additional tests added (2026-06-02)**:
+
+- `test_execution_logs_same_user_roundtrip`: execution log + item survive export → clear → reimport
+- `test_execution_log_id_remapping`: log item `exercise_id` is remapped when exercise gets `new_id`
+- `test_session_with_combo_item_remapping`: session `item_type=combo` item_id follows combo remap
+- `test_collection_session_remapping`: collection session ref follows session `new_id` remap
+- `test_settings_import_roundtrip`: `language` and `theme` applied from settings-only envelope
+- `test_single_entity_export_buttons_session_collection`: export button visible on session/collection detail
+- Refactored `test_new_id_propagation_to_combo` to load from `tests/fixtures/cross_user_id_collision.json`
+- Added `tests/fixtures/cross_user_full.json` for cross-user remapping tests
+
+---
+
+### Step 8 — Execution Mode (Core)
+
+**Status:** Done
+
+#### Decisions
+
+| Decision              | Choice                                                                       | Rationale                                                                                                                                                             |
+| --------------------- | ---------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| Combo repetitions     | Full sequence × N rounds                                                     | `repetitions` on a session combo item = number of full passes through the combo exercise list                                                                         |
+| Schema change         | Add `combo_id` + `round_number` to `execution_log_item` (v2 → v3)            | Enables accurate per-combo statistics in Step 9; nullable columns, no FK constraint                                                                                   |
+| Abandon behavior      | Save partial log                                                             | Completed items saved, unfinished omitted; session appears in history as partial                                                                                      |
+| Mid-round transition  | Auto-advance silently                                                        | Only the final round of a combo shows a pause screen                                                                                                                  |
+| Final-round screen    | Continue + One More                                                          | After the last exercise of the last combo round: "Continue →" advances to the next session item; "+ One More Round" appends one extra round to the queue (repeatable) |
+| Prefill source        | Last run of this session                                                     | Reps/weight prefilled from the most recent `execution_log` for this specific session; falls back to item/exercise defaults if no prior log                            |
+| Asymmetric side logic | `alternate=true` → flip side per step; `alternate=false` → flip side per set | Matches the exercise definition; side logged in `execution_log_item.side`                                                                                             |
+
+#### Execution Queue Model
+
+When a session starts, the app builds a flat linear **queue** of steps from the session items. A combo with `repetitions = N` unrolls into `N × (number of exercises in combo)` steps:
+
+```
+Session items:
+  1. Exercise A  ×3 reps, 50kg          → 1 step
+  2. Combo "HIIT" ×2 rounds             → 4 steps (2 exercises × 2 rounds)
+       Round 1: Push-up ×10, Squat ×15
+       Round 2: Push-up ×10, Squat ×15
+  3. Exercise B  ×5 reps                → 1 step
+
+Queue (flat):
+  [0] Exercise A        (reps=3, weight=50)
+  [1] Push-up  — HIIT, Round 1/2
+  [2] Squat    — HIIT, Round 1/2
+      ↓ auto-advance (not last round)
+  [3] Push-up  — HIIT, Round 2/2
+  [4] Squat    — HIIT, Round 2/2
+      ↓ final-round screen: [Continue →] [+ One More Round]
+  [5] Exercise B        (reps=5, weight=0)
+```
+
+Each step carries: `exerciseId`, `exerciseTitle`, `reps`, `weight`, `comboId?`, `comboTitle?`, `roundNumber?`, `totalRounds?`, `asymmetric`, `alternate`, `side?`.
+
+#### UI Layout
+
+```
+┌─────────────────────────────────────────┐
+│  Monday Workout               [✕ exit]  │
+│  ████████████░░░░░  3 / 6 steps         │
+├─────────────────────────────────────────┤
+│  ▶ NOW                                  │
+│  ┌───────────────────────────────────┐  │
+│  │  Push-up                          │  │
+│  │  Combo: HIIT — Round 2 of 2       │  │  ← combo context (hidden for exercises)
+│  │                                   │  │
+│  │  Reps:   [ 10 ]                   │  │
+│  │  Weight: [  0 ] kg                │  │
+│  │  Side:   RIGHT ↔                  │  │  ← only for asymmetric exercises
+│  │                                   │  │
+│  │          [ ✓ Done ]               │  │
+│  └───────────────────────────────────┘  │
+│                                         │
+│  ↓ NEXT                                 │
+│  Squat — 15 reps  (HIIT, Round 2)       │
+└─────────────────────────────────────────┘
+```
+
+Final-round transition screen (replaces the card after the last exercise of the last combo round):
+
+```
+│  ✓ HIIT — 2 rounds complete             │
+│                                         │
+│  [ Continue → ]   [ + One More Round ]  │
+```
+
+#### Schema change (v2 → v3)
+
+Two nullable columns added to `execution_log_item`:
+
+```sql
+ALTER TABLE execution_log_item ADD COLUMN combo_id TEXT DEFAULT NULL;
+ALTER TABLE execution_log_item ADD COLUMN round_number INTEGER DEFAULT NULL;
+```
+
+`NULL` for standalone exercises; populated for exercises inside a combo. No FK constraint (combo may have been deleted before statistics are viewed).
+
+#### Files to create / modify
+
+**New:**
+
+- `src/views/SessionExecuteView.vue` — execution UI (stepper, current/next display, reps/weight inputs, side indicator, final-round screen)
+- `src/composables/useSessionExecution.js` — queue building, current/next step state, prefill logic, done/advance/exit logic, save to log
+
+**Modified:**
+
+- `src/db/schema.js` — add `combo_id` + `round_number` columns, bump `SCHEMA_VERSION` 2 → 3, add migration script
+- `src/db/repositories/executionLogRepository.js` — add `getLastItemsBySession(sessionId)` returning map `exerciseId → { reps_done, weight_used, side }` from most recent log for that session
+- `src/router/index.js` — add `{ path: '/sessions/:id/execute', name: 'session-execute', component: SessionExecuteView }`
+- `src/views/SessionDetailView.vue` — add play button in action bar
+- `src/views/SessionListView.vue` — add play icon per session row
+- `src/i18n/locales/en.json`, `fr.json` — new keys under `execution.*`
+
+**Not in this step (deferred):**
+
+- Timers (EMOM/AMRAP/TABATA) → Step 12
+- Statistics charts → Step 9
+
+**Verification:** Playwright tests — start session navigates to execute view, steps advance on Done, reps/weight editable and saved, asymmetric side shown and logged, combo rounds auto-advance between non-final rounds, final-round screen shows Continue + One More, One More appends extra round, Continue advances to next session item, exit mid-session saves partial log (done items only), re-execute prefills from last session run, session with no prior log prefills from defaults, progress bar reflects current position
+
+---
+
+### Step 9 — Statistics
+
+**Status:** Done
+
+- `StatsView.vue` at `#/stats`
+- Displays database creation date: "You are using TrainUs since [formatted date]"
+- Date formatting uses centralized `dateFormatter.js` utility with locale-aware formatting (DD/MM/YYYY for French, MM/DD/YYYY for English)
+- `chart.js` + `vue-chartjs` v5
+- **Summary cards:** total sessions, total exercises done, current day streak
+- **Date range filter:** quick tabs — 7d / 30d / 3m / All (default: 30d)
+- **Frequency** (bar): sessions grouped by week or month (toggle)
+- **Volume** (bar): total volume (`reps_done × weight_used`) per session execution over time
+- **Progression** (line): reps + weight over time for a selected exercise (one at a time)
+- `src/composables/useStats.js` — all stat queries
+
+**Deferred to Step 9b:** Statistics export (e.g. CSV export of chart data / execution summary)
+
+**Verification:** Playwright tests — creation date displayed, date format changes with language, summary cards show correct counts, cards respond to date range change, streak count correct, frequency/volume/progression charts render, no-data messages shown when period is empty
+
+---
+
+### Step 10 — PWA Finalization & Polish
+
+**Status:** Done
+
+- Migrated from hand-rolled `public/sw.js` to `vite-plugin-pwa` + Workbox (`registerType: 'autoUpdate'`, 10 MB cache limit to cover `sqlite3.wasm`)
+- `manifest.json` updated: `purpose` field on both icons, both icon files now exist (192 × 512 placeholder PNGs)
+- `index.html`: removed manual SW registration script (auto-injected by vite-plugin-pwa), added `<link rel="icon">` and `<link rel="apple-touch-icon">`
+- Install prompt: `useInstallPrompt.js` composable + `InstallPrompt.vue` component (session-dismissible, teleported into action bar, shows only when `beforeinstallprompt` fires)
+- Accessibility (critical flows): `aria-label` on all icon-only actionbar buttons across every view, `role="progressbar"` + `aria-valuenow/min/max` on execution progress bar, `role="alert"` + `aria-describedby` on form error messages, `required`/`aria-required` on required inputs, `role="dialog"` + `aria-modal` + `aria-labelledby` + focus-on-mount + Escape key on `ModalDialog`
+- Responsive 400px: wrapping breakpoints added to exercise, combo, session, and collection form views for dense list items and form action rows
+- Placeholder icons generated (dark bg + blue "T"); real SVG logo deferred
+
+**Verification:** 10/11 tests pass on Firefox and Chromium (1 skipped: progress bar test requires a pre-existing session in the DB)
+
+---
+
+### Step 11 — Documentation & Final Testing
+
+**Status:** Done
+
+- Full test suite run: **434 passed, 2 skipped** on Firefox + Chromium — no failures
+- `docs/technical-documentation.md`: complete rewrite — architecture, full ER diagram (updated for all columns), routing table, all feature sections (Steps 0–10), i18n, versioning, build & deploy
+- `docs/user-documentation.md`: updated — added missing Sessions section, generalized Export/Import section to cover all entity types, added PWA install info
+- `docs/decisions-log.md`: catch-up entries added for Steps 4 and 7
+- `tests/README.md`: new file — setup, run commands, browser targets, file inventory
+- `README.md`: updated tech stack (removed step annotations, added vite-plugin-pwa), added tutorial rows for Steps 3, 3b, 5
+- `docs/plan.md`: Step 11 marked done
+
+**Verification:** all tests green on Firefox + Chromium, docs complete, manual walkthrough by user
+
+---
+
+### Step 12 — Timers & Combo Execution (Optional — Stretch Goal)
+
+**Status:** Done
+
+#### Timer behavior per combo type
+
+**EMOM (Every Minute On the Minute)** — timer drives advancement:
+
+- `repetitions` on the session item = total duration in **minutes**. The number of rounds is `floor(repetitions / number_of_exercises_in_combo)`. The session form displays the field as **Duration (min)** for EMOM items (same as AMRAP).
+- Each exercise occupies one 60-second slot. When the slot timer reaches 0, the app auto-advances to the next step (the log item is saved as completed even if the user never tapped Done). Tapping Done early advances immediately and resets the timer for the next slot.
+- Sound pattern per slot: `bip` at 30 s remaining, `bip` at 2 s remaining, `bip` at 1 s remaining, `BIP` at 0 s.
+
+**AMRAP (As Many Rounds As Possible)** — one countdown for the whole combo, user advances manually:
+
+- Duration = `repetitions` minutes (the `repetitions` field label changes to "Duration (min)" in session form, detail, and execute views when the item is an AMRAP combo).
+- The user taps Done to advance through exercises and rounds as fast as they can.
+- Sound pattern: `BIP` at every elapsed full minute, except the final minute which uses the EMOM pattern — `bip` at 30 s remaining, `bip` at 2 s remaining, `bip` at 1 s remaining, `BIP` at 0 s.
+- When the timer reaches 0: show a "Time's up" screen → user taps Continue to advance to the next session item.
+
+**TABATA** — timer drives each phase automatically:
+
+- Work time and rest time are per-combo, stored in `timer_config` JSON (defaults: work = 20 s, rest = 10 s).
+- Per exercise slot: work phase starts with `BIP` → countdown → auto-transition to rest phase → rest phase starts with `BIP` → countdown → auto-advance to next exercise.
+- After the last exercise of the last round: show the existing final-round screen (Continue / One More Round from Step 8).
+- Duration = `(workTime + restTime) × number_of_exercises_in_combo × rounds`.
+- `ComboFormView` shows "Work time (s)" and "Rest time (s)" number inputs (min 1) when type = TABATA.
+
+#### Sounds (Web Audio API)
+
+Two sound types synthesised via `AudioContext` — no audio assets required:
+
+| Name  | Frequency | Duration | Gain |
+| ----- | --------- | -------- | ---- |
+| `bip` | 440 Hz    | 0.1 s    | low  |
+| `BIP` | 880 Hz    | 0.3 s    | high |
+
+#### Pause
+
+A pause button is visible whenever a timer is active. Pausing freezes the countdown and suppresses scheduled sounds. Resuming continues from the frozen value. Pause works in both work and rest phases (TABATA).
+
+#### UI additions
+
+**Timer display** — shown inside the exercise card for timed combos:
+
+```
+│  Push-up                          │
+│  Combo: HIIT — Round 2 of 2       │
+│                                   │
+│         00:42                     │  ← turns red when < 10 s
+│                                   │
+│  [⏸ Pause]        [ ✓ Done ]      │
+```
+
+**TABATA rest screen** — replaces the exercise card during rest phase:
+
+```
+│  REST                             │
+│  Next: Squat                      │
+│                                   │
+│         00:08                     │
+│                                   │
+│  [⏸ Pause]                        │
+```
+
+**AMRAP "Time's up" screen** — shown when the overall AMRAP timer reaches 0:
+
+```
+│  ⏱ Time's up — HIIT              │
+│                                   │
+│  [ Continue → ]                   │
+```
+
+#### Schema
+
+No schema version bump needed. The `timer_config` column already exists on `combo` as a JSON text field:
+
+- TABATA: `{ "workTime": 20, "restTime": 10 }`
+- EMOM / AMRAP: `{}` or `null` (duration derived from `repetitions` at runtime)
+
+#### Files to create / modify
+
+**New:**
+
+| File                              | Purpose                                                                          |
+| --------------------------------- | -------------------------------------------------------------------------------- |
+| `src/composables/useTimer.js`     | Core countdown: start, pause, resume, reset, per-second tick with callback hooks |
+| `src/composables/useAudioCues.js` | Web Audio API helpers: `playBip()`, `playBIP()`, AudioContext lifecycle          |
+| `src/components/TimerDisplay.vue` | Visual countdown (MM:SS), red-when-low styling, pause/resume button              |
+
+**Modified:**
+
+| File                                     | Change                                                                                                          |
+| ---------------------------------------- | --------------------------------------------------------------------------------------------------------------- |
+| `src/composables/useSessionExecution.js` | Wire timer into step lifecycle: EMOM/TABATA auto-advance on expiry; AMRAP time-up; sound scheduling             |
+| `src/views/SessionExecuteView.vue`       | Render `<TimerDisplay>`, TABATA rest screen, AMRAP time-up screen, pause state                                  |
+| `src/views/ComboFormView.vue`            | Work/rest time inputs shown only when type = TABATA; saved to `timer_config`                                    |
+| `src/views/SessionFormView.vue`          | AMRAP combo item label: "Repetitions" → "Duration (min)"                                                        |
+| `src/views/SessionDetailView.vue`        | Same AMRAP label change                                                                                         |
+| `src/i18n/locales/en.json` + `fr.json`   | New keys under `execution.timer.*`, `combos.form.workTime`, `combos.form.restTime`, `sessions.form.durationMin` |
+| `docs/plan.md`                           | Step marked done                                                                                                |
+
+**Note:** Once implemented, Step 10 (PWA) and Step 11 (documentation) will need a follow-up review pass.
+
+**Verification:** Playwright tests — EMOM timer auto-advances at 0 s, EMOM sounds fire at 30/2/1/0 s, EMOM manual Done advances early and resets timer; AMRAP BIP fires every elapsed minute, AMRAP last-minute bip/bip/BIP pattern fires correctly, AMRAP time-up screen appears at 0 and Continue advances; TABATA work→rest→next-exercise cycle, BIP at start of each phase, pause works in both phases; TABATA ComboForm shows work/rest inputs only for TABATA type and values round-trip correctly; session form shows "Duration (min)" for AMRAP combo items; non-timed combos (NONE) show no timer and behave as in Step 8; mixed session (timed + non-timed items) works end-to-end; pause freezes countdown and suppresses sounds; resume continues from frozen value
+
+---
+
+### Step 13 — Markdown in Description Fields
+
+**Status:** Done
+
+- Enabled `marked` + `DOMPurify` for rendering description fields in exercise, combo, and session detail views (already used as dependencies; this step wired them into the detail views)
+- Added "Basic Markdown supported" hint text next to each description label in create and edit forms
+- Description is intentionally **not** shown on list view cards (only in detail views)
+- `src/utils/markdown.js` centralises the sanitized rendering pipeline; all three detail views call it via `v-html`
+
+**New / modified files:**
+
+- `src/utils/markdown.js` — `renderMarkdown(text)` using `marked.parse` + `DOMPurify.sanitize`
+- `src/views/ExerciseDetailView.vue`, `src/views/ComboDetailView.vue`, `src/views/SessionDetailView.vue` — render description via `v-html`
+- `src/views/ExerciseFormView.vue`, `src/views/ComboFormView.vue`, `src/views/SessionFormView.vue` — hint text alongside description label
+- `src/i18n/locales/en.json`, `fr.json` — `"markdownHint"` translation key
+
+**Verification:** Playwright tests — markdown hint visible on exercise/combo/session forms; bold, italic, and list items render as HTML in exercise detail; bold renders in combo and session details; description absent from all list cards
+
+---
+
+### Step 14 — Form Keyboard Shortcuts
+
+**Status:** Done
+
+- `Ctrl+Enter` saves any create or edit form, even when a text field is focused
+- `Escape` cancels the form and navigates back (to list on new forms, to detail on edit forms), even when a text field is focused
+- Save button exposes a `title` attribute showing the shortcut hint (visible as a native tooltip on hover)
+- Shortcuts are attached to the form element's `keydown` event and skip when the browser is composing (IME)
+- Applies to Exercise, Combo, Session, and Collection forms
+
+**Modified files:**
+
+- `src/views/ExerciseFormView.vue`, `src/views/ComboFormView.vue`, `src/views/SessionFormView.vue`, `src/views/CollectionFormView.vue` — keydown handler, save button `title`
+- `src/i18n/locales/en.json`, `fr.json` — `"saveShortcutHint"` translation key
+
+**Verification:** Playwright tests — `Ctrl+Enter` saves from body and from within an input; `Ctrl+Enter` with empty title shows validation error (does not save); `Escape` from body and from within an input navigates back; `Escape` on edit form returns to detail view; Save button title contains the shortcut hint; shortcuts confirmed on session, combo, and collection forms
+
+---
+
+### Step 15 — Audio Cues Refinement
+
+**Status:** Done
+
+Iterative refinement of the audio cue timing introduced in Step 12, driven by deterministic fake-clock tests that exposed subtle off-by-one issues in the scheduling logic.
+
+- **TABATA:** `playBip` fires at the exact halfway point of each work and rest interval (not at 30 s absolute like EMOM — relative to the phase duration)
+- **TABATA:** `bip, bip, BIP` countdown fires at `r = 2`, `r = 1`, and phase expiry for both work and rest phases
+- **AMRAP:** `playBip` (soft) fires at each elapsed full minute tick; the half-time signal uses `playBIP` (loud) — both corrected to fire on the right tick
+- Tests use `page.clock.install()` to control fake time, making timer assertions instant and deterministic without real `setTimeout` waits
+
+**Modified files:**
+
+- `src/composables/useSessionExecution.js` — `_tabataCountdown`, `_amrapSounds`, `_maybeStartAmrapTimer` helpers adjusted for correct relative timing
+- `tests/test_step15_audio_cues.py` — new test file using `AudioContext` mock + `page.clock`
+
+**Verification:** Playwright tests — TABATA bip at half work/rest interval; bip/bip/BIP countdown at end of work and rest phases; AMRAP per-minute soft bip fires correctly; all assertions driven by fake clock
+
+---
+
+### Step 16 — Single Deployment + Startup DB Migration
+
+**Status:** Implemented — detailed plan in [`plan-step16-single-deployment-migration.md`](plan-step16-single-deployment-migration.md); awaiting manual validation by the user
+
+Replaces the "versioned deployments with isolated data" model: a single deployment (latest version at site root), a stable OPFS database location (no version suffix), and a transactional migration step at app startup driven by the `RELEASES` registry. When a migration is pending, a blocking screen forces the user to download a backup before the update runs. No `SCHEMA_VERSION` bump (stays at 1).
+
+**Key files:**
+
+- `src/db/releases.js` — `adaptScript` renamed to `migrationScript`; new `getMigrationScripts(from, to)` helper shared by startup migration and restore adaptation
+- `src/db/worker.js` — stable OPFS directory (`.trainus`); `getSchemaStatus` (fresh / up-to-date / incompatible / migration-pending) and `runMigrations` (one transaction per release, rollback on failure) message handlers
+- `src/db/database.js` — init pauses on `migration-pending` (sets `db.migrationPending`); `runPendingMigrations()`; error codes `DB_NEWER_THAN_APP` / `DB_MIGRATION_FAILED`
+- `src/App.vue` — blocking migration screen (forced backup download enables the Update button) + error-code → translated message mapping
+- `src/composables/useBackupDownload.js` — backup download logic shared by SettingsView and the migration screen
+- `tests/test_step16_migration.py` — green + red paths, Firefox + Chromium
+
+**Verification:** Playwright tests — fresh install stamps `schema_version`; data persists across reloads; OPFS dir is unversioned; full migration flow (forced backup → Update → data intact); DB-newer-than-app blocks safely; migration screen cannot be bypassed. Migration-failure rollback test deferred until a real v2 migration script exists.
+
+---
+
+### Improvement Plan (post-v1.0 review) — `docs/improvement-plan.md`
+
+**Status:** Implemented — awaiting manual validation by the user
+
+All items from the improvement plan have been implemented. See `docs/improvement-plan.md` for the original descriptions and DoDs.
+
+| Item | Description                                              | Status  |
+| ---- | -------------------------------------------------------- | ------- |
+| R1   | Batch transactions for multi-statement repository writes | ✅ Done |
+| R2   | Atomic full-DB restore (single transaction)              | ✅ Done |
+| R3   | Wall-clock timer (timestamp-based, drift-free)           | ✅ Done |
+| R4-B | Execution log status column + route-leave guard          | ✅ Done |
+| R5   | DB worker crash → error overlay + immediate reject       | ✅ Done |
+| R6   | Remove duplicate `getAllWithItems` key                   | ✅ Done |
+| R7   | Deduplicate AMRAP round-adder (`_appendRound`)           | ✅ Done |
+| R8   | Add ESLint (flat config, 0 errors/warnings)              | ✅ Done |
+| R9   | Fix O(n²) import (Map-based title lookup)                | ✅ Done |
+| R10  | Escape LIKE wildcards in all `search()` methods          | ✅ Done |
+| R11  | `validateMin` returns `{key, params}` for interpolation  | ✅ Done |
+| R12  | 404 catch-all route → redirect to /home                  | ✅ Done |
+| R13  | Superseded by Step 16                                    | ✅ N/A  |
+| R14  | Cross-user import skips settings                         | ✅ Done |
+| R15  | Delete confirms show history count                       | ✅ Done |
+| R16  | GitHub Actions CI (lint + build + test)                  | ✅ Done |
+| R17  | Documentation refresh (locale claims, COOP/COEP, lint)   | ✅ Done |
+| R18  | Test-infra: isolate tmp paths per pytest run             | ✅ Done |
+
+**Key files changed:** `src/db/worker.js`, `src/db/database.js`, `src/db/schema.js`, `src/db/repositories/*.js`, `src/composables/useTimer.js`, `src/composables/useSessionExecution.js`, `src/composables/useJsonImport.js`, `src/views/SessionExecuteView.vue`, `src/views/ExerciseDetailView.vue`, `src/views/SessionDetailView.vue`, `src/router/index.js`, `src/utils/escapeLike.js`, `src/utils/validation.js`, `eslint.config.js`, `.github/workflows/ci.yml`, `tests/conftest.py`, `tests/test_step17_transactions.py`, `tests/test_step18_execution_abandon.py`, `tests/test_step19_db_resilience.py`, `tests/test_step20_search_escaping.py`
+
+---
+
+### Website — Hugo static site (`website/`)
+
+**Status:** Steps 1–5 done (2026-06-14) — awaiting manual validation
+
+Hugo 0.123.7 static site under `website/`. FR default at `/`, EN at `/en/`. Deployed to a subpath of the personal domain on Uberspace (manual deploy, no CI). No tutorials section. Blog lives on this project site.
+
+| Step | Description                                                                     | Status  |
+| ---- | ------------------------------------------------------------------------------- | ------- |
+| W1   | Scaffold: `hugo new site`, `hugo.toml`, npm scripts, `.gitignore`               | ✅ Done |
+| W2   | Base theme: `baseof.html`, partials, `main.css`, `single.html`, `list.html`     | ✅ Done |
+| W3   | Home page: hero, greyed CTA button, features grid, i18n strings                 | ✅ Done |
+| W4   | Docs: port EN docs, FR skeletons, Mermaid hook, stub old docs, update AGENTS.md | ✅ Done |
+| W5   | Blog: `_index`, first FR post + EN skeleton, RSS autodiscovery verified         | ✅ Done |
+| W6   | Deploy: set `baseURL`, set `params.appUrl`, upload `dist/` to Uberspace         | 🔲 TODO |
+| W7   | EN docs: port `user-guide.en.md` to the FR Diataxis split (2026-06-16)          | ✅ Done |
+
+**Key files:** `website/hugo.toml`, `website/assets/css/main.css`, `website/layouts/`, `website/content/docs/`, `website/content/blog/`, `website/i18n/`
+
+**Known quirk:** Mermaid render hook must be at `layouts/_default/_markup/render-codeblock-mermaid.html` (not `layouts/_markup/` — Ubuntu pkg 0.123.7 only picks up the `_default/` path).
+
+---
+
+### Backlog — JSON import: title-conflict resolution UX
+
+**Status:** ✅ Done (2026-06-16)
+
+**Found:** 2026-06-16, while writing the user documentation and tracing `useJsonImport.js` to answer a question about what drives import conflict detection. Conflict detection during import was `id`-only: a title match against a _different_ existing row either silently failed (same-user) or only offered a forced rename (cross-user, after suffixing).
+
+**What changed:**
+
+- `_analyzeEntityList` now detects title conflicts (different id, same title) for same-user imports and folds them into the existing `sameUserCollisions` bucket — the same Replace/Skip screen (with batch Replace All / Skip All) used for id conflicts handles them with zero new UI.
+- `_importEntityList` resolves same-user collisions against `collision.existing.id` (not `collision.imported.id`), so Replace updates the existing row in place and Skip leaves it untouched — both redirect any same-batch reference to the imported id (e.g. a combo's `exercise_id`) to the existing row's id via the same `idMap` mechanism already used for cross-user `new_id` remapping.
+- Cross-user title conflicts (suffixed title collides with a previously-imported item from the same external user) now also resolve via Replace/Skip instead of a forced rename — `ImportDialog.vue` folds them into the same per-entity-type resolution arrays once detected in `onApply`.
+- **Cleanup:** `analyzeExercises`, `applySameUserImport`, `applyDifferentUserImport`, and `checkTitleConflict` in `useJsonImport.js` turned out to be dead code (confirmed via grep — never called for applying; `analyzeAll` already produces an identical shape for exercise-only envelopes). Removed, along with the "legacy exercise-only" branch in `ImportDialog.vue`'s `onMounted` and the now-unreachable forced-rename `titleConflict` step/state. `analyzeAll`/`applyAllImport` now handle every envelope shape.
+
+**Key files changed:** `src/composables/useJsonImport.js`, `src/components/ImportDialog.vue`, `src/i18n/locales/{en,fr,da}.json`, `tests/test_step21_import_title_conflicts.py` (new), `website/content/docs/comprendre.fr.md`, `website/content/docs/user-guide/index.fr.md`, `website/content/docs/user-guide.en.md`, `website/content/developers/technical.en.md`.
+
+**Out of scope (unchanged):** an id-collision where the _new_ title also conflicts with an unrelated third row still surfaces as a raw DB error, same as before.
+
+---
+
+### Backlog — Save filename prompt on every disk save
+
+**Status:** ✅ Done (2026-06-16)
+
+**Found:** 2026-06-16, user request — every file save (JSON exports, home HTML export, SQLite backup) should ask for a filename, prefilled with the previous default, before saving.
+
+**What changed:**
+
+- New singleton composable `useSaveFilePrompt.js` (`promptFilename(defaultFilename)` → `Promise<string|null>`, splits the default into stem + extension) and new component `SaveFileDialog.vue` (editable stem, fixed extension, Enter-to-confirm), mounted once in `App.vue` so it's available app-wide, including the blocking pre-migration backup screen.
+- The 3 existing low-level download functions — `downloadJson` (`jsonEnvelope.js`), `downloadBackup` (`useBackupDownload.js`), the local `downloadHtml` (`useHtmlExport.js`) — call the prompt before building the blob/anchor and no-op on cancel. No view-level export call site changed.
+- `downloadBackup()` now returns `false` on cancel; `App.vue`'s `onMigrationBackup` only enables the Update button if the save actually completed.
+- **Fix found along the way:** `ModalDialog`'s `z-index: 1000` was below the blocking `.db-overlay`'s `9999`, making the dialog unclickable from the migration screen — bumped to `10000`.
+- **Fix found along the way:** a few export call sites (`useJsonExport.js`'s `downloadJson` calls, `SettingsView.vue`'s `onExportAll`, `HomeView.vue`'s `onExportHtml`) weren't awaited; added `await` since the call now blocks on user input.
+
+**Key files changed:** `src/composables/useSaveFilePrompt.js` (new), `src/components/SaveFileDialog.vue` (new), `src/utils/jsonEnvelope.js`, `src/composables/useBackupDownload.js`, `src/composables/useHtmlExport.js`, `src/composables/useJsonExport.js`, `src/components/ModalDialog.vue`, `src/App.vue`, `src/views/SettingsView.vue`, `src/views/HomeView.vue`, `src/i18n/locales/{en,fr,da}.json`, `tests/test_step22_save_filename_prompt.py` (new), `tests/test_step2_settings.py`, `tests/test_step3c_backup.py`, `tests/test_step16_migration.py` (updated to confirm the dialog before asserting on the download), `website/content/developers/technical.en.md`, `website/content/docs/user-guide.en.md`, `docs/decisions-log.md`.
+
+---
+
+### Backlog — Clear (×) button on list search fields
+
+**Status:** ✅ Done (2026-06-18)
+
+**Found:** 2026-06-18, user request — the search field on the four list views (Exercises, Combos, Sessions, Collections) had no quick way to clear the text short of selecting/deleting it manually or toggling search off and back on.
+
+**What changed:**
+
+- Each of `ExerciseListView.vue`, `ComboListView.vue`, `SessionListView.vue`, `CollectionsView.vue` gained a `clearSearch()` function and a clear button (`bi-x-lg`) rendered inside the search input, visible only when the field has text. The button uses `@mousedown.prevent` (not `@click`) so it clears focus-safely without triggering the existing blur-to-close-search-bar logic on the old value.
+- New shared i18n key `common.clearSearch` (EN/FR/DA) for the button's `title`/`aria-label`.
+- New `data-testid="<entity>-search-clear"` per view, following the existing `<entity>-search-*` convention.
+
+**Key files changed:** `src/views/ExerciseListView.vue`, `src/views/ComboListView.vue`, `src/views/SessionListView.vue`, `src/views/CollectionsView.vue`, `src/i18n/locales/{en,fr,da}.json`, `tests/test_step3_exercises.py`, `tests/test_step4_combos.py`, `tests/test_step5_sessions.py`, `tests/test_step6_collections_home.py`, `website/content/docs/user-guide/index.{en,fr}.md`, `website/content/developers/technical.{en,fr}.md`, `docs/decisions-log.md`.
+
+---
+
+## Data Model
+
+```mermaid
+erDiagram
+    SETTINGS {
+        text key PK
+        text value
+    }
+    EXERCISE {
+        text id PK
+        text title UK
+        text description
+        boolean asymmetric
+        boolean alternate
+        text image_urls
+        text video_urls
+        integer default_reps
+        real default_weight
+        text created_by
+    }
+    COMBO {
+        text id PK
+        text title UK
+        text description
+        text type
+        text timer_config
+        text created_by
+    }
+    COMBO_EXERCISE {
+        text combo_id FK
+        text exercise_id FK
+        integer position
+        integer default_reps
+        real default_weight
+    }
+    SESSION {
+        text id PK
+        text title UK
+        text description
+        text created_by
+    }
+    SESSION_ITEM {
+        text session_id FK
+        text item_id
+        text item_type
+        integer position
+        integer repetitions
+        real weight
+    }
+    COLLECTION {
+        text id PK
+        text label UK
+        text created_by
+    }
+    COLLECTION_SESSION {
+        text collection_id FK
+        text session_id FK
+        integer position
+    }
+    EXECUTION_LOG {
+        text id PK
+        text session_id FK
+        datetime started_at
+        datetime finished_at
+    }
+    EXECUTION_LOG_ITEM {
+        text id PK
+        text log_id FK
+        text exercise_id FK
+        text combo_id
+        integer round_number
+        integer reps_done
+        real weight_used
+        text side
+        boolean completed
+        datetime timestamp
+    }
+    SUFFIX {
+        text user_uuid PK
+        text user_name
+        text suffix UK
+    }
+
+    COMBO ||--|{ COMBO_EXERCISE : contains
+    EXERCISE ||--o{ COMBO_EXERCISE : "used in"
+    SESSION ||--|{ SESSION_ITEM : contains
+    COLLECTION ||--|{ COLLECTION_SESSION : contains
+    SESSION ||--o{ COLLECTION_SESSION : "used in"
+    SESSION ||--o{ EXECUTION_LOG : "executed as"
+    EXECUTION_LOG ||--|{ EXECUTION_LOG_ITEM : records
+    EXERCISE ||--o{ EXECUTION_LOG_ITEM : tracks
+```
+
+`SETTINGS` stores: `user_uuid`, `user_name`, `app_version`, `language`, `theme`, `db_created_at`, `last_backup_at`, `backup_reminder_days` as key/value rows. `created_by` on entities = UUID string for export provenance. `SUFFIX` maps external user UUIDs to short suffix strings used to disambiguate imported titles (e.g., `"Push-ups [JD]"`).
+
+---
+
+## Decisions
+
+| Decision         | Choice                                                   | Rationale                                                                                                                                                                       |
+| ---------------- | -------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| Framework        | Vue 3 + Vite                                             | Reactive framework needed for form-heavy CRUD, timers, i18n                                                                                                                     |
+| i18n             | i18next + vue-i18next                                    | Proven open-source, MIT licensed, rich features                                                                                                                                 |
+| App version      | package.json → Vite inject → DB settings                 | Single source of truth, available at build + runtime                                                                                                                            |
+| User model       | Single user per device, identity in settings             | No multi-user complexity needed                                                                                                                                                 |
+| Settings order   | Step 2 (early)                                           | Language/theme switching before entity CRUD                                                                                                                                     |
+| SQLite           | Official WASM with OPFS VFS                              | Best maintained, native OPFS                                                                                                                                                    |
+| Charts           | Chart.js via vue-chartjs                                 | Good balance of features and size                                                                                                                                               |
+| Routing          | Vue Router, hash mode                                    | No server config needed                                                                                                                                                         |
+| ID collisions    | Suffix on title + new UUID                               | Preserves alphabetical sort; "Title [SUFFIX]" is user-readable; suffix pre-filled with exporter name; batch Replace All / Skip All for same-user conflicts                      |
+| OPFS namespacing | Stable directory `.trainus`, no version suffix (Step 16) | OPFS is origin-scoped, so versioned directories never truly isolated data; a stable location preserves data across app updates, with startup migrations handling schema changes |
+| Timer config     | EMOM/AMRAP/TABATA params as JSON                         | Flexible, stored in `timer_config` column                                                                                                                                       |
diff --git a/docs/release-procedure.md b/docs/release-procedure.md
new file mode 100644
index 0000000..38bf8b5
--- /dev/null
+++ b/docs/release-procedure.md
@@ -0,0 +1,101 @@
+# Release Procedure
+
+Describes how to publish a new TrainUs release. A local script prepares everything on your machine; all server-side steps (Forgejo, deployment, website) are done manually afterwards.
+
+## Pre-release checklist
+
+Before running the script, verify:
+
+- [ ] All tests pass on both browsers: `npm run test:parallel`
+- [ ] `docs/plan.md` is up to date
+- [ ] Documentation updated (`website/content/developers/technical.en.md`, `website/content/docs/user-guide/index.en.md`, `docs/decisions-log.md`)
+- [ ] Working tree is clean on `main`
+
+## Step 1 — Run the local script
+
+```bash
+./scripts/release.sh
+```
+
+The script asks for the new version (semver, e.g. `1.1.0`), then displays the full plan and asks for confirmation before doing anything. It then executes the following steps in order, printing what it does before each one:
+
+Before displaying the plan, the script lists all commits since the last tag (or all commits if no tag exists yet). This helps you choose the right version bump (patch/minor/major) and serves as the raw material for the release notes.
+
+| #   | What                | Command / output                                                                                                                                      |
+| --- | ------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- |
+| 1   | Bump version        | `npm version X.Y.Z --no-git-tag-version` → updates `package.json` and `package-lock.json`                                                             |
+| 2   | Build the app       | `npm run build` → outputs to `dist/`                                                                                                                  |
+| 3   | Release commit      | `git commit -m "chore: release vX.Y.Z"` on the current branch                                                                                         |
+| 4   | Annotated tag       | `git tag -a vX.Y.Z -m "Release vX.Y.Z"` — local only, not pushed                                                                                      |
+| 5   | Source archive      | `git archive --format=zip HEAD --output=trainus-vX.Y.Z-src.zip` — tracked files only; excludes `node_modules/`, `dist/`, `.git/`, and untracked files |
+| 6   | Draft release notes | Writes `trainus-vX.Y.Z-notes.md` — a Markdown template pre-filled with the commit list, ready to edit                                                 |
+
+Nothing is pushed or sent anywhere during this step.
+
+### Artifacts produced
+
+| File                      | Purpose                                                            |
+| ------------------------- | ------------------------------------------------------------------ |
+| `dist/`                   | Built PWA — deploy to your static host                             |
+| `trainus-vX.Y.Z-src.zip`  | Source archive — attach to the Forgejo release                     |
+| `trainus-vX.Y.Z-notes.md` | Draft release notes — edit, then paste as the Forgejo release body |
+
+## Step 2 — Edit the release notes
+
+Open `trainus-vX.Y.Z-notes.md` in your editor. The file contains:
+
+- A template with "What's new", "Bug fixes", and "Breaking changes" sections
+- The raw commit list since the last release, for reference
+
+Rewrite the sections into polished prose, remove the raw commit list, then save the file.
+
+## Step 3 — Push to Forgejo
+
+```bash
+git push origin main
+git push origin vX.Y.Z
+```
+
+## Step 4 — Create the release on Forgejo
+
+In your Forgejo repository → **Releases → New release**:
+
+- **Tag**: `vX.Y.Z`
+- **Title**: `TrainUs vX.Y.Z`
+- **Body**: release notes (what's new, bug fixes, breaking changes)
+- **Attachments**: `trainus-vX.Y.Z-src.zip` (created by the script)
+
+Publish the release. You can then delete the local archive.
+
+## Step 5 — Deploy the app
+
+Upload the contents of `dist/` to your static host (the live PWA).
+
+## Step 6 — Deploy the website
+
+```bash
+npm run site:build   # outputs to website/public/
+```
+
+Upload the contents of `website/public/` to your website host.
+
+## Step 7 — Publish the release blog post
+
+1. Duplicate `website/content/blog/release-template.en.md`
+2. Rename it `YYYY-MM-DD-release-vX.Y.Z.en.md` (use today's date)
+3. Fill in every `{PLACEHOLDER}` field
+4. Set `draft: false` when the post is ready to publish
+5. Write the French version yourself: `YYYY-MM-DD-release-vX.Y.Z.fr.md`
+6. Rebuild and redeploy the website (step 5)
+
+## Versioning
+
+TrainUs uses **semantic versioning**: `MAJOR.MINOR.PATCH`
+
+| Increment | When                               |
+| --------- | ---------------------------------- |
+| `PATCH`   | Bug fixes only, no new features    |
+| `MINOR`   | New features, backwards-compatible |
+| `MAJOR`   | Breaking change or major redesign  |
+
+Git tags use the `v` prefix convention: `v1.0.0`, `v1.1.0`, `v2.0.0`, etc.
diff --git a/eslint.config.js b/eslint.config.js
new file mode 100644
index 0000000..55b3356
--- /dev/null
+++ b/eslint.config.js
@@ -0,0 +1,58 @@
+import js from '@eslint/js'
+import vue from 'eslint-plugin-vue'
+import prettier from 'eslint-config-prettier'
+
+export default [
+  {
+    ignores: ['dist/**', 'tests/**', 'public/**', 'node_modules/**'],
+  },
+  js.configs.recommended,
+  ...vue.configs['flat/recommended'],
+  prettier,
+  {
+    languageOptions: {
+      globals: {
+        __APP_VERSION__: 'readonly',
+        __APP_NAME__: 'readonly',
+        // Browser globals
+        window: 'readonly',
+        document: 'readonly',
+        console: 'readonly',
+        crypto: 'readonly',
+        navigator: 'readonly',
+        self: 'readonly',
+        fetch: 'readonly',
+        setTimeout: 'readonly',
+        clearTimeout: 'readonly',
+        setInterval: 'readonly',
+        clearInterval: 'readonly',
+        URL: 'readonly',
+        URLSearchParams: 'readonly',
+        Blob: 'readonly',
+        File: 'readonly',
+        FileReader: 'readonly',
+        CustomEvent: 'readonly',
+        Worker: 'readonly',
+        Promise: 'readonly',
+        Map: 'readonly',
+        Set: 'readonly',
+        // Web APIs
+        AudioContext: 'readonly',
+        TextEncoder: 'readonly',
+        TextDecoder: 'readonly',
+        btoa: 'readonly',
+        atob: 'readonly',
+        // Worker globals
+        importScripts: 'readonly',
+      },
+    },
+    rules: {
+      'no-unused-vars': [
+        'warn',
+        { argsIgnorePattern: '^_', varsIgnorePattern: '^_', caughtErrorsIgnorePattern: '^_' },
+      ],
+      'vue/multi-word-component-names': 'off',
+      'vue/no-v-html': 'off',
+    },
+  },
+]
diff --git a/index.html b/index.html
new file mode 100644
index 0000000..9defe84
--- /dev/null
+++ b/index.html
@@ -0,0 +1,21 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <meta name="description" content="TrainUs — Local-first fitness training app" />
+    <meta name="theme-color" content="#1a1a1a" />
+    <meta name="mobile-web-app-capable" content="yes" />
+    <meta name="apple-mobile-web-app-capable" content="yes" />
+    <meta name="apple-mobile-web-app-status-bar-style" content="black-translucent" />
+    <link rel="manifest" href="/manifest.json" />
+    <link rel="icon" type="image/svg+xml" href="/icon.svg" />
+    <link rel="icon" type="image/png" href="/icon-192.png" />
+    <link rel="apple-touch-icon" href="/icon-192.png" />
+    <title>TrainUs</title>
+  </head>
+  <body>
+    <div id="app"></div>
+    <script type="module" src="/src/main.js"></script>
+  </body>
+</html>
diff --git a/jsconfig.json b/jsconfig.json
new file mode 100644
index 0000000..97adc43
--- /dev/null
+++ b/jsconfig.json
@@ -0,0 +1,11 @@
+{
+  "compilerOptions": {
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "target": "ESNext",
+    "jsx": "preserve",
+    "baseUrl": "."
+  },
+  "include": ["src/**/*", "vite.config.js"],
+  "exclude": ["node_modules", "dist"]
+}
diff --git a/notice.md b/notice.md
new file mode 100644
index 0000000..29e2236
--- /dev/null
+++ b/notice.md
@@ -0,0 +1,15 @@
+TrainUs — an open, local-first, offline-capable fitness tracking application where you can create and share your own training sessions.
+Copyright (C) 2026 [David Florance](http://kaivalya.eu)
+
+This program is free software: you can redistribute it and/or modify
+it under the terms of the GNU Affero General Public License as
+published by the Free Software Foundation, either version 3 of the
+License, or (at your option) any later version.
+
+This program is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+GNU Affero General Public License for more details.
+
+You should have received a copy of the GNU Affero General Public License
+along with this program. If not, see <http://www.gnu.org/licenses/>.
diff --git a/package-lock.json b/package-lock.json
new file mode 100644
index 0000000..18842df
--- /dev/null
+++ b/package-lock.json
@@ -0,0 +1,7144 @@
+{
+  "name": "trainus",
+  "version": "1.0.0",
+  "lockfileVersion": 3,
+  "requires": true,
+  "packages": {
+    "": {
+      "name": "trainus",
+      "version": "1.0.0",
+      "dependencies": {
+        "@sqlite.org/sqlite-wasm": "^3.51.2-build7",
+        "bootstrap-icons": "^1.13.1",
+        "chart.js": "^4.5.1",
+        "dompurify": "^3.4.7",
+        "i18next": "^25.8.17",
+        "i18next-vue": "^5.4.0",
+        "marked": "^18.0.4",
+        "vue": "^3.5.25",
+        "vue-chartjs": "^5.3.3",
+        "vue-router": "^4.6.4"
+      },
+      "devDependencies": {
+        "@eslint/js": "^10.0.1",
+        "@vitejs/plugin-vue": "^6.0.2",
+        "eslint": "^10.5.0",
+        "eslint-config-prettier": "^10.1.8",
+        "eslint-plugin-vue": "^10.9.2",
+        "prettier": "^3.8.1",
+        "vite": "^7.3.1",
+        "vite-plugin-pwa": "^1.3.0"
+      }
+    },
+    "node_modules/@apideck/better-ajv-errors": {
+      "version": "0.3.7",
+      "resolved": "https://registry.npmjs.org/@apideck/better-ajv-errors/-/better-ajv-errors-0.3.7.tgz",
+      "integrity": "sha512-TajUJwGWbDwkCx/CZi7tRE8PVB7simCvKJfHUsSdvps+aTM/PDPP4gkLmKnc+x3CE//y9i/nj74GqdL/hwk7Iw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "jsonpointer": "^5.0.1",
+        "leven": "^3.1.0"
+      },
+      "engines": {
+        "node": ">=10"
+      },
+      "peerDependencies": {
+        "ajv": ">=8"
+      }
+    },
+    "node_modules/@babel/code-frame": {
+      "version": "7.29.7",
+      "resolved": "https://registry.npmjs.org/@babel/code-frame/-/code-frame-7.29.7.tgz",
+      "integrity": "sha512-Aup7aUOfpbAUg2ROOJN6Iw5f9DMBlzu0mIkm/malLQFN/YQgO48wCj0Kxa3sEHJvPVFg7siR+qRInwXd2qhQKw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@babel/helper-validator-identifier": "^7.29.7",
+        "js-tokens": "^4.0.0",
+        "picocolors": "^1.1.1"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      }
+    },
+    "node_modules/@babel/compat-data": {
+      "version": "7.29.7",
+      "resolved": "https://registry.npmjs.org/@babel/compat-data/-/compat-data-7.29.7.tgz",
+      "integrity": "sha512-locTkQyKvwIEgBzVrn8693ebc97F2U8ZHjbXwDXJ5Fn2TCpNwTlKcaKLkdHop5c/icOFE7qt7Q9JC5hnKNa6Gg==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=6.9.0"
+      }
+    },
+    "node_modules/@babel/core": {
+      "version": "7.29.7",
+      "resolved": "https://registry.npmjs.org/@babel/core/-/core-7.29.7.tgz",
+      "integrity": "sha512-RgHBCvtjbOK2gXSNBNIkNoEc9qoVEtau3hj8gEqKQuL3HZAibKarWFEI3Lfm6EYKkLalOh8eSrj9b+ch9H/VBA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@babel/code-frame": "^7.29.7",
+        "@babel/generator": "^7.29.7",
+        "@babel/helper-compilation-targets": "^7.29.7",
+        "@babel/helper-module-transforms": "^7.29.7",
+        "@babel/helpers": "^7.29.7",
+        "@babel/parser": "^7.29.7",
+        "@babel/template": "^7.29.7",
+        "@babel/traverse": "^7.29.7",
+        "@babel/types": "^7.29.7",
+        "@jridgewell/remapping": "^2.3.5",
+        "convert-source-map": "^2.0.0",
+        "debug": "^4.1.0",
+        "gensync": "^1.0.0-beta.2",
+        "json5": "^2.2.3",
+        "semver": "^6.3.1"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/babel"
+      }
+    },
+    "node_modules/@babel/generator": {
+      "version": "7.29.7",
+      "resolved": "https://registry.npmjs.org/@babel/generator/-/generator-7.29.7.tgz",
+      "integrity": "sha512-DkXD5OJQaAQIdZ1bt3UZdEnHAn9Imd3IVBdX03UFe+ony9Ojw5pzr9YVKGDY1jt+Gcn/FnGkNf8r+Vj5NOJWtQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@babel/parser": "^7.29.7",
+        "@babel/types": "^7.29.7",
+        "@jridgewell/gen-mapping": "^0.3.12",
+        "@jridgewell/trace-mapping": "^0.3.28",
+        "jsesc": "^3.0.2"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      }
+    },
+    "node_modules/@babel/helper-annotate-as-pure": {
+      "version": "7.29.7",
+      "resolved": "https://registry.npmjs.org/@babel/helper-annotate-as-pure/-/helper-annotate-as-pure-7.29.7.tgz",
+      "integrity": "sha512-OoK6239jHPuSQOoS0kfTVKn0b/rVTk0seKq4Gd2UMLtmOVLjDC0ki3e+c90Trqv2gMfvJFqkiljrr568+qddiw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@babel/types": "^7.29.7"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      }
+    },
+    "node_modules/@babel/helper-compilation-targets": {
+      "version": "7.29.7",
+      "resolved": "https://registry.npmjs.org/@babel/helper-compilation-targets/-/helper-compilation-targets-7.29.7.tgz",
+      "integrity": "sha512-wem6WaBj4NaVYVdNhLPPVacES6ZJ+KBBfSkTMD3YZxbP3rm3Di85tJU5ljaUNhaOynt+Aj0xruhYuzQBt8n71g==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@babel/compat-data": "^7.29.7",
+        "@babel/helper-validator-option": "^7.29.7",
+        "browserslist": "^4.24.0",
+        "lru-cache": "^5.1.1",
+        "semver": "^6.3.1"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      }
+    },
+    "node_modules/@babel/helper-create-class-features-plugin": {
+      "version": "7.29.7",
+      "resolved": "https://registry.npmjs.org/@babel/helper-create-class-features-plugin/-/helper-create-class-features-plugin-7.29.7.tgz",
+      "integrity": "sha512-IY3ZD9Tmooqr3TUhc3DUWxiuo8xx1DWLhd5M7hQ+ZWJamqM2BbalrBJb2MisSLoYorOj75U03qULCxQTY9r3hg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@babel/helper-annotate-as-pure": "^7.29.7",
+        "@babel/helper-member-expression-to-functions": "^7.29.7",
+        "@babel/helper-optimise-call-expression": "^7.29.7",
+        "@babel/helper-replace-supers": "^7.29.7",
+        "@babel/helper-skip-transparent-expression-wrappers": "^7.29.7",
+        "@babel/traverse": "^7.29.7",
+        "semver": "^6.3.1"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      },
+      "peerDependencies": {
+        "@babel/core": "^7.0.0"
+      }
+    },
+    "node_modules/@babel/helper-create-regexp-features-plugin": {
+      "version": "7.29.7",
+      "resolved": "https://registry.npmjs.org/@babel/helper-create-regexp-features-plugin/-/helper-create-regexp-features-plugin-7.29.7.tgz",
+      "integrity": "sha512-907Uymvqgg1dwUA+7IGwFAOSYzQOuzPXKNJ1yxzwPffzkYFg2q2eHi1fIOs6sXkG9NbIUMunnUlkYsfRFNvomg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@babel/helper-annotate-as-pure": "^7.29.7",
+        "regexpu-core": "^6.3.1",
+        "semver": "^6.3.1"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      },
+      "peerDependencies": {
+        "@babel/core": "^7.0.0"
+      }
+    },
+    "node_modules/@babel/helper-define-polyfill-provider": {
+      "version": "0.6.8",
+      "resolved": "https://registry.npmjs.org/@babel/helper-define-polyfill-provider/-/helper-define-polyfill-provider-0.6.8.tgz",
+      "integrity": "sha512-47UwBLPpQi1NoWzLuHNjRoHlYXMwIJoBf7MFou6viC/sIHWYygpvr0B6IAyh5sBdA2nr2LPIRww8lfaUVQINBA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@babel/helper-compilation-targets": "^7.28.6",
+        "@babel/helper-plugin-utils": "^7.28.6",
+        "debug": "^4.4.3",
+        "lodash.debounce": "^4.0.8",
+        "resolve": "^1.22.11"
+      },
+      "peerDependencies": {
+        "@babel/core": "^7.4.0 || ^8.0.0-0 <8.0.0"
+      }
+    },
+    "node_modules/@babel/helper-globals": {
+      "version": "7.29.7",
+      "resolved": "https://registry.npmjs.org/@babel/helper-globals/-/helper-globals-7.29.7.tgz",
+      "integrity": "sha512-3nQVUAtvkKH9zahfWgw96Jc/uFOmjACE1kQz82E2lqWmHBgjzbNlsC22nuQTfahmWeQtTq5nQ/4Nnd2A1wj4zA==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=6.9.0"
+      }
+    },
+    "node_modules/@babel/helper-member-expression-to-functions": {
+      "version": "7.29.7",
+      "resolved": "https://registry.npmjs.org/@babel/helper-member-expression-to-functions/-/helper-member-expression-to-functions-7.29.7.tgz",
+      "integrity": "sha512-j+7JYmk1JYDtACIGj0QJqqWZjoUpMoEikQGADMaHgCMCSDqd2+P32rfcibUNrGOMWrlzK1WJBdxrB3JJQZwWtg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@babel/traverse": "^7.29.7",
+        "@babel/types": "^7.29.7"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      }
+    },
+    "node_modules/@babel/helper-module-imports": {
+      "version": "7.29.7",
+      "resolved": "https://registry.npmjs.org/@babel/helper-module-imports/-/helper-module-imports-7.29.7.tgz",
+      "integrity": "sha512-ejHwrQQYcm9xnTivShn2IDOlIzInN34AXskvq9QicvCtEzq1Vzclu/tKF8Jq1Cg8JG2GL6/EmjgsCT7lXepE3g==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@babel/traverse": "^7.29.7",
+        "@babel/types": "^7.29.7"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      }
+    },
+    "node_modules/@babel/helper-module-transforms": {
+      "version": "7.29.7",
+      "resolved": "https://registry.npmjs.org/@babel/helper-module-transforms/-/helper-module-transforms-7.29.7.tgz",
+      "integrity": "sha512-UPUVSyXbOh627KiCIGQSgwWzGeBKLkaJ9PJEdrngIwMSzxLR4jS4+f1f1jb7VzBbg8nFLaYotvVPFCTqdrmTAg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@babel/helper-module-imports": "^7.29.7",
+        "@babel/helper-validator-identifier": "^7.29.7",
+        "@babel/traverse": "^7.29.7"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      },
+      "peerDependencies": {
+        "@babel/core": "^7.0.0"
+      }
+    },
+    "node_modules/@babel/helper-optimise-call-expression": {
+      "version": "7.29.7",
+      "resolved": "https://registry.npmjs.org/@babel/helper-optimise-call-expression/-/helper-optimise-call-expression-7.29.7.tgz",
+      "integrity": "sha512-+kmGVjcT9RGYzoDwdwEqEvGgKe3BYq+O1iGzjFubaNgZHwYHP6lsF2Yghf4kEuv9BV7tYDZ913aBW9am6YKong==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@babel/types": "^7.29.7"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      }
+    },
+    "node_modules/@babel/helper-plugin-utils": {
+      "version": "7.29.7",
+      "resolved": "https://registry.npmjs.org/@babel/helper-plugin-utils/-/helper-plugin-utils-7.29.7.tgz",
+      "integrity": "sha512-G7sHYigPY17oO5SYWnfD/0MTBwVR781S/JI643e/JhUYgVgWE/61SoW3NH9KWUKyKq5LVh3npif99Wkt6j86Jw==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=6.9.0"
+      }
+    },
+    "node_modules/@babel/helper-remap-async-to-generator": {
+      "version": "7.29.7",
+      "resolved": "https://registry.npmjs.org/@babel/helper-remap-async-to-generator/-/helper-remap-async-to-generator-7.29.7.tgz",
+      "integrity": "sha512-16AMiW26DbXWBbr3B8wNozKM0ydMLB892vaOaJW/fPJdnT8vJk5sdkQcU/isqUxyCE0cEoa8wZOcbgDuC4b6Og==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@babel/helper-annotate-as-pure": "^7.29.7",
+        "@babel/helper-wrap-function": "^7.29.7",
+        "@babel/traverse": "^7.29.7"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      },
+      "peerDependencies": {
+        "@babel/core": "^7.0.0"
+      }
+    },
+    "node_modules/@babel/helper-replace-supers": {
+      "version": "7.29.7",
+      "resolved": "https://registry.npmjs.org/@babel/helper-replace-supers/-/helper-replace-supers-7.29.7.tgz",
+      "integrity": "sha512-atfGXWSeCiF4DnKZIfmJfQRkSw9b9gNNXR1kqKjbhG4pGYCOnkp8OcTB8E3NXjBu8NpheSnOeNKz8KT7UNFTmQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@babel/helper-member-expression-to-functions": "^7.29.7",
+        "@babel/helper-optimise-call-expression": "^7.29.7",
+        "@babel/traverse": "^7.29.7"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      },
+      "peerDependencies": {
+        "@babel/core": "^7.0.0"
+      }
+    },
+    "node_modules/@babel/helper-skip-transparent-expression-wrappers": {
+      "version": "7.29.7",
+      "resolved": "https://registry.npmjs.org/@babel/helper-skip-transparent-expression-wrappers/-/helper-skip-transparent-expression-wrappers-7.29.7.tgz",
+      "integrity": "sha512-brcMGQaVzIeUb+6/bs1Av0f8YuNNjKY2JyvfRCsFuFsdKccEQ5Ges2y74D74NZ1Rz8lKJ9ksJkfqwQFJ/iNEyQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@babel/traverse": "^7.29.7",
+        "@babel/types": "^7.29.7"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      }
+    },
+    "node_modules/@babel/helper-string-parser": {
+      "version": "7.29.7",
+      "resolved": "https://registry.npmjs.org/@babel/helper-string-parser/-/helper-string-parser-7.29.7.tgz",
+      "integrity": "sha512-Pb5ijPrZ89GDH8223L4UP8i6QApWxs04RbPQJTeWDV0/keR2E36MeKnyr6LYmUUvqRRI+Iv87SuF1W6ErINzYw==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=6.9.0"
+      }
+    },
+    "node_modules/@babel/helper-validator-identifier": {
+      "version": "7.29.7",
+      "resolved": "https://registry.npmjs.org/@babel/helper-validator-identifier/-/helper-validator-identifier-7.29.7.tgz",
+      "integrity": "sha512-qehxGkRj55h/ff8EMaJ+cYhyaKlHIxqYDn682wQD7RNp9UujOQsHog2uS0r2vzr4pW+sXf90NeeayjcNaX3fFg==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=6.9.0"
+      }
+    },
+    "node_modules/@babel/helper-validator-option": {
+      "version": "7.29.7",
+      "resolved": "https://registry.npmjs.org/@babel/helper-validator-option/-/helper-validator-option-7.29.7.tgz",
+      "integrity": "sha512-N9ZErrD+yW5geCDtBqnOoxmR8+tNKiGuxKlDpuJxfsqpa2dFcexaziGAE/qoHLiDDreVNMupxGmSoNlyvsA3gw==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=6.9.0"
+      }
+    },
+    "node_modules/@babel/helper-wrap-function": {
+      "version": "7.29.7",
+      "resolved": "https://registry.npmjs.org/@babel/helper-wrap-function/-/helper-wrap-function-7.29.7.tgz",
+      "integrity": "sha512-iES0Skag9ERIF68aXadpO6dbXa03mNWK3sEqJaMnLNs/eC3l0lkImdfoy6Y09/SfkpawdAB4RjQ7PVA7TcVGdw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@babel/template": "^7.29.7",
+        "@babel/traverse": "^7.29.7",
+        "@babel/types": "^7.29.7"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      }
+    },
+    "node_modules/@babel/helpers": {
+      "version": "7.29.7",
+      "resolved": "https://registry.npmjs.org/@babel/helpers/-/helpers-7.29.7.tgz",
+      "integrity": "sha512-1k2lAGRMfHTcwuNYcCNUmaUffmQv8KWMfh2iJUUeRlwlwH4FdNG7mfPI10NPfLHJFThE4Tyr4mv7kTNZOiPuBg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@babel/template": "^7.29.7",
+        "@babel/types": "^7.29.7"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      }
+    },
+    "node_modules/@babel/parser": {
+      "version": "7.29.7",
+      "resolved": "https://registry.npmjs.org/@babel/parser/-/parser-7.29.7.tgz",
+      "integrity": "sha512-hnORnjP/1P/zFEndoeX+n+t1RwWRJiJpM/jO7FW32Kn9r5+sJB2JWOdYo4L6k78j15eCwY3Gm/7364B1EMwtNg==",
+      "license": "MIT",
+      "dependencies": {
+        "@babel/types": "^7.29.7"
+      },
+      "bin": {
+        "parser": "bin/babel-parser.js"
+      },
+      "engines": {
+        "node": ">=6.0.0"
+      }
+    },
+    "node_modules/@babel/plugin-bugfix-firefox-class-in-computed-class-key": {
+      "version": "7.29.7",
+      "resolved": "https://registry.npmjs.org/@babel/plugin-bugfix-firefox-class-in-computed-class-key/-/plugin-bugfix-firefox-class-in-computed-class-key-7.29.7.tgz",
+      "integrity": "sha512-j8SrR0zLZrRsC09DlszEx8FpMiwukKffYXMK0d5LmOglO7vGG6sz/BR/20yHqWH+Lnn31JTt2PE3hIWNgM2J6w==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@babel/helper-plugin-utils": "^7.29.7",
+        "@babel/traverse": "^7.29.7"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      },
+      "peerDependencies": {
+        "@babel/core": "^7.0.0"
+      }
+    },
+    "node_modules/@babel/plugin-bugfix-safari-class-field-initializer-scope": {
+      "version": "7.29.7",
+      "resolved": "https://registry.npmjs.org/@babel/plugin-bugfix-safari-class-field-initializer-scope/-/plugin-bugfix-safari-class-field-initializer-scope-7.29.7.tgz",
+      "integrity": "sha512-r8j8escF+U2FUHo0KOhPUdMzUO+jp9fInva6+ACVAF3Y97Ev+5iNZwiqTghmzNeWwDkOPlYuTcfb1vDaoZKmAQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@babel/helper-plugin-utils": "^7.29.7"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      },
+      "peerDependencies": {
+        "@babel/core": "^7.0.0"
+      }
+    },
+    "node_modules/@babel/plugin-bugfix-safari-id-destructuring-collision-in-function-expression": {
+      "version": "7.29.7",
+      "resolved": "https://registry.npmjs.org/@babel/plugin-bugfix-safari-id-destructuring-collision-in-function-expression/-/plugin-bugfix-safari-id-destructuring-collision-in-function-expression-7.29.7.tgz",
+      "integrity": "sha512-GE1TFSiuFeGsCxmYXZl8HwoPrVlwe4rHPFE8weieGKZqnDORK+Ar3vgWMgW+AOxQ6/2TgLSKx9p6W7O4rC6qgQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@babel/helper-plugin-utils": "^7.29.7"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      },
+      "peerDependencies": {
+        "@babel/core": "^7.0.0"
+      }
+    },
+    "node_modules/@babel/plugin-bugfix-safari-rest-destructuring-rhs-array": {
+      "version": "7.29.7",
+      "resolved": "https://registry.npmjs.org/@babel/plugin-bugfix-safari-rest-destructuring-rhs-array/-/plugin-bugfix-safari-rest-destructuring-rhs-array-7.29.7.tgz",
+      "integrity": "sha512-oBNVCvnO5tND+xSopWvV8WNGfpTfgP4Zr/YXXSj8zfmcPktp5Ku/aZlsIowgSD4fjmgHn6sGmB9APVsU5zOdhA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@babel/helper-plugin-utils": "^7.29.7",
+        "@babel/helper-skip-transparent-expression-wrappers": "^7.29.7"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      },
+      "peerDependencies": {
+        "@babel/core": "^7.0.0"
+      }
+    },
+    "node_modules/@babel/plugin-bugfix-v8-spread-parameters-in-optional-chaining": {
+      "version": "7.29.7",
+      "resolved": "https://registry.npmjs.org/@babel/plugin-bugfix-v8-spread-parameters-in-optional-chaining/-/plugin-bugfix-v8-spread-parameters-in-optional-chaining-7.29.7.tgz",
+      "integrity": "sha512-QQt9qKHZ2sg/kivaLr7lnQr8HVrQDdBNSfCsTjiDxRuX/K5ORyKq+Bu8Xr0cDE3Dfkv0cw28Ve0EKyKMvulkOw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@babel/helper-plugin-utils": "^7.29.7",
+        "@babel/helper-skip-transparent-expression-wrappers": "^7.29.7",
+        "@babel/plugin-transform-optional-chaining": "^7.29.7"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      },
+      "peerDependencies": {
+        "@babel/core": "^7.13.0"
+      }
+    },
+    "node_modules/@babel/plugin-bugfix-v8-static-class-fields-redefine-readonly": {
+      "version": "7.29.7",
+      "resolved": "https://registry.npmjs.org/@babel/plugin-bugfix-v8-static-class-fields-redefine-readonly/-/plugin-bugfix-v8-static-class-fields-redefine-readonly-7.29.7.tgz",
+      "integrity": "sha512-pn6QacGLgvCcwc+syUhKE/qSjV2D1IHDB84RNxWYSt1mW3K/SCtjinZ2p0cETJxAWBjPy3K/1lHwG5BjjPxNlw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@babel/helper-plugin-utils": "^7.29.7",
+        "@babel/traverse": "^7.29.7"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      },
+      "peerDependencies": {
+        "@babel/core": "^7.0.0"
+      }
+    },
+    "node_modules/@babel/plugin-proposal-private-property-in-object": {
+      "version": "7.21.0-placeholder-for-preset-env.2",
+      "resolved": "https://registry.npmjs.org/@babel/plugin-proposal-private-property-in-object/-/plugin-proposal-private-property-in-object-7.21.0-placeholder-for-preset-env.2.tgz",
+      "integrity": "sha512-SOSkfJDddaM7mak6cPEpswyTRnuRltl429hMraQEglW+OkovnCzsiszTmsrlY//qLFjCpQDFRvjdm2wA5pPm9w==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=6.9.0"
+      },
+      "peerDependencies": {
+        "@babel/core": "^7.0.0-0"
+      }
+    },
+    "node_modules/@babel/plugin-syntax-import-assertions": {
+      "version": "7.29.7",
+      "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-import-assertions/-/plugin-syntax-import-assertions-7.29.7.tgz",
+      "integrity": "sha512-/An1OCBN93thpBAGyfsK2pcf0jvju1SAtKkL2Ny++B5Sy6sqgzXDQH1cZxWbF96Wuk+bn41MDA9bLd4VVAw6rw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@babel/helper-plugin-utils": "^7.29.7"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      },
+      "peerDependencies": {
+        "@babel/core": "^7.0.0-0"
+      }
+    },
+    "node_modules/@babel/plugin-syntax-import-attributes": {
+      "version": "7.29.7",
+      "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-import-attributes/-/plugin-syntax-import-attributes-7.29.7.tgz",
+      "integrity": "sha512-zGYcYfq/WmZ4V+kBIXQon9dSSc8ircGZqw9ZaNhhGj9nZkeBu1jHLBDQqYYi5WA9uawvA2sIMbry2nCFhf5Djg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@babel/helper-plugin-utils": "^7.29.7"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      },
+      "peerDependencies": {
+        "@babel/core": "^7.0.0-0"
+      }
+    },
+    "node_modules/@babel/plugin-syntax-unicode-sets-regex": {
+      "version": "7.18.6",
+      "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-unicode-sets-regex/-/plugin-syntax-unicode-sets-regex-7.18.6.tgz",
+      "integrity": "sha512-727YkEAPwSIQTv5im8QHz3upqp92JTWhidIC81Tdx4VJYIte/VndKf1qKrfnnhPLiPghStWfvC/iFaMCQu7Nqg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@babel/helper-create-regexp-features-plugin": "^7.18.6",
+        "@babel/helper-plugin-utils": "^7.18.6"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      },
+      "peerDependencies": {
+        "@babel/core": "^7.0.0"
+      }
+    },
+    "node_modules/@babel/plugin-transform-arrow-functions": {
+      "version": "7.29.7",
+      "resolved": "https://registry.npmjs.org/@babel/plugin-transform-arrow-functions/-/plugin-transform-arrow-functions-7.29.7.tgz",
+      "integrity": "sha512-N7zArUXWzAMzm+/N0uPBeVB3Fam5lMxtUwMmDK5f/IBBS7a7p1qeUoxd/6CckXoxUdgsntq1Dh8xNW06maZbDQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@babel/helper-plugin-utils": "^7.29.7"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      },
+      "peerDependencies": {
+        "@babel/core": "^7.0.0-0"
+      }
+    },
+    "node_modules/@babel/plugin-transform-async-generator-functions": {
+      "version": "7.29.7",
+      "resolved": "https://registry.npmjs.org/@babel/plugin-transform-async-generator-functions/-/plugin-transform-async-generator-functions-7.29.7.tgz",
+      "integrity": "sha512-d98gXZkgswvkyohMBABkhm3GeXhYj8psWfwQ2C7gtfrKGTykQa/iOIi+JJhwMjPlZ6Vm2XN+DCf3Es1EoG4ZLA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@babel/helper-plugin-utils": "^7.29.7",
+        "@babel/helper-remap-async-to-generator": "^7.29.7",
+        "@babel/traverse": "^7.29.7"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      },
+      "peerDependencies": {
+        "@babel/core": "^7.0.0-0"
+      }
+    },
+    "node_modules/@babel/plugin-transform-async-to-generator": {
+      "version": "7.29.7",
+      "resolved": "https://registry.npmjs.org/@babel/plugin-transform-async-to-generator/-/plugin-transform-async-to-generator-7.29.7.tgz",
+      "integrity": "sha512-pcUb2SS+RMo9TWVBwKGI5ShtoG7R+zBsFmCKDa6fe8c+hPr3XJlZgoE5j6i8W7gDjhyvy+85vmYexanvXh3d1w==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@babel/helper-module-imports": "^7.29.7",
+        "@babel/helper-plugin-utils": "^7.29.7",
+        "@babel/helper-remap-async-to-generator": "^7.29.7"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      },
+      "peerDependencies": {
+        "@babel/core": "^7.0.0-0"
+      }
+    },
+    "node_modules/@babel/plugin-transform-block-scoped-functions": {
+      "version": "7.29.7",
+      "resolved": "https://registry.npmjs.org/@babel/plugin-transform-block-scoped-functions/-/plugin-transform-block-scoped-functions-7.29.7.tgz",
+      "integrity": "sha512-cUSmjh72N+rN4PrkFlN1dJwNCwjVp5d38/CQrEsFggkD10UiFlBFgdH3tv5dNsLuHY+3S8db2xCHjhZcv5WgvA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@babel/helper-plugin-utils": "^7.29.7"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      },
+      "peerDependencies": {
+        "@babel/core": "^7.0.0-0"
+      }
+    },
+    "node_modules/@babel/plugin-transform-block-scoping": {
+      "version": "7.29.7",
+      "resolved": "https://registry.npmjs.org/@babel/plugin-transform-block-scoping/-/plugin-transform-block-scoping-7.29.7.tgz",
+      "integrity": "sha512-ONyr4+AZhKh8yKWInVxU9AXA9EbsyeLcL6V0dJy6M2/62vuvpGm29zzuymbTpdc451GEpDIdAyPLP3r+P61yKQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@babel/helper-plugin-utils": "^7.29.7"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      },
+      "peerDependencies": {
+        "@babel/core": "^7.0.0-0"
+      }
+    },
+    "node_modules/@babel/plugin-transform-class-properties": {
+      "version": "7.29.7",
+      "resolved": "https://registry.npmjs.org/@babel/plugin-transform-class-properties/-/plugin-transform-class-properties-7.29.7.tgz",
+      "integrity": "sha512-GtcpjFvanPfzNQi3eTitsCqtRRmmqzpy/A+yhTR1HaZo1Ly3EA8ZXxlPyHdR8/IuRMYc3E4wdGBewB2QKQjAaA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@babel/helper-create-class-features-plugin": "^7.29.7",
+        "@babel/helper-plugin-utils": "^7.29.7"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      },
+      "peerDependencies": {
+        "@babel/core": "^7.0.0-0"
+      }
+    },
+    "node_modules/@babel/plugin-transform-class-static-block": {
+      "version": "7.29.7",
+      "resolved": "https://registry.npmjs.org/@babel/plugin-transform-class-static-block/-/plugin-transform-class-static-block-7.29.7.tgz",
+      "integrity": "sha512-kibJgmEdX2iMwsHY2tSZNDgj8PwIlCQz7FK9KuGKO8zsuoUwSEhoNnNVp/emKWrbY4HeO6kkXfdMqRKKKXBm2A==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@babel/helper-create-class-features-plugin": "^7.29.7",
+        "@babel/helper-plugin-utils": "^7.29.7"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      },
+      "peerDependencies": {
+        "@babel/core": "^7.12.0"
+      }
+    },
+    "node_modules/@babel/plugin-transform-classes": {
+      "version": "7.29.7",
+      "resolved": "https://registry.npmjs.org/@babel/plugin-transform-classes/-/plugin-transform-classes-7.29.7.tgz",
+      "integrity": "sha512-qV0OGGBVacduzQHE649JyCneOFI/maT+YKsO+K4Yi3xv2wTPNjM/W2o2gdzMwEAZz7fXNTHAe0NcSg30bIN69g==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@babel/helper-annotate-as-pure": "^7.29.7",
+        "@babel/helper-compilation-targets": "^7.29.7",
+        "@babel/helper-globals": "^7.29.7",
+        "@babel/helper-plugin-utils": "^7.29.7",
+        "@babel/helper-replace-supers": "^7.29.7",
+        "@babel/traverse": "^7.29.7"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      },
+      "peerDependencies": {
+        "@babel/core": "^7.0.0-0"
+      }
+    },
+    "node_modules/@babel/plugin-transform-computed-properties": {
+      "version": "7.29.7",
+      "resolved": "https://registry.npmjs.org/@babel/plugin-transform-computed-properties/-/plugin-transform-computed-properties-7.29.7.tgz",
+      "integrity": "sha512-RK7/IyU5phpuCdBAuig5VkzG/EnbDaui5SQGdU9BFrHdV+mV4cUjLMQ9lJDjLNtWHsqtiefpGZUXQP2BiTYMsA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@babel/helper-plugin-utils": "^7.29.7",
+        "@babel/template": "^7.29.7"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      },
+      "peerDependencies": {
+        "@babel/core": "^7.0.0-0"
+      }
+    },
+    "node_modules/@babel/plugin-transform-destructuring": {
+      "version": "7.29.7",
+      "resolved": "https://registry.npmjs.org/@babel/plugin-transform-destructuring/-/plugin-transform-destructuring-7.29.7.tgz",
+      "integrity": "sha512-iPX8aD6H9zV5s7ZsqTdNocPN/MGQ5sSMnElKrktxjJRMnB2jN/1p2+R7GkfD6CAYoVFqy5A4XnSIUeGgJzIWpg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@babel/helper-plugin-utils": "^7.29.7",
+        "@babel/traverse": "^7.29.7"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      },
+      "peerDependencies": {
+        "@babel/core": "^7.0.0-0"
+      }
+    },
+    "node_modules/@babel/plugin-transform-dotall-regex": {
+      "version": "7.29.7",
+      "resolved": "https://registry.npmjs.org/@babel/plugin-transform-dotall-regex/-/plugin-transform-dotall-regex-7.29.7.tgz",
+      "integrity": "sha512-3qc18hsD2RdZiyJNDNc7HQpv6xbncwh8FYtxNFFzclSyh/trPD9KkVR9BDECUjDLvb7yJVF15GfYUuC+LMkkiQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@babel/helper-create-regexp-features-plugin": "^7.29.7",
+        "@babel/helper-plugin-utils": "^7.29.7"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      },
+      "peerDependencies": {
+        "@babel/core": "^7.0.0-0"
+      }
+    },
+    "node_modules/@babel/plugin-transform-duplicate-keys": {
+      "version": "7.29.7",
+      "resolved": "https://registry.npmjs.org/@babel/plugin-transform-duplicate-keys/-/plugin-transform-duplicate-keys-7.29.7.tgz",
+      "integrity": "sha512-6IvRRriEMqnBwD6chtxdLpMYCHWEzN+oL5cyQtjykya19UgzbmKhxmhZgKC/LHxS2nYr9Q/qYPZ5Lr6jOL9+yQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@babel/helper-plugin-utils": "^7.29.7"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      },
+      "peerDependencies": {
+        "@babel/core": "^7.0.0-0"
+      }
+    },
+    "node_modules/@babel/plugin-transform-duplicate-named-capturing-groups-regex": {
+      "version": "7.29.7",
+      "resolved": "https://registry.npmjs.org/@babel/plugin-transform-duplicate-named-capturing-groups-regex/-/plugin-transform-duplicate-named-capturing-groups-regex-7.29.7.tgz",
+      "integrity": "sha512-2wiIyo2BjtgU7HufSeDnL9L2O7zr8jmhFKuSr65VpRkUiRKRNpb0mdlk56+XPPKoIrfHqzbMuglDvZun0RISsA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@babel/helper-create-regexp-features-plugin": "^7.29.7",
+        "@babel/helper-plugin-utils": "^7.29.7"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      },
+      "peerDependencies": {
+        "@babel/core": "^7.0.0"
+      }
+    },
+    "node_modules/@babel/plugin-transform-dynamic-import": {
+      "version": "7.29.7",
+      "resolved": "https://registry.npmjs.org/@babel/plugin-transform-dynamic-import/-/plugin-transform-dynamic-import-7.29.7.tgz",
+      "integrity": "sha512-giOlEm/EFjfjr+te9NsdjkUo2v4f8rS/SXPumRVHAtbNcyNlvtREkU1dZzaIDclNpnaVhlCqRdFKhJBjBikzLg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@babel/helper-plugin-utils": "^7.29.7"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      },
+      "peerDependencies": {
+        "@babel/core": "^7.0.0-0"
+      }
+    },
+    "node_modules/@babel/plugin-transform-explicit-resource-management": {
+      "version": "7.29.7",
+      "resolved": "https://registry.npmjs.org/@babel/plugin-transform-explicit-resource-management/-/plugin-transform-explicit-resource-management-7.29.7.tgz",
+      "integrity": "sha512-Rstj7coNz8sE+7Ju7ihpHLI564lsK5pUpNNlvptCIC/16E/S5hbl6n3kESPKdNRmqEWlpn5xpS5Q2dvXBsySLw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@babel/helper-plugin-utils": "^7.29.7",
+        "@babel/plugin-transform-destructuring": "^7.29.7"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      },
+      "peerDependencies": {
+        "@babel/core": "^7.0.0-0"
+      }
+    },
+    "node_modules/@babel/plugin-transform-exponentiation-operator": {
+      "version": "7.29.7",
+      "resolved": "https://registry.npmjs.org/@babel/plugin-transform-exponentiation-operator/-/plugin-transform-exponentiation-operator-7.29.7.tgz",
+      "integrity": "sha512-zFpMOTLZBdW5LfObqcSbL6kefg4R4eLdmvS0wbN9M6D5Mym/sKm9toOoWyVOa+xDjvCnuWcHls2YonXwHvH3CQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@babel/helper-plugin-utils": "^7.29.7"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      },
+      "peerDependencies": {
+        "@babel/core": "^7.0.0-0"
+      }
+    },
+    "node_modules/@babel/plugin-transform-export-namespace-from": {
+      "version": "7.29.7",
+      "resolved": "https://registry.npmjs.org/@babel/plugin-transform-export-namespace-from/-/plugin-transform-export-namespace-from-7.29.7.tgz",
+      "integrity": "sha512-24B2nOy2TeJSMheqwPD4DDQOV/elLSIlKxjZt4i05H5AgdPdWR3n18HnNrcJ+j76WJd9gbwb9jPjNYUy6RautA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@babel/helper-plugin-utils": "^7.29.7"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      },
+      "peerDependencies": {
+        "@babel/core": "^7.0.0-0"
+      }
+    },
+    "node_modules/@babel/plugin-transform-for-of": {
+      "version": "7.29.7",
+      "resolved": "https://registry.npmjs.org/@babel/plugin-transform-for-of/-/plugin-transform-for-of-7.29.7.tgz",
+      "integrity": "sha512-zeSIHh0+E1Um1WJRXCFlHQYu2ieJNdivLLjlBEp+dIBu3S51n+SZZmIXjxnItw6pz56Cn+KvK68BIBVsxq2JiQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@babel/helper-plugin-utils": "^7.29.7",
+        "@babel/helper-skip-transparent-expression-wrappers": "^7.29.7"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      },
+      "peerDependencies": {
+        "@babel/core": "^7.0.0-0"
+      }
+    },
+    "node_modules/@babel/plugin-transform-function-name": {
+      "version": "7.29.7",
+      "resolved": "https://registry.npmjs.org/@babel/plugin-transform-function-name/-/plugin-transform-function-name-7.29.7.tgz",
+      "integrity": "sha512-otRWaHXE6fbAGkePvaj/kvs3HsqXfPhlnzwSOlnFgbqCPMd975dW+4wZ00WFBt+/YlBGcJwNrARQTOJOb4ZrIg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@babel/helper-compilation-targets": "^7.29.7",
+        "@babel/helper-plugin-utils": "^7.29.7",
+        "@babel/traverse": "^7.29.7"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      },
+      "peerDependencies": {
+        "@babel/core": "^7.0.0-0"
+      }
+    },
+    "node_modules/@babel/plugin-transform-json-strings": {
+      "version": "7.29.7",
+      "resolved": "https://registry.npmjs.org/@babel/plugin-transform-json-strings/-/plugin-transform-json-strings-7.29.7.tgz",
+      "integrity": "sha512-RRnE2+eon1rJAq8MnoF1b5kTpY1vU88twHcvcKMrsqP/jxIRqDVs9iJB5fqPuqyeFAW0wJo4MlUIPpQCq/aRsg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@babel/helper-plugin-utils": "^7.29.7"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      },
+      "peerDependencies": {
+        "@babel/core": "^7.0.0-0"
+      }
+    },
+    "node_modules/@babel/plugin-transform-literals": {
+      "version": "7.29.7",
+      "resolved": "https://registry.npmjs.org/@babel/plugin-transform-literals/-/plugin-transform-literals-7.29.7.tgz",
+      "integrity": "sha512-DZ/oLP21ZuWx1vKqnoNv6/tvEK48AQOBRai40CX9dTjGluvT/YZCyY3rryDtyUqCEoyNroy5KKPwX2iQCiRvyw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@babel/helper-plugin-utils": "^7.29.7"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      },
+      "peerDependencies": {
+        "@babel/core": "^7.0.0-0"
+      }
+    },
+    "node_modules/@babel/plugin-transform-logical-assignment-operators": {
+      "version": "7.29.7",
+      "resolved": "https://registry.npmjs.org/@babel/plugin-transform-logical-assignment-operators/-/plugin-transform-logical-assignment-operators-7.29.7.tgz",
+      "integrity": "sha512-A0H91hh6W8MFRkp5TqJmMr39jzGD1A1E1Ysiv2O06Sfbhkapm+XyIzxWCEh5kqwOZ1/8QZ0dY3SeQ7XBqfJd5Q==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@babel/helper-plugin-utils": "^7.29.7"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      },
+      "peerDependencies": {
+        "@babel/core": "^7.0.0-0"
+      }
+    },
+    "node_modules/@babel/plugin-transform-member-expression-literals": {
+      "version": "7.29.7",
+      "resolved": "https://registry.npmjs.org/@babel/plugin-transform-member-expression-literals/-/plugin-transform-member-expression-literals-7.29.7.tgz",
+      "integrity": "sha512-hl1kwFZCCiDyfH25Xmco9jTrkPgnS9pmOzSG7W5I4SaGbLeqKv417hcU2RKmaxoPEgsoJh7ZPOrnPGq99bHoUg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@babel/helper-plugin-utils": "^7.29.7"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      },
+      "peerDependencies": {
+        "@babel/core": "^7.0.0-0"
+      }
+    },
+    "node_modules/@babel/plugin-transform-modules-amd": {
+      "version": "7.29.7",
+      "resolved": "https://registry.npmjs.org/@babel/plugin-transform-modules-amd/-/plugin-transform-modules-amd-7.29.7.tgz",
+      "integrity": "sha512-fxtQoH3m5ywUSIfaH0FGCzWu4McsYon5bD3K4XnskC7f+OyQMj7rsOMi4NvvmJ83WwBAg4UCe+ov4VZlqEvyew==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@babel/helper-module-transforms": "^7.29.7",
+        "@babel/helper-plugin-utils": "^7.29.7"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      },
+      "peerDependencies": {
+        "@babel/core": "^7.0.0-0"
+      }
+    },
+    "node_modules/@babel/plugin-transform-modules-commonjs": {
+      "version": "7.29.7",
+      "resolved": "https://registry.npmjs.org/@babel/plugin-transform-modules-commonjs/-/plugin-transform-modules-commonjs-7.29.7.tgz",
+      "integrity": "sha512-j0vCldybPC5b5dwCQOJ21uKtHzt7hxLygJTg9eF1ScfaikEDNfzn94XoW5Fi+seBR0nCyL23xaBFFkq7dTM8XQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@babel/helper-module-transforms": "^7.29.7",
+        "@babel/helper-plugin-utils": "^7.29.7"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      },
+      "peerDependencies": {
+        "@babel/core": "^7.0.0-0"
+      }
+    },
+    "node_modules/@babel/plugin-transform-modules-systemjs": {
+      "version": "7.29.7",
+      "resolved": "https://registry.npmjs.org/@babel/plugin-transform-modules-systemjs/-/plugin-transform-modules-systemjs-7.29.7.tgz",
+      "integrity": "sha512-TM2ZcQLoG2/y4HODiStCo10DibYhWhGWAwVv+EQKmG/7GFl0N+AAmUiXOMKM+aiJ9XBJ9AHVZBvTzMnJ2sM3cQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@babel/helper-module-transforms": "^7.29.7",
+        "@babel/helper-plugin-utils": "^7.29.7",
+        "@babel/helper-validator-identifier": "^7.29.7",
+        "@babel/traverse": "^7.29.7"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      },
+      "peerDependencies": {
+        "@babel/core": "^7.0.0-0"
+      }
+    },
+    "node_modules/@babel/plugin-transform-modules-umd": {
+      "version": "7.29.7",
+      "resolved": "https://registry.npmjs.org/@babel/plugin-transform-modules-umd/-/plugin-transform-modules-umd-7.29.7.tgz",
+      "integrity": "sha512-B4UkaTK3QpgCwJnrxKfMPKdo92CN7OKXAlpAAnM3UPu0Q0lCCk57ylA9AJbRy2v8dDKOPAAWcoR6CMyeoHwRCA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@babel/helper-module-transforms": "^7.29.7",
+        "@babel/helper-plugin-utils": "^7.29.7"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      },
+      "peerDependencies": {
+        "@babel/core": "^7.0.0-0"
+      }
+    },
+    "node_modules/@babel/plugin-transform-named-capturing-groups-regex": {
+      "version": "7.29.7",
+      "resolved": "https://registry.npmjs.org/@babel/plugin-transform-named-capturing-groups-regex/-/plugin-transform-named-capturing-groups-regex-7.29.7.tgz",
+      "integrity": "sha512-vuFoLwr4qnv2xbZ16SQd6uPcH5FNrLHhk/Jzo++0XJFcaDsr4gjJVg6j398oMHiC+83k/GiBzviwF5KBJkPUtQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@babel/helper-create-regexp-features-plugin": "^7.29.7",
+        "@babel/helper-plugin-utils": "^7.29.7"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      },
+      "peerDependencies": {
+        "@babel/core": "^7.0.0"
+      }
+    },
+    "node_modules/@babel/plugin-transform-new-target": {
+      "version": "7.29.7",
+      "resolved": "https://registry.npmjs.org/@babel/plugin-transform-new-target/-/plugin-transform-new-target-7.29.7.tgz",
+      "integrity": "sha512-fEo41GmsOUhOBlw8ioo6zvjX5Xc2Lqkzlyfqbpsk3eB6TReV18uhxZ0esfEokVbY2+PVJAQHNKxER6lGrzNd3A==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@babel/helper-plugin-utils": "^7.29.7"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      },
+      "peerDependencies": {
+        "@babel/core": "^7.0.0-0"
+      }
+    },
+    "node_modules/@babel/plugin-transform-nullish-coalescing-operator": {
+      "version": "7.29.7",
+      "resolved": "https://registry.npmjs.org/@babel/plugin-transform-nullish-coalescing-operator/-/plugin-transform-nullish-coalescing-operator-7.29.7.tgz",
+      "integrity": "sha512-idmp1dFaekP9GbcMvG24Kvw2BfhFZjHnNJCkV4WuIY4PskJzwI3f1N5OdgYke38T7rftO6ERulFRn2cFeZwRkg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@babel/helper-plugin-utils": "^7.29.7"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      },
+      "peerDependencies": {
+        "@babel/core": "^7.0.0-0"
+      }
+    },
+    "node_modules/@babel/plugin-transform-numeric-separator": {
+      "version": "7.29.7",
+      "resolved": "https://registry.npmjs.org/@babel/plugin-transform-numeric-separator/-/plugin-transform-numeric-separator-7.29.7.tgz",
+      "integrity": "sha512-zR7fv/z14OjgHl4AgRtkDBvBMhIzCxqV/qN/2BCRC7LjFwvuzjYe7gDWxC4Wl/SNsLM6SE1IWvRPYMgSJaUvNw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@babel/helper-plugin-utils": "^7.29.7"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      },
+      "peerDependencies": {
+        "@babel/core": "^7.0.0-0"
+      }
+    },
+    "node_modules/@babel/plugin-transform-object-rest-spread": {
+      "version": "7.29.7",
+      "resolved": "https://registry.npmjs.org/@babel/plugin-transform-object-rest-spread/-/plugin-transform-object-rest-spread-7.29.7.tgz",
+      "integrity": "sha512-Ld98jn4c0smUywL57m7SgsHq3OpThOa6LqZJif3G6jYOovPleoFhVrBJ1WegRApSFB2wu4+RelAj9AC9G08Z4A==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@babel/helper-compilation-targets": "^7.29.7",
+        "@babel/helper-plugin-utils": "^7.29.7",
+        "@babel/plugin-transform-destructuring": "^7.29.7",
+        "@babel/plugin-transform-parameters": "^7.29.7",
+        "@babel/traverse": "^7.29.7"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      },
+      "peerDependencies": {
+        "@babel/core": "^7.0.0-0"
+      }
+    },
+    "node_modules/@babel/plugin-transform-object-super": {
+      "version": "7.29.7",
+      "resolved": "https://registry.npmjs.org/@babel/plugin-transform-object-super/-/plugin-transform-object-super-7.29.7.tgz",
+      "integrity": "sha512-Ea/diGcw0twB5IlZPO5sgET6fJsLJqPABqTuFWIR+iMPGPZJkATEIWx0wa+aEQ5UY1CBQyP/gkAiLEqn1vBiQA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@babel/helper-plugin-utils": "^7.29.7",
+        "@babel/helper-replace-supers": "^7.29.7"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      },
+      "peerDependencies": {
+        "@babel/core": "^7.0.0-0"
+      }
+    },
+    "node_modules/@babel/plugin-transform-optional-catch-binding": {
+      "version": "7.29.7",
+      "resolved": "https://registry.npmjs.org/@babel/plugin-transform-optional-catch-binding/-/plugin-transform-optional-catch-binding-7.29.7.tgz",
+      "integrity": "sha512-sLsyndxK2VwX6yNUOakMb7Sh553ZTe/vVM1XJ+9Z5aW1ytsc8xOIwmyk05NNjN60vkc5/KqoTH6hB4V41LJhng==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@babel/helper-plugin-utils": "^7.29.7"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      },
+      "peerDependencies": {
+        "@babel/core": "^7.0.0-0"
+      }
+    },
+    "node_modules/@babel/plugin-transform-optional-chaining": {
+      "version": "7.29.7",
+      "resolved": "https://registry.npmjs.org/@babel/plugin-transform-optional-chaining/-/plugin-transform-optional-chaining-7.29.7.tgz",
+      "integrity": "sha512-6GM1dhvK3gNODkXcEcMCOLEDCLSoZ/sBbro2Ax8HURyasQ4NshagQixkRFdh5niI6E4gmA/jYI/4aT7rRos3ZQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@babel/helper-plugin-utils": "^7.29.7",
+        "@babel/helper-skip-transparent-expression-wrappers": "^7.29.7"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      },
+      "peerDependencies": {
+        "@babel/core": "^7.0.0-0"
+      }
+    },
+    "node_modules/@babel/plugin-transform-parameters": {
+      "version": "7.29.7",
+      "resolved": "https://registry.npmjs.org/@babel/plugin-transform-parameters/-/plugin-transform-parameters-7.29.7.tgz",
+      "integrity": "sha512-ZDOBqV/qLYJI0YElr8DcENEyARsFQeESqWXH6gZlghYXuPPjvweuDhP4VyEi4BlUBlLRFZVjxoZDMjxhLW766g==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@babel/helper-plugin-utils": "^7.29.7"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      },
+      "peerDependencies": {
+        "@babel/core": "^7.0.0-0"
+      }
+    },
+    "node_modules/@babel/plugin-transform-private-methods": {
+      "version": "7.29.7",
+      "resolved": "https://registry.npmjs.org/@babel/plugin-transform-private-methods/-/plugin-transform-private-methods-7.29.7.tgz",
+      "integrity": "sha512-/6Rz4DK1ETDEM/bWHsPHcaEe7ZaT1EqSXjtSP/L0DijOYuaUhiRiOKcwpZ8P7zR4xXEHc2ITdiCgBm9Tpyv9ug==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@babel/helper-create-class-features-plugin": "^7.29.7",
+        "@babel/helper-plugin-utils": "^7.29.7"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      },
+      "peerDependencies": {
+        "@babel/core": "^7.0.0-0"
+      }
+    },
+    "node_modules/@babel/plugin-transform-private-property-in-object": {
+      "version": "7.29.7",
+      "resolved": "https://registry.npmjs.org/@babel/plugin-transform-private-property-in-object/-/plugin-transform-private-property-in-object-7.29.7.tgz",
+      "integrity": "sha512-+BNo06dnrzdNNqCm1X6YUaVv0DKk8Q+JYcoZfOkLhYWNCXzlwTSRq8zGWayT1csjcpNXV9CQTBRRbmTLZac5cA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@babel/helper-annotate-as-pure": "^7.29.7",
+        "@babel/helper-create-class-features-plugin": "^7.29.7",
+        "@babel/helper-plugin-utils": "^7.29.7"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      },
+      "peerDependencies": {
+        "@babel/core": "^7.0.0-0"
+      }
+    },
+    "node_modules/@babel/plugin-transform-property-literals": {
+      "version": "7.29.7",
+      "resolved": "https://registry.npmjs.org/@babel/plugin-transform-property-literals/-/plugin-transform-property-literals-7.29.7.tgz",
+      "integrity": "sha512-bOMRLQuI0A5ZqHq3OWJ89/rXpJ/NJrbVhXiP4zwPGMs6kpcVsuTUNjwoE30K0Qm3mf48a/TnRYYD6vPNqcg6jA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@babel/helper-plugin-utils": "^7.29.7"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      },
+      "peerDependencies": {
+        "@babel/core": "^7.0.0-0"
+      }
+    },
+    "node_modules/@babel/plugin-transform-regenerator": {
+      "version": "7.29.7",
+      "resolved": "https://registry.npmjs.org/@babel/plugin-transform-regenerator/-/plugin-transform-regenerator-7.29.7.tgz",
+      "integrity": "sha512-rNNFV0DBAJp988xW2DOntfDoYn1eR8GGF5AT5vYc+rjyfaQkM242c9tZUHHPe7KYaiJizXPWhQTzzdbXySyhBw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@babel/helper-plugin-utils": "^7.29.7"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      },
+      "peerDependencies": {
+        "@babel/core": "^7.0.0-0"
+      }
+    },
+    "node_modules/@babel/plugin-transform-regexp-modifiers": {
+      "version": "7.29.7",
+      "resolved": "https://registry.npmjs.org/@babel/plugin-transform-regexp-modifiers/-/plugin-transform-regexp-modifiers-7.29.7.tgz",
+      "integrity": "sha512-mB5Fs0VWrJ42ZCmc8114v60qetdaUVNkj9PmSZRmanCZM3S9hm0CFRLjRmYIsuXav14l2jvZ+4T8iiCGnhj3nQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@babel/helper-create-regexp-features-plugin": "^7.29.7",
+        "@babel/helper-plugin-utils": "^7.29.7"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      },
+      "peerDependencies": {
+        "@babel/core": "^7.0.0"
+      }
+    },
+    "node_modules/@babel/plugin-transform-reserved-words": {
+      "version": "7.29.7",
+      "resolved": "https://registry.npmjs.org/@babel/plugin-transform-reserved-words/-/plugin-transform-reserved-words-7.29.7.tgz",
+      "integrity": "sha512-5+YhdpVgmfSmwZyLMftfaiffLRMHjzIRHFHHLdibcSyJm2pasMrKHrO3Ptrt2DRshjvpgjEJJ1zVW14WPq/6QA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@babel/helper-plugin-utils": "^7.29.7"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      },
+      "peerDependencies": {
+        "@babel/core": "^7.0.0-0"
+      }
+    },
+    "node_modules/@babel/plugin-transform-shorthand-properties": {
+      "version": "7.29.7",
+      "resolved": "https://registry.npmjs.org/@babel/plugin-transform-shorthand-properties/-/plugin-transform-shorthand-properties-7.29.7.tgz",
+      "integrity": "sha512-I+WYbGBAiCn7nA6xBrlgPH+MB7HWb4u8pv5S0Pv7OtwNvIFvCCb24YlttKEeUFVurfBCEaOTnuhlqsb7f0Z5Dg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@babel/helper-plugin-utils": "^7.29.7"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      },
+      "peerDependencies": {
+        "@babel/core": "^7.0.0-0"
+      }
+    },
+    "node_modules/@babel/plugin-transform-spread": {
+      "version": "7.29.7",
+      "resolved": "https://registry.npmjs.org/@babel/plugin-transform-spread/-/plugin-transform-spread-7.29.7.tgz",
+      "integrity": "sha512-/u5K1QWada7tbYNqTjMh96718g9NTwh9tfPJMsSmVsQwGT447FskV+KcfeXkXq2GWki4EM/MuTdmBec+hOuVTQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@babel/helper-plugin-utils": "^7.29.7",
+        "@babel/helper-skip-transparent-expression-wrappers": "^7.29.7"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      },
+      "peerDependencies": {
+        "@babel/core": "^7.0.0-0"
+      }
+    },
+    "node_modules/@babel/plugin-transform-sticky-regex": {
+      "version": "7.29.7",
+      "resolved": "https://registry.npmjs.org/@babel/plugin-transform-sticky-regex/-/plugin-transform-sticky-regex-7.29.7.tgz",
+      "integrity": "sha512-BCHzNYJGe9l7EpwwDBN/ztlL2NYFFq8hp9ddjtUEM9f2O7S7kKV/lL6Fwo7IF7NSkYhPK2vO+86nIGltA90MsA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@babel/helper-plugin-utils": "^7.29.7"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      },
+      "peerDependencies": {
+        "@babel/core": "^7.0.0-0"
+      }
+    },
+    "node_modules/@babel/plugin-transform-template-literals": {
+      "version": "7.29.7",
+      "resolved": "https://registry.npmjs.org/@babel/plugin-transform-template-literals/-/plugin-transform-template-literals-7.29.7.tgz",
+      "integrity": "sha512-NCSEJ4sLFU2gqAub45HYh4fus2yQ36rr6ei6vpU7NdoJqCpxvEG8E6eJpscGyXP3VHD2Ny+fSXr04k1hoUrFqA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@babel/helper-plugin-utils": "^7.29.7"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      },
+      "peerDependencies": {
+        "@babel/core": "^7.0.0-0"
+      }
+    },
+    "node_modules/@babel/plugin-transform-typeof-symbol": {
+      "version": "7.29.7",
+      "resolved": "https://registry.npmjs.org/@babel/plugin-transform-typeof-symbol/-/plugin-transform-typeof-symbol-7.29.7.tgz",
+      "integrity": "sha512-223mNGoTkBiTEWFoK+Q6Go3tueMRclO8vxxxxquNCYuNI4jWOofFKJRRDu6SDrB8Sgo1UEGW9T4GAQ8ZyRso1A==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@babel/helper-plugin-utils": "^7.29.7"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      },
+      "peerDependencies": {
+        "@babel/core": "^7.0.0-0"
+      }
+    },
+    "node_modules/@babel/plugin-transform-unicode-escapes": {
+      "version": "7.29.7",
+      "resolved": "https://registry.npmjs.org/@babel/plugin-transform-unicode-escapes/-/plugin-transform-unicode-escapes-7.29.7.tgz",
+      "integrity": "sha512-jCfXxSjf94lf4E0hKE0AByxF6F3/pVFqRdUUNkDJhsY0m1ZKjnN6ZYyMeHNpzflxb/0q5b7t3p+BE+SLF1WOtA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@babel/helper-plugin-utils": "^7.29.7"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      },
+      "peerDependencies": {
+        "@babel/core": "^7.0.0-0"
+      }
+    },
+    "node_modules/@babel/plugin-transform-unicode-property-regex": {
+      "version": "7.29.7",
+      "resolved": "https://registry.npmjs.org/@babel/plugin-transform-unicode-property-regex/-/plugin-transform-unicode-property-regex-7.29.7.tgz",
+      "integrity": "sha512-OgZ+zoAJgZLUCunsTRQ5LAjOywDv5zzZ2/hQ5aMw1pGXyY2rtE8/chXYUmu3AlVHKpm10KEdG9aMwbI/K76ZGw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@babel/helper-create-regexp-features-plugin": "^7.29.7",
+        "@babel/helper-plugin-utils": "^7.29.7"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      },
+      "peerDependencies": {
+        "@babel/core": "^7.0.0-0"
+      }
+    },
+    "node_modules/@babel/plugin-transform-unicode-regex": {
+      "version": "7.29.7",
+      "resolved": "https://registry.npmjs.org/@babel/plugin-transform-unicode-regex/-/plugin-transform-unicode-regex-7.29.7.tgz",
+      "integrity": "sha512-7D/x/23/d/3VqZ0QA+LGbZMlGwZjztBygSWWWsfTPoQ1oQ6Q1P6Mr3d0kk42XabyUVw+fha3LqdRsFqeKqvCyA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@babel/helper-create-regexp-features-plugin": "^7.29.7",
+        "@babel/helper-plugin-utils": "^7.29.7"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      },
+      "peerDependencies": {
+        "@babel/core": "^7.0.0-0"
+      }
+    },
+    "node_modules/@babel/plugin-transform-unicode-sets-regex": {
+      "version": "7.29.7",
+      "resolved": "https://registry.npmjs.org/@babel/plugin-transform-unicode-sets-regex/-/plugin-transform-unicode-sets-regex-7.29.7.tgz",
+      "integrity": "sha512-BLOhLht9DOJwIxlmp91wHvkXv1lguuHS3/FwUO8HL1H0u8s4hR1gASVFyilu9iGtcTRYqjTZmlsFFeQletntEg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@babel/helper-create-regexp-features-plugin": "^7.29.7",
+        "@babel/helper-plugin-utils": "^7.29.7"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      },
+      "peerDependencies": {
+        "@babel/core": "^7.0.0"
+      }
+    },
+    "node_modules/@babel/preset-env": {
+      "version": "7.29.7",
+      "resolved": "https://registry.npmjs.org/@babel/preset-env/-/preset-env-7.29.7.tgz",
+      "integrity": "sha512-GYzX36n1nsciIb0uyH0GHwxwtNwPQIcpxSeiVLDtG/B7jB5xXgchnmL1f/jCX5o+pwnaDBtO60ONSJhEBJfxYA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@babel/compat-data": "^7.29.7",
+        "@babel/helper-compilation-targets": "^7.29.7",
+        "@babel/helper-plugin-utils": "^7.29.7",
+        "@babel/helper-validator-option": "^7.29.7",
+        "@babel/plugin-bugfix-firefox-class-in-computed-class-key": "^7.29.7",
+        "@babel/plugin-bugfix-safari-class-field-initializer-scope": "^7.29.7",
+        "@babel/plugin-bugfix-safari-id-destructuring-collision-in-function-expression": "^7.29.7",
+        "@babel/plugin-bugfix-safari-rest-destructuring-rhs-array": "^7.29.7",
+        "@babel/plugin-bugfix-v8-spread-parameters-in-optional-chaining": "^7.29.7",
+        "@babel/plugin-bugfix-v8-static-class-fields-redefine-readonly": "^7.29.7",
+        "@babel/plugin-proposal-private-property-in-object": "7.21.0-placeholder-for-preset-env.2",
+        "@babel/plugin-syntax-import-assertions": "^7.29.7",
+        "@babel/plugin-syntax-import-attributes": "^7.29.7",
+        "@babel/plugin-syntax-unicode-sets-regex": "^7.18.6",
+        "@babel/plugin-transform-arrow-functions": "^7.29.7",
+        "@babel/plugin-transform-async-generator-functions": "^7.29.7",
+        "@babel/plugin-transform-async-to-generator": "^7.29.7",
+        "@babel/plugin-transform-block-scoped-functions": "^7.29.7",
+        "@babel/plugin-transform-block-scoping": "^7.29.7",
+        "@babel/plugin-transform-class-properties": "^7.29.7",
+        "@babel/plugin-transform-class-static-block": "^7.29.7",
+        "@babel/plugin-transform-classes": "^7.29.7",
+        "@babel/plugin-transform-computed-properties": "^7.29.7",
+        "@babel/plugin-transform-destructuring": "^7.29.7",
+        "@babel/plugin-transform-dotall-regex": "^7.29.7",
+        "@babel/plugin-transform-duplicate-keys": "^7.29.7",
+        "@babel/plugin-transform-duplicate-named-capturing-groups-regex": "^7.29.7",
+        "@babel/plugin-transform-dynamic-import": "^7.29.7",
+        "@babel/plugin-transform-explicit-resource-management": "^7.29.7",
+        "@babel/plugin-transform-exponentiation-operator": "^7.29.7",
+        "@babel/plugin-transform-export-namespace-from": "^7.29.7",
+        "@babel/plugin-transform-for-of": "^7.29.7",
+        "@babel/plugin-transform-function-name": "^7.29.7",
+        "@babel/plugin-transform-json-strings": "^7.29.7",
+        "@babel/plugin-transform-literals": "^7.29.7",
+        "@babel/plugin-transform-logical-assignment-operators": "^7.29.7",
+        "@babel/plugin-transform-member-expression-literals": "^7.29.7",
+        "@babel/plugin-transform-modules-amd": "^7.29.7",
+        "@babel/plugin-transform-modules-commonjs": "^7.29.7",
+        "@babel/plugin-transform-modules-systemjs": "^7.29.7",
+        "@babel/plugin-transform-modules-umd": "^7.29.7",
+        "@babel/plugin-transform-named-capturing-groups-regex": "^7.29.7",
+        "@babel/plugin-transform-new-target": "^7.29.7",
+        "@babel/plugin-transform-nullish-coalescing-operator": "^7.29.7",
+        "@babel/plugin-transform-numeric-separator": "^7.29.7",
+        "@babel/plugin-transform-object-rest-spread": "^7.29.7",
+        "@babel/plugin-transform-object-super": "^7.29.7",
+        "@babel/plugin-transform-optional-catch-binding": "^7.29.7",
+        "@babel/plugin-transform-optional-chaining": "^7.29.7",
+        "@babel/plugin-transform-parameters": "^7.29.7",
+        "@babel/plugin-transform-private-methods": "^7.29.7",
+        "@babel/plugin-transform-private-property-in-object": "^7.29.7",
+        "@babel/plugin-transform-property-literals": "^7.29.7",
+        "@babel/plugin-transform-regenerator": "^7.29.7",
+        "@babel/plugin-transform-regexp-modifiers": "^7.29.7",
+        "@babel/plugin-transform-reserved-words": "^7.29.7",
+        "@babel/plugin-transform-shorthand-properties": "^7.29.7",
+        "@babel/plugin-transform-spread": "^7.29.7",
+        "@babel/plugin-transform-sticky-regex": "^7.29.7",
+        "@babel/plugin-transform-template-literals": "^7.29.7",
+        "@babel/plugin-transform-typeof-symbol": "^7.29.7",
+        "@babel/plugin-transform-unicode-escapes": "^7.29.7",
+        "@babel/plugin-transform-unicode-property-regex": "^7.29.7",
+        "@babel/plugin-transform-unicode-regex": "^7.29.7",
+        "@babel/plugin-transform-unicode-sets-regex": "^7.29.7",
+        "@babel/preset-modules": "0.1.6-no-external-plugins",
+        "babel-plugin-polyfill-corejs2": "^0.4.15",
+        "babel-plugin-polyfill-corejs3": "^0.14.0",
+        "babel-plugin-polyfill-regenerator": "^0.6.6",
+        "core-js-compat": "^3.48.0",
+        "semver": "^6.3.1"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      },
+      "peerDependencies": {
+        "@babel/core": "^7.0.0-0"
+      }
+    },
+    "node_modules/@babel/preset-modules": {
+      "version": "0.1.6-no-external-plugins",
+      "resolved": "https://registry.npmjs.org/@babel/preset-modules/-/preset-modules-0.1.6-no-external-plugins.tgz",
+      "integrity": "sha512-HrcgcIESLm9aIR842yhJ5RWan/gebQUJ6E/E5+rf0y9o6oj7w0Br+sWuL6kEQ/o/AdfvR1Je9jG18/gnpwjEyA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@babel/helper-plugin-utils": "^7.0.0",
+        "@babel/types": "^7.4.4",
+        "esutils": "^2.0.2"
+      },
+      "peerDependencies": {
+        "@babel/core": "^7.0.0-0 || ^8.0.0-0 <8.0.0"
+      }
+    },
+    "node_modules/@babel/runtime": {
+      "version": "7.28.6",
+      "resolved": "https://registry.npmjs.org/@babel/runtime/-/runtime-7.28.6.tgz",
+      "integrity": "sha512-05WQkdpL9COIMz4LjTxGpPNCdlpyimKppYNoJ5Di5EUObifl8t4tuLuUBBZEpoLYOmfvIWrsp9fCl0HoPRVTdA==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=6.9.0"
+      }
+    },
+    "node_modules/@babel/template": {
+      "version": "7.29.7",
+      "resolved": "https://registry.npmjs.org/@babel/template/-/template-7.29.7.tgz",
+      "integrity": "sha512-puq+Gf35oI24FeN11LkoUQFqv9uwNeWpxXZi/Ji3rRIoKAzKnxRaZ+Gkj0vKS9ZCiTESfng1N9LyOyXvo+m+Gg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@babel/code-frame": "^7.29.7",
+        "@babel/parser": "^7.29.7",
+        "@babel/types": "^7.29.7"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      }
+    },
+    "node_modules/@babel/traverse": {
+      "version": "7.29.7",
+      "resolved": "https://registry.npmjs.org/@babel/traverse/-/traverse-7.29.7.tgz",
+      "integrity": "sha512-EhlfNQtZ+NK22w5BM61ciuiq1m58ed33Wr1Xan//ZRTy6hgjnwyCffRYwzsGXdASJSUJ1guZILsErh1eQcl+zw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@babel/code-frame": "^7.29.7",
+        "@babel/generator": "^7.29.7",
+        "@babel/helper-globals": "^7.29.7",
+        "@babel/parser": "^7.29.7",
+        "@babel/template": "^7.29.7",
+        "@babel/types": "^7.29.7",
+        "debug": "^4.3.1"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      }
+    },
+    "node_modules/@babel/types": {
+      "version": "7.29.7",
+      "resolved": "https://registry.npmjs.org/@babel/types/-/types-7.29.7.tgz",
+      "integrity": "sha512-4zBIxpPzowiZpusoFkyGVwakdRJUyuH5PxQ/PrqghfdFWWasvnCdPfQXHrenDai+gyLARulZjZowCOj6fjT4pA==",
+      "license": "MIT",
+      "dependencies": {
+        "@babel/helper-string-parser": "^7.29.7",
+        "@babel/helper-validator-identifier": "^7.29.7"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      }
+    },
+    "node_modules/@esbuild/aix-ppc64": {
+      "version": "0.27.3",
+      "resolved": "https://registry.npmjs.org/@esbuild/aix-ppc64/-/aix-ppc64-0.27.3.tgz",
+      "integrity": "sha512-9fJMTNFTWZMh5qwrBItuziu834eOCUcEqymSH7pY+zoMVEZg3gcPuBNxH1EvfVYe9h0x/Ptw8KBzv7qxb7l8dg==",
+      "cpu": [
+        "ppc64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "aix"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/android-arm": {
+      "version": "0.27.3",
+      "resolved": "https://registry.npmjs.org/@esbuild/android-arm/-/android-arm-0.27.3.tgz",
+      "integrity": "sha512-i5D1hPY7GIQmXlXhs2w8AWHhenb00+GxjxRncS2ZM7YNVGNfaMxgzSGuO8o8SJzRc/oZwU2bcScvVERk03QhzA==",
+      "cpu": [
+        "arm"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "android"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/android-arm64": {
+      "version": "0.27.3",
+      "resolved": "https://registry.npmjs.org/@esbuild/android-arm64/-/android-arm64-0.27.3.tgz",
+      "integrity": "sha512-YdghPYUmj/FX2SYKJ0OZxf+iaKgMsKHVPF1MAq/P8WirnSpCStzKJFjOjzsW0QQ7oIAiccHdcqjbHmJxRb/dmg==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "android"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/android-x64": {
+      "version": "0.27.3",
+      "resolved": "https://registry.npmjs.org/@esbuild/android-x64/-/android-x64-0.27.3.tgz",
+      "integrity": "sha512-IN/0BNTkHtk8lkOM8JWAYFg4ORxBkZQf9zXiEOfERX/CzxW3Vg1ewAhU7QSWQpVIzTW+b8Xy+lGzdYXV6UZObQ==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "android"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/darwin-arm64": {
+      "version": "0.27.3",
+      "resolved": "https://registry.npmjs.org/@esbuild/darwin-arm64/-/darwin-arm64-0.27.3.tgz",
+      "integrity": "sha512-Re491k7ByTVRy0t3EKWajdLIr0gz2kKKfzafkth4Q8A5n1xTHrkqZgLLjFEHVD+AXdUGgQMq+Godfq45mGpCKg==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "darwin"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/darwin-x64": {
+      "version": "0.27.3",
+      "resolved": "https://registry.npmjs.org/@esbuild/darwin-x64/-/darwin-x64-0.27.3.tgz",
+      "integrity": "sha512-vHk/hA7/1AckjGzRqi6wbo+jaShzRowYip6rt6q7VYEDX4LEy1pZfDpdxCBnGtl+A5zq8iXDcyuxwtv3hNtHFg==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "darwin"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/freebsd-arm64": {
+      "version": "0.27.3",
+      "resolved": "https://registry.npmjs.org/@esbuild/freebsd-arm64/-/freebsd-arm64-0.27.3.tgz",
+      "integrity": "sha512-ipTYM2fjt3kQAYOvo6vcxJx3nBYAzPjgTCk7QEgZG8AUO3ydUhvelmhrbOheMnGOlaSFUoHXB6un+A7q4ygY9w==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "freebsd"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/freebsd-x64": {
+      "version": "0.27.3",
+      "resolved": "https://registry.npmjs.org/@esbuild/freebsd-x64/-/freebsd-x64-0.27.3.tgz",
+      "integrity": "sha512-dDk0X87T7mI6U3K9VjWtHOXqwAMJBNN2r7bejDsc+j03SEjtD9HrOl8gVFByeM0aJksoUuUVU9TBaZa2rgj0oA==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "freebsd"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/linux-arm": {
+      "version": "0.27.3",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-arm/-/linux-arm-0.27.3.tgz",
+      "integrity": "sha512-s6nPv2QkSupJwLYyfS+gwdirm0ukyTFNl3KTgZEAiJDd+iHZcbTPPcWCcRYH+WlNbwChgH2QkE9NSlNrMT8Gfw==",
+      "cpu": [
+        "arm"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/linux-arm64": {
+      "version": "0.27.3",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-arm64/-/linux-arm64-0.27.3.tgz",
+      "integrity": "sha512-sZOuFz/xWnZ4KH3YfFrKCf1WyPZHakVzTiqji3WDc0BCl2kBwiJLCXpzLzUBLgmp4veFZdvN5ChW4Eq/8Fc2Fg==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/linux-ia32": {
+      "version": "0.27.3",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-ia32/-/linux-ia32-0.27.3.tgz",
+      "integrity": "sha512-yGlQYjdxtLdh0a3jHjuwOrxQjOZYD/C9PfdbgJJF3TIZWnm/tMd/RcNiLngiu4iwcBAOezdnSLAwQDPqTmtTYg==",
+      "cpu": [
+        "ia32"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/linux-loong64": {
+      "version": "0.27.3",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-loong64/-/linux-loong64-0.27.3.tgz",
+      "integrity": "sha512-WO60Sn8ly3gtzhyjATDgieJNet/KqsDlX5nRC5Y3oTFcS1l0KWba+SEa9Ja1GfDqSF1z6hif/SkpQJbL63cgOA==",
+      "cpu": [
+        "loong64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/linux-mips64el": {
+      "version": "0.27.3",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-mips64el/-/linux-mips64el-0.27.3.tgz",
+      "integrity": "sha512-APsymYA6sGcZ4pD6k+UxbDjOFSvPWyZhjaiPyl/f79xKxwTnrn5QUnXR5prvetuaSMsb4jgeHewIDCIWljrSxw==",
+      "cpu": [
+        "mips64el"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/linux-ppc64": {
+      "version": "0.27.3",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-ppc64/-/linux-ppc64-0.27.3.tgz",
+      "integrity": "sha512-eizBnTeBefojtDb9nSh4vvVQ3V9Qf9Df01PfawPcRzJH4gFSgrObw+LveUyDoKU3kxi5+9RJTCWlj4FjYXVPEA==",
+      "cpu": [
+        "ppc64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/linux-riscv64": {
+      "version": "0.27.3",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-riscv64/-/linux-riscv64-0.27.3.tgz",
+      "integrity": "sha512-3Emwh0r5wmfm3ssTWRQSyVhbOHvqegUDRd0WhmXKX2mkHJe1SFCMJhagUleMq+Uci34wLSipf8Lagt4LlpRFWQ==",
+      "cpu": [
+        "riscv64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/linux-s390x": {
+      "version": "0.27.3",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-s390x/-/linux-s390x-0.27.3.tgz",
+      "integrity": "sha512-pBHUx9LzXWBc7MFIEEL0yD/ZVtNgLytvx60gES28GcWMqil8ElCYR4kvbV2BDqsHOvVDRrOxGySBM9Fcv744hw==",
+      "cpu": [
+        "s390x"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/linux-x64": {
+      "version": "0.27.3",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-x64/-/linux-x64-0.27.3.tgz",
+      "integrity": "sha512-Czi8yzXUWIQYAtL/2y6vogER8pvcsOsk5cpwL4Gk5nJqH5UZiVByIY8Eorm5R13gq+DQKYg0+JyQoytLQas4dA==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/netbsd-arm64": {
+      "version": "0.27.3",
+      "resolved": "https://registry.npmjs.org/@esbuild/netbsd-arm64/-/netbsd-arm64-0.27.3.tgz",
+      "integrity": "sha512-sDpk0RgmTCR/5HguIZa9n9u+HVKf40fbEUt+iTzSnCaGvY9kFP0YKBWZtJaraonFnqef5SlJ8/TiPAxzyS+UoA==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "netbsd"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/netbsd-x64": {
+      "version": "0.27.3",
+      "resolved": "https://registry.npmjs.org/@esbuild/netbsd-x64/-/netbsd-x64-0.27.3.tgz",
+      "integrity": "sha512-P14lFKJl/DdaE00LItAukUdZO5iqNH7+PjoBm+fLQjtxfcfFE20Xf5CrLsmZdq5LFFZzb5JMZ9grUwvtVYzjiA==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "netbsd"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/openbsd-arm64": {
+      "version": "0.27.3",
+      "resolved": "https://registry.npmjs.org/@esbuild/openbsd-arm64/-/openbsd-arm64-0.27.3.tgz",
+      "integrity": "sha512-AIcMP77AvirGbRl/UZFTq5hjXK+2wC7qFRGoHSDrZ5v5b8DK/GYpXW3CPRL53NkvDqb9D+alBiC/dV0Fb7eJcw==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "openbsd"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/openbsd-x64": {
+      "version": "0.27.3",
+      "resolved": "https://registry.npmjs.org/@esbuild/openbsd-x64/-/openbsd-x64-0.27.3.tgz",
+      "integrity": "sha512-DnW2sRrBzA+YnE70LKqnM3P+z8vehfJWHXECbwBmH/CU51z6FiqTQTHFenPlHmo3a8UgpLyH3PT+87OViOh1AQ==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "openbsd"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/openharmony-arm64": {
+      "version": "0.27.3",
+      "resolved": "https://registry.npmjs.org/@esbuild/openharmony-arm64/-/openharmony-arm64-0.27.3.tgz",
+      "integrity": "sha512-NinAEgr/etERPTsZJ7aEZQvvg/A6IsZG/LgZy+81wON2huV7SrK3e63dU0XhyZP4RKGyTm7aOgmQk0bGp0fy2g==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "openharmony"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/sunos-x64": {
+      "version": "0.27.3",
+      "resolved": "https://registry.npmjs.org/@esbuild/sunos-x64/-/sunos-x64-0.27.3.tgz",
+      "integrity": "sha512-PanZ+nEz+eWoBJ8/f8HKxTTD172SKwdXebZ0ndd953gt1HRBbhMsaNqjTyYLGLPdoWHy4zLU7bDVJztF5f3BHA==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "sunos"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/win32-arm64": {
+      "version": "0.27.3",
+      "resolved": "https://registry.npmjs.org/@esbuild/win32-arm64/-/win32-arm64-0.27.3.tgz",
+      "integrity": "sha512-B2t59lWWYrbRDw/tjiWOuzSsFh1Y/E95ofKz7rIVYSQkUYBjfSgf6oeYPNWHToFRr2zx52JKApIcAS/D5TUBnA==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "win32"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/win32-ia32": {
+      "version": "0.27.3",
+      "resolved": "https://registry.npmjs.org/@esbuild/win32-ia32/-/win32-ia32-0.27.3.tgz",
+      "integrity": "sha512-QLKSFeXNS8+tHW7tZpMtjlNb7HKau0QDpwm49u0vUp9y1WOF+PEzkU84y9GqYaAVW8aH8f3GcBck26jh54cX4Q==",
+      "cpu": [
+        "ia32"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "win32"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/win32-x64": {
+      "version": "0.27.3",
+      "resolved": "https://registry.npmjs.org/@esbuild/win32-x64/-/win32-x64-0.27.3.tgz",
+      "integrity": "sha512-4uJGhsxuptu3OcpVAzli+/gWusVGwZZHTlS63hh++ehExkVT8SgiEf7/uC/PclrPPkLhZqGgCTjd0VWLo6xMqA==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "win32"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@eslint-community/eslint-utils": {
+      "version": "4.9.1",
+      "resolved": "https://registry.npmjs.org/@eslint-community/eslint-utils/-/eslint-utils-4.9.1.tgz",
+      "integrity": "sha512-phrYmNiYppR7znFEdqgfWHXR6NCkZEK7hwWDHZUjit/2/U0r6XvkDl0SYnoM51Hq7FhCGdLDT6zxCCOY1hexsQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "eslint-visitor-keys": "^3.4.3"
+      },
+      "engines": {
+        "node": "^12.22.0 || ^14.17.0 || >=16.0.0"
+      },
+      "funding": {
+        "url": "https://opencollective.com/eslint"
+      },
+      "peerDependencies": {
+        "eslint": "^6.0.0 || ^7.0.0 || >=8.0.0"
+      }
+    },
+    "node_modules/@eslint-community/eslint-utils/node_modules/eslint-visitor-keys": {
+      "version": "3.4.3",
+      "resolved": "https://registry.npmjs.org/eslint-visitor-keys/-/eslint-visitor-keys-3.4.3.tgz",
+      "integrity": "sha512-wpc+LXeiyiisxPlEkUzU6svyS1frIO3Mgxj1fdy7Pm8Ygzguax2N3Fa/D/ag1WqbOprdI+uY6wMUl8/a2G+iag==",
+      "dev": true,
+      "license": "Apache-2.0",
+      "engines": {
+        "node": "^12.22.0 || ^14.17.0 || >=16.0.0"
+      },
+      "funding": {
+        "url": "https://opencollective.com/eslint"
+      }
+    },
+    "node_modules/@eslint-community/regexpp": {
+      "version": "4.12.2",
+      "resolved": "https://registry.npmjs.org/@eslint-community/regexpp/-/regexpp-4.12.2.tgz",
+      "integrity": "sha512-EriSTlt5OC9/7SXkRSCAhfSxxoSUgBm33OH+IkwbdpgoqsSsUg7y3uh+IICI/Qg4BBWr3U2i39RpmycbxMq4ew==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": "^12.0.0 || ^14.0.0 || >=16.0.0"
+      }
+    },
+    "node_modules/@eslint/config-array": {
+      "version": "0.23.5",
+      "resolved": "https://registry.npmjs.org/@eslint/config-array/-/config-array-0.23.5.tgz",
+      "integrity": "sha512-Y3kKLvC1dvTOT+oGlqNQ1XLqK6D1HU2YXPc52NmAlJZbMMWDzGYXMiPRJ8TYD39muD/OTjlZmNJ4ib7dvSrMBA==",
+      "dev": true,
+      "license": "Apache-2.0",
+      "dependencies": {
+        "@eslint/object-schema": "^3.0.5",
+        "debug": "^4.3.1",
+        "minimatch": "^10.2.4"
+      },
+      "engines": {
+        "node": "^20.19.0 || ^22.13.0 || >=24"
+      }
+    },
+    "node_modules/@eslint/config-helpers": {
+      "version": "0.6.0",
+      "resolved": "https://registry.npmjs.org/@eslint/config-helpers/-/config-helpers-0.6.0.tgz",
+      "integrity": "sha512-ii6Bw9jJ2zi2cWA2Z+9/QZ/+3DX6kwaV5Q986D/CdP3Lap3w/pgQZ373FV7byY/i7L4IRH/G43I5dz1ClsCbpA==",
+      "dev": true,
+      "license": "Apache-2.0",
+      "dependencies": {
+        "@eslint/core": "^1.2.1"
+      },
+      "engines": {
+        "node": "^20.19.0 || ^22.13.0 || >=24"
+      }
+    },
+    "node_modules/@eslint/core": {
+      "version": "1.2.1",
+      "resolved": "https://registry.npmjs.org/@eslint/core/-/core-1.2.1.tgz",
+      "integrity": "sha512-MwcE1P+AZ4C6DWlpin/OmOA54mmIZ/+xZuJiQd4SyB29oAJjN30UW9wkKNptW2ctp4cEsvhlLY/CsQ1uoHDloQ==",
+      "dev": true,
+      "license": "Apache-2.0",
+      "dependencies": {
+        "@types/json-schema": "^7.0.15"
+      },
+      "engines": {
+        "node": "^20.19.0 || ^22.13.0 || >=24"
+      }
+    },
+    "node_modules/@eslint/js": {
+      "version": "10.0.1",
+      "resolved": "https://registry.npmjs.org/@eslint/js/-/js-10.0.1.tgz",
+      "integrity": "sha512-zeR9k5pd4gxjZ0abRoIaxdc7I3nDktoXZk2qOv9gCNWx3mVwEn32VRhyLaRsDiJjTs0xq/T8mfPtyuXu7GWBcA==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": "^20.19.0 || ^22.13.0 || >=24"
+      },
+      "funding": {
+        "url": "https://eslint.org/donate"
+      },
+      "peerDependencies": {
+        "eslint": "^10.0.0"
+      },
+      "peerDependenciesMeta": {
+        "eslint": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/@eslint/object-schema": {
+      "version": "3.0.5",
+      "resolved": "https://registry.npmjs.org/@eslint/object-schema/-/object-schema-3.0.5.tgz",
+      "integrity": "sha512-vqTaUEgxzm+YDSdElad6PiRoX4t8VGDjCtt05zn4nU810UIx/uNEV7/lZJ6KwFThKZOzOxzXy48da+No7HZaMw==",
+      "dev": true,
+      "license": "Apache-2.0",
+      "engines": {
+        "node": "^20.19.0 || ^22.13.0 || >=24"
+      }
+    },
+    "node_modules/@eslint/plugin-kit": {
+      "version": "0.7.2",
+      "resolved": "https://registry.npmjs.org/@eslint/plugin-kit/-/plugin-kit-0.7.2.tgz",
+      "integrity": "sha512-+CNAzxglkrpNf/kKywqQfk74QjtceuOE7Qm+AF8miRvPF/wmmK5+OJOgVh3AVTT3RP2mH3+FOaxlE5v72owk0A==",
+      "dev": true,
+      "license": "Apache-2.0",
+      "dependencies": {
+        "@eslint/core": "^1.2.1",
+        "levn": "^0.4.1"
+      },
+      "engines": {
+        "node": "^20.19.0 || ^22.13.0 || >=24"
+      }
+    },
+    "node_modules/@humanfs/core": {
+      "version": "0.19.2",
+      "resolved": "https://registry.npmjs.org/@humanfs/core/-/core-0.19.2.tgz",
+      "integrity": "sha512-UhXNm+CFMWcbChXywFwkmhqjs3PRCmcSa/hfBgLIb7oQ5HNb1wS0icWsGtSAUNgefHeI+eBrA8I1fxmbHsGdvA==",
+      "dev": true,
+      "license": "Apache-2.0",
+      "dependencies": {
+        "@humanfs/types": "^0.15.0"
+      },
+      "engines": {
+        "node": ">=18.18.0"
+      }
+    },
+    "node_modules/@humanfs/node": {
+      "version": "0.16.8",
+      "resolved": "https://registry.npmjs.org/@humanfs/node/-/node-0.16.8.tgz",
+      "integrity": "sha512-gE1eQNZ3R++kTzFUpdGlpmy8kDZD/MLyHqDwqjkVQI0JMdI1D51sy1H958PNXYkM2rAac7e5/CnIKZrHtPh3BQ==",
+      "dev": true,
+      "license": "Apache-2.0",
+      "dependencies": {
+        "@humanfs/core": "^0.19.2",
+        "@humanfs/types": "^0.15.0",
+        "@humanwhocodes/retry": "^0.4.0"
+      },
+      "engines": {
+        "node": ">=18.18.0"
+      }
+    },
+    "node_modules/@humanfs/types": {
+      "version": "0.15.0",
+      "resolved": "https://registry.npmjs.org/@humanfs/types/-/types-0.15.0.tgz",
+      "integrity": "sha512-ZZ1w0aoQkwuUuC7Yf+7sdeaNfqQiiLcSRbfI08oAxqLtpXQr9AIVX7Ay7HLDuiLYAaFPu8oBYNq/QIi9URHJ3Q==",
+      "dev": true,
+      "license": "Apache-2.0",
+      "engines": {
+        "node": ">=18.18.0"
+      }
+    },
+    "node_modules/@humanwhocodes/module-importer": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/@humanwhocodes/module-importer/-/module-importer-1.0.1.tgz",
+      "integrity": "sha512-bxveV4V8v5Yb4ncFTT3rPSgZBOpCkjfK0y4oVVVJwIuDVBRMDXrPyXRL988i5ap9m9bnyEEjWfm5WkBmtffLfA==",
+      "dev": true,
+      "license": "Apache-2.0",
+      "engines": {
+        "node": ">=12.22"
+      },
+      "funding": {
+        "type": "github",
+        "url": "https://github.com/sponsors/nzakas"
+      }
+    },
+    "node_modules/@humanwhocodes/retry": {
+      "version": "0.4.3",
+      "resolved": "https://registry.npmjs.org/@humanwhocodes/retry/-/retry-0.4.3.tgz",
+      "integrity": "sha512-bV0Tgo9K4hfPCek+aMAn81RppFKv2ySDQeMoSZuvTASywNTnVJCArCZE2FWqpvIatKu7VMRLWlR1EazvVhDyhQ==",
+      "dev": true,
+      "license": "Apache-2.0",
+      "engines": {
+        "node": ">=18.18"
+      },
+      "funding": {
+        "type": "github",
+        "url": "https://github.com/sponsors/nzakas"
+      }
+    },
+    "node_modules/@isaacs/cliui": {
+      "version": "9.0.0",
+      "resolved": "https://registry.npmjs.org/@isaacs/cliui/-/cliui-9.0.0.tgz",
+      "integrity": "sha512-AokJm4tuBHillT+FpMtxQ60n8ObyXBatq7jD2/JA9dxbDDokKQm8KMht5ibGzLVU9IJDIKK4TPKgMHEYMn3lMg==",
+      "dev": true,
+      "license": "BlueOak-1.0.0",
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@jridgewell/gen-mapping": {
+      "version": "0.3.13",
+      "resolved": "https://registry.npmjs.org/@jridgewell/gen-mapping/-/gen-mapping-0.3.13.tgz",
+      "integrity": "sha512-2kkt/7niJ6MgEPxF0bYdQ6etZaA+fQvDcLKckhy1yIQOzaoKjBBjSj63/aLVjYE3qhRt5dvM+uUyfCg6UKCBbA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@jridgewell/sourcemap-codec": "^1.5.0",
+        "@jridgewell/trace-mapping": "^0.3.24"
+      }
+    },
+    "node_modules/@jridgewell/remapping": {
+      "version": "2.3.5",
+      "resolved": "https://registry.npmjs.org/@jridgewell/remapping/-/remapping-2.3.5.tgz",
+      "integrity": "sha512-LI9u/+laYG4Ds1TDKSJW2YPrIlcVYOwi2fUC6xB43lueCjgxV4lffOCZCtYFiH6TNOX+tQKXx97T4IKHbhyHEQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@jridgewell/gen-mapping": "^0.3.5",
+        "@jridgewell/trace-mapping": "^0.3.24"
+      }
+    },
+    "node_modules/@jridgewell/resolve-uri": {
+      "version": "3.1.2",
+      "resolved": "https://registry.npmjs.org/@jridgewell/resolve-uri/-/resolve-uri-3.1.2.tgz",
+      "integrity": "sha512-bRISgCIjP20/tbWSPWMEi54QVPRZExkuD9lJL+UIxUKtwVJA8wW1Trb1jMs1RFXo1CBTNZ/5hpC9QvmKWdopKw==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=6.0.0"
+      }
+    },
+    "node_modules/@jridgewell/source-map": {
+      "version": "0.3.11",
+      "resolved": "https://registry.npmjs.org/@jridgewell/source-map/-/source-map-0.3.11.tgz",
+      "integrity": "sha512-ZMp1V8ZFcPG5dIWnQLr3NSI1MiCU7UETdS/A0G8V/XWHvJv3ZsFqutJn1Y5RPmAPX6F3BiE397OqveU/9NCuIA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@jridgewell/gen-mapping": "^0.3.5",
+        "@jridgewell/trace-mapping": "^0.3.25"
+      }
+    },
+    "node_modules/@jridgewell/sourcemap-codec": {
+      "version": "1.5.5",
+      "resolved": "https://registry.npmjs.org/@jridgewell/sourcemap-codec/-/sourcemap-codec-1.5.5.tgz",
+      "integrity": "sha512-cYQ9310grqxueWbl+WuIUIaiUaDcj7WOq5fVhEljNVgRfOUhY9fy2zTvfoqWsnebh8Sl70VScFbICvJnLKB0Og==",
+      "license": "MIT"
+    },
+    "node_modules/@jridgewell/trace-mapping": {
+      "version": "0.3.31",
+      "resolved": "https://registry.npmjs.org/@jridgewell/trace-mapping/-/trace-mapping-0.3.31.tgz",
+      "integrity": "sha512-zzNR+SdQSDJzc8joaeP8QQoCQr8NuYx2dIIytl1QeBEZHJ9uW6hebsrYgbz8hJwUQao3TWCMtmfV8Nu1twOLAw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@jridgewell/resolve-uri": "^3.1.0",
+        "@jridgewell/sourcemap-codec": "^1.4.14"
+      }
+    },
+    "node_modules/@kurkle/color": {
+      "version": "0.3.4",
+      "resolved": "https://registry.npmjs.org/@kurkle/color/-/color-0.3.4.tgz",
+      "integrity": "sha512-M5UknZPHRu3DEDWoipU6sE8PdkZ6Z/S+v4dD+Ke8IaNlpdSQah50lz1KtcFBa2vsdOnwbbnxJwVM4wty6udA5w==",
+      "license": "MIT"
+    },
+    "node_modules/@rolldown/pluginutils": {
+      "version": "1.0.0-rc.2",
+      "resolved": "https://registry.npmjs.org/@rolldown/pluginutils/-/pluginutils-1.0.0-rc.2.tgz",
+      "integrity": "sha512-izyXV/v+cHiRfozX62W9htOAvwMo4/bXKDrQ+vom1L1qRuexPock/7VZDAhnpHCLNejd3NJ6hiab+tO0D44Rgw==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/@rollup/plugin-babel": {
+      "version": "6.1.0",
+      "resolved": "https://registry.npmjs.org/@rollup/plugin-babel/-/plugin-babel-6.1.0.tgz",
+      "integrity": "sha512-dFZNuFD2YRcoomP4oYf+DvQNSUA9ih+A3vUqopQx5EdtPGo3WBnQcI/S8pwpz91UsGfL0HsMSOlaMld8HrbubA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@babel/helper-module-imports": "^7.18.6",
+        "@rollup/pluginutils": "^5.0.1"
+      },
+      "engines": {
+        "node": ">=14.0.0"
+      },
+      "peerDependencies": {
+        "@babel/core": "^7.0.0",
+        "@types/babel__core": "^7.1.9",
+        "rollup": "^1.20.0||^2.0.0||^3.0.0||^4.0.0"
+      },
+      "peerDependenciesMeta": {
+        "@types/babel__core": {
+          "optional": true
+        },
+        "rollup": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/@rollup/plugin-node-resolve": {
+      "version": "16.0.3",
+      "resolved": "https://registry.npmjs.org/@rollup/plugin-node-resolve/-/plugin-node-resolve-16.0.3.tgz",
+      "integrity": "sha512-lUYM3UBGuM93CnMPG1YocWu7X802BrNF3jW2zny5gQyLQgRFJhV1Sq0Zi74+dh/6NBx1DxFC4b4GXg9wUCG5Qg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@rollup/pluginutils": "^5.0.1",
+        "@types/resolve": "1.20.2",
+        "deepmerge": "^4.2.2",
+        "is-module": "^1.0.0",
+        "resolve": "^1.22.1"
+      },
+      "engines": {
+        "node": ">=14.0.0"
+      },
+      "peerDependencies": {
+        "rollup": "^2.78.0||^3.0.0||^4.0.0"
+      },
+      "peerDependenciesMeta": {
+        "rollup": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/@rollup/plugin-replace": {
+      "version": "6.0.3",
+      "resolved": "https://registry.npmjs.org/@rollup/plugin-replace/-/plugin-replace-6.0.3.tgz",
+      "integrity": "sha512-J4RZarRvQAm5IF0/LwUUg+obsm+xZhYnbMXmXROyoSE1ATJe3oXSb9L5MMppdxP2ylNSjv6zFBwKYjcKMucVfA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@rollup/pluginutils": "^5.0.1",
+        "magic-string": "^0.30.3"
+      },
+      "engines": {
+        "node": ">=14.0.0"
+      },
+      "peerDependencies": {
+        "rollup": "^1.20.0||^2.0.0||^3.0.0||^4.0.0"
+      },
+      "peerDependenciesMeta": {
+        "rollup": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/@rollup/plugin-terser": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/@rollup/plugin-terser/-/plugin-terser-1.0.0.tgz",
+      "integrity": "sha512-FnCxhTBx6bMOYQrar6C8h3scPt8/JwIzw3+AJ2K++6guogH5fYaIFia+zZuhqv0eo1RN7W1Pz630SyvLbDjhtQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "serialize-javascript": "^7.0.3",
+        "smob": "^1.0.0",
+        "terser": "^5.17.4"
+      },
+      "engines": {
+        "node": ">=20.0.0"
+      },
+      "peerDependencies": {
+        "rollup": "^2.0.0||^3.0.0||^4.0.0"
+      },
+      "peerDependenciesMeta": {
+        "rollup": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/@rollup/pluginutils": {
+      "version": "5.3.0",
+      "resolved": "https://registry.npmjs.org/@rollup/pluginutils/-/pluginutils-5.3.0.tgz",
+      "integrity": "sha512-5EdhGZtnu3V88ces7s53hhfK5KSASnJZv8Lulpc04cWO3REESroJXg73DFsOmgbU2BhwV0E20bu2IDZb3VKW4Q==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@types/estree": "^1.0.0",
+        "estree-walker": "^2.0.2",
+        "picomatch": "^4.0.2"
+      },
+      "engines": {
+        "node": ">=14.0.0"
+      },
+      "peerDependencies": {
+        "rollup": "^1.20.0||^2.0.0||^3.0.0||^4.0.0"
+      },
+      "peerDependenciesMeta": {
+        "rollup": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/@rollup/rollup-android-arm-eabi": {
+      "version": "4.59.0",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-android-arm-eabi/-/rollup-android-arm-eabi-4.59.0.tgz",
+      "integrity": "sha512-upnNBkA6ZH2VKGcBj9Fyl9IGNPULcjXRlg0LLeaioQWueH30p6IXtJEbKAgvyv+mJaMxSm1l6xwDXYjpEMiLMg==",
+      "cpu": [
+        "arm"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "android"
+      ]
+    },
+    "node_modules/@rollup/rollup-android-arm64": {
+      "version": "4.59.0",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-android-arm64/-/rollup-android-arm64-4.59.0.tgz",
+      "integrity": "sha512-hZ+Zxj3SySm4A/DylsDKZAeVg0mvi++0PYVceVyX7hemkw7OreKdCvW2oQ3T1FMZvCaQXqOTHb8qmBShoqk69Q==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "android"
+      ]
+    },
+    "node_modules/@rollup/rollup-darwin-arm64": {
+      "version": "4.59.0",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-darwin-arm64/-/rollup-darwin-arm64-4.59.0.tgz",
+      "integrity": "sha512-W2Psnbh1J8ZJw0xKAd8zdNgF9HRLkdWwwdWqubSVk0pUuQkoHnv7rx4GiF9rT4t5DIZGAsConRE3AxCdJ4m8rg==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "darwin"
+      ]
+    },
+    "node_modules/@rollup/rollup-darwin-x64": {
+      "version": "4.59.0",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-darwin-x64/-/rollup-darwin-x64-4.59.0.tgz",
+      "integrity": "sha512-ZW2KkwlS4lwTv7ZVsYDiARfFCnSGhzYPdiOU4IM2fDbL+QGlyAbjgSFuqNRbSthybLbIJ915UtZBtmuLrQAT/w==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "darwin"
+      ]
+    },
+    "node_modules/@rollup/rollup-freebsd-arm64": {
+      "version": "4.59.0",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-freebsd-arm64/-/rollup-freebsd-arm64-4.59.0.tgz",
+      "integrity": "sha512-EsKaJ5ytAu9jI3lonzn3BgG8iRBjV4LxZexygcQbpiU0wU0ATxhNVEpXKfUa0pS05gTcSDMKpn3Sx+QB9RlTTA==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "freebsd"
+      ]
+    },
+    "node_modules/@rollup/rollup-freebsd-x64": {
+      "version": "4.59.0",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-freebsd-x64/-/rollup-freebsd-x64-4.59.0.tgz",
+      "integrity": "sha512-d3DuZi2KzTMjImrxoHIAODUZYoUUMsuUiY4SRRcJy6NJoZ6iIqWnJu9IScV9jXysyGMVuW+KNzZvBLOcpdl3Vg==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "freebsd"
+      ]
+    },
+    "node_modules/@rollup/rollup-linux-arm-gnueabihf": {
+      "version": "4.59.0",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm-gnueabihf/-/rollup-linux-arm-gnueabihf-4.59.0.tgz",
+      "integrity": "sha512-t4ONHboXi/3E0rT6OZl1pKbl2Vgxf9vJfWgmUoCEVQVxhW6Cw/c8I6hbbu7DAvgp82RKiH7TpLwxnJeKv2pbsw==",
+      "cpu": [
+        "arm"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ]
+    },
+    "node_modules/@rollup/rollup-linux-arm-musleabihf": {
+      "version": "4.59.0",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm-musleabihf/-/rollup-linux-arm-musleabihf-4.59.0.tgz",
+      "integrity": "sha512-CikFT7aYPA2ufMD086cVORBYGHffBo4K8MQ4uPS/ZnY54GKj36i196u8U+aDVT2LX4eSMbyHtyOh7D7Zvk2VvA==",
+      "cpu": [
+        "arm"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ]
+    },
+    "node_modules/@rollup/rollup-linux-arm64-gnu": {
+      "version": "4.59.0",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm64-gnu/-/rollup-linux-arm64-gnu-4.59.0.tgz",
+      "integrity": "sha512-jYgUGk5aLd1nUb1CtQ8E+t5JhLc9x5WdBKew9ZgAXg7DBk0ZHErLHdXM24rfX+bKrFe+Xp5YuJo54I5HFjGDAA==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ]
+    },
+    "node_modules/@rollup/rollup-linux-arm64-musl": {
+      "version": "4.59.0",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm64-musl/-/rollup-linux-arm64-musl-4.59.0.tgz",
+      "integrity": "sha512-peZRVEdnFWZ5Bh2KeumKG9ty7aCXzzEsHShOZEFiCQlDEepP1dpUl/SrUNXNg13UmZl+gzVDPsiCwnV1uI0RUA==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ]
+    },
+    "node_modules/@rollup/rollup-linux-loong64-gnu": {
+      "version": "4.59.0",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-loong64-gnu/-/rollup-linux-loong64-gnu-4.59.0.tgz",
+      "integrity": "sha512-gbUSW/97f7+r4gHy3Jlup8zDG190AuodsWnNiXErp9mT90iCy9NKKU0Xwx5k8VlRAIV2uU9CsMnEFg/xXaOfXg==",
+      "cpu": [
+        "loong64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ]
+    },
+    "node_modules/@rollup/rollup-linux-loong64-musl": {
+      "version": "4.59.0",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-loong64-musl/-/rollup-linux-loong64-musl-4.59.0.tgz",
+      "integrity": "sha512-yTRONe79E+o0FWFijasoTjtzG9EBedFXJMl888NBEDCDV9I2wGbFFfJQQe63OijbFCUZqxpHz1GzpbtSFikJ4Q==",
+      "cpu": [
+        "loong64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ]
+    },
+    "node_modules/@rollup/rollup-linux-ppc64-gnu": {
+      "version": "4.59.0",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-ppc64-gnu/-/rollup-linux-ppc64-gnu-4.59.0.tgz",
+      "integrity": "sha512-sw1o3tfyk12k3OEpRddF68a1unZ5VCN7zoTNtSn2KndUE+ea3m3ROOKRCZxEpmT9nsGnogpFP9x6mnLTCaoLkA==",
+      "cpu": [
+        "ppc64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ]
+    },
+    "node_modules/@rollup/rollup-linux-ppc64-musl": {
+      "version": "4.59.0",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-ppc64-musl/-/rollup-linux-ppc64-musl-4.59.0.tgz",
+      "integrity": "sha512-+2kLtQ4xT3AiIxkzFVFXfsmlZiG5FXYW7ZyIIvGA7Bdeuh9Z0aN4hVyXS/G1E9bTP/vqszNIN/pUKCk/BTHsKA==",
+      "cpu": [
+        "ppc64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ]
+    },
+    "node_modules/@rollup/rollup-linux-riscv64-gnu": {
+      "version": "4.59.0",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-riscv64-gnu/-/rollup-linux-riscv64-gnu-4.59.0.tgz",
+      "integrity": "sha512-NDYMpsXYJJaj+I7UdwIuHHNxXZ/b/N2hR15NyH3m2qAtb/hHPA4g4SuuvrdxetTdndfj9b1WOmy73kcPRoERUg==",
+      "cpu": [
+        "riscv64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ]
+    },
+    "node_modules/@rollup/rollup-linux-riscv64-musl": {
+      "version": "4.59.0",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-riscv64-musl/-/rollup-linux-riscv64-musl-4.59.0.tgz",
+      "integrity": "sha512-nLckB8WOqHIf1bhymk+oHxvM9D3tyPndZH8i8+35p/1YiVoVswPid2yLzgX7ZJP0KQvnkhM4H6QZ5m0LzbyIAg==",
+      "cpu": [
+        "riscv64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ]
+    },
+    "node_modules/@rollup/rollup-linux-s390x-gnu": {
+      "version": "4.59.0",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-s390x-gnu/-/rollup-linux-s390x-gnu-4.59.0.tgz",
+      "integrity": "sha512-oF87Ie3uAIvORFBpwnCvUzdeYUqi2wY6jRFWJAy1qus/udHFYIkplYRW+wo+GRUP4sKzYdmE1Y3+rY5Gc4ZO+w==",
+      "cpu": [
+        "s390x"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ]
+    },
+    "node_modules/@rollup/rollup-linux-x64-gnu": {
+      "version": "4.59.0",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-x64-gnu/-/rollup-linux-x64-gnu-4.59.0.tgz",
+      "integrity": "sha512-3AHmtQq/ppNuUspKAlvA8HtLybkDflkMuLK4DPo77DfthRb71V84/c4MlWJXixZz4uruIH4uaa07IqoAkG64fg==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ]
+    },
+    "node_modules/@rollup/rollup-linux-x64-musl": {
+      "version": "4.59.0",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-x64-musl/-/rollup-linux-x64-musl-4.59.0.tgz",
+      "integrity": "sha512-2UdiwS/9cTAx7qIUZB/fWtToJwvt0Vbo0zmnYt7ED35KPg13Q0ym1g442THLC7VyI6JfYTP4PiSOWyoMdV2/xg==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ]
+    },
+    "node_modules/@rollup/rollup-openbsd-x64": {
+      "version": "4.59.0",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-openbsd-x64/-/rollup-openbsd-x64-4.59.0.tgz",
+      "integrity": "sha512-M3bLRAVk6GOwFlPTIxVBSYKUaqfLrn8l0psKinkCFxl4lQvOSz8ZrKDz2gxcBwHFpci0B6rttydI4IpS4IS/jQ==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "openbsd"
+      ]
+    },
+    "node_modules/@rollup/rollup-openharmony-arm64": {
+      "version": "4.59.0",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-openharmony-arm64/-/rollup-openharmony-arm64-4.59.0.tgz",
+      "integrity": "sha512-tt9KBJqaqp5i5HUZzoafHZX8b5Q2Fe7UjYERADll83O4fGqJ49O1FsL6LpdzVFQcpwvnyd0i+K/VSwu/o/nWlA==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "openharmony"
+      ]
+    },
+    "node_modules/@rollup/rollup-win32-arm64-msvc": {
+      "version": "4.59.0",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-arm64-msvc/-/rollup-win32-arm64-msvc-4.59.0.tgz",
+      "integrity": "sha512-V5B6mG7OrGTwnxaNUzZTDTjDS7F75PO1ae6MJYdiMu60sq0CqN5CVeVsbhPxalupvTX8gXVSU9gq+Rx1/hvu6A==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "win32"
+      ]
+    },
+    "node_modules/@rollup/rollup-win32-ia32-msvc": {
+      "version": "4.59.0",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-ia32-msvc/-/rollup-win32-ia32-msvc-4.59.0.tgz",
+      "integrity": "sha512-UKFMHPuM9R0iBegwzKF4y0C4J9u8C6MEJgFuXTBerMk7EJ92GFVFYBfOZaSGLu6COf7FxpQNqhNS4c4icUPqxA==",
+      "cpu": [
+        "ia32"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "win32"
+      ]
+    },
+    "node_modules/@rollup/rollup-win32-x64-gnu": {
+      "version": "4.59.0",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-x64-gnu/-/rollup-win32-x64-gnu-4.59.0.tgz",
+      "integrity": "sha512-laBkYlSS1n2L8fSo1thDNGrCTQMmxjYY5G0WFWjFFYZkKPjsMBsgJfGf4TLxXrF6RyhI60L8TMOjBMvXiTcxeA==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "win32"
+      ]
+    },
+    "node_modules/@rollup/rollup-win32-x64-msvc": {
+      "version": "4.59.0",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-x64-msvc/-/rollup-win32-x64-msvc-4.59.0.tgz",
+      "integrity": "sha512-2HRCml6OztYXyJXAvdDXPKcawukWY2GpR5/nxKp4iBgiO3wcoEGkAaqctIbZcNB6KlUQBIqt8VYkNSj2397EfA==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "win32"
+      ]
+    },
+    "node_modules/@sqlite.org/sqlite-wasm": {
+      "version": "3.51.2-build7",
+      "resolved": "https://registry.npmjs.org/@sqlite.org/sqlite-wasm/-/sqlite-wasm-3.51.2-build7.tgz",
+      "integrity": "sha512-11GK8eeFTP4pLCDdFZTwxeQ57bjghDo7JLNw1li+jmhXDr01lUcee2A+Rn6BJhPBU29oqf3OPBXfZtWDzoNCww==",
+      "license": "Apache-2.0",
+      "engines": {
+        "node": ">=22"
+      }
+    },
+    "node_modules/@trickfilm400/rollup-plugin-off-main-thread": {
+      "version": "3.0.0-pre1",
+      "resolved": "https://registry.npmjs.org/@trickfilm400/rollup-plugin-off-main-thread/-/rollup-plugin-off-main-thread-3.0.0-pre1.tgz",
+      "integrity": "sha512-/67zpWDBLV+oYAEL682s1ktXL0HgqX76f6gaVGkGnVZlBbm1zd0v4Bz8MFF2GGhoX9rvfq3KSQHubFHwa6w6/Q==",
+      "dev": true,
+      "license": "Apache-2.0",
+      "dependencies": {
+        "ejs": "^3.1.10",
+        "json5": "^2.2.3",
+        "magic-string": "^0.30.21",
+        "string.prototype.matchall": "^4.0.12"
+      },
+      "engines": {
+        "node": ">=12"
+      }
+    },
+    "node_modules/@types/esrecurse": {
+      "version": "4.3.1",
+      "resolved": "https://registry.npmjs.org/@types/esrecurse/-/esrecurse-4.3.1.tgz",
+      "integrity": "sha512-xJBAbDifo5hpffDBuHl0Y8ywswbiAp/Wi7Y/GtAgSlZyIABppyurxVueOPE8LUQOxdlgi6Zqce7uoEpqNTeiUw==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/@types/estree": {
+      "version": "1.0.8",
+      "resolved": "https://registry.npmjs.org/@types/estree/-/estree-1.0.8.tgz",
+      "integrity": "sha512-dWHzHa2WqEXI/O1E9OjrocMTKJl2mSrEolh1Iomrv6U+JuNwaHXsXx9bLu5gG7BUWFIN0skIQJQ/L1rIex4X6w==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/@types/json-schema": {
+      "version": "7.0.15",
+      "resolved": "https://registry.npmjs.org/@types/json-schema/-/json-schema-7.0.15.tgz",
+      "integrity": "sha512-5+fP8P8MFNC+AyZCDxrB2pkZFPGzqQWUzpSeuuVLvm8VMcorNYavBqoFcxK8bQz4Qsbn4oUEEem4wDLfcysGHA==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/@types/resolve": {
+      "version": "1.20.2",
+      "resolved": "https://registry.npmjs.org/@types/resolve/-/resolve-1.20.2.tgz",
+      "integrity": "sha512-60BCwRFOZCQhDncwQdxxeOEEkbc5dIMccYLwbxsS4TUNeVECQ/pBJ0j09mrHOl/JJvpRPGwO9SvE4nR2Nb/a4Q==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/@types/trusted-types": {
+      "version": "2.0.7",
+      "resolved": "https://registry.npmjs.org/@types/trusted-types/-/trusted-types-2.0.7.tgz",
+      "integrity": "sha512-ScaPdn1dQczgbl0QFTeTOmVHFULt394XJgOQNoyVhZ6r2vLnMLJfBPd53SB52T/3G36VI1/g2MZaX0cwDuXsfw==",
+      "devOptional": true,
+      "license": "MIT"
+    },
+    "node_modules/@vitejs/plugin-vue": {
+      "version": "6.0.4",
+      "resolved": "https://registry.npmjs.org/@vitejs/plugin-vue/-/plugin-vue-6.0.4.tgz",
+      "integrity": "sha512-uM5iXipgYIn13UUQCZNdWkYk+sysBeA97d5mHsAoAt1u/wpN3+zxOmsVJWosuzX+IMGRzeYUNytztrYznboIkQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@rolldown/pluginutils": "1.0.0-rc.2"
+      },
+      "engines": {
+        "node": "^20.19.0 || >=22.12.0"
+      },
+      "peerDependencies": {
+        "vite": "^5.0.0 || ^6.0.0 || ^7.0.0 || ^8.0.0-0",
+        "vue": "^3.2.25"
+      }
+    },
+    "node_modules/@vue/compiler-core": {
+      "version": "3.5.30",
+      "resolved": "https://registry.npmjs.org/@vue/compiler-core/-/compiler-core-3.5.30.tgz",
+      "integrity": "sha512-s3DfdZkcu/qExZ+td75015ljzHc6vE+30cFMGRPROYjqkroYI5NV2X1yAMX9UeyBNWB9MxCfPcsjpLS11nzkkw==",
+      "license": "MIT",
+      "dependencies": {
+        "@babel/parser": "^7.29.0",
+        "@vue/shared": "3.5.30",
+        "entities": "^7.0.1",
+        "estree-walker": "^2.0.2",
+        "source-map-js": "^1.2.1"
+      }
+    },
+    "node_modules/@vue/compiler-dom": {
+      "version": "3.5.30",
+      "resolved": "https://registry.npmjs.org/@vue/compiler-dom/-/compiler-dom-3.5.30.tgz",
+      "integrity": "sha512-eCFYESUEVYHhiMuK4SQTldO3RYxyMR/UQL4KdGD1Yrkfdx4m/HYuZ9jSfPdA+nWJY34VWndiYdW/wZXyiPEB9g==",
+      "license": "MIT",
+      "dependencies": {
+        "@vue/compiler-core": "3.5.30",
+        "@vue/shared": "3.5.30"
+      }
+    },
+    "node_modules/@vue/compiler-sfc": {
+      "version": "3.5.30",
+      "resolved": "https://registry.npmjs.org/@vue/compiler-sfc/-/compiler-sfc-3.5.30.tgz",
+      "integrity": "sha512-LqmFPDn89dtU9vI3wHJnwaV6GfTRD87AjWpTWpyrdVOObVtjIuSeZr181z5C4PmVx/V3j2p+0f7edFKGRMpQ5A==",
+      "license": "MIT",
+      "dependencies": {
+        "@babel/parser": "^7.29.0",
+        "@vue/compiler-core": "3.5.30",
+        "@vue/compiler-dom": "3.5.30",
+        "@vue/compiler-ssr": "3.5.30",
+        "@vue/shared": "3.5.30",
+        "estree-walker": "^2.0.2",
+        "magic-string": "^0.30.21",
+        "postcss": "^8.5.8",
+        "source-map-js": "^1.2.1"
+      }
+    },
+    "node_modules/@vue/compiler-ssr": {
+      "version": "3.5.30",
+      "resolved": "https://registry.npmjs.org/@vue/compiler-ssr/-/compiler-ssr-3.5.30.tgz",
+      "integrity": "sha512-NsYK6OMTnx109PSL2IAyf62JP6EUdk4Dmj6AkWcJGBvN0dQoMYtVekAmdqgTtWQgEJo+Okstbf/1p7qZr5H+bA==",
+      "license": "MIT",
+      "dependencies": {
+        "@vue/compiler-dom": "3.5.30",
+        "@vue/shared": "3.5.30"
+      }
+    },
+    "node_modules/@vue/devtools-api": {
+      "version": "6.6.4",
+      "resolved": "https://registry.npmjs.org/@vue/devtools-api/-/devtools-api-6.6.4.tgz",
+      "integrity": "sha512-sGhTPMuXqZ1rVOk32RylztWkfXTRhuS7vgAKv0zjqk8gbsHkJ7xfFf+jbySxt7tWObEJwyKaHMikV/WGDiQm8g==",
+      "license": "MIT"
+    },
+    "node_modules/@vue/reactivity": {
+      "version": "3.5.30",
+      "resolved": "https://registry.npmjs.org/@vue/reactivity/-/reactivity-3.5.30.tgz",
+      "integrity": "sha512-179YNgKATuwj9gB+66snskRDOitDiuOZqkYia7mHKJaidOMo/WJxHKF8DuGc4V4XbYTJANlfEKb0yxTQotnx4Q==",
+      "license": "MIT",
+      "dependencies": {
+        "@vue/shared": "3.5.30"
+      }
+    },
+    "node_modules/@vue/runtime-core": {
+      "version": "3.5.30",
+      "resolved": "https://registry.npmjs.org/@vue/runtime-core/-/runtime-core-3.5.30.tgz",
+      "integrity": "sha512-e0Z+8PQsUTdwV8TtEsLzUM7SzC7lQwYKePydb7K2ZnmS6jjND+WJXkmmfh/swYzRyfP1EY3fpdesyYoymCzYfg==",
+      "license": "MIT",
+      "dependencies": {
+        "@vue/reactivity": "3.5.30",
+        "@vue/shared": "3.5.30"
+      }
+    },
+    "node_modules/@vue/runtime-dom": {
+      "version": "3.5.30",
+      "resolved": "https://registry.npmjs.org/@vue/runtime-dom/-/runtime-dom-3.5.30.tgz",
+      "integrity": "sha512-2UIGakjU4WSQ0T4iwDEW0W7vQj6n7AFn7taqZ9Cvm0Q/RA2FFOziLESrDL4GmtI1wV3jXg5nMoJSYO66egDUBw==",
+      "license": "MIT",
+      "dependencies": {
+        "@vue/reactivity": "3.5.30",
+        "@vue/runtime-core": "3.5.30",
+        "@vue/shared": "3.5.30",
+        "csstype": "^3.2.3"
+      }
+    },
+    "node_modules/@vue/server-renderer": {
+      "version": "3.5.30",
+      "resolved": "https://registry.npmjs.org/@vue/server-renderer/-/server-renderer-3.5.30.tgz",
+      "integrity": "sha512-v+R34icapydRwbZRD0sXwtHqrQJv38JuMB4JxbOxd8NEpGLny7cncMp53W9UH/zo4j8eDHjQ1dEJXwzFQknjtQ==",
+      "license": "MIT",
+      "dependencies": {
+        "@vue/compiler-ssr": "3.5.30",
+        "@vue/shared": "3.5.30"
+      },
+      "peerDependencies": {
+        "vue": "3.5.30"
+      }
+    },
+    "node_modules/@vue/shared": {
+      "version": "3.5.30",
+      "resolved": "https://registry.npmjs.org/@vue/shared/-/shared-3.5.30.tgz",
+      "integrity": "sha512-YXgQ7JjaO18NeK2K9VTbDHaFy62WrObMa6XERNfNOkAhD1F1oDSf3ZJ7K6GqabZ0BvSDHajp8qfS5Sa2I9n8uQ==",
+      "license": "MIT"
+    },
+    "node_modules/acorn": {
+      "version": "8.16.0",
+      "resolved": "https://registry.npmjs.org/acorn/-/acorn-8.16.0.tgz",
+      "integrity": "sha512-UVJyE9MttOsBQIDKw1skb9nAwQuR5wuGD3+82K6JgJlm/Y+KI92oNsMNGZCYdDsVtRHSak0pcV5Dno5+4jh9sw==",
+      "dev": true,
+      "license": "MIT",
+      "bin": {
+        "acorn": "bin/acorn"
+      },
+      "engines": {
+        "node": ">=0.4.0"
+      }
+    },
+    "node_modules/acorn-jsx": {
+      "version": "5.3.2",
+      "resolved": "https://registry.npmjs.org/acorn-jsx/-/acorn-jsx-5.3.2.tgz",
+      "integrity": "sha512-rq9s+JNhf0IChjtDXxllJ7g41oZk5SlXtp0LHwyA5cejwn7vKmKp4pPri6YEePv2PU65sAsegbXtIinmDFDXgQ==",
+      "dev": true,
+      "license": "MIT",
+      "peerDependencies": {
+        "acorn": "^6.0.0 || ^7.0.0 || ^8.0.0"
+      }
+    },
+    "node_modules/ajv": {
+      "version": "8.20.0",
+      "resolved": "https://registry.npmjs.org/ajv/-/ajv-8.20.0.tgz",
+      "integrity": "sha512-Thbli+OlOj+iMPYFBVBfJ3OmCAnaSyNn4M1vz9T6Gka5Jt9ba/HIR56joy65tY6kx/FCF5VXNB819Y7/GUrBGA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "fast-deep-equal": "^3.1.3",
+        "fast-uri": "^3.0.1",
+        "json-schema-traverse": "^1.0.0",
+        "require-from-string": "^2.0.2"
+      },
+      "funding": {
+        "type": "github",
+        "url": "https://github.com/sponsors/epoberezkin"
+      }
+    },
+    "node_modules/array-buffer-byte-length": {
+      "version": "1.0.2",
+      "resolved": "https://registry.npmjs.org/array-buffer-byte-length/-/array-buffer-byte-length-1.0.2.tgz",
+      "integrity": "sha512-LHE+8BuR7RYGDKvnrmcuSq3tDcKv9OFEXQt/HpbZhY7V6h0zlUXutnAD82GiFx9rdieCMjkvtcsPqBwgUl1Iiw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "call-bound": "^1.0.3",
+        "is-array-buffer": "^3.0.5"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/arraybuffer.prototype.slice": {
+      "version": "1.0.4",
+      "resolved": "https://registry.npmjs.org/arraybuffer.prototype.slice/-/arraybuffer.prototype.slice-1.0.4.tgz",
+      "integrity": "sha512-BNoCY6SXXPQ7gF2opIP4GBE+Xw7U+pHMYKuzjgCN3GwiaIR09UUeKfheyIry77QtrCBlC0KK0q5/TER/tYh3PQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "array-buffer-byte-length": "^1.0.1",
+        "call-bind": "^1.0.8",
+        "define-properties": "^1.2.1",
+        "es-abstract": "^1.23.5",
+        "es-errors": "^1.3.0",
+        "get-intrinsic": "^1.2.6",
+        "is-array-buffer": "^3.0.4"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/async": {
+      "version": "3.2.6",
+      "resolved": "https://registry.npmjs.org/async/-/async-3.2.6.tgz",
+      "integrity": "sha512-htCUDlxyyCLMgaM3xXg0C0LW2xqfuQ6p05pCEIsXuyQ+a1koYKTuBMzRNwmybfLgvJDMd0r1LTn4+E0Ti6C2AA==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/async-function": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/async-function/-/async-function-1.0.0.tgz",
+      "integrity": "sha512-hsU18Ae8CDTR6Kgu9DYf0EbCr/a5iGL0rytQDobUcdpYOKokk8LEjVphnXkDkgpi0wYVsqrXuP0bZxJaTqdgoA==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
+    "node_modules/at-least-node": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/at-least-node/-/at-least-node-1.0.0.tgz",
+      "integrity": "sha512-+q/t7Ekv1EDY2l6Gda6LLiX14rU9TV20Wa3ofeQmwPFZbOMo9DXrLbOjFaaclkXKWidIaopwAObQDqwWtGUjqg==",
+      "dev": true,
+      "license": "ISC",
+      "engines": {
+        "node": ">= 4.0.0"
+      }
+    },
+    "node_modules/available-typed-arrays": {
+      "version": "1.0.7",
+      "resolved": "https://registry.npmjs.org/available-typed-arrays/-/available-typed-arrays-1.0.7.tgz",
+      "integrity": "sha512-wvUjBtSGN7+7SjNpq/9M2Tg350UZD3q62IFZLbRAR1bSMlCo1ZaeW+BJ+D090e4hIIZLBcTDWe4Mh4jvUDajzQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "possible-typed-array-names": "^1.0.0"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/babel-plugin-polyfill-corejs2": {
+      "version": "0.4.17",
+      "resolved": "https://registry.npmjs.org/babel-plugin-polyfill-corejs2/-/babel-plugin-polyfill-corejs2-0.4.17.tgz",
+      "integrity": "sha512-aTyf30K/rqAsNwN76zYrdtx8obu0E4KoUME29B1xj+B3WxgvWkp943vYQ+z8Mv3lw9xHXMHpvSPOBxzAkIa94w==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@babel/compat-data": "^7.28.6",
+        "@babel/helper-define-polyfill-provider": "^0.6.8",
+        "semver": "^6.3.1"
+      },
+      "peerDependencies": {
+        "@babel/core": "^7.4.0 || ^8.0.0-0 <8.0.0"
+      }
+    },
+    "node_modules/babel-plugin-polyfill-corejs3": {
+      "version": "0.14.2",
+      "resolved": "https://registry.npmjs.org/babel-plugin-polyfill-corejs3/-/babel-plugin-polyfill-corejs3-0.14.2.tgz",
+      "integrity": "sha512-coWpDLJ410R781Npmn/SIBZEsAetR4xVi0SxLMXPaMO4lSf1MwnkGYMtkFxew0Dn8B3/CpbpYxN0JCgg8mn67g==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@babel/helper-define-polyfill-provider": "^0.6.8",
+        "core-js-compat": "^3.48.0"
+      },
+      "peerDependencies": {
+        "@babel/core": "^7.4.0 || ^8.0.0-0 <8.0.0"
+      }
+    },
+    "node_modules/babel-plugin-polyfill-regenerator": {
+      "version": "0.6.8",
+      "resolved": "https://registry.npmjs.org/babel-plugin-polyfill-regenerator/-/babel-plugin-polyfill-regenerator-0.6.8.tgz",
+      "integrity": "sha512-M762rNHfSF1EV3SLtnCJXFoQbbIIz0OyRwnCmV0KPC7qosSfCO0QLTSuJX3ayAebubhE6oYBAYPrBA5ljowaZg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@babel/helper-define-polyfill-provider": "^0.6.8"
+      },
+      "peerDependencies": {
+        "@babel/core": "^7.4.0 || ^8.0.0-0 <8.0.0"
+      }
+    },
+    "node_modules/balanced-match": {
+      "version": "4.0.4",
+      "resolved": "https://registry.npmjs.org/balanced-match/-/balanced-match-4.0.4.tgz",
+      "integrity": "sha512-BLrgEcRTwX2o6gGxGOCNyMvGSp35YofuYzw9h1IMTRmKqttAZZVU67bdb9Pr2vUHA8+j3i2tJfjO6C6+4myGTA==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": "18 || 20 || >=22"
+      }
+    },
+    "node_modules/baseline-browser-mapping": {
+      "version": "2.10.32",
+      "resolved": "https://registry.npmjs.org/baseline-browser-mapping/-/baseline-browser-mapping-2.10.32.tgz",
+      "integrity": "sha512-wbPvpyjJPC0zdfdKXxqEL3Ea+bOMD/87X4lftiJkkaBiuG6ALQy1SLmEd7BSmVCuwCQsBrCamgBoLyfFDD1EPg==",
+      "dev": true,
+      "license": "Apache-2.0",
+      "bin": {
+        "baseline-browser-mapping": "dist/cli.cjs"
+      },
+      "engines": {
+        "node": ">=6.0.0"
+      }
+    },
+    "node_modules/boolbase": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/boolbase/-/boolbase-1.0.0.tgz",
+      "integrity": "sha512-JZOSA7Mo9sNGB8+UjSgzdLtokWAky1zbztM3WRLCbZ70/3cTANmQmOdR7y2g+J0e2WXywy1yS468tY+IruqEww==",
+      "dev": true,
+      "license": "ISC"
+    },
+    "node_modules/bootstrap-icons": {
+      "version": "1.13.1",
+      "resolved": "https://registry.npmjs.org/bootstrap-icons/-/bootstrap-icons-1.13.1.tgz",
+      "integrity": "sha512-ijombt4v6bv5CLeXvRWKy7CuM3TRTuPEuGaGKvTV5cz65rQSY8RQ2JcHt6b90cBBAC7s8fsf2EkQDldzCoXUjw==",
+      "funding": [
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/twbs"
+        },
+        {
+          "type": "opencollective",
+          "url": "https://opencollective.com/bootstrap"
+        }
+      ],
+      "license": "MIT"
+    },
+    "node_modules/brace-expansion": {
+      "version": "5.0.6",
+      "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-5.0.6.tgz",
+      "integrity": "sha512-kLpxurY4Z4r9sgMsyG0Z9uzsBlgiU/EFKhj/h91/8yHu0edo7XuixOIH3VcJ8kkxs6/jPzoI6U9Vj3WqbMQ94g==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "balanced-match": "^4.0.2"
+      },
+      "engines": {
+        "node": "18 || 20 || >=22"
+      }
+    },
+    "node_modules/browserslist": {
+      "version": "4.28.2",
+      "resolved": "https://registry.npmjs.org/browserslist/-/browserslist-4.28.2.tgz",
+      "integrity": "sha512-48xSriZYYg+8qXna9kwqjIVzuQxi+KYWp2+5nCYnYKPTr0LvD89Jqk2Or5ogxz0NUMfIjhh2lIUX/LyX9B4oIg==",
+      "dev": true,
+      "funding": [
+        {
+          "type": "opencollective",
+          "url": "https://opencollective.com/browserslist"
+        },
+        {
+          "type": "tidelift",
+          "url": "https://tidelift.com/funding/github/npm/browserslist"
+        },
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/ai"
+        }
+      ],
+      "license": "MIT",
+      "dependencies": {
+        "baseline-browser-mapping": "^2.10.12",
+        "caniuse-lite": "^1.0.30001782",
+        "electron-to-chromium": "^1.5.328",
+        "node-releases": "^2.0.36",
+        "update-browserslist-db": "^1.2.3"
+      },
+      "bin": {
+        "browserslist": "cli.js"
+      },
+      "engines": {
+        "node": "^6 || ^7 || ^8 || ^9 || ^10 || ^11 || ^12 || >=13.7"
+      }
+    },
+    "node_modules/buffer-from": {
+      "version": "1.1.2",
+      "resolved": "https://registry.npmjs.org/buffer-from/-/buffer-from-1.1.2.tgz",
+      "integrity": "sha512-E+XQCRwSbaaiChtv6k6Dwgc+bx+Bs6vuKJHHl5kox/BaKbhiXzqQOwK4cO22yElGp2OCmjwVhT3HmxgyPGnJfQ==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/call-bind": {
+      "version": "1.0.9",
+      "resolved": "https://registry.npmjs.org/call-bind/-/call-bind-1.0.9.tgz",
+      "integrity": "sha512-a/hy+pNsFUTR+Iz8TCJvXudKVLAnz/DyeSUo10I5yvFDQJBFU2s9uqQpoSrJlroHUKoKqzg+epxyP9lqFdzfBQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "call-bind-apply-helpers": "^1.0.2",
+        "es-define-property": "^1.0.1",
+        "get-intrinsic": "^1.3.0",
+        "set-function-length": "^1.2.2"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/call-bind-apply-helpers": {
+      "version": "1.0.2",
+      "resolved": "https://registry.npmjs.org/call-bind-apply-helpers/-/call-bind-apply-helpers-1.0.2.tgz",
+      "integrity": "sha512-Sp1ablJ0ivDkSzjcaJdxEunN5/XvksFJ2sMBFfq6x0ryhQV/2b/KwFe21cMpmHtPOSij8K99/wSfoEuTObmuMQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "es-errors": "^1.3.0",
+        "function-bind": "^1.1.2"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
+    "node_modules/call-bound": {
+      "version": "1.0.4",
+      "resolved": "https://registry.npmjs.org/call-bound/-/call-bound-1.0.4.tgz",
+      "integrity": "sha512-+ys997U96po4Kx/ABpBCqhA9EuxJaQWDQg7295H4hBphv3IZg0boBKuwYpt4YXp6MZ5AmZQnU/tyMTlRpaSejg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "call-bind-apply-helpers": "^1.0.2",
+        "get-intrinsic": "^1.3.0"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/caniuse-lite": {
+      "version": "1.0.30001793",
+      "resolved": "https://registry.npmjs.org/caniuse-lite/-/caniuse-lite-1.0.30001793.tgz",
+      "integrity": "sha512-iwSsYWaCOoh26cV8NwNRViHlrfUvYsHDfRVcbtmw0Kg6PJIZZXwMkj1442FYLBGkeUf1juAsU3DTfxW579mrPA==",
+      "dev": true,
+      "funding": [
+        {
+          "type": "opencollective",
+          "url": "https://opencollective.com/browserslist"
+        },
+        {
+          "type": "tidelift",
+          "url": "https://tidelift.com/funding/github/npm/caniuse-lite"
+        },
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/ai"
+        }
+      ],
+      "license": "CC-BY-4.0"
+    },
+    "node_modules/chart.js": {
+      "version": "4.5.1",
+      "resolved": "https://registry.npmjs.org/chart.js/-/chart.js-4.5.1.tgz",
+      "integrity": "sha512-GIjfiT9dbmHRiYi6Nl2yFCq7kkwdkp1W/lp2J99rX0yo9tgJGn3lKQATztIjb5tVtevcBtIdICNWqlq5+E8/Pw==",
+      "license": "MIT",
+      "dependencies": {
+        "@kurkle/color": "^0.3.0"
+      },
+      "engines": {
+        "pnpm": ">=8"
+      }
+    },
+    "node_modules/commander": {
+      "version": "2.20.3",
+      "resolved": "https://registry.npmjs.org/commander/-/commander-2.20.3.tgz",
+      "integrity": "sha512-GpVkmM8vF2vQUkj2LvZmD35JxeJOLCwJ9cUkugyk2nuhbv3+mJvpLYYt+0+USMxE+oj+ey/lJEnhZw75x/OMcQ==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/common-tags": {
+      "version": "1.8.2",
+      "resolved": "https://registry.npmjs.org/common-tags/-/common-tags-1.8.2.tgz",
+      "integrity": "sha512-gk/Z852D2Wtb//0I+kRFNKKE9dIIVirjoqPoA1wJU+XePVXZfGeBpk45+A1rKO4Q43prqWBNY/MiIeRLbPWUaA==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=4.0.0"
+      }
+    },
+    "node_modules/convert-source-map": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/convert-source-map/-/convert-source-map-2.0.0.tgz",
+      "integrity": "sha512-Kvp459HrV2FEJ1CAsi1Ku+MY3kasH19TFykTz2xWmMeq6bk2NU3XXvfJ+Q61m0xktWwt+1HSYf3JZsTms3aRJg==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/core-js-compat": {
+      "version": "3.49.0",
+      "resolved": "https://registry.npmjs.org/core-js-compat/-/core-js-compat-3.49.0.tgz",
+      "integrity": "sha512-VQXt1jr9cBz03b331DFDCCP90b3fanciLkgiOoy8SBHy06gNf+vQ1A3WFLqG7I8TipYIKeYK9wxd0tUrvHcOZA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "browserslist": "^4.28.1"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/core-js"
+      }
+    },
+    "node_modules/cross-spawn": {
+      "version": "7.0.6",
+      "resolved": "https://registry.npmjs.org/cross-spawn/-/cross-spawn-7.0.6.tgz",
+      "integrity": "sha512-uV2QOWP2nWzsy2aMp8aRibhi9dlzF5Hgh5SHaB9OiTGEyDTiJJyx0uy51QXdyWbtAHNua4XJzUKca3OzKUd3vA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "path-key": "^3.1.0",
+        "shebang-command": "^2.0.0",
+        "which": "^2.0.1"
+      },
+      "engines": {
+        "node": ">= 8"
+      }
+    },
+    "node_modules/crypto-random-string": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/crypto-random-string/-/crypto-random-string-2.0.0.tgz",
+      "integrity": "sha512-v1plID3y9r/lPhviJ1wrXpLeyUIGAZ2SHNYTEapm7/8A9nLPoyvVp3RK/EPFqn5kEznyWgYZNsRtYYIWbuG8KA==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/cssesc": {
+      "version": "3.0.0",
+      "resolved": "https://registry.npmjs.org/cssesc/-/cssesc-3.0.0.tgz",
+      "integrity": "sha512-/Tb/JcjK111nNScGob5MNtsntNM1aCNUDipB/TkwZFhyDrrE47SOx/18wF2bbjgc3ZzCSKW1T5nt5EbFoAz/Vg==",
+      "dev": true,
+      "license": "MIT",
+      "bin": {
+        "cssesc": "bin/cssesc"
+      },
+      "engines": {
+        "node": ">=4"
+      }
+    },
+    "node_modules/csstype": {
+      "version": "3.2.3",
+      "resolved": "https://registry.npmjs.org/csstype/-/csstype-3.2.3.tgz",
+      "integrity": "sha512-z1HGKcYy2xA8AGQfwrn0PAy+PB7X/GSj3UVJW9qKyn43xWa+gl5nXmU4qqLMRzWVLFC8KusUX8T/0kCiOYpAIQ==",
+      "license": "MIT"
+    },
+    "node_modules/data-view-buffer": {
+      "version": "1.0.2",
+      "resolved": "https://registry.npmjs.org/data-view-buffer/-/data-view-buffer-1.0.2.tgz",
+      "integrity": "sha512-EmKO5V3OLXh1rtK2wgXRansaK1/mtVdTUEiEI0W8RkvgT05kfxaH29PliLnpLP73yYO6142Q72QNa8Wx/A5CqQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "call-bound": "^1.0.3",
+        "es-errors": "^1.3.0",
+        "is-data-view": "^1.0.2"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/data-view-byte-length": {
+      "version": "1.0.2",
+      "resolved": "https://registry.npmjs.org/data-view-byte-length/-/data-view-byte-length-1.0.2.tgz",
+      "integrity": "sha512-tuhGbE6CfTM9+5ANGf+oQb72Ky/0+s3xKUpHvShfiz2RxMFgFPjsXuRLBVMtvMs15awe45SRb83D6wH4ew6wlQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "call-bound": "^1.0.3",
+        "es-errors": "^1.3.0",
+        "is-data-view": "^1.0.2"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/inspect-js"
+      }
+    },
+    "node_modules/data-view-byte-offset": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/data-view-byte-offset/-/data-view-byte-offset-1.0.1.tgz",
+      "integrity": "sha512-BS8PfmtDGnrgYdOonGZQdLZslWIeCGFP9tpan0hi1Co2Zr2NKADsvGYA8XxuG/4UWgJ6Cjtv+YJnB6MM69QGlQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "call-bound": "^1.0.2",
+        "es-errors": "^1.3.0",
+        "is-data-view": "^1.0.1"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/debug": {
+      "version": "4.4.3",
+      "resolved": "https://registry.npmjs.org/debug/-/debug-4.4.3.tgz",
+      "integrity": "sha512-RGwwWnwQvkVfavKVt22FGLw+xYSdzARwm0ru6DhTVA3umU5hZc28V3kO4stgYryrTlLpuvgI9GiijltAjNbcqA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "ms": "^2.1.3"
+      },
+      "engines": {
+        "node": ">=6.0"
+      },
+      "peerDependenciesMeta": {
+        "supports-color": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/deep-is": {
+      "version": "0.1.4",
+      "resolved": "https://registry.npmjs.org/deep-is/-/deep-is-0.1.4.tgz",
+      "integrity": "sha512-oIPzksmTg4/MriiaYGO+okXDT7ztn/w3Eptv/+gSIdMdKsJo0u4CfYNFJPy+4SKMuCqGw2wxnA+URMg3t8a/bQ==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/deepmerge": {
+      "version": "4.3.1",
+      "resolved": "https://registry.npmjs.org/deepmerge/-/deepmerge-4.3.1.tgz",
+      "integrity": "sha512-3sUqbMEc77XqpdNO7FRyRog+eW3ph+GYCbj+rK+uYyRMuwsVy0rMiVtPn+QJlKFvWP/1PYpapqYn0Me2knFn+A==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
+    "node_modules/define-data-property": {
+      "version": "1.1.4",
+      "resolved": "https://registry.npmjs.org/define-data-property/-/define-data-property-1.1.4.tgz",
+      "integrity": "sha512-rBMvIzlpA8v6E+SJZoo++HAYqsLrkg7MSfIinMPFhmkorw7X+dOXVJQs+QT69zGkzMyfDnIMN2Wid1+NbL3T+A==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "es-define-property": "^1.0.0",
+        "es-errors": "^1.3.0",
+        "gopd": "^1.0.1"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/define-properties": {
+      "version": "1.2.1",
+      "resolved": "https://registry.npmjs.org/define-properties/-/define-properties-1.2.1.tgz",
+      "integrity": "sha512-8QmQKqEASLd5nx0U1B1okLElbUuuttJ/AnYmRXbbbGDWh6uS208EjD4Xqq/I9wK7u0v6O08XhTWnt5XtEbR6Dg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "define-data-property": "^1.0.1",
+        "has-property-descriptors": "^1.0.0",
+        "object-keys": "^1.1.1"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/dompurify": {
+      "version": "3.4.7",
+      "resolved": "https://registry.npmjs.org/dompurify/-/dompurify-3.4.7.tgz",
+      "integrity": "sha512-2jBxDJY4RR06tQNy4w5FlFH7kfxsQZlufd0sbv+chfHCxeJwrFw2baUDsSwvBISD4K4RDbd0PTfy3uNXsR6siA==",
+      "license": "(MPL-2.0 OR Apache-2.0)",
+      "optionalDependencies": {
+        "@types/trusted-types": "^2.0.7"
+      }
+    },
+    "node_modules/dunder-proto": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/dunder-proto/-/dunder-proto-1.0.1.tgz",
+      "integrity": "sha512-KIN/nDJBQRcXw0MLVhZE9iQHmG68qAVIBg9CqmUYjmQIhgij9U5MFvrqkUL5FbtyyzZuOeOt0zdeRe4UY7ct+A==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "call-bind-apply-helpers": "^1.0.1",
+        "es-errors": "^1.3.0",
+        "gopd": "^1.2.0"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
+    "node_modules/ejs": {
+      "version": "3.1.10",
+      "resolved": "https://registry.npmjs.org/ejs/-/ejs-3.1.10.tgz",
+      "integrity": "sha512-UeJmFfOrAQS8OJWPZ4qtgHyWExa088/MtK5UEyoJGFH67cDEXkZSviOiKRCZ4Xij0zxI3JECgYs3oKx+AizQBA==",
+      "dev": true,
+      "license": "Apache-2.0",
+      "dependencies": {
+        "jake": "^10.8.5"
+      },
+      "bin": {
+        "ejs": "bin/cli.js"
+      },
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
+    "node_modules/electron-to-chromium": {
+      "version": "1.5.361",
+      "resolved": "https://registry.npmjs.org/electron-to-chromium/-/electron-to-chromium-1.5.361.tgz",
+      "integrity": "sha512-Q6Hts7N9FnJc5LeGRINFvLhCI9xZmNtTDe5ZbcVezQz7cU4a8Aua3GH1b8J2XY8Al9PF+OCwYqhgsOOheMdvkA==",
+      "dev": true,
+      "license": "ISC"
+    },
+    "node_modules/entities": {
+      "version": "7.0.1",
+      "resolved": "https://registry.npmjs.org/entities/-/entities-7.0.1.tgz",
+      "integrity": "sha512-TWrgLOFUQTH994YUyl1yT4uyavY5nNB5muff+RtWaqNVCAK408b5ZnnbNAUEWLTCpum9w6arT70i1XdQ4UeOPA==",
+      "license": "BSD-2-Clause",
+      "engines": {
+        "node": ">=0.12"
+      },
+      "funding": {
+        "url": "https://github.com/fb55/entities?sponsor=1"
+      }
+    },
+    "node_modules/es-abstract": {
+      "version": "1.24.2",
+      "resolved": "https://registry.npmjs.org/es-abstract/-/es-abstract-1.24.2.tgz",
+      "integrity": "sha512-2FpH9Q5i2RRwyEP1AylXe6nYLR5OhaJTZwmlcP0dL/+JCbgg7yyEo/sEK6HeGZRf3dFpWwThaRHVApXSkW3xeg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "array-buffer-byte-length": "^1.0.2",
+        "arraybuffer.prototype.slice": "^1.0.4",
+        "available-typed-arrays": "^1.0.7",
+        "call-bind": "^1.0.8",
+        "call-bound": "^1.0.4",
+        "data-view-buffer": "^1.0.2",
+        "data-view-byte-length": "^1.0.2",
+        "data-view-byte-offset": "^1.0.1",
+        "es-define-property": "^1.0.1",
+        "es-errors": "^1.3.0",
+        "es-object-atoms": "^1.1.1",
+        "es-set-tostringtag": "^2.1.0",
+        "es-to-primitive": "^1.3.0",
+        "function.prototype.name": "^1.1.8",
+        "get-intrinsic": "^1.3.0",
+        "get-proto": "^1.0.1",
+        "get-symbol-description": "^1.1.0",
+        "globalthis": "^1.0.4",
+        "gopd": "^1.2.0",
+        "has-property-descriptors": "^1.0.2",
+        "has-proto": "^1.2.0",
+        "has-symbols": "^1.1.0",
+        "hasown": "^2.0.2",
+        "internal-slot": "^1.1.0",
+        "is-array-buffer": "^3.0.5",
+        "is-callable": "^1.2.7",
+        "is-data-view": "^1.0.2",
+        "is-negative-zero": "^2.0.3",
+        "is-regex": "^1.2.1",
+        "is-set": "^2.0.3",
+        "is-shared-array-buffer": "^1.0.4",
+        "is-string": "^1.1.1",
+        "is-typed-array": "^1.1.15",
+        "is-weakref": "^1.1.1",
+        "math-intrinsics": "^1.1.0",
+        "object-inspect": "^1.13.4",
+        "object-keys": "^1.1.1",
+        "object.assign": "^4.1.7",
+        "own-keys": "^1.0.1",
+        "regexp.prototype.flags": "^1.5.4",
+        "safe-array-concat": "^1.1.3",
+        "safe-push-apply": "^1.0.0",
+        "safe-regex-test": "^1.1.0",
+        "set-proto": "^1.0.0",
+        "stop-iteration-iterator": "^1.1.0",
+        "string.prototype.trim": "^1.2.10",
+        "string.prototype.trimend": "^1.0.9",
+        "string.prototype.trimstart": "^1.0.8",
+        "typed-array-buffer": "^1.0.3",
+        "typed-array-byte-length": "^1.0.3",
+        "typed-array-byte-offset": "^1.0.4",
+        "typed-array-length": "^1.0.7",
+        "unbox-primitive": "^1.1.0",
+        "which-typed-array": "^1.1.19"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/es-define-property": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/es-define-property/-/es-define-property-1.0.1.tgz",
+      "integrity": "sha512-e3nRfgfUZ4rNGL232gUgX06QNyyez04KdjFrF+LTRoOXmrOgFKDg4BCdsjW8EnT69eqdYGmRpJwiPVYNrCaW3g==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
+    "node_modules/es-errors": {
+      "version": "1.3.0",
+      "resolved": "https://registry.npmjs.org/es-errors/-/es-errors-1.3.0.tgz",
+      "integrity": "sha512-Zf5H2Kxt2xjTvbJvP2ZWLEICxA6j+hAmMzIlypy4xcBg1vKVnx89Wy0GbS+kf5cwCVFFzdCFh2XSCFNULS6csw==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
+    "node_modules/es-object-atoms": {
+      "version": "1.1.2",
+      "resolved": "https://registry.npmjs.org/es-object-atoms/-/es-object-atoms-1.1.2.tgz",
+      "integrity": "sha512-HWcBoN6NileqtSydK2FqHbS/LoDd2pqrnQHLyJzBj4kOp/ky2MWMN694xOfkK8/SnUsW2DH7EfyVlydKCsm1Zw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "es-errors": "^1.3.0"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
+    "node_modules/es-set-tostringtag": {
+      "version": "2.1.0",
+      "resolved": "https://registry.npmjs.org/es-set-tostringtag/-/es-set-tostringtag-2.1.0.tgz",
+      "integrity": "sha512-j6vWzfrGVfyXxge+O0x5sh6cvxAog0a/4Rdd2K36zCMV5eJ+/+tOAngRO8cODMNWbVRdVlmGZQL2YS3yR8bIUA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "es-errors": "^1.3.0",
+        "get-intrinsic": "^1.2.6",
+        "has-tostringtag": "^1.0.2",
+        "hasown": "^2.0.2"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
+    "node_modules/es-to-primitive": {
+      "version": "1.3.0",
+      "resolved": "https://registry.npmjs.org/es-to-primitive/-/es-to-primitive-1.3.0.tgz",
+      "integrity": "sha512-w+5mJ3GuFL+NjVtJlvydShqE1eN3h3PbI7/5LAsYJP/2qtuMXjfL2LpHSRqo4b4eSF5K/DH1JXKUAHSB2UW50g==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "is-callable": "^1.2.7",
+        "is-date-object": "^1.0.5",
+        "is-symbol": "^1.0.4"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/esbuild": {
+      "version": "0.27.3",
+      "resolved": "https://registry.npmjs.org/esbuild/-/esbuild-0.27.3.tgz",
+      "integrity": "sha512-8VwMnyGCONIs6cWue2IdpHxHnAjzxnw2Zr7MkVxB2vjmQ2ivqGFb4LEG3SMnv0Gb2F/G/2yA8zUaiL1gywDCCg==",
+      "dev": true,
+      "hasInstallScript": true,
+      "license": "MIT",
+      "bin": {
+        "esbuild": "bin/esbuild"
+      },
+      "engines": {
+        "node": ">=18"
+      },
+      "optionalDependencies": {
+        "@esbuild/aix-ppc64": "0.27.3",
+        "@esbuild/android-arm": "0.27.3",
+        "@esbuild/android-arm64": "0.27.3",
+        "@esbuild/android-x64": "0.27.3",
+        "@esbuild/darwin-arm64": "0.27.3",
+        "@esbuild/darwin-x64": "0.27.3",
+        "@esbuild/freebsd-arm64": "0.27.3",
+        "@esbuild/freebsd-x64": "0.27.3",
+        "@esbuild/linux-arm": "0.27.3",
+        "@esbuild/linux-arm64": "0.27.3",
+        "@esbuild/linux-ia32": "0.27.3",
+        "@esbuild/linux-loong64": "0.27.3",
+        "@esbuild/linux-mips64el": "0.27.3",
+        "@esbuild/linux-ppc64": "0.27.3",
+        "@esbuild/linux-riscv64": "0.27.3",
+        "@esbuild/linux-s390x": "0.27.3",
+        "@esbuild/linux-x64": "0.27.3",
+        "@esbuild/netbsd-arm64": "0.27.3",
+        "@esbuild/netbsd-x64": "0.27.3",
+        "@esbuild/openbsd-arm64": "0.27.3",
+        "@esbuild/openbsd-x64": "0.27.3",
+        "@esbuild/openharmony-arm64": "0.27.3",
+        "@esbuild/sunos-x64": "0.27.3",
+        "@esbuild/win32-arm64": "0.27.3",
+        "@esbuild/win32-ia32": "0.27.3",
+        "@esbuild/win32-x64": "0.27.3"
+      }
+    },
+    "node_modules/escalade": {
+      "version": "3.2.0",
+      "resolved": "https://registry.npmjs.org/escalade/-/escalade-3.2.0.tgz",
+      "integrity": "sha512-WUj2qlxaQtO4g6Pq5c29GTcWGDyd8itL8zTlipgECz3JesAiiOKotd8JU6otB3PACgG6xkJUyVhboMS+bje/jA==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=6"
+      }
+    },
+    "node_modules/escape-string-regexp": {
+      "version": "4.0.0",
+      "resolved": "https://registry.npmjs.org/escape-string-regexp/-/escape-string-regexp-4.0.0.tgz",
+      "integrity": "sha512-TtpcNJ3XAzx3Gq8sWRzJaVajRs0uVxA2YAkdb1jm2YkPz4G6egUFAyA3n5vtEIZefPk5Wa4UXbKuS5fKkJWdgA==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=10"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/eslint": {
+      "version": "10.5.0",
+      "resolved": "https://registry.npmjs.org/eslint/-/eslint-10.5.0.tgz",
+      "integrity": "sha512-1y+7C+vi12bUK1IpZeaV3gsH9fHLBmPvYmPx42pvT/E9yG0IC8g3PUZZgp0+JLJl7ZDK0flc2gc+Aw9dpCvIsQ==",
+      "dev": true,
+      "license": "MIT",
+      "workspaces": [
+        "packages/*"
+      ],
+      "dependencies": {
+        "@eslint-community/eslint-utils": "^4.8.0",
+        "@eslint-community/regexpp": "^4.12.2",
+        "@eslint/config-array": "^0.23.5",
+        "@eslint/config-helpers": "^0.6.0",
+        "@eslint/core": "^1.2.1",
+        "@eslint/plugin-kit": "^0.7.2",
+        "@humanfs/node": "^0.16.6",
+        "@humanwhocodes/module-importer": "^1.0.1",
+        "@humanwhocodes/retry": "^0.4.2",
+        "@types/estree": "^1.0.6",
+        "ajv": "^6.14.0",
+        "cross-spawn": "^7.0.6",
+        "debug": "^4.3.2",
+        "escape-string-regexp": "^4.0.0",
+        "eslint-scope": "^9.1.2",
+        "eslint-visitor-keys": "^5.0.1",
+        "espree": "^11.2.0",
+        "esquery": "^1.7.0",
+        "esutils": "^2.0.2",
+        "fast-deep-equal": "^3.1.3",
+        "file-entry-cache": "^8.0.0",
+        "find-up": "^5.0.0",
+        "glob-parent": "^6.0.2",
+        "ignore": "^5.2.0",
+        "imurmurhash": "^0.1.4",
+        "is-glob": "^4.0.0",
+        "json-stable-stringify-without-jsonify": "^1.0.1",
+        "minimatch": "^10.2.4",
+        "natural-compare": "^1.4.0",
+        "optionator": "^0.9.3"
+      },
+      "bin": {
+        "eslint": "bin/eslint.js"
+      },
+      "engines": {
+        "node": "^20.19.0 || ^22.13.0 || >=24"
+      },
+      "funding": {
+        "url": "https://eslint.org/donate"
+      },
+      "peerDependencies": {
+        "jiti": "*"
+      },
+      "peerDependenciesMeta": {
+        "jiti": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/eslint-config-prettier": {
+      "version": "10.1.8",
+      "resolved": "https://registry.npmjs.org/eslint-config-prettier/-/eslint-config-prettier-10.1.8.tgz",
+      "integrity": "sha512-82GZUjRS0p/jganf6q1rEO25VSoHH0hKPCTrgillPjdI/3bgBhAE1QzHrHTizjpRvy6pGAvKjDJtk2pF9NDq8w==",
+      "dev": true,
+      "license": "MIT",
+      "bin": {
+        "eslint-config-prettier": "bin/cli.js"
+      },
+      "funding": {
+        "url": "https://opencollective.com/eslint-config-prettier"
+      },
+      "peerDependencies": {
+        "eslint": ">=7.0.0"
+      }
+    },
+    "node_modules/eslint-plugin-vue": {
+      "version": "10.9.2",
+      "resolved": "https://registry.npmjs.org/eslint-plugin-vue/-/eslint-plugin-vue-10.9.2.tgz",
+      "integrity": "sha512-4g7ZP3pYcuqd7Zp0pzUKcos0W+RkjBz4EGdhJ92FcYk6v03Ti/GK5NwjgsjxHK+98eXDbHeK7VtX1az7/8doZA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@eslint-community/eslint-utils": "^4.4.0",
+        "natural-compare": "^1.4.0",
+        "nth-check": "^2.1.1",
+        "postcss-selector-parser": "^7.1.0",
+        "semver": "^7.6.3",
+        "xml-name-validator": "^4.0.0"
+      },
+      "engines": {
+        "node": "^18.18.0 || ^20.9.0 || >=21.1.0"
+      },
+      "peerDependencies": {
+        "@stylistic/eslint-plugin": "^2.0.0 || ^3.0.0 || ^4.0.0 || ^5.0.0",
+        "@typescript-eslint/parser": "^7.0.0 || ^8.0.0",
+        "eslint": "^8.57.0 || ^9.0.0 || ^10.0.0",
+        "vue-eslint-parser": "^10.3.0"
+      },
+      "peerDependenciesMeta": {
+        "@stylistic/eslint-plugin": {
+          "optional": true
+        },
+        "@typescript-eslint/parser": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/eslint-plugin-vue/node_modules/semver": {
+      "version": "7.8.4",
+      "resolved": "https://registry.npmjs.org/semver/-/semver-7.8.4.tgz",
+      "integrity": "sha512-rUCObTnP32Q08R2uuIrt7r9PlEonuTmtuXYcW6s5kjdlj3xbnwe+21yXptAUYcMAABLkYYTtnmzb3w3EDZfueA==",
+      "dev": true,
+      "license": "ISC",
+      "bin": {
+        "semver": "bin/semver.js"
+      },
+      "engines": {
+        "node": ">=10"
+      }
+    },
+    "node_modules/eslint-scope": {
+      "version": "9.1.2",
+      "resolved": "https://registry.npmjs.org/eslint-scope/-/eslint-scope-9.1.2.tgz",
+      "integrity": "sha512-xS90H51cKw0jltxmvmHy2Iai1LIqrfbw57b79w/J7MfvDfkIkFZ+kj6zC3BjtUwh150HsSSdxXZcsuv72miDFQ==",
+      "dev": true,
+      "license": "BSD-2-Clause",
+      "dependencies": {
+        "@types/esrecurse": "^4.3.1",
+        "@types/estree": "^1.0.8",
+        "esrecurse": "^4.3.0",
+        "estraverse": "^5.2.0"
+      },
+      "engines": {
+        "node": "^20.19.0 || ^22.13.0 || >=24"
+      },
+      "funding": {
+        "url": "https://opencollective.com/eslint"
+      }
+    },
+    "node_modules/eslint-visitor-keys": {
+      "version": "5.0.1",
+      "resolved": "https://registry.npmjs.org/eslint-visitor-keys/-/eslint-visitor-keys-5.0.1.tgz",
+      "integrity": "sha512-tD40eHxA35h0PEIZNeIjkHoDR4YjjJp34biM0mDvplBe//mB+IHCqHDGV7pxF+7MklTvighcCPPZC7ynWyjdTA==",
+      "dev": true,
+      "license": "Apache-2.0",
+      "engines": {
+        "node": "^20.19.0 || ^22.13.0 || >=24"
+      },
+      "funding": {
+        "url": "https://opencollective.com/eslint"
+      }
+    },
+    "node_modules/eslint/node_modules/ajv": {
+      "version": "6.15.0",
+      "resolved": "https://registry.npmjs.org/ajv/-/ajv-6.15.0.tgz",
+      "integrity": "sha512-fgFx7Hfoq60ytK2c7DhnF8jIvzYgOMxfugjLOSMHjLIPgenqa7S7oaagATUq99mV6IYvN2tRmC0wnTYX6iPbMw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "fast-deep-equal": "^3.1.1",
+        "fast-json-stable-stringify": "^2.0.0",
+        "json-schema-traverse": "^0.4.1",
+        "uri-js": "^4.2.2"
+      },
+      "funding": {
+        "type": "github",
+        "url": "https://github.com/sponsors/epoberezkin"
+      }
+    },
+    "node_modules/eslint/node_modules/json-schema-traverse": {
+      "version": "0.4.1",
+      "resolved": "https://registry.npmjs.org/json-schema-traverse/-/json-schema-traverse-0.4.1.tgz",
+      "integrity": "sha512-xbbCH5dCYU5T8LcEhhuh7HJ88HXuW3qsI3Y0zOZFKfZEHcpWiHU/Jxzk629Brsab/mMiHQti9wMP+845RPe3Vg==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/espree": {
+      "version": "11.2.0",
+      "resolved": "https://registry.npmjs.org/espree/-/espree-11.2.0.tgz",
+      "integrity": "sha512-7p3DrVEIopW1B1avAGLuCSh1jubc01H2JHc8B4qqGblmg5gI9yumBgACjWo4JlIc04ufug4xJ3SQI8HkS/Rgzw==",
+      "dev": true,
+      "license": "BSD-2-Clause",
+      "dependencies": {
+        "acorn": "^8.16.0",
+        "acorn-jsx": "^5.3.2",
+        "eslint-visitor-keys": "^5.0.1"
+      },
+      "engines": {
+        "node": "^20.19.0 || ^22.13.0 || >=24"
+      },
+      "funding": {
+        "url": "https://opencollective.com/eslint"
+      }
+    },
+    "node_modules/esquery": {
+      "version": "1.7.0",
+      "resolved": "https://registry.npmjs.org/esquery/-/esquery-1.7.0.tgz",
+      "integrity": "sha512-Ap6G0WQwcU/LHsvLwON1fAQX9Zp0A2Y6Y/cJBl9r/JbW90Zyg4/zbG6zzKa2OTALELarYHmKu0GhpM5EO+7T0g==",
+      "dev": true,
+      "license": "BSD-3-Clause",
+      "dependencies": {
+        "estraverse": "^5.1.0"
+      },
+      "engines": {
+        "node": ">=0.10"
+      }
+    },
+    "node_modules/esrecurse": {
+      "version": "4.3.0",
+      "resolved": "https://registry.npmjs.org/esrecurse/-/esrecurse-4.3.0.tgz",
+      "integrity": "sha512-KmfKL3b6G+RXvP8N1vr3Tq1kL/oCFgn2NYXEtqP8/L3pKapUA4G8cFVaoF3SU323CD4XypR/ffioHmkti6/Tag==",
+      "dev": true,
+      "license": "BSD-2-Clause",
+      "dependencies": {
+        "estraverse": "^5.2.0"
+      },
+      "engines": {
+        "node": ">=4.0"
+      }
+    },
+    "node_modules/estraverse": {
+      "version": "5.3.0",
+      "resolved": "https://registry.npmjs.org/estraverse/-/estraverse-5.3.0.tgz",
+      "integrity": "sha512-MMdARuVEQziNTeJD8DgMqmhwR11BRQ/cBP+pLtYdSTnf3MIO8fFeiINEbX36ZdNlfU/7A9f3gUw49B3oQsvwBA==",
+      "dev": true,
+      "license": "BSD-2-Clause",
+      "engines": {
+        "node": ">=4.0"
+      }
+    },
+    "node_modules/estree-walker": {
+      "version": "2.0.2",
+      "resolved": "https://registry.npmjs.org/estree-walker/-/estree-walker-2.0.2.tgz",
+      "integrity": "sha512-Rfkk/Mp/DL7JVje3u18FxFujQlTNR2q6QfMSMB7AvCBx91NGj/ba3kCfza0f6dVDbw7YlRf/nDrn7pQrCCyQ/w==",
+      "license": "MIT"
+    },
+    "node_modules/esutils": {
+      "version": "2.0.3",
+      "resolved": "https://registry.npmjs.org/esutils/-/esutils-2.0.3.tgz",
+      "integrity": "sha512-kVscqXk4OCp68SZ0dkgEKVi6/8ij300KBWTJq32P/dYeWTSwK41WyTxalN1eRmA5Z9UU/LX9D7FWSmV9SAYx6g==",
+      "dev": true,
+      "license": "BSD-2-Clause",
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
+    "node_modules/eta": {
+      "version": "4.6.0",
+      "resolved": "https://registry.npmjs.org/eta/-/eta-4.6.0.tgz",
+      "integrity": "sha512-lW6is4T1NFOYnmqGZIfvixqj7A7sSvScF+DN8EK6K58xI5MZ5UvYe0GjopxOXQtZvUn4eDdVuZ8XSoYWTMEKwA==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=20"
+      },
+      "funding": {
+        "url": "https://github.com/bgub/eta?sponsor=1"
+      }
+    },
+    "node_modules/fast-deep-equal": {
+      "version": "3.1.3",
+      "resolved": "https://registry.npmjs.org/fast-deep-equal/-/fast-deep-equal-3.1.3.tgz",
+      "integrity": "sha512-f3qQ9oQy9j2AhBe/H9VC91wLmKBCCU/gDOnKNAYG5hswO7BLKj09Hc5HYNz9cGI++xlpDCIgDaitVs03ATR84Q==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/fast-json-stable-stringify": {
+      "version": "2.1.0",
+      "resolved": "https://registry.npmjs.org/fast-json-stable-stringify/-/fast-json-stable-stringify-2.1.0.tgz",
+      "integrity": "sha512-lhd/wF+Lk98HZoTCtlVraHtfh5XYijIjalXck7saUtuanSDyLMxnHhSXEDJqHxD7msR8D0uCmqlkwjCV8xvwHw==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/fast-levenshtein": {
+      "version": "2.0.6",
+      "resolved": "https://registry.npmjs.org/fast-levenshtein/-/fast-levenshtein-2.0.6.tgz",
+      "integrity": "sha512-DCXu6Ifhqcks7TZKY3Hxp3y6qphY5SJZmrWMDrKcERSOXWQdMhU9Ig/PYrzyw/ul9jOIyh0N4M0tbC5hodg8dw==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/fast-uri": {
+      "version": "3.1.2",
+      "resolved": "https://registry.npmjs.org/fast-uri/-/fast-uri-3.1.2.tgz",
+      "integrity": "sha512-rVjf7ArG3LTk+FS6Yw81V1DLuZl1bRbNrev6Tmd/9RaroeeRRJhAt7jg/6YFxbvAQXUCavSoZhPPj6oOx+5KjQ==",
+      "dev": true,
+      "funding": [
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/fastify"
+        },
+        {
+          "type": "opencollective",
+          "url": "https://opencollective.com/fastify"
+        }
+      ],
+      "license": "BSD-3-Clause"
+    },
+    "node_modules/fdir": {
+      "version": "6.5.0",
+      "resolved": "https://registry.npmjs.org/fdir/-/fdir-6.5.0.tgz",
+      "integrity": "sha512-tIbYtZbucOs0BRGqPJkshJUYdL+SDH7dVM8gjy+ERp3WAUjLEFJE+02kanyHtwjWOnwrKYBiwAmM0p4kLJAnXg==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=12.0.0"
+      },
+      "peerDependencies": {
+        "picomatch": "^3 || ^4"
+      },
+      "peerDependenciesMeta": {
+        "picomatch": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/file-entry-cache": {
+      "version": "8.0.0",
+      "resolved": "https://registry.npmjs.org/file-entry-cache/-/file-entry-cache-8.0.0.tgz",
+      "integrity": "sha512-XXTUwCvisa5oacNGRP9SfNtYBNAMi+RPwBFmblZEF7N7swHYQS6/Zfk7SRwx4D5j3CH211YNRco1DEMNVfZCnQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "flat-cache": "^4.0.0"
+      },
+      "engines": {
+        "node": ">=16.0.0"
+      }
+    },
+    "node_modules/filelist": {
+      "version": "1.0.6",
+      "resolved": "https://registry.npmjs.org/filelist/-/filelist-1.0.6.tgz",
+      "integrity": "sha512-5giy2PkLYY1cP39p17Ech+2xlpTRL9HLspOfEgm0L6CwBXBTgsK5ou0JtzYuepxkaQ/tvhCFIJ5uXo0OrM2DxA==",
+      "dev": true,
+      "license": "Apache-2.0",
+      "dependencies": {
+        "minimatch": "^5.0.1"
+      }
+    },
+    "node_modules/filelist/node_modules/balanced-match": {
+      "version": "1.0.2",
+      "resolved": "https://registry.npmjs.org/balanced-match/-/balanced-match-1.0.2.tgz",
+      "integrity": "sha512-3oSeUO0TMV67hN1AmbXsK4yaqU7tjiHlbxRDZOpH0KW9+CeX4bRAaX0Anxt0tx2MrpRpWwQaPwIlISEJhYU5Pw==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/filelist/node_modules/brace-expansion": {
+      "version": "2.1.1",
+      "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-2.1.1.tgz",
+      "integrity": "sha512-WR1cURNjuvBLMZBMbqM0UoE+WAfdUcEV1ccD8PVBVOI+Z3ND4+SZbN8RsfT2bMuG1qwz5RFvPukSZm5fF2D5eA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "balanced-match": "^1.0.0"
+      }
+    },
+    "node_modules/filelist/node_modules/minimatch": {
+      "version": "5.1.9",
+      "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-5.1.9.tgz",
+      "integrity": "sha512-7o1wEA2RyMP7Iu7GNba9vc0RWWGACJOCZBJX2GJWip0ikV+wcOsgVuY9uE8CPiyQhkGFSlhuSkZPavN7u1c2Fw==",
+      "dev": true,
+      "license": "ISC",
+      "dependencies": {
+        "brace-expansion": "^2.0.1"
+      },
+      "engines": {
+        "node": ">=10"
+      }
+    },
+    "node_modules/find-up": {
+      "version": "5.0.0",
+      "resolved": "https://registry.npmjs.org/find-up/-/find-up-5.0.0.tgz",
+      "integrity": "sha512-78/PXT1wlLLDgTzDs7sjq9hzz0vXD+zn+7wypEe4fXQxCmdmqfGsEPQxmiCSQI3ajFV91bVSsvNtrJRiW6nGng==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "locate-path": "^6.0.0",
+        "path-exists": "^4.0.0"
+      },
+      "engines": {
+        "node": ">=10"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/flat-cache": {
+      "version": "4.0.1",
+      "resolved": "https://registry.npmjs.org/flat-cache/-/flat-cache-4.0.1.tgz",
+      "integrity": "sha512-f7ccFPK3SXFHpx15UIGyRJ/FJQctuKZ0zVuN3frBo4HnK3cay9VEW0R6yPYFHC0AgqhukPzKjq22t5DmAyqGyw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "flatted": "^3.2.9",
+        "keyv": "^4.5.4"
+      },
+      "engines": {
+        "node": ">=16"
+      }
+    },
+    "node_modules/flatted": {
+      "version": "3.4.2",
+      "resolved": "https://registry.npmjs.org/flatted/-/flatted-3.4.2.tgz",
+      "integrity": "sha512-PjDse7RzhcPkIJwy5t7KPWQSZ9cAbzQXcafsetQoD7sOJRQlGikNbx7yZp2OotDnJyrDcbyRq3Ttb18iYOqkxA==",
+      "dev": true,
+      "license": "ISC"
+    },
+    "node_modules/for-each": {
+      "version": "0.3.5",
+      "resolved": "https://registry.npmjs.org/for-each/-/for-each-0.3.5.tgz",
+      "integrity": "sha512-dKx12eRCVIzqCxFGplyFKJMPvLEWgmNtUrpTiJIR5u97zEhRG8ySrtboPHZXx7daLxQVrl643cTzbab2tkQjxg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "is-callable": "^1.2.7"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/foreground-child": {
+      "version": "3.3.1",
+      "resolved": "https://registry.npmjs.org/foreground-child/-/foreground-child-3.3.1.tgz",
+      "integrity": "sha512-gIXjKqtFuWEgzFRJA9WCQeSJLZDjgJUOMCMzxtvFq/37KojM1BFGufqsCy0r4qSQmYLsZYMeyRqzIWOMup03sw==",
+      "dev": true,
+      "license": "ISC",
+      "dependencies": {
+        "cross-spawn": "^7.0.6",
+        "signal-exit": "^4.0.1"
+      },
+      "engines": {
+        "node": ">=14"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/isaacs"
+      }
+    },
+    "node_modules/fs-extra": {
+      "version": "9.1.0",
+      "resolved": "https://registry.npmjs.org/fs-extra/-/fs-extra-9.1.0.tgz",
+      "integrity": "sha512-hcg3ZmepS30/7BSFqRvoo3DOMQu7IjqxO5nCDt+zM9XWjb33Wg7ziNT+Qvqbuc3+gWpzO02JubVyk2G4Zvo1OQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "at-least-node": "^1.0.0",
+        "graceful-fs": "^4.2.0",
+        "jsonfile": "^6.0.1",
+        "universalify": "^2.0.0"
+      },
+      "engines": {
+        "node": ">=10"
+      }
+    },
+    "node_modules/fsevents": {
+      "version": "2.3.3",
+      "resolved": "https://registry.npmjs.org/fsevents/-/fsevents-2.3.3.tgz",
+      "integrity": "sha512-5xoDfX+fL7faATnagmWPpbFtwh/R77WmMMqqHGS65C3vvB0YHrgF+B1YmZ3441tMj5n63k0212XNoJwzlhffQw==",
+      "dev": true,
+      "hasInstallScript": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "darwin"
+      ],
+      "engines": {
+        "node": "^8.16.0 || ^10.6.0 || >=11.0.0"
+      }
+    },
+    "node_modules/function-bind": {
+      "version": "1.1.2",
+      "resolved": "https://registry.npmjs.org/function-bind/-/function-bind-1.1.2.tgz",
+      "integrity": "sha512-7XHNxH7qX9xG5mIwxkhumTox/MIRNcOgDrxWsMt2pAr23WHp6MrRlN7FBSFpCpr+oVO0F744iUgR82nJMfG2SA==",
+      "dev": true,
+      "license": "MIT",
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/function.prototype.name": {
+      "version": "1.1.8",
+      "resolved": "https://registry.npmjs.org/function.prototype.name/-/function.prototype.name-1.1.8.tgz",
+      "integrity": "sha512-e5iwyodOHhbMr/yNrc7fDYG4qlbIvI5gajyzPnb5TCwyhjApznQh1BMFou9b30SevY43gCJKXycoCBjMbsuW0Q==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "call-bind": "^1.0.8",
+        "call-bound": "^1.0.3",
+        "define-properties": "^1.2.1",
+        "functions-have-names": "^1.2.3",
+        "hasown": "^2.0.2",
+        "is-callable": "^1.2.7"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/functions-have-names": {
+      "version": "1.2.3",
+      "resolved": "https://registry.npmjs.org/functions-have-names/-/functions-have-names-1.2.3.tgz",
+      "integrity": "sha512-xckBUXyTIqT97tq2x2AMb+g163b5JFysYk0x4qxNFwbfQkmNZoiRHb6sPzI9/QV33WeuvVYBUIiD4NzNIyqaRQ==",
+      "dev": true,
+      "license": "MIT",
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/generator-function": {
+      "version": "2.0.1",
+      "resolved": "https://registry.npmjs.org/generator-function/-/generator-function-2.0.1.tgz",
+      "integrity": "sha512-SFdFmIJi+ybC0vjlHN0ZGVGHc3lgE0DxPAT0djjVg+kjOnSqclqmj0KQ7ykTOLP6YxoqOvuAODGdcHJn+43q3g==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
+    "node_modules/gensync": {
+      "version": "1.0.0-beta.2",
+      "resolved": "https://registry.npmjs.org/gensync/-/gensync-1.0.0-beta.2.tgz",
+      "integrity": "sha512-3hN7NaskYvMDLQY55gnW3NQ+mesEAepTqlg+VEbj7zzqEMBVNhzcGYYeqFo/TlYz6eQiFcp1HcsCZO+nGgS8zg==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=6.9.0"
+      }
+    },
+    "node_modules/get-intrinsic": {
+      "version": "1.3.0",
+      "resolved": "https://registry.npmjs.org/get-intrinsic/-/get-intrinsic-1.3.0.tgz",
+      "integrity": "sha512-9fSjSaos/fRIVIp+xSJlE6lfwhES7LNtKaCBIamHsjr2na1BiABJPo0mOjjz8GJDURarmCPGqaiVg5mfjb98CQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "call-bind-apply-helpers": "^1.0.2",
+        "es-define-property": "^1.0.1",
+        "es-errors": "^1.3.0",
+        "es-object-atoms": "^1.1.1",
+        "function-bind": "^1.1.2",
+        "get-proto": "^1.0.1",
+        "gopd": "^1.2.0",
+        "has-symbols": "^1.1.0",
+        "hasown": "^2.0.2",
+        "math-intrinsics": "^1.1.0"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/get-own-enumerable-property-symbols": {
+      "version": "3.0.2",
+      "resolved": "https://registry.npmjs.org/get-own-enumerable-property-symbols/-/get-own-enumerable-property-symbols-3.0.2.tgz",
+      "integrity": "sha512-I0UBV/XOz1XkIJHEUDMZAbzCThU/H8DxmSfmdGcKPnVhu2VfFqr34jr9777IyaTYvxjedWhqVIilEDsCdP5G6g==",
+      "dev": true,
+      "license": "ISC"
+    },
+    "node_modules/get-proto": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/get-proto/-/get-proto-1.0.1.tgz",
+      "integrity": "sha512-sTSfBjoXBp89JvIKIefqw7U2CCebsc74kiY6awiGogKtoSGbgjYE/G/+l9sF3MWFPNc9IcoOC4ODfKHfxFmp0g==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "dunder-proto": "^1.0.1",
+        "es-object-atoms": "^1.0.0"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
+    "node_modules/get-symbol-description": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/get-symbol-description/-/get-symbol-description-1.1.0.tgz",
+      "integrity": "sha512-w9UMqWwJxHNOvoNzSJ2oPF5wvYcvP7jUvYzhp67yEhTi17ZDBBC1z9pTdGuzjD+EFIqLSYRweZjqfiPzQ06Ebg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "call-bound": "^1.0.3",
+        "es-errors": "^1.3.0",
+        "get-intrinsic": "^1.2.6"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/glob": {
+      "version": "11.1.0",
+      "resolved": "https://registry.npmjs.org/glob/-/glob-11.1.0.tgz",
+      "integrity": "sha512-vuNwKSaKiqm7g0THUBu2x7ckSs3XJLXE+2ssL7/MfTGPLLcrJQ/4Uq1CjPTtO5cCIiRxqvN6Twy1qOwhL0Xjcw==",
+      "deprecated": "Old versions of glob are not supported, and contain widely publicized security vulnerabilities, which have been fixed in the current version. Please update. Support for old versions may be purchased (at exorbitant rates) by contacting i@izs.me",
+      "dev": true,
+      "license": "BlueOak-1.0.0",
+      "dependencies": {
+        "foreground-child": "^3.3.1",
+        "jackspeak": "^4.1.1",
+        "minimatch": "^10.1.1",
+        "minipass": "^7.1.2",
+        "package-json-from-dist": "^1.0.0",
+        "path-scurry": "^2.0.0"
+      },
+      "bin": {
+        "glob": "dist/esm/bin.mjs"
+      },
+      "engines": {
+        "node": "20 || >=22"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/isaacs"
+      }
+    },
+    "node_modules/glob-parent": {
+      "version": "6.0.2",
+      "resolved": "https://registry.npmjs.org/glob-parent/-/glob-parent-6.0.2.tgz",
+      "integrity": "sha512-XxwI8EOhVQgWp6iDL+3b0r86f4d6AX6zSU55HfB4ydCEuXLXc5FcYeOu+nnGftS4TEju/11rt4KJPTMgbfmv4A==",
+      "dev": true,
+      "license": "ISC",
+      "dependencies": {
+        "is-glob": "^4.0.3"
+      },
+      "engines": {
+        "node": ">=10.13.0"
+      }
+    },
+    "node_modules/globalthis": {
+      "version": "1.0.4",
+      "resolved": "https://registry.npmjs.org/globalthis/-/globalthis-1.0.4.tgz",
+      "integrity": "sha512-DpLKbNU4WylpxJykQujfCcwYWiV/Jhm50Goo0wrVILAv5jOr9d+H+UR3PhSCD2rCCEIg0uc+G+muBTwD54JhDQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "define-properties": "^1.2.1",
+        "gopd": "^1.0.1"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/gopd": {
+      "version": "1.2.0",
+      "resolved": "https://registry.npmjs.org/gopd/-/gopd-1.2.0.tgz",
+      "integrity": "sha512-ZUKRh6/kUFoAiTAtTYPZJ3hw9wNxx+BIBOijnlG9PnrJsCcSjs1wyyD6vJpaYtgnzDrKYRSqf3OO6Rfa93xsRg==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/graceful-fs": {
+      "version": "4.2.11",
+      "resolved": "https://registry.npmjs.org/graceful-fs/-/graceful-fs-4.2.11.tgz",
+      "integrity": "sha512-RbJ5/jmFcNNCcDV5o9eTnBLJ/HszWV0P73bc+Ff4nS/rJj+YaS6IGyiOL0VoBYX+l1Wrl3k63h/KrH+nhJ0XvQ==",
+      "dev": true,
+      "license": "ISC"
+    },
+    "node_modules/has-bigints": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/has-bigints/-/has-bigints-1.1.0.tgz",
+      "integrity": "sha512-R3pbpkcIqv2Pm3dUwgjclDRVmWpTJW2DcMzcIhEXEx1oh/CEMObMm3KLmRJOdvhM7o4uQBnwr8pzRK2sJWIqfg==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/has-property-descriptors": {
+      "version": "1.0.2",
+      "resolved": "https://registry.npmjs.org/has-property-descriptors/-/has-property-descriptors-1.0.2.tgz",
+      "integrity": "sha512-55JNKuIW+vq4Ke1BjOTjM2YctQIvCT7GFzHwmfZPGo5wnrgkid0YQtnAleFSqumZm4az3n2BS+erby5ipJdgrg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "es-define-property": "^1.0.0"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/has-proto": {
+      "version": "1.2.0",
+      "resolved": "https://registry.npmjs.org/has-proto/-/has-proto-1.2.0.tgz",
+      "integrity": "sha512-KIL7eQPfHQRC8+XluaIw7BHUwwqL19bQn4hzNgdr+1wXoU0KKj6rufu47lhY7KbJR2C6T6+PfyN0Ea7wkSS+qQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "dunder-proto": "^1.0.0"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/has-symbols": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/has-symbols/-/has-symbols-1.1.0.tgz",
+      "integrity": "sha512-1cDNdwJ2Jaohmb3sg4OmKaMBwuC48sYni5HUw2DvsC8LjGTLK9h+eb1X6RyuOHe4hT0ULCW68iomhjUoKUqlPQ==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/has-tostringtag": {
+      "version": "1.0.2",
+      "resolved": "https://registry.npmjs.org/has-tostringtag/-/has-tostringtag-1.0.2.tgz",
+      "integrity": "sha512-NqADB8VjPFLM2V0VvHUewwwsw0ZWBaIdgo+ieHtK3hasLz4qeCRjYcqfB6AQrBggRKppKF8L52/VqdVsO47Dlw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "has-symbols": "^1.0.3"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/hasown": {
+      "version": "2.0.3",
+      "resolved": "https://registry.npmjs.org/hasown/-/hasown-2.0.3.tgz",
+      "integrity": "sha512-ej4AhfhfL2Q2zpMmLo7U1Uv9+PyhIZpgQLGT1F9miIGmiCJIoCgSmczFdrc97mWT4kVY72KA+WnnhJ5pghSvSg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "function-bind": "^1.1.2"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
+    "node_modules/i18next": {
+      "version": "25.8.17",
+      "resolved": "https://registry.npmjs.org/i18next/-/i18next-25.8.17.tgz",
+      "integrity": "sha512-vWtCttyn5bpOK4hWbRAe1ZXkA+Yzcn2OcACT+WJavtfGMcxzkfvXTLMeOU8MUhRmAySKjU4VVuKlo0sSGeBokA==",
+      "funding": [
+        {
+          "type": "individual",
+          "url": "https://locize.com"
+        },
+        {
+          "type": "individual",
+          "url": "https://locize.com/i18next.html"
+        },
+        {
+          "type": "individual",
+          "url": "https://www.i18next.com/how-to/faq#i18next-is-awesome.-how-can-i-support-the-project"
+        }
+      ],
+      "license": "MIT",
+      "dependencies": {
+        "@babel/runtime": "^7.28.6"
+      },
+      "peerDependencies": {
+        "typescript": "^5"
+      },
+      "peerDependenciesMeta": {
+        "typescript": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/i18next-vue": {
+      "version": "5.4.0",
+      "resolved": "https://registry.npmjs.org/i18next-vue/-/i18next-vue-5.4.0.tgz",
+      "integrity": "sha512-GDj0Xvmis5Xgcvo9gMBJMgJCtewYMLZP6gAEPDDGCMjA+QeB4uS4qUf1MK79mkz/FukhaJdC+nlj0y1qk6NO2Q==",
+      "license": "MIT",
+      "peerDependencies": {
+        "i18next": ">=23",
+        "vue": "^3.4.38"
+      }
+    },
+    "node_modules/idb": {
+      "version": "7.1.1",
+      "resolved": "https://registry.npmjs.org/idb/-/idb-7.1.1.tgz",
+      "integrity": "sha512-gchesWBzyvGHRO9W8tzUWFDycow5gwjvFKfyV9FF32Y7F50yZMp7mP+T2mJIWFx49zicqyC4uefHM17o6xKIVQ==",
+      "dev": true,
+      "license": "ISC"
+    },
+    "node_modules/ignore": {
+      "version": "5.3.2",
+      "resolved": "https://registry.npmjs.org/ignore/-/ignore-5.3.2.tgz",
+      "integrity": "sha512-hsBTNUqQTDwkWtcdYI2i06Y/nUBEsNEDJKjWdigLvegy8kDuJAS8uRlpkkcQpyEXL0Z/pjDy5HBmMjRCJ2gq+g==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">= 4"
+      }
+    },
+    "node_modules/imurmurhash": {
+      "version": "0.1.4",
+      "resolved": "https://registry.npmjs.org/imurmurhash/-/imurmurhash-0.1.4.tgz",
+      "integrity": "sha512-JmXMZ6wuvDmLiHEml9ykzqO6lwFbof0GG4IkcGaENdCRDDmMVnny7s5HsIgHCbaq0w2MyPhDqkhTUgS2LU2PHA==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=0.8.19"
+      }
+    },
+    "node_modules/internal-slot": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/internal-slot/-/internal-slot-1.1.0.tgz",
+      "integrity": "sha512-4gd7VpWNQNB4UKKCFFVcp1AVv+FMOgs9NKzjHKusc8jTMhd5eL1NqQqOpE0KzMds804/yHlglp3uxgluOqAPLw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "es-errors": "^1.3.0",
+        "hasown": "^2.0.2",
+        "side-channel": "^1.1.0"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
+    "node_modules/is-array-buffer": {
+      "version": "3.0.5",
+      "resolved": "https://registry.npmjs.org/is-array-buffer/-/is-array-buffer-3.0.5.tgz",
+      "integrity": "sha512-DDfANUiiG2wC1qawP66qlTugJeL5HyzMpfr8lLK+jMQirGzNod0B12cFB/9q838Ru27sBwfw78/rdoU7RERz6A==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "call-bind": "^1.0.8",
+        "call-bound": "^1.0.3",
+        "get-intrinsic": "^1.2.6"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/is-async-function": {
+      "version": "2.1.1",
+      "resolved": "https://registry.npmjs.org/is-async-function/-/is-async-function-2.1.1.tgz",
+      "integrity": "sha512-9dgM/cZBnNvjzaMYHVoxxfPj2QXt22Ev7SuuPrs+xav0ukGB0S6d4ydZdEiM48kLx5kDV+QBPrpVnFyefL8kkQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "async-function": "^1.0.0",
+        "call-bound": "^1.0.3",
+        "get-proto": "^1.0.1",
+        "has-tostringtag": "^1.0.2",
+        "safe-regex-test": "^1.1.0"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/is-bigint": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/is-bigint/-/is-bigint-1.1.0.tgz",
+      "integrity": "sha512-n4ZT37wG78iz03xPRKJrHTdZbe3IicyucEtdRsV5yglwc3GyUfbAfpSeD0FJ41NbUNSt5wbhqfp1fS+BgnvDFQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "has-bigints": "^1.0.2"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/is-boolean-object": {
+      "version": "1.2.2",
+      "resolved": "https://registry.npmjs.org/is-boolean-object/-/is-boolean-object-1.2.2.tgz",
+      "integrity": "sha512-wa56o2/ElJMYqjCjGkXri7it5FbebW5usLw/nPmCMs5DeZ7eziSYZhSmPRn0txqeW4LnAmQQU7FgqLpsEFKM4A==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "call-bound": "^1.0.3",
+        "has-tostringtag": "^1.0.2"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/is-callable": {
+      "version": "1.2.7",
+      "resolved": "https://registry.npmjs.org/is-callable/-/is-callable-1.2.7.tgz",
+      "integrity": "sha512-1BC0BVFhS/p0qtw6enp8e+8OD0UrK0oFLztSjNzhcKA3WDuJxxAPXzPuPtKkjEY9UUoEWlX/8fgKeu2S8i9JTA==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/is-core-module": {
+      "version": "2.16.2",
+      "resolved": "https://registry.npmjs.org/is-core-module/-/is-core-module-2.16.2.tgz",
+      "integrity": "sha512-evOr8xfXKxE6qSR0hSXL2r3sd7ALj8+7jQEUvPYcm5sgZFdJ+AYzT6yNmJenvIYQBgIGwfwz08sL8zoL7yq2BA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "hasown": "^2.0.3"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/is-data-view": {
+      "version": "1.0.2",
+      "resolved": "https://registry.npmjs.org/is-data-view/-/is-data-view-1.0.2.tgz",
+      "integrity": "sha512-RKtWF8pGmS87i2D6gqQu/l7EYRlVdfzemCJN/P3UOs//x1QE7mfhvzHIApBTRf7axvT6DMGwSwBXYCT0nfB9xw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "call-bound": "^1.0.2",
+        "get-intrinsic": "^1.2.6",
+        "is-typed-array": "^1.1.13"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/is-date-object": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/is-date-object/-/is-date-object-1.1.0.tgz",
+      "integrity": "sha512-PwwhEakHVKTdRNVOw+/Gyh0+MzlCl4R6qKvkhuvLtPMggI1WAHt9sOwZxQLSGpUaDnrdyDsomoRgNnCfKNSXXg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "call-bound": "^1.0.2",
+        "has-tostringtag": "^1.0.2"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/is-extglob": {
+      "version": "2.1.1",
+      "resolved": "https://registry.npmjs.org/is-extglob/-/is-extglob-2.1.1.tgz",
+      "integrity": "sha512-SbKbANkN603Vi4jEZv49LeVJMn4yGwsbzZworEoyEiutsN3nJYdbO36zfhGJ6QEDpOZIFkDtnq5JRxmvl3jsoQ==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
+    "node_modules/is-finalizationregistry": {
+      "version": "1.1.1",
+      "resolved": "https://registry.npmjs.org/is-finalizationregistry/-/is-finalizationregistry-1.1.1.tgz",
+      "integrity": "sha512-1pC6N8qWJbWoPtEjgcL2xyhQOP491EQjeUo3qTKcmV8YSDDJrOepfG8pcC7h/QgnQHYSv0mJ3Z/ZWxmatVrysg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "call-bound": "^1.0.3"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/is-generator-function": {
+      "version": "1.1.2",
+      "resolved": "https://registry.npmjs.org/is-generator-function/-/is-generator-function-1.1.2.tgz",
+      "integrity": "sha512-upqt1SkGkODW9tsGNG5mtXTXtECizwtS2kA161M+gJPc1xdb/Ax629af6YrTwcOeQHbewrPNlE5Dx7kzvXTizA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "call-bound": "^1.0.4",
+        "generator-function": "^2.0.0",
+        "get-proto": "^1.0.1",
+        "has-tostringtag": "^1.0.2",
+        "safe-regex-test": "^1.1.0"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/is-glob": {
+      "version": "4.0.3",
+      "resolved": "https://registry.npmjs.org/is-glob/-/is-glob-4.0.3.tgz",
+      "integrity": "sha512-xelSayHH36ZgE7ZWhli7pW34hNbNl8Ojv5KVmkJD4hBdD3th8Tfk9vYasLM+mXWOZhFkgZfxhLSnrwRr4elSSg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "is-extglob": "^2.1.1"
+      },
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
+    "node_modules/is-map": {
+      "version": "2.0.3",
+      "resolved": "https://registry.npmjs.org/is-map/-/is-map-2.0.3.tgz",
+      "integrity": "sha512-1Qed0/Hr2m+YqxnM09CjA2d/i6YZNfF6R2oRAOj36eUdS6qIV/huPJNSEpKbupewFs+ZsJlxsjjPbc0/afW6Lw==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/is-module": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/is-module/-/is-module-1.0.0.tgz",
+      "integrity": "sha512-51ypPSPCoTEIN9dy5Oy+h4pShgJmPCygKfyRCISBI+JoWT/2oJvK8QPxmwv7b/p239jXrm9M1mlQbyKJ5A152g==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/is-negative-zero": {
+      "version": "2.0.3",
+      "resolved": "https://registry.npmjs.org/is-negative-zero/-/is-negative-zero-2.0.3.tgz",
+      "integrity": "sha512-5KoIu2Ngpyek75jXodFvnafB6DJgr3u8uuK0LEZJjrU19DrMD3EVERaR8sjz8CCGgpZvxPl9SuE1GMVPFHx1mw==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/is-number-object": {
+      "version": "1.1.1",
+      "resolved": "https://registry.npmjs.org/is-number-object/-/is-number-object-1.1.1.tgz",
+      "integrity": "sha512-lZhclumE1G6VYD8VHe35wFaIif+CTy5SJIi5+3y4psDgWu4wPDoBhF8NxUOinEc7pHgiTsT6MaBb92rKhhD+Xw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "call-bound": "^1.0.3",
+        "has-tostringtag": "^1.0.2"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/is-obj": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/is-obj/-/is-obj-1.0.1.tgz",
+      "integrity": "sha512-l4RyHgRqGN4Y3+9JHVrNqO+tN0rV5My76uW5/nuO4K1b6vw5G8d/cmFjP9tRfEsdhZNt0IFdZuK/c2Vr4Nb+Qg==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
+    "node_modules/is-regex": {
+      "version": "1.2.1",
+      "resolved": "https://registry.npmjs.org/is-regex/-/is-regex-1.2.1.tgz",
+      "integrity": "sha512-MjYsKHO5O7mCsmRGxWcLWheFqN9DJ/2TmngvjKXihe6efViPqc274+Fx/4fYj/r03+ESvBdTXK0V6tA3rgez1g==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "call-bound": "^1.0.2",
+        "gopd": "^1.2.0",
+        "has-tostringtag": "^1.0.2",
+        "hasown": "^2.0.2"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/is-regexp": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/is-regexp/-/is-regexp-1.0.0.tgz",
+      "integrity": "sha512-7zjFAPO4/gwyQAAgRRmqeEeyIICSdmCqa3tsVHMdBzaXXRiqopZL4Cyghg/XulGWrtABTpbnYYzzIRffLkP4oA==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
+    "node_modules/is-set": {
+      "version": "2.0.3",
+      "resolved": "https://registry.npmjs.org/is-set/-/is-set-2.0.3.tgz",
+      "integrity": "sha512-iPAjerrse27/ygGLxw+EBR9agv9Y6uLeYVJMu+QNCoouJ1/1ri0mGrcWpfCqFZuzzx3WjtwxG098X+n4OuRkPg==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/is-shared-array-buffer": {
+      "version": "1.0.4",
+      "resolved": "https://registry.npmjs.org/is-shared-array-buffer/-/is-shared-array-buffer-1.0.4.tgz",
+      "integrity": "sha512-ISWac8drv4ZGfwKl5slpHG9OwPNty4jOWPRIhBpxOoD+hqITiwuipOQ2bNthAzwA3B4fIjO4Nln74N0S9byq8A==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "call-bound": "^1.0.3"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/is-stream": {
+      "version": "2.0.1",
+      "resolved": "https://registry.npmjs.org/is-stream/-/is-stream-2.0.1.tgz",
+      "integrity": "sha512-hFoiJiTl63nn+kstHGBtewWSKnQLpyb155KHheA1l39uvtO9nWIop1p3udqPcUd/xbF1VLMO4n7OI6p7RbngDg==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=8"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/is-string": {
+      "version": "1.1.1",
+      "resolved": "https://registry.npmjs.org/is-string/-/is-string-1.1.1.tgz",
+      "integrity": "sha512-BtEeSsoaQjlSPBemMQIrY1MY0uM6vnS1g5fmufYOtnxLGUZM2178PKbhsk7Ffv58IX+ZtcvoGwccYsh0PglkAA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "call-bound": "^1.0.3",
+        "has-tostringtag": "^1.0.2"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/is-symbol": {
+      "version": "1.1.1",
+      "resolved": "https://registry.npmjs.org/is-symbol/-/is-symbol-1.1.1.tgz",
+      "integrity": "sha512-9gGx6GTtCQM73BgmHQXfDmLtfjjTUDSyoxTCbp5WtoixAhfgsDirWIcVQ/IHpvI5Vgd5i/J5F7B9cN/WlVbC/w==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "call-bound": "^1.0.2",
+        "has-symbols": "^1.1.0",
+        "safe-regex-test": "^1.1.0"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/is-typed-array": {
+      "version": "1.1.15",
+      "resolved": "https://registry.npmjs.org/is-typed-array/-/is-typed-array-1.1.15.tgz",
+      "integrity": "sha512-p3EcsicXjit7SaskXHs1hA91QxgTw46Fv6EFKKGS5DRFLD8yKnohjF3hxoju94b/OcMZoQukzpPpBE9uLVKzgQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "which-typed-array": "^1.1.16"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/is-weakmap": {
+      "version": "2.0.2",
+      "resolved": "https://registry.npmjs.org/is-weakmap/-/is-weakmap-2.0.2.tgz",
+      "integrity": "sha512-K5pXYOm9wqY1RgjpL3YTkF39tni1XajUIkawTLUo9EZEVUFga5gSQJF8nNS7ZwJQ02y+1YCNYcMh+HIf1ZqE+w==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/is-weakref": {
+      "version": "1.1.1",
+      "resolved": "https://registry.npmjs.org/is-weakref/-/is-weakref-1.1.1.tgz",
+      "integrity": "sha512-6i9mGWSlqzNMEqpCp93KwRS1uUOodk2OJ6b+sq7ZPDSy2WuI5NFIxp/254TytR8ftefexkWn5xNiHUNpPOfSew==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "call-bound": "^1.0.3"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/is-weakset": {
+      "version": "2.0.4",
+      "resolved": "https://registry.npmjs.org/is-weakset/-/is-weakset-2.0.4.tgz",
+      "integrity": "sha512-mfcwb6IzQyOKTs84CQMrOwW4gQcaTOAWJ0zzJCl2WSPDrWk/OzDaImWFH3djXhb24g4eudZfLRozAvPGw4d9hQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "call-bound": "^1.0.3",
+        "get-intrinsic": "^1.2.6"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/isarray": {
+      "version": "2.0.5",
+      "resolved": "https://registry.npmjs.org/isarray/-/isarray-2.0.5.tgz",
+      "integrity": "sha512-xHjhDr3cNBK0BzdUJSPXZntQUx/mwMS5Rw4A7lPJ90XGAO6ISP/ePDNuo0vhqOZU+UD5JoodwCAAoZQd3FeAKw==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/isexe": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/isexe/-/isexe-2.0.0.tgz",
+      "integrity": "sha512-RHxMLp9lnKHGHRng9QFhRCMbYAcVpn69smSGcq3f36xjgVVWThj4qqLbTLlq7Ssj8B+fIQ1EuCEGI2lKsyQeIw==",
+      "dev": true,
+      "license": "ISC"
+    },
+    "node_modules/jackspeak": {
+      "version": "4.2.3",
+      "resolved": "https://registry.npmjs.org/jackspeak/-/jackspeak-4.2.3.tgz",
+      "integrity": "sha512-ykkVRwrYvFm1nb2AJfKKYPr0emF6IiXDYUaFx4Zn9ZuIH7MrzEZ3sD5RlqGXNRpHtvUHJyOnCEFxOlNDtGo7wg==",
+      "dev": true,
+      "license": "BlueOak-1.0.0",
+      "dependencies": {
+        "@isaacs/cliui": "^9.0.0"
+      },
+      "engines": {
+        "node": "20 || >=22"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/isaacs"
+      }
+    },
+    "node_modules/jake": {
+      "version": "10.9.4",
+      "resolved": "https://registry.npmjs.org/jake/-/jake-10.9.4.tgz",
+      "integrity": "sha512-wpHYzhxiVQL+IV05BLE2Xn34zW1S223hvjtqk0+gsPrwd/8JNLXJgZZM/iPFsYc1xyphF+6M6EvdE5E9MBGkDA==",
+      "dev": true,
+      "license": "Apache-2.0",
+      "dependencies": {
+        "async": "^3.2.6",
+        "filelist": "^1.0.4",
+        "picocolors": "^1.1.1"
+      },
+      "bin": {
+        "jake": "bin/cli.js"
+      },
+      "engines": {
+        "node": ">=10"
+      }
+    },
+    "node_modules/js-tokens": {
+      "version": "4.0.0",
+      "resolved": "https://registry.npmjs.org/js-tokens/-/js-tokens-4.0.0.tgz",
+      "integrity": "sha512-RdJUflcE3cUzKiMqQgsCu06FPu9UdIJO0beYbPhHN4k6apgJtifcoCtT9bcxOpYBtpD2kCM6Sbzg4CausW/PKQ==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/jsesc": {
+      "version": "3.1.0",
+      "resolved": "https://registry.npmjs.org/jsesc/-/jsesc-3.1.0.tgz",
+      "integrity": "sha512-/sM3dO2FOzXjKQhJuo0Q173wf2KOo8t4I8vHy6lF9poUp7bKT0/NHE8fPX23PwfhnykfqnC2xRxOnVw5XuGIaA==",
+      "dev": true,
+      "license": "MIT",
+      "bin": {
+        "jsesc": "bin/jsesc"
+      },
+      "engines": {
+        "node": ">=6"
+      }
+    },
+    "node_modules/json-buffer": {
+      "version": "3.0.1",
+      "resolved": "https://registry.npmjs.org/json-buffer/-/json-buffer-3.0.1.tgz",
+      "integrity": "sha512-4bV5BfR2mqfQTJm+V5tPPdf+ZpuhiIvTuAB5g8kcrXOZpTT/QwwVRWBywX1ozr6lEuPdbHxwaJlm9G6mI2sfSQ==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/json-schema-traverse": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/json-schema-traverse/-/json-schema-traverse-1.0.0.tgz",
+      "integrity": "sha512-NM8/P9n3XjXhIZn1lLhkFaACTOURQXjWhV4BA/RnOv8xvgqtqpAX9IO4mRQxSx1Rlo4tqzeqb0sOlruaOy3dug==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/json-stable-stringify-without-jsonify": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/json-stable-stringify-without-jsonify/-/json-stable-stringify-without-jsonify-1.0.1.tgz",
+      "integrity": "sha512-Bdboy+l7tA3OGW6FjyFHWkP5LuByj1Tk33Ljyq0axyzdk9//JSi2u3fP1QSmd1KNwq6VOKYGlAu87CisVir6Pw==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/json5": {
+      "version": "2.2.3",
+      "resolved": "https://registry.npmjs.org/json5/-/json5-2.2.3.tgz",
+      "integrity": "sha512-XmOWe7eyHYH14cLdVPoyg+GOH3rYX++KpzrylJwSW98t3Nk+U8XOl8FWKOgwtzdb8lXGf6zYwDUzeHMWfxasyg==",
+      "dev": true,
+      "license": "MIT",
+      "bin": {
+        "json5": "lib/cli.js"
+      },
+      "engines": {
+        "node": ">=6"
+      }
+    },
+    "node_modules/jsonfile": {
+      "version": "6.2.1",
+      "resolved": "https://registry.npmjs.org/jsonfile/-/jsonfile-6.2.1.tgz",
+      "integrity": "sha512-zwOTdL3rFQ/lRdBnntKVOX6k5cKJwEc1HdilT71BWEu7J41gXIB2MRp+vxduPSwZJPWBxEzv4yH1wYLJGUHX4Q==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "universalify": "^2.0.0"
+      },
+      "optionalDependencies": {
+        "graceful-fs": "^4.1.6"
+      }
+    },
+    "node_modules/jsonpointer": {
+      "version": "5.0.1",
+      "resolved": "https://registry.npmjs.org/jsonpointer/-/jsonpointer-5.0.1.tgz",
+      "integrity": "sha512-p/nXbhSEcu3pZRdkW1OfJhpsVtW1gd4Wa1fnQc9YLiTfAjn0312eMKimbdIQzuZl9aa9xUGaRlP9T/CJE/ditQ==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
+    "node_modules/keyv": {
+      "version": "4.5.4",
+      "resolved": "https://registry.npmjs.org/keyv/-/keyv-4.5.4.tgz",
+      "integrity": "sha512-oxVHkHR/EJf2CNXnWxRLW6mg7JyCCUcG0DtEGmL2ctUo1PNTin1PUil+r/+4r5MpVgC/fn1kjsx7mjSujKqIpw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "json-buffer": "3.0.1"
+      }
+    },
+    "node_modules/leven": {
+      "version": "3.1.0",
+      "resolved": "https://registry.npmjs.org/leven/-/leven-3.1.0.tgz",
+      "integrity": "sha512-qsda+H8jTaUaN/x5vzW2rzc+8Rw4TAQ/4KjB46IwK5VH+IlVeeeje/EoZRpiXvIqjFgK84QffqPztGI3VBLG1A==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=6"
+      }
+    },
+    "node_modules/levn": {
+      "version": "0.4.1",
+      "resolved": "https://registry.npmjs.org/levn/-/levn-0.4.1.tgz",
+      "integrity": "sha512-+bT2uH4E5LGE7h/n3evcS/sQlJXCpIp6ym8OWJ5eV6+67Dsql/LaaT7qJBAt2rzfoa/5QBGBhxDix1dMt2kQKQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "prelude-ls": "^1.2.1",
+        "type-check": "~0.4.0"
+      },
+      "engines": {
+        "node": ">= 0.8.0"
+      }
+    },
+    "node_modules/locate-path": {
+      "version": "6.0.0",
+      "resolved": "https://registry.npmjs.org/locate-path/-/locate-path-6.0.0.tgz",
+      "integrity": "sha512-iPZK6eYjbxRu3uB4/WZ3EsEIMJFMqAoopl3R+zuq0UjcAm/MO6KCweDgPfP3elTztoKP3KtnVHxTn2NHBSDVUw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "p-locate": "^5.0.0"
+      },
+      "engines": {
+        "node": ">=10"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/lodash.debounce": {
+      "version": "4.0.8",
+      "resolved": "https://registry.npmjs.org/lodash.debounce/-/lodash.debounce-4.0.8.tgz",
+      "integrity": "sha512-FT1yDzDYEoYWhnSGnpE/4Kj1fLZkDFyqRb7fNt6FdYOSxlUWAtp42Eh6Wb0rGIv/m9Bgo7x4GhQbm5Ys4SG5ow==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/lodash.sortby": {
+      "version": "4.7.0",
+      "resolved": "https://registry.npmjs.org/lodash.sortby/-/lodash.sortby-4.7.0.tgz",
+      "integrity": "sha512-HDWXG8isMntAyRF5vZ7xKuEvOhT4AhlRt/3czTSjvGUxjYCBVRQY48ViDHyfYz9VIoBkW4TMGQNapx+l3RUwdA==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/lru-cache": {
+      "version": "5.1.1",
+      "resolved": "https://registry.npmjs.org/lru-cache/-/lru-cache-5.1.1.tgz",
+      "integrity": "sha512-KpNARQA3Iwv+jTA0utUVVbrh+Jlrr1Fv0e56GGzAFOXN7dk/FviaDW8LHmK52DlcH4WP2n6gI8vN1aesBFgo9w==",
+      "dev": true,
+      "license": "ISC",
+      "dependencies": {
+        "yallist": "^3.0.2"
+      }
+    },
+    "node_modules/magic-string": {
+      "version": "0.30.21",
+      "resolved": "https://registry.npmjs.org/magic-string/-/magic-string-0.30.21.tgz",
+      "integrity": "sha512-vd2F4YUyEXKGcLHoq+TEyCjxueSeHnFxyyjNp80yg0XV4vUhnDer/lvvlqM/arB5bXQN5K2/3oinyCRyx8T2CQ==",
+      "license": "MIT",
+      "dependencies": {
+        "@jridgewell/sourcemap-codec": "^1.5.5"
+      }
+    },
+    "node_modules/marked": {
+      "version": "18.0.4",
+      "resolved": "https://registry.npmjs.org/marked/-/marked-18.0.4.tgz",
+      "integrity": "sha512-c/BTaKzg0G6ezQx97DAkYU7k0HM6ys0FqYeKBL6hlBByZwy+ycA1+f0vDdjMHKKeEjdgkx0GOv9Il6D+85cOqA==",
+      "license": "MIT",
+      "bin": {
+        "marked": "bin/marked.js"
+      },
+      "engines": {
+        "node": ">= 20"
+      }
+    },
+    "node_modules/math-intrinsics": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/math-intrinsics/-/math-intrinsics-1.1.0.tgz",
+      "integrity": "sha512-/IXtbwEk5HTPyEwyKX6hGkYXxM9nbj64B+ilVJnC/R6B0pH5G4V3b0pVbL7DBj4tkhBAppbQUlf6F6Xl9LHu1g==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
+    "node_modules/minimatch": {
+      "version": "10.2.5",
+      "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-10.2.5.tgz",
+      "integrity": "sha512-MULkVLfKGYDFYejP07QOurDLLQpcjk7Fw+7jXS2R2czRQzR56yHRveU5NDJEOviH+hETZKSkIk5c+T23GjFUMg==",
+      "dev": true,
+      "license": "BlueOak-1.0.0",
+      "dependencies": {
+        "brace-expansion": "^5.0.5"
+      },
+      "engines": {
+        "node": "18 || 20 || >=22"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/isaacs"
+      }
+    },
+    "node_modules/minipass": {
+      "version": "7.1.3",
+      "resolved": "https://registry.npmjs.org/minipass/-/minipass-7.1.3.tgz",
+      "integrity": "sha512-tEBHqDnIoM/1rXME1zgka9g6Q2lcoCkxHLuc7ODJ5BxbP5d4c2Z5cGgtXAku59200Cx7diuHTOYfSBD8n6mm8A==",
+      "dev": true,
+      "license": "BlueOak-1.0.0",
+      "engines": {
+        "node": ">=16 || 14 >=14.17"
+      }
+    },
+    "node_modules/ms": {
+      "version": "2.1.3",
+      "resolved": "https://registry.npmjs.org/ms/-/ms-2.1.3.tgz",
+      "integrity": "sha512-6FlzubTLZG3J2a/NVCAleEhjzq5oxgHyaCU9yYXvcLsvoVaHJq/s5xXI6/XXP6tz7R9xAOtHnSO/tXtF3WRTlA==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/nanoid": {
+      "version": "3.3.11",
+      "resolved": "https://registry.npmjs.org/nanoid/-/nanoid-3.3.11.tgz",
+      "integrity": "sha512-N8SpfPUnUp1bK+PMYW8qSWdl9U+wwNWI4QKxOYDy9JAro3WMX7p2OeVRF9v+347pnakNevPmiHhNmZ2HbFA76w==",
+      "funding": [
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/ai"
+        }
+      ],
+      "license": "MIT",
+      "bin": {
+        "nanoid": "bin/nanoid.cjs"
+      },
+      "engines": {
+        "node": "^10 || ^12 || ^13.7 || ^14 || >=15.0.1"
+      }
+    },
+    "node_modules/natural-compare": {
+      "version": "1.4.0",
+      "resolved": "https://registry.npmjs.org/natural-compare/-/natural-compare-1.4.0.tgz",
+      "integrity": "sha512-OWND8ei3VtNC9h7V60qff3SVobHr996CTwgxubgyQYEpg290h9J0buyECNNJexkFm5sOajh5G116RYA1c8ZMSw==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/node-releases": {
+      "version": "2.0.46",
+      "resolved": "https://registry.npmjs.org/node-releases/-/node-releases-2.0.46.tgz",
+      "integrity": "sha512-GYVXHE2KnrzAfsAjl4uP++evGFCrAU1jta4ubEjIG7YWt/64Gqv66a30yKwWczVjA6j3bM4nBwH7Pk1JmDHaxQ==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/nth-check": {
+      "version": "2.1.1",
+      "resolved": "https://registry.npmjs.org/nth-check/-/nth-check-2.1.1.tgz",
+      "integrity": "sha512-lqjrjmaOoAnWfMmBPL+XNnynZh2+swxiX3WUE0s4yEHI6m+AwrK2UZOimIRl3X/4QctVqS8AiZjFqyOGrMXb/w==",
+      "dev": true,
+      "license": "BSD-2-Clause",
+      "dependencies": {
+        "boolbase": "^1.0.0"
+      },
+      "funding": {
+        "url": "https://github.com/fb55/nth-check?sponsor=1"
+      }
+    },
+    "node_modules/object-inspect": {
+      "version": "1.13.4",
+      "resolved": "https://registry.npmjs.org/object-inspect/-/object-inspect-1.13.4.tgz",
+      "integrity": "sha512-W67iLl4J2EXEGTbfeHCffrjDfitvLANg0UlX3wFUUSTx92KXRFegMHUVgSqE+wvhAbi4WqjGg9czysTV2Epbew==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/object-keys": {
+      "version": "1.1.1",
+      "resolved": "https://registry.npmjs.org/object-keys/-/object-keys-1.1.1.tgz",
+      "integrity": "sha512-NuAESUOUMrlIXOfHKzD6bpPu3tYt3xvjNdRIQ+FeT0lNb4K8WR70CaDxhuNguS2XG+GjkyMwOzsN5ZktImfhLA==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
+    "node_modules/object.assign": {
+      "version": "4.1.7",
+      "resolved": "https://registry.npmjs.org/object.assign/-/object.assign-4.1.7.tgz",
+      "integrity": "sha512-nK28WOo+QIjBkDduTINE4JkF/UJJKyf2EJxvJKfblDpyg0Q+pkOHNTL0Qwy6NP6FhE/EnzV73BxxqcJaXY9anw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "call-bind": "^1.0.8",
+        "call-bound": "^1.0.3",
+        "define-properties": "^1.2.1",
+        "es-object-atoms": "^1.0.0",
+        "has-symbols": "^1.1.0",
+        "object-keys": "^1.1.1"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/optionator": {
+      "version": "0.9.4",
+      "resolved": "https://registry.npmjs.org/optionator/-/optionator-0.9.4.tgz",
+      "integrity": "sha512-6IpQ7mKUxRcZNLIObR0hz7lxsapSSIYNZJwXPGeF0mTVqGKFIXj1DQcMoT22S3ROcLyY/rz0PWaWZ9ayWmad9g==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "deep-is": "^0.1.3",
+        "fast-levenshtein": "^2.0.6",
+        "levn": "^0.4.1",
+        "prelude-ls": "^1.2.1",
+        "type-check": "^0.4.0",
+        "word-wrap": "^1.2.5"
+      },
+      "engines": {
+        "node": ">= 0.8.0"
+      }
+    },
+    "node_modules/own-keys": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/own-keys/-/own-keys-1.0.1.tgz",
+      "integrity": "sha512-qFOyK5PjiWZd+QQIh+1jhdb9LpxTF0qs7Pm8o5QHYZ0M3vKqSqzsZaEB6oWlxZ+q2sJBMI/Ktgd2N5ZwQoRHfg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "get-intrinsic": "^1.2.6",
+        "object-keys": "^1.1.1",
+        "safe-push-apply": "^1.0.0"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/p-limit": {
+      "version": "3.1.0",
+      "resolved": "https://registry.npmjs.org/p-limit/-/p-limit-3.1.0.tgz",
+      "integrity": "sha512-TYOanM3wGwNGsZN2cVTYPArw454xnXj5qmWF1bEoAc4+cU/ol7GVh7odevjp1FNHduHc3KZMcFduxU5Xc6uJRQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "yocto-queue": "^0.1.0"
+      },
+      "engines": {
+        "node": ">=10"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/p-locate": {
+      "version": "5.0.0",
+      "resolved": "https://registry.npmjs.org/p-locate/-/p-locate-5.0.0.tgz",
+      "integrity": "sha512-LaNjtRWUBY++zB5nE/NwcaoMylSPk+S+ZHNB1TzdbMJMny6dynpAGt7X/tl/QYq3TIeE6nxHppbo2LGymrG5Pw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "p-limit": "^3.0.2"
+      },
+      "engines": {
+        "node": ">=10"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/package-json-from-dist": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/package-json-from-dist/-/package-json-from-dist-1.0.1.tgz",
+      "integrity": "sha512-UEZIS3/by4OC8vL3P2dTXRETpebLI2NiI5vIrjaD/5UtrkFX/tNbwjTSRAGC/+7CAo2pIcBaRgWmcBBHcsaCIw==",
+      "dev": true,
+      "license": "BlueOak-1.0.0"
+    },
+    "node_modules/path-exists": {
+      "version": "4.0.0",
+      "resolved": "https://registry.npmjs.org/path-exists/-/path-exists-4.0.0.tgz",
+      "integrity": "sha512-ak9Qy5Q7jYb2Wwcey5Fpvg2KoAc/ZIhLSLOSBmRmygPsGwkVVt0fZa0qrtMz+m6tJTAHfZQ8FnmB4MG4LWy7/w==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/path-key": {
+      "version": "3.1.1",
+      "resolved": "https://registry.npmjs.org/path-key/-/path-key-3.1.1.tgz",
+      "integrity": "sha512-ojmeN0qd+y0jszEtoY48r0Peq5dwMEkIlCOu6Q5f41lfkswXuKtYrhgoTpLnyIcHm24Uhqx+5Tqm2InSwLhE6Q==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/path-parse": {
+      "version": "1.0.7",
+      "resolved": "https://registry.npmjs.org/path-parse/-/path-parse-1.0.7.tgz",
+      "integrity": "sha512-LDJzPVEEEPR+y48z93A0Ed0yXb8pAByGWo/k5YYdYgpY2/2EsOsksJrq7lOHxryrVOn1ejG6oAp8ahvOIQD8sw==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/path-scurry": {
+      "version": "2.0.2",
+      "resolved": "https://registry.npmjs.org/path-scurry/-/path-scurry-2.0.2.tgz",
+      "integrity": "sha512-3O/iVVsJAPsOnpwWIeD+d6z/7PmqApyQePUtCndjatj/9I5LylHvt5qluFaBT3I5h3r1ejfR056c+FCv+NnNXg==",
+      "dev": true,
+      "license": "BlueOak-1.0.0",
+      "dependencies": {
+        "lru-cache": "^11.0.0",
+        "minipass": "^7.1.2"
+      },
+      "engines": {
+        "node": "18 || 20 || >=22"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/isaacs"
+      }
+    },
+    "node_modules/path-scurry/node_modules/lru-cache": {
+      "version": "11.5.0",
+      "resolved": "https://registry.npmjs.org/lru-cache/-/lru-cache-11.5.0.tgz",
+      "integrity": "sha512-5YgH9UJd7wVb9hIouI2adWpgqrrICkt070Dnj8EUY1+B4B2P9eRLPAkAAo6NICA7CEhOIeBHl46u9zSNpNu7zA==",
+      "dev": true,
+      "license": "BlueOak-1.0.0",
+      "engines": {
+        "node": "20 || >=22"
+      }
+    },
+    "node_modules/picocolors": {
+      "version": "1.1.1",
+      "resolved": "https://registry.npmjs.org/picocolors/-/picocolors-1.1.1.tgz",
+      "integrity": "sha512-xceH2snhtb5M9liqDsmEw56le376mTZkEX/jEb/RxNFyegNul7eNslCXP9FDj/Lcu0X8KEyMceP2ntpaHrDEVA==",
+      "license": "ISC"
+    },
+    "node_modules/picomatch": {
+      "version": "4.0.3",
+      "resolved": "https://registry.npmjs.org/picomatch/-/picomatch-4.0.3.tgz",
+      "integrity": "sha512-5gTmgEY/sqK6gFXLIsQNH19lWb4ebPDLA4SdLP7dsWkIXHWlG66oPuVvXSGFPppYZz8ZDZq0dYYrbHfBCVUb1Q==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=12"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/jonschlinkert"
+      }
+    },
+    "node_modules/possible-typed-array-names": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/possible-typed-array-names/-/possible-typed-array-names-1.1.0.tgz",
+      "integrity": "sha512-/+5VFTchJDoVj3bhoqi6UeymcD00DAwb1nJwamzPvHEszJ4FpF6SNNbUbOS8yI56qHzdV8eK0qEfOSiodkTdxg==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
+    "node_modules/postcss": {
+      "version": "8.5.8",
+      "resolved": "https://registry.npmjs.org/postcss/-/postcss-8.5.8.tgz",
+      "integrity": "sha512-OW/rX8O/jXnm82Ey1k44pObPtdblfiuWnrd8X7GJ7emImCOstunGbXUpp7HdBrFQX6rJzn3sPT397Wp5aCwCHg==",
+      "funding": [
+        {
+          "type": "opencollective",
+          "url": "https://opencollective.com/postcss/"
+        },
+        {
+          "type": "tidelift",
+          "url": "https://tidelift.com/funding/github/npm/postcss"
+        },
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/ai"
+        }
+      ],
+      "license": "MIT",
+      "dependencies": {
+        "nanoid": "^3.3.11",
+        "picocolors": "^1.1.1",
+        "source-map-js": "^1.2.1"
+      },
+      "engines": {
+        "node": "^10 || ^12 || >=14"
+      }
+    },
+    "node_modules/postcss-selector-parser": {
+      "version": "7.1.4",
+      "resolved": "https://registry.npmjs.org/postcss-selector-parser/-/postcss-selector-parser-7.1.4.tgz",
+      "integrity": "sha512-HeP7D2wyhkR+XaK6v4W8oRF62Dsz4flyuczALJp61GckGm42u1saSSJ/0auvcBqxs3jMRFEcPK34At/0JBKdOg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "cssesc": "^3.0.0",
+        "util-deprecate": "^1.0.2"
+      },
+      "engines": {
+        "node": ">=4"
+      }
+    },
+    "node_modules/prelude-ls": {
+      "version": "1.2.1",
+      "resolved": "https://registry.npmjs.org/prelude-ls/-/prelude-ls-1.2.1.tgz",
+      "integrity": "sha512-vkcDPrRZo1QZLbn5RLGPpg/WmIQ65qoWWhcGKf/b5eplkkarX0m9z8ppCat4mlOqUsWpyNuYgO3VRyrYHSzX5g==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.8.0"
+      }
+    },
+    "node_modules/prettier": {
+      "version": "3.8.1",
+      "resolved": "https://registry.npmjs.org/prettier/-/prettier-3.8.1.tgz",
+      "integrity": "sha512-UOnG6LftzbdaHZcKoPFtOcCKztrQ57WkHDeRD9t/PTQtmT0NHSeWWepj6pS0z/N7+08BHFDQVUrfmfMRcZwbMg==",
+      "dev": true,
+      "license": "MIT",
+      "bin": {
+        "prettier": "bin/prettier.cjs"
+      },
+      "engines": {
+        "node": ">=14"
+      },
+      "funding": {
+        "url": "https://github.com/prettier/prettier?sponsor=1"
+      }
+    },
+    "node_modules/pretty-bytes": {
+      "version": "6.1.1",
+      "resolved": "https://registry.npmjs.org/pretty-bytes/-/pretty-bytes-6.1.1.tgz",
+      "integrity": "sha512-mQUvGU6aUFQ+rNvTIAcZuWGRT9a6f6Yrg9bHs4ImKF+HZCEK+plBvnAZYSIQztknZF2qnzNtr6F8s0+IuptdlQ==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": "^14.13.1 || >=16.0.0"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/punycode": {
+      "version": "2.3.1",
+      "resolved": "https://registry.npmjs.org/punycode/-/punycode-2.3.1.tgz",
+      "integrity": "sha512-vYt7UD1U9Wg6138shLtLOvdAu+8DsC/ilFtEVHcH+wydcSpNE20AfSOduf6MkRFahL5FY7X1oU7nKVZFtfq8Fg==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=6"
+      }
+    },
+    "node_modules/reflect.getprototypeof": {
+      "version": "1.0.10",
+      "resolved": "https://registry.npmjs.org/reflect.getprototypeof/-/reflect.getprototypeof-1.0.10.tgz",
+      "integrity": "sha512-00o4I+DVrefhv+nX0ulyi3biSHCPDe+yLv5o/p6d/UVlirijB8E16FtfwSAi4g3tcqrQ4lRAqQSoFEZJehYEcw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "call-bind": "^1.0.8",
+        "define-properties": "^1.2.1",
+        "es-abstract": "^1.23.9",
+        "es-errors": "^1.3.0",
+        "es-object-atoms": "^1.0.0",
+        "get-intrinsic": "^1.2.7",
+        "get-proto": "^1.0.1",
+        "which-builtin-type": "^1.2.1"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/regenerate": {
+      "version": "1.4.2",
+      "resolved": "https://registry.npmjs.org/regenerate/-/regenerate-1.4.2.tgz",
+      "integrity": "sha512-zrceR/XhGYU/d/opr2EKO7aRHUeiBI8qjtfHqADTwZd6Szfy16la6kqD0MIUs5z5hx6AaKa+PixpPrR289+I0A==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/regenerate-unicode-properties": {
+      "version": "10.2.2",
+      "resolved": "https://registry.npmjs.org/regenerate-unicode-properties/-/regenerate-unicode-properties-10.2.2.tgz",
+      "integrity": "sha512-m03P+zhBeQd1RGnYxrGyDAPpWX/epKirLrp8e3qevZdVkKtnCrjjWczIbYc8+xd6vcTStVlqfycTx1KR4LOr0g==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "regenerate": "^1.4.2"
+      },
+      "engines": {
+        "node": ">=4"
+      }
+    },
+    "node_modules/regexp.prototype.flags": {
+      "version": "1.5.4",
+      "resolved": "https://registry.npmjs.org/regexp.prototype.flags/-/regexp.prototype.flags-1.5.4.tgz",
+      "integrity": "sha512-dYqgNSZbDwkaJ2ceRd9ojCGjBq+mOm9LmtXnAnEGyHhN/5R7iDW2TRw3h+o/jCFxus3P2LfWIIiwowAjANm7IA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "call-bind": "^1.0.8",
+        "define-properties": "^1.2.1",
+        "es-errors": "^1.3.0",
+        "get-proto": "^1.0.1",
+        "gopd": "^1.2.0",
+        "set-function-name": "^2.0.2"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/regexpu-core": {
+      "version": "6.4.0",
+      "resolved": "https://registry.npmjs.org/regexpu-core/-/regexpu-core-6.4.0.tgz",
+      "integrity": "sha512-0ghuzq67LI9bLXpOX/ISfve/Mq33a4aFRzoQYhnnok1JOFpmE/A2TBGkNVenOGEeSBCjIiWcc6MVOG5HEQv0sA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "regenerate": "^1.4.2",
+        "regenerate-unicode-properties": "^10.2.2",
+        "regjsgen": "^0.8.0",
+        "regjsparser": "^0.13.0",
+        "unicode-match-property-ecmascript": "^2.0.0",
+        "unicode-match-property-value-ecmascript": "^2.2.1"
+      },
+      "engines": {
+        "node": ">=4"
+      }
+    },
+    "node_modules/regjsgen": {
+      "version": "0.8.0",
+      "resolved": "https://registry.npmjs.org/regjsgen/-/regjsgen-0.8.0.tgz",
+      "integrity": "sha512-RvwtGe3d7LvWiDQXeQw8p5asZUmfU1G/l6WbUXeHta7Y2PEIvBTwH6E2EfmYUK8pxcxEdEmaomqyp0vZZ7C+3Q==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/regjsparser": {
+      "version": "0.13.1",
+      "resolved": "https://registry.npmjs.org/regjsparser/-/regjsparser-0.13.1.tgz",
+      "integrity": "sha512-dLsljMd9sqwRkby8zhO1gSg3PnJIBFid8f4CQj/sXx+7cKx+E7u0PKhZ+U4wmhx7EfmtvnA318oVaIkAB1lRJw==",
+      "dev": true,
+      "license": "BSD-2-Clause",
+      "dependencies": {
+        "jsesc": "~3.1.0"
+      },
+      "bin": {
+        "regjsparser": "bin/parser"
+      }
+    },
+    "node_modules/require-from-string": {
+      "version": "2.0.2",
+      "resolved": "https://registry.npmjs.org/require-from-string/-/require-from-string-2.0.2.tgz",
+      "integrity": "sha512-Xf0nWe6RseziFMu+Ap9biiUbmplq6S9/p+7w7YXP/JBHhrUDDUhwa+vANyubuqfZWTveU//DYVGsDG7RKL/vEw==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
+    "node_modules/resolve": {
+      "version": "1.22.12",
+      "resolved": "https://registry.npmjs.org/resolve/-/resolve-1.22.12.tgz",
+      "integrity": "sha512-TyeJ1zif53BPfHootBGwPRYT1RUt6oGWsaQr8UyZW/eAm9bKoijtvruSDEmZHm92CwS9nj7/fWttqPCgzep8CA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "es-errors": "^1.3.0",
+        "is-core-module": "^2.16.1",
+        "path-parse": "^1.0.7",
+        "supports-preserve-symlinks-flag": "^1.0.0"
+      },
+      "bin": {
+        "resolve": "bin/resolve"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/rollup": {
+      "version": "4.59.0",
+      "resolved": "https://registry.npmjs.org/rollup/-/rollup-4.59.0.tgz",
+      "integrity": "sha512-2oMpl67a3zCH9H79LeMcbDhXW/UmWG/y2zuqnF2jQq5uq9TbM9TVyXvA4+t+ne2IIkBdrLpAaRQAvo7YI/Yyeg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@types/estree": "1.0.8"
+      },
+      "bin": {
+        "rollup": "dist/bin/rollup"
+      },
+      "engines": {
+        "node": ">=18.0.0",
+        "npm": ">=8.0.0"
+      },
+      "optionalDependencies": {
+        "@rollup/rollup-android-arm-eabi": "4.59.0",
+        "@rollup/rollup-android-arm64": "4.59.0",
+        "@rollup/rollup-darwin-arm64": "4.59.0",
+        "@rollup/rollup-darwin-x64": "4.59.0",
+        "@rollup/rollup-freebsd-arm64": "4.59.0",
+        "@rollup/rollup-freebsd-x64": "4.59.0",
+        "@rollup/rollup-linux-arm-gnueabihf": "4.59.0",
+        "@rollup/rollup-linux-arm-musleabihf": "4.59.0",
+        "@rollup/rollup-linux-arm64-gnu": "4.59.0",
+        "@rollup/rollup-linux-arm64-musl": "4.59.0",
+        "@rollup/rollup-linux-loong64-gnu": "4.59.0",
+        "@rollup/rollup-linux-loong64-musl": "4.59.0",
+        "@rollup/rollup-linux-ppc64-gnu": "4.59.0",
+        "@rollup/rollup-linux-ppc64-musl": "4.59.0",
+        "@rollup/rollup-linux-riscv64-gnu": "4.59.0",
+        "@rollup/rollup-linux-riscv64-musl": "4.59.0",
+        "@rollup/rollup-linux-s390x-gnu": "4.59.0",
+        "@rollup/rollup-linux-x64-gnu": "4.59.0",
+        "@rollup/rollup-linux-x64-musl": "4.59.0",
+        "@rollup/rollup-openbsd-x64": "4.59.0",
+        "@rollup/rollup-openharmony-arm64": "4.59.0",
+        "@rollup/rollup-win32-arm64-msvc": "4.59.0",
+        "@rollup/rollup-win32-ia32-msvc": "4.59.0",
+        "@rollup/rollup-win32-x64-gnu": "4.59.0",
+        "@rollup/rollup-win32-x64-msvc": "4.59.0",
+        "fsevents": "~2.3.2"
+      }
+    },
+    "node_modules/safe-array-concat": {
+      "version": "1.1.4",
+      "resolved": "https://registry.npmjs.org/safe-array-concat/-/safe-array-concat-1.1.4.tgz",
+      "integrity": "sha512-wtZlHyOje6OZTGqAoaDKxFkgRtkF9CnHAVnCHKfuj200wAgL+bSJhdsCD2l0Qx/2ekEXjPWcyKkfGb5CPboslg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "call-bind": "^1.0.9",
+        "call-bound": "^1.0.4",
+        "get-intrinsic": "^1.3.0",
+        "has-symbols": "^1.1.0",
+        "isarray": "^2.0.5"
+      },
+      "engines": {
+        "node": ">=0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/safe-push-apply": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/safe-push-apply/-/safe-push-apply-1.0.0.tgz",
+      "integrity": "sha512-iKE9w/Z7xCzUMIZqdBsp6pEQvwuEebH4vdpjcDWnyzaI6yl6O9FHvVpmGelvEHNsoY6wGblkxR6Zty/h00WiSA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "es-errors": "^1.3.0",
+        "isarray": "^2.0.5"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/safe-regex-test": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/safe-regex-test/-/safe-regex-test-1.1.0.tgz",
+      "integrity": "sha512-x/+Cz4YrimQxQccJf5mKEbIa1NzeCRNI5Ecl/ekmlYaampdNLPalVyIcCZNNH3MvmqBugV5TMYZXv0ljslUlaw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "call-bound": "^1.0.2",
+        "es-errors": "^1.3.0",
+        "is-regex": "^1.2.1"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/semver": {
+      "version": "6.3.1",
+      "resolved": "https://registry.npmjs.org/semver/-/semver-6.3.1.tgz",
+      "integrity": "sha512-BR7VvDCVHO+q2xBEWskxS6DJE1qRnb7DxzUrogb71CWoSficBxYsiAGd+Kl0mmq/MprG9yArRkyrQxTO6XjMzA==",
+      "dev": true,
+      "license": "ISC",
+      "bin": {
+        "semver": "bin/semver.js"
+      }
+    },
+    "node_modules/serialize-javascript": {
+      "version": "7.0.5",
+      "resolved": "https://registry.npmjs.org/serialize-javascript/-/serialize-javascript-7.0.5.tgz",
+      "integrity": "sha512-F4LcB0UqUl1zErq+1nYEEzSHJnIwb3AF2XWB94b+afhrekOUijwooAYqFyRbjYkm2PAKBabx6oYv/xDxNi8IBw==",
+      "dev": true,
+      "license": "BSD-3-Clause",
+      "engines": {
+        "node": ">=20.0.0"
+      }
+    },
+    "node_modules/set-function-length": {
+      "version": "1.2.2",
+      "resolved": "https://registry.npmjs.org/set-function-length/-/set-function-length-1.2.2.tgz",
+      "integrity": "sha512-pgRc4hJ4/sNjWCSS9AmnS40x3bNMDTknHgL5UaMBTMyJnU90EgWh1Rz+MC9eFu4BuN/UwZjKQuY/1v3rM7HMfg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "define-data-property": "^1.1.4",
+        "es-errors": "^1.3.0",
+        "function-bind": "^1.1.2",
+        "get-intrinsic": "^1.2.4",
+        "gopd": "^1.0.1",
+        "has-property-descriptors": "^1.0.2"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
+    "node_modules/set-function-name": {
+      "version": "2.0.2",
+      "resolved": "https://registry.npmjs.org/set-function-name/-/set-function-name-2.0.2.tgz",
+      "integrity": "sha512-7PGFlmtwsEADb0WYyvCMa1t+yke6daIG4Wirafur5kcf+MhUnPms1UeR0CKQdTZD81yESwMHbtn+TR+dMviakQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "define-data-property": "^1.1.4",
+        "es-errors": "^1.3.0",
+        "functions-have-names": "^1.2.3",
+        "has-property-descriptors": "^1.0.2"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
+    "node_modules/set-proto": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/set-proto/-/set-proto-1.0.0.tgz",
+      "integrity": "sha512-RJRdvCo6IAnPdsvP/7m6bsQqNnn1FCBX5ZNtFL98MmFF/4xAIJTIg1YbHW5DC2W5SKZanrC6i4HsJqlajw/dZw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "dunder-proto": "^1.0.1",
+        "es-errors": "^1.3.0",
+        "es-object-atoms": "^1.0.0"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
+    "node_modules/shebang-command": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/shebang-command/-/shebang-command-2.0.0.tgz",
+      "integrity": "sha512-kHxr2zZpYtdmrN1qDjrrX/Z1rR1kG8Dx+gkpK1G4eXmvXswmcE1hTWBWYUzlraYw1/yZp6YuDY77YtvbN0dmDA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "shebang-regex": "^3.0.0"
+      },
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/shebang-regex": {
+      "version": "3.0.0",
+      "resolved": "https://registry.npmjs.org/shebang-regex/-/shebang-regex-3.0.0.tgz",
+      "integrity": "sha512-7++dFhtcx3353uBaq8DDR4NuxBetBzC7ZQOhmTQInHEd6bSrXdiEyzCvG07Z44UYdLShWUyXt5M/yhz8ekcb1A==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/side-channel": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/side-channel/-/side-channel-1.1.0.tgz",
+      "integrity": "sha512-ZX99e6tRweoUXqR+VBrslhda51Nh5MTQwou5tnUDgbtyM0dBgmhEDtWGP/xbKn6hqfPRHujUNwz5fy/wbbhnpw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "es-errors": "^1.3.0",
+        "object-inspect": "^1.13.3",
+        "side-channel-list": "^1.0.0",
+        "side-channel-map": "^1.0.1",
+        "side-channel-weakmap": "^1.0.2"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/side-channel-list": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/side-channel-list/-/side-channel-list-1.0.1.tgz",
+      "integrity": "sha512-mjn/0bi/oUURjc5Xl7IaWi/OJJJumuoJFQJfDDyO46+hBWsfaVM65TBHq2eoZBhzl9EchxOijpkbRC8SVBQU0w==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "es-errors": "^1.3.0",
+        "object-inspect": "^1.13.4"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/side-channel-map": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/side-channel-map/-/side-channel-map-1.0.1.tgz",
+      "integrity": "sha512-VCjCNfgMsby3tTdo02nbjtM/ewra6jPHmpThenkTYh8pG9ucZ/1P8So4u4FGBek/BjpOVsDCMoLA/iuBKIFXRA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "call-bound": "^1.0.2",
+        "es-errors": "^1.3.0",
+        "get-intrinsic": "^1.2.5",
+        "object-inspect": "^1.13.3"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/side-channel-weakmap": {
+      "version": "1.0.2",
+      "resolved": "https://registry.npmjs.org/side-channel-weakmap/-/side-channel-weakmap-1.0.2.tgz",
+      "integrity": "sha512-WPS/HvHQTYnHisLo9McqBHOJk2FkHO/tlpvldyrnem4aeQp4hai3gythswg6p01oSoTl58rcpiFAjF2br2Ak2A==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "call-bound": "^1.0.2",
+        "es-errors": "^1.3.0",
+        "get-intrinsic": "^1.2.5",
+        "object-inspect": "^1.13.3",
+        "side-channel-map": "^1.0.1"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/signal-exit": {
+      "version": "4.1.0",
+      "resolved": "https://registry.npmjs.org/signal-exit/-/signal-exit-4.1.0.tgz",
+      "integrity": "sha512-bzyZ1e88w9O1iNJbKnOlvYTrWPDl46O1bG0D3XInv+9tkPrxrN8jUUTiFlDkkmKWgn1M6CfIA13SuGqOa9Korw==",
+      "dev": true,
+      "license": "ISC",
+      "engines": {
+        "node": ">=14"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/isaacs"
+      }
+    },
+    "node_modules/smob": {
+      "version": "1.6.2",
+      "resolved": "https://registry.npmjs.org/smob/-/smob-1.6.2.tgz",
+      "integrity": "sha512-RQsvleCbF8cVHEv+xuDGaA4pOizFqJ0GgjtMSRo6oP8pnN7WsigHgVGey6aILRBKv4W2YOMHLqbKdnB6hpB9fw==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=20.0.0"
+      }
+    },
+    "node_modules/source-map": {
+      "version": "0.8.0-beta.0",
+      "resolved": "https://registry.npmjs.org/source-map/-/source-map-0.8.0-beta.0.tgz",
+      "integrity": "sha512-2ymg6oRBpebeZi9UUNsgQ89bhx01TcTkmNTGnNO88imTmbSgy4nfujrgVEFKWpMTEGA11EDkTt7mqObTPdigIA==",
+      "deprecated": "The work that was done in this beta branch won't be included in future versions",
+      "dev": true,
+      "license": "BSD-3-Clause",
+      "dependencies": {
+        "whatwg-url": "^7.0.0"
+      },
+      "engines": {
+        "node": ">= 8"
+      }
+    },
+    "node_modules/source-map-js": {
+      "version": "1.2.1",
+      "resolved": "https://registry.npmjs.org/source-map-js/-/source-map-js-1.2.1.tgz",
+      "integrity": "sha512-UXWMKhLOwVKb728IUtQPXxfYU+usdybtUrK/8uGE8CQMvrhOpwvzDBwj0QhSL7MQc7vIsISBG8VQ8+IDQxpfQA==",
+      "license": "BSD-3-Clause",
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
+    "node_modules/source-map-support": {
+      "version": "0.5.21",
+      "resolved": "https://registry.npmjs.org/source-map-support/-/source-map-support-0.5.21.tgz",
+      "integrity": "sha512-uBHU3L3czsIyYXKX88fdrGovxdSCoTGDRZ6SYXtSRxLZUzHg5P/66Ht6uoUlHu9EZod+inXhKo3qQgwXUT/y1w==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "buffer-from": "^1.0.0",
+        "source-map": "^0.6.0"
+      }
+    },
+    "node_modules/source-map-support/node_modules/source-map": {
+      "version": "0.6.1",
+      "resolved": "https://registry.npmjs.org/source-map/-/source-map-0.6.1.tgz",
+      "integrity": "sha512-UjgapumWlbMhkBgzT7Ykc5YXUT46F0iKu8SGXq0bcwP5dz/h0Plj6enJqjz1Zbq2l5WaqYnrVbwWOWMyF3F47g==",
+      "dev": true,
+      "license": "BSD-3-Clause",
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
+    "node_modules/stop-iteration-iterator": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/stop-iteration-iterator/-/stop-iteration-iterator-1.1.0.tgz",
+      "integrity": "sha512-eLoXW/DHyl62zxY4SCaIgnRhuMr6ri4juEYARS8E6sCEqzKpOiE521Ucofdx+KnDZl5xmvGYaaKCk5FEOxJCoQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "es-errors": "^1.3.0",
+        "internal-slot": "^1.1.0"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
+    "node_modules/string.prototype.matchall": {
+      "version": "4.0.12",
+      "resolved": "https://registry.npmjs.org/string.prototype.matchall/-/string.prototype.matchall-4.0.12.tgz",
+      "integrity": "sha512-6CC9uyBL+/48dYizRf7H7VAYCMCNTBeM78x/VTUe9bFEaxBepPJDa1Ow99LqI/1yF7kuy7Q3cQsYMrcjGUcskA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "call-bind": "^1.0.8",
+        "call-bound": "^1.0.3",
+        "define-properties": "^1.2.1",
+        "es-abstract": "^1.23.6",
+        "es-errors": "^1.3.0",
+        "es-object-atoms": "^1.0.0",
+        "get-intrinsic": "^1.2.6",
+        "gopd": "^1.2.0",
+        "has-symbols": "^1.1.0",
+        "internal-slot": "^1.1.0",
+        "regexp.prototype.flags": "^1.5.3",
+        "set-function-name": "^2.0.2",
+        "side-channel": "^1.1.0"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/string.prototype.trim": {
+      "version": "1.2.10",
+      "resolved": "https://registry.npmjs.org/string.prototype.trim/-/string.prototype.trim-1.2.10.tgz",
+      "integrity": "sha512-Rs66F0P/1kedk5lyYyH9uBzuiI/kNRmwJAR9quK6VOtIpZ2G+hMZd+HQbbv25MgCA6gEffoMZYxlTod4WcdrKA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "call-bind": "^1.0.8",
+        "call-bound": "^1.0.2",
+        "define-data-property": "^1.1.4",
+        "define-properties": "^1.2.1",
+        "es-abstract": "^1.23.5",
+        "es-object-atoms": "^1.0.0",
+        "has-property-descriptors": "^1.0.2"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/string.prototype.trimend": {
+      "version": "1.0.9",
+      "resolved": "https://registry.npmjs.org/string.prototype.trimend/-/string.prototype.trimend-1.0.9.tgz",
+      "integrity": "sha512-G7Ok5C6E/j4SGfyLCloXTrngQIQU3PWtXGst3yM7Bea9FRURf1S42ZHlZZtsNque2FN2PoUhfZXYLNWwEr4dLQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "call-bind": "^1.0.8",
+        "call-bound": "^1.0.2",
+        "define-properties": "^1.2.1",
+        "es-object-atoms": "^1.0.0"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/string.prototype.trimstart": {
+      "version": "1.0.8",
+      "resolved": "https://registry.npmjs.org/string.prototype.trimstart/-/string.prototype.trimstart-1.0.8.tgz",
+      "integrity": "sha512-UXSH262CSZY1tfu3G3Secr6uGLCFVPMhIqHjlgCUtCCcgihYc/xKs9djMTMUOb2j1mVSeU8EU6NWc/iQKU6Gfg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "call-bind": "^1.0.7",
+        "define-properties": "^1.2.1",
+        "es-object-atoms": "^1.0.0"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/stringify-object": {
+      "version": "3.3.0",
+      "resolved": "https://registry.npmjs.org/stringify-object/-/stringify-object-3.3.0.tgz",
+      "integrity": "sha512-rHqiFh1elqCQ9WPLIC8I0Q/g/wj5J1eMkyoiD6eoQApWHP0FtlK7rqnhmabL5VUY9JQCcqwwvlOaSuutekgyrw==",
+      "dev": true,
+      "license": "BSD-2-Clause",
+      "dependencies": {
+        "get-own-enumerable-property-symbols": "^3.0.0",
+        "is-obj": "^1.0.1",
+        "is-regexp": "^1.0.0"
+      },
+      "engines": {
+        "node": ">=4"
+      }
+    },
+    "node_modules/strip-comments": {
+      "version": "2.0.1",
+      "resolved": "https://registry.npmjs.org/strip-comments/-/strip-comments-2.0.1.tgz",
+      "integrity": "sha512-ZprKx+bBLXv067WTCALv8SSz5l2+XhpYCsVtSqlMnkAXMWDq+/ekVbl1ghqP9rUHTzv6sm/DwCOiYutU/yp1fw==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=10"
+      }
+    },
+    "node_modules/supports-preserve-symlinks-flag": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/supports-preserve-symlinks-flag/-/supports-preserve-symlinks-flag-1.0.0.tgz",
+      "integrity": "sha512-ot0WnXS9fgdkgIcePe6RHNk1WA8+muPa6cSjeR3V8K27q9BB1rTE3R1p7Hv0z1ZyAc8s6Vvv8DIyWf681MAt0w==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/temp-dir": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/temp-dir/-/temp-dir-2.0.0.tgz",
+      "integrity": "sha512-aoBAniQmmwtcKp/7BzsH8Cxzv8OL736p7v1ihGb5e9DJ9kTwGWHrQrVB5+lfVDzfGrdRzXch+ig7LHaY1JTOrg==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/tempy": {
+      "version": "0.6.0",
+      "resolved": "https://registry.npmjs.org/tempy/-/tempy-0.6.0.tgz",
+      "integrity": "sha512-G13vtMYPT/J8A4X2SjdtBTphZlrp1gKv6hZiOjw14RCWg6GbHuQBGtjlx75xLbYV/wEc0D7G5K4rxKP/cXk8Bw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "is-stream": "^2.0.0",
+        "temp-dir": "^2.0.0",
+        "type-fest": "^0.16.0",
+        "unique-string": "^2.0.0"
+      },
+      "engines": {
+        "node": ">=10"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/terser": {
+      "version": "5.48.0",
+      "resolved": "https://registry.npmjs.org/terser/-/terser-5.48.0.tgz",
+      "integrity": "sha512-J/9An6vs9Us6wKRriSFXBWdRZapREHqFzdNUKk0pmu804EMR6dr6winwo7e5JDxN4xahxQsuysyYFwlwj4XN/Q==",
+      "dev": true,
+      "license": "BSD-2-Clause",
+      "dependencies": {
+        "@jridgewell/source-map": "^0.3.3",
+        "acorn": "^8.15.0",
+        "commander": "^2.20.0",
+        "source-map-support": "~0.5.20"
+      },
+      "bin": {
+        "terser": "bin/terser"
+      },
+      "engines": {
+        "node": ">=10"
+      }
+    },
+    "node_modules/tinyglobby": {
+      "version": "0.2.15",
+      "resolved": "https://registry.npmjs.org/tinyglobby/-/tinyglobby-0.2.15.tgz",
+      "integrity": "sha512-j2Zq4NyQYG5XMST4cbs02Ak8iJUdxRM0XI5QyxXuZOzKOINmWurp3smXu3y5wDcJrptwpSjgXHzIQxR0omXljQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "fdir": "^6.5.0",
+        "picomatch": "^4.0.3"
+      },
+      "engines": {
+        "node": ">=12.0.0"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/SuperchupuDev"
+      }
+    },
+    "node_modules/tr46": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/tr46/-/tr46-1.0.1.tgz",
+      "integrity": "sha512-dTpowEjclQ7Kgx5SdBkqRzVhERQXov8/l9Ft9dVM9fmg0W0KQSVaXX9T4i6twCPNtYiZM53lpSSUAwJbFPOHxA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "punycode": "^2.1.0"
+      }
+    },
+    "node_modules/type-check": {
+      "version": "0.4.0",
+      "resolved": "https://registry.npmjs.org/type-check/-/type-check-0.4.0.tgz",
+      "integrity": "sha512-XleUoc9uwGXqjWwXaUTZAmzMcFZ5858QA2vvx1Ur5xIcixXIP+8LnFDgRplU30us6teqdlskFfu+ae4K79Ooew==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "prelude-ls": "^1.2.1"
+      },
+      "engines": {
+        "node": ">= 0.8.0"
+      }
+    },
+    "node_modules/type-fest": {
+      "version": "0.16.0",
+      "resolved": "https://registry.npmjs.org/type-fest/-/type-fest-0.16.0.tgz",
+      "integrity": "sha512-eaBzG6MxNzEn9kiwvtre90cXaNLkmadMWa1zQMs3XORCXNbsH/OewwbxC5ia9dCxIxnTAsSxXJaa/p5y8DlvJg==",
+      "dev": true,
+      "license": "(MIT OR CC0-1.0)",
+      "engines": {
+        "node": ">=10"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/typed-array-buffer": {
+      "version": "1.0.3",
+      "resolved": "https://registry.npmjs.org/typed-array-buffer/-/typed-array-buffer-1.0.3.tgz",
+      "integrity": "sha512-nAYYwfY3qnzX30IkA6AQZjVbtK6duGontcQm1WSG1MD94YLqK0515GNApXkoxKOWMusVssAHWLh9SeaoefYFGw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "call-bound": "^1.0.3",
+        "es-errors": "^1.3.0",
+        "is-typed-array": "^1.1.14"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
+    "node_modules/typed-array-byte-length": {
+      "version": "1.0.3",
+      "resolved": "https://registry.npmjs.org/typed-array-byte-length/-/typed-array-byte-length-1.0.3.tgz",
+      "integrity": "sha512-BaXgOuIxz8n8pIq3e7Atg/7s+DpiYrxn4vdot3w9KbnBhcRQq6o3xemQdIfynqSeXeDrF32x+WvfzmOjPiY9lg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "call-bind": "^1.0.8",
+        "for-each": "^0.3.3",
+        "gopd": "^1.2.0",
+        "has-proto": "^1.2.0",
+        "is-typed-array": "^1.1.14"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/typed-array-byte-offset": {
+      "version": "1.0.4",
+      "resolved": "https://registry.npmjs.org/typed-array-byte-offset/-/typed-array-byte-offset-1.0.4.tgz",
+      "integrity": "sha512-bTlAFB/FBYMcuX81gbL4OcpH5PmlFHqlCCpAl8AlEzMz5k53oNDvN8p1PNOWLEmI2x4orp3raOFB51tv9X+MFQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "available-typed-arrays": "^1.0.7",
+        "call-bind": "^1.0.8",
+        "for-each": "^0.3.3",
+        "gopd": "^1.2.0",
+        "has-proto": "^1.2.0",
+        "is-typed-array": "^1.1.15",
+        "reflect.getprototypeof": "^1.0.9"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/typed-array-length": {
+      "version": "1.0.7",
+      "resolved": "https://registry.npmjs.org/typed-array-length/-/typed-array-length-1.0.7.tgz",
+      "integrity": "sha512-3KS2b+kL7fsuk/eJZ7EQdnEmQoaho/r6KUef7hxvltNA5DR8NAUM+8wJMbJyZ4G9/7i3v5zPBIMN5aybAh2/Jg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "call-bind": "^1.0.7",
+        "for-each": "^0.3.3",
+        "gopd": "^1.0.1",
+        "is-typed-array": "^1.1.13",
+        "possible-typed-array-names": "^1.0.0",
+        "reflect.getprototypeof": "^1.0.6"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/unbox-primitive": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/unbox-primitive/-/unbox-primitive-1.1.0.tgz",
+      "integrity": "sha512-nWJ91DjeOkej/TA8pXQ3myruKpKEYgqvpw9lz4OPHj/NWFNluYrjbz9j01CJ8yKQd2g4jFoOkINCTW2I5LEEyw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "call-bound": "^1.0.3",
+        "has-bigints": "^1.0.2",
+        "has-symbols": "^1.1.0",
+        "which-boxed-primitive": "^1.1.1"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/unicode-canonical-property-names-ecmascript": {
+      "version": "2.0.1",
+      "resolved": "https://registry.npmjs.org/unicode-canonical-property-names-ecmascript/-/unicode-canonical-property-names-ecmascript-2.0.1.tgz",
+      "integrity": "sha512-dA8WbNeb2a6oQzAQ55YlT5vQAWGV9WXOsi3SskE3bcCdM0P4SDd+24zS/OCacdRq5BkdsRj9q3Pg6YyQoxIGqg==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=4"
+      }
+    },
+    "node_modules/unicode-match-property-ecmascript": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/unicode-match-property-ecmascript/-/unicode-match-property-ecmascript-2.0.0.tgz",
+      "integrity": "sha512-5kaZCrbp5mmbz5ulBkDkbY0SsPOjKqVS35VpL9ulMPfSl0J0Xsm+9Evphv9CoIZFwre7aJoa94AY6seMKGVN5Q==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "unicode-canonical-property-names-ecmascript": "^2.0.0",
+        "unicode-property-aliases-ecmascript": "^2.0.0"
+      },
+      "engines": {
+        "node": ">=4"
+      }
+    },
+    "node_modules/unicode-match-property-value-ecmascript": {
+      "version": "2.2.1",
+      "resolved": "https://registry.npmjs.org/unicode-match-property-value-ecmascript/-/unicode-match-property-value-ecmascript-2.2.1.tgz",
+      "integrity": "sha512-JQ84qTuMg4nVkx8ga4A16a1epI9H6uTXAknqxkGF/aFfRLw1xC/Bp24HNLaZhHSkWd3+84t8iXnp1J0kYcZHhg==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=4"
+      }
+    },
+    "node_modules/unicode-property-aliases-ecmascript": {
+      "version": "2.2.0",
+      "resolved": "https://registry.npmjs.org/unicode-property-aliases-ecmascript/-/unicode-property-aliases-ecmascript-2.2.0.tgz",
+      "integrity": "sha512-hpbDzxUY9BFwX+UeBnxv3Sh1q7HFxj48DTmXchNgRa46lO8uj3/1iEn3MiNUYTg1g9ctIqXCCERn8gYZhHC5lQ==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=4"
+      }
+    },
+    "node_modules/unique-string": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/unique-string/-/unique-string-2.0.0.tgz",
+      "integrity": "sha512-uNaeirEPvpZWSgzwsPGtU2zVSTrn/8L5q/IexZmH0eH6SA73CmAA5U4GwORTxQAZs95TAXLNqeLoPPNO5gZfWg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "crypto-random-string": "^2.0.0"
+      },
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/universalify": {
+      "version": "2.0.1",
+      "resolved": "https://registry.npmjs.org/universalify/-/universalify-2.0.1.tgz",
+      "integrity": "sha512-gptHNQghINnc/vTGIk0SOFGFNXw7JVrlRUtConJRlvaw6DuX0wO5Jeko9sWrMBhh+PsYAZ7oXAiOnf/UKogyiw==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">= 10.0.0"
+      }
+    },
+    "node_modules/upath": {
+      "version": "1.2.0",
+      "resolved": "https://registry.npmjs.org/upath/-/upath-1.2.0.tgz",
+      "integrity": "sha512-aZwGpamFO61g3OlfT7OQCHqhGnW43ieH9WZeP7QxN/G/jS4jfqUkZxoryvJgVPEcrl5NL/ggHsSmLMHuH64Lhg==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=4",
+        "yarn": "*"
+      }
+    },
+    "node_modules/update-browserslist-db": {
+      "version": "1.2.3",
+      "resolved": "https://registry.npmjs.org/update-browserslist-db/-/update-browserslist-db-1.2.3.tgz",
+      "integrity": "sha512-Js0m9cx+qOgDxo0eMiFGEueWztz+d4+M3rGlmKPT+T4IS/jP4ylw3Nwpu6cpTTP8R1MAC1kF4VbdLt3ARf209w==",
+      "dev": true,
+      "funding": [
+        {
+          "type": "opencollective",
+          "url": "https://opencollective.com/browserslist"
+        },
+        {
+          "type": "tidelift",
+          "url": "https://tidelift.com/funding/github/npm/browserslist"
+        },
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/ai"
+        }
+      ],
+      "license": "MIT",
+      "dependencies": {
+        "escalade": "^3.2.0",
+        "picocolors": "^1.1.1"
+      },
+      "bin": {
+        "update-browserslist-db": "cli.js"
+      },
+      "peerDependencies": {
+        "browserslist": ">= 4.21.0"
+      }
+    },
+    "node_modules/uri-js": {
+      "version": "4.4.1",
+      "resolved": "https://registry.npmjs.org/uri-js/-/uri-js-4.4.1.tgz",
+      "integrity": "sha512-7rKUyy33Q1yc98pQ1DAmLtwX109F7TIfWlW1Ydo8Wl1ii1SeHieeh0HHfPeL2fMXK6z0s8ecKs9frCuLJvndBg==",
+      "dev": true,
+      "license": "BSD-2-Clause",
+      "dependencies": {
+        "punycode": "^2.1.0"
+      }
+    },
+    "node_modules/util-deprecate": {
+      "version": "1.0.2",
+      "resolved": "https://registry.npmjs.org/util-deprecate/-/util-deprecate-1.0.2.tgz",
+      "integrity": "sha512-EPD5q1uXyFxJpCrLnCc1nHnq3gOa6DZBocAIiI2TaSCA7VCJ1UJDMagCzIkXNsUYfD1daK//LTEQ8xiIbrHtcw==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/vite": {
+      "version": "7.3.1",
+      "resolved": "https://registry.npmjs.org/vite/-/vite-7.3.1.tgz",
+      "integrity": "sha512-w+N7Hifpc3gRjZ63vYBXA56dvvRlNWRczTdmCBBa+CotUzAPf5b7YMdMR/8CQoeYE5LX3W4wj6RYTgonm1b9DA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "esbuild": "^0.27.0",
+        "fdir": "^6.5.0",
+        "picomatch": "^4.0.3",
+        "postcss": "^8.5.6",
+        "rollup": "^4.43.0",
+        "tinyglobby": "^0.2.15"
+      },
+      "bin": {
+        "vite": "bin/vite.js"
+      },
+      "engines": {
+        "node": "^20.19.0 || >=22.12.0"
+      },
+      "funding": {
+        "url": "https://github.com/vitejs/vite?sponsor=1"
+      },
+      "optionalDependencies": {
+        "fsevents": "~2.3.3"
+      },
+      "peerDependencies": {
+        "@types/node": "^20.19.0 || >=22.12.0",
+        "jiti": ">=1.21.0",
+        "less": "^4.0.0",
+        "lightningcss": "^1.21.0",
+        "sass": "^1.70.0",
+        "sass-embedded": "^1.70.0",
+        "stylus": ">=0.54.8",
+        "sugarss": "^5.0.0",
+        "terser": "^5.16.0",
+        "tsx": "^4.8.1",
+        "yaml": "^2.4.2"
+      },
+      "peerDependenciesMeta": {
+        "@types/node": {
+          "optional": true
+        },
+        "jiti": {
+          "optional": true
+        },
+        "less": {
+          "optional": true
+        },
+        "lightningcss": {
+          "optional": true
+        },
+        "sass": {
+          "optional": true
+        },
+        "sass-embedded": {
+          "optional": true
+        },
+        "stylus": {
+          "optional": true
+        },
+        "sugarss": {
+          "optional": true
+        },
+        "terser": {
+          "optional": true
+        },
+        "tsx": {
+          "optional": true
+        },
+        "yaml": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/vite-plugin-pwa": {
+      "version": "1.3.0",
+      "resolved": "https://registry.npmjs.org/vite-plugin-pwa/-/vite-plugin-pwa-1.3.0.tgz",
+      "integrity": "sha512-c5kMgN+ITrOtHXp8PAtk2uOIEea6XjP/unCGxOWWBzQ6qa65qj/awHg0wf+QF9E/2u9vh86LqxPwzEPNbM2r5A==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "debug": "^4.3.6",
+        "pretty-bytes": "^6.1.1",
+        "tinyglobby": "^0.2.10",
+        "workbox-build": "^7.4.1",
+        "workbox-window": "^7.4.1"
+      },
+      "engines": {
+        "node": ">=16.0.0"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/antfu"
+      },
+      "peerDependencies": {
+        "@vite-pwa/assets-generator": "^1.0.0",
+        "vite": "^3.1.0 || ^4.0.0 || ^5.0.0 || ^6.0.0 || ^7.0.0 || ^8.0.0",
+        "workbox-build": "^7.4.1",
+        "workbox-window": "^7.4.1"
+      },
+      "peerDependenciesMeta": {
+        "@vite-pwa/assets-generator": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/vue": {
+      "version": "3.5.30",
+      "resolved": "https://registry.npmjs.org/vue/-/vue-3.5.30.tgz",
+      "integrity": "sha512-hTHLc6VNZyzzEH/l7PFGjpcTvUgiaPK5mdLkbjrTeWSRcEfxFrv56g/XckIYlE9ckuobsdwqd5mk2g1sBkMewg==",
+      "license": "MIT",
+      "dependencies": {
+        "@vue/compiler-dom": "3.5.30",
+        "@vue/compiler-sfc": "3.5.30",
+        "@vue/runtime-dom": "3.5.30",
+        "@vue/server-renderer": "3.5.30",
+        "@vue/shared": "3.5.30"
+      },
+      "peerDependencies": {
+        "typescript": "*"
+      },
+      "peerDependenciesMeta": {
+        "typescript": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/vue-chartjs": {
+      "version": "5.3.3",
+      "resolved": "https://registry.npmjs.org/vue-chartjs/-/vue-chartjs-5.3.3.tgz",
+      "integrity": "sha512-jqxtL8KZ6YJ5NTv6XzrzLS7osyegOi28UGNZW0h9OkDL7Sh1396ht4Dorh04aKrl2LiSalQ84WtqiG0RIJb0tA==",
+      "license": "MIT",
+      "peerDependencies": {
+        "chart.js": "^4.1.1",
+        "vue": "^3.0.0-0 || ^2.7.0"
+      }
+    },
+    "node_modules/vue-eslint-parser": {
+      "version": "10.4.1",
+      "resolved": "https://registry.npmjs.org/vue-eslint-parser/-/vue-eslint-parser-10.4.1.tgz",
+      "integrity": "sha512-Gk6gRDj0n/fkRa3C3l0bBheoBckUq/Rs0F/TvMWIS6nzzx67amAViMe9CkNgsP2tXyQONvGiHQESHwFtZ3aYDA==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "debug": "^4.4.0",
+        "eslint-scope": "^8.2.0 || ^9.0.0",
+        "eslint-visitor-keys": "^4.2.0 || ^5.0.0",
+        "espree": "^10.3.0 || ^11.0.0",
+        "esquery": "^1.6.0",
+        "semver": "^7.6.3"
+      },
+      "engines": {
+        "node": "^18.18.0 || ^20.9.0 || >=21.1.0"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/mysticatea"
+      },
+      "peerDependencies": {
+        "eslint": "^8.57.0 || ^9.0.0 || ^10.0.0"
+      }
+    },
+    "node_modules/vue-eslint-parser/node_modules/semver": {
+      "version": "7.8.4",
+      "resolved": "https://registry.npmjs.org/semver/-/semver-7.8.4.tgz",
+      "integrity": "sha512-rUCObTnP32Q08R2uuIrt7r9PlEonuTmtuXYcW6s5kjdlj3xbnwe+21yXptAUYcMAABLkYYTtnmzb3w3EDZfueA==",
+      "dev": true,
+      "license": "ISC",
+      "peer": true,
+      "bin": {
+        "semver": "bin/semver.js"
+      },
+      "engines": {
+        "node": ">=10"
+      }
+    },
+    "node_modules/vue-router": {
+      "version": "4.6.4",
+      "resolved": "https://registry.npmjs.org/vue-router/-/vue-router-4.6.4.tgz",
+      "integrity": "sha512-Hz9q5sa33Yhduglwz6g9skT8OBPii+4bFn88w6J+J4MfEo4KRRpmiNG/hHHkdbRFlLBOqxN8y8gf2Fb0MTUgVg==",
+      "license": "MIT",
+      "dependencies": {
+        "@vue/devtools-api": "^6.6.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/posva"
+      },
+      "peerDependencies": {
+        "vue": "^3.5.0"
+      }
+    },
+    "node_modules/webidl-conversions": {
+      "version": "4.0.2",
+      "resolved": "https://registry.npmjs.org/webidl-conversions/-/webidl-conversions-4.0.2.tgz",
+      "integrity": "sha512-YQ+BmxuTgd6UXZW3+ICGfyqRyHXVlD5GtQr5+qjiNW7bF0cqrzX500HVXPBOvgXb5YnzDd+h0zqyv61KUD7+Sg==",
+      "dev": true,
+      "license": "BSD-2-Clause"
+    },
+    "node_modules/whatwg-url": {
+      "version": "7.1.0",
+      "resolved": "https://registry.npmjs.org/whatwg-url/-/whatwg-url-7.1.0.tgz",
+      "integrity": "sha512-WUu7Rg1DroM7oQvGWfOiAK21n74Gg+T4elXEQYkOhtyLeWiJFoOGLXPKI/9gzIie9CtwVLm8wtw6YJdKyxSjeg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "lodash.sortby": "^4.7.0",
+        "tr46": "^1.0.1",
+        "webidl-conversions": "^4.0.2"
+      }
+    },
+    "node_modules/which": {
+      "version": "2.0.2",
+      "resolved": "https://registry.npmjs.org/which/-/which-2.0.2.tgz",
+      "integrity": "sha512-BLI3Tl1TW3Pvl70l3yq3Y64i+awpwXqsGBYWkkqMtnbXgrMD+yj7rhW0kuEDxzJaYXGjEW5ogapKNMEKNMjibA==",
+      "dev": true,
+      "license": "ISC",
+      "dependencies": {
+        "isexe": "^2.0.0"
+      },
+      "bin": {
+        "node-which": "bin/node-which"
+      },
+      "engines": {
+        "node": ">= 8"
+      }
+    },
+    "node_modules/which-boxed-primitive": {
+      "version": "1.1.1",
+      "resolved": "https://registry.npmjs.org/which-boxed-primitive/-/which-boxed-primitive-1.1.1.tgz",
+      "integrity": "sha512-TbX3mj8n0odCBFVlY8AxkqcHASw3L60jIuF8jFP78az3C2YhmGvqbHBpAjTRH2/xqYunrJ9g1jSyjCjpoWzIAA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "is-bigint": "^1.1.0",
+        "is-boolean-object": "^1.2.1",
+        "is-number-object": "^1.1.1",
+        "is-string": "^1.1.1",
+        "is-symbol": "^1.1.1"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/which-builtin-type": {
+      "version": "1.2.1",
+      "resolved": "https://registry.npmjs.org/which-builtin-type/-/which-builtin-type-1.2.1.tgz",
+      "integrity": "sha512-6iBczoX+kDQ7a3+YJBnh3T+KZRxM/iYNPXicqk66/Qfm1b93iu+yOImkg0zHbj5LNOcNv1TEADiZ0xa34B4q6Q==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "call-bound": "^1.0.2",
+        "function.prototype.name": "^1.1.6",
+        "has-tostringtag": "^1.0.2",
+        "is-async-function": "^2.0.0",
+        "is-date-object": "^1.1.0",
+        "is-finalizationregistry": "^1.1.0",
+        "is-generator-function": "^1.0.10",
+        "is-regex": "^1.2.1",
+        "is-weakref": "^1.0.2",
+        "isarray": "^2.0.5",
+        "which-boxed-primitive": "^1.1.0",
+        "which-collection": "^1.0.2",
+        "which-typed-array": "^1.1.16"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/which-collection": {
+      "version": "1.0.2",
+      "resolved": "https://registry.npmjs.org/which-collection/-/which-collection-1.0.2.tgz",
+      "integrity": "sha512-K4jVyjnBdgvc86Y6BkaLZEN933SwYOuBFkdmBu9ZfkcAbdVbpITnDmjvZ/aQjRXQrv5EPkTnD1s39GiiqbngCw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "is-map": "^2.0.3",
+        "is-set": "^2.0.3",
+        "is-weakmap": "^2.0.2",
+        "is-weakset": "^2.0.3"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/which-typed-array": {
+      "version": "1.1.20",
+      "resolved": "https://registry.npmjs.org/which-typed-array/-/which-typed-array-1.1.20.tgz",
+      "integrity": "sha512-LYfpUkmqwl0h9A2HL09Mms427Q1RZWuOHsukfVcKRq9q95iQxdw0ix1JQrqbcDR9PH1QDwf5Qo8OZb5lksZ8Xg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "available-typed-arrays": "^1.0.7",
+        "call-bind": "^1.0.8",
+        "call-bound": "^1.0.4",
+        "for-each": "^0.3.5",
+        "get-proto": "^1.0.1",
+        "gopd": "^1.2.0",
+        "has-tostringtag": "^1.0.2"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/word-wrap": {
+      "version": "1.2.5",
+      "resolved": "https://registry.npmjs.org/word-wrap/-/word-wrap-1.2.5.tgz",
+      "integrity": "sha512-BN22B5eaMMI9UMtjrGd5g5eCYPpCPDUy0FJXbYsaT5zYxjFOckS53SQDE3pWkVoWpHXVb3BrYcEN4Twa55B5cA==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
+    "node_modules/workbox-background-sync": {
+      "version": "7.4.1",
+      "resolved": "https://registry.npmjs.org/workbox-background-sync/-/workbox-background-sync-7.4.1.tgz",
+      "integrity": "sha512-HhT7KE8tOWDm02wRNshXUnUPofMlhenF2DBdUnDPOubhizzPeItkYTmAB6td1Z2cjYPa98vzEiPLEuzn5hN66g==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "idb": "^7.0.1",
+        "workbox-core": "7.4.1"
+      }
+    },
+    "node_modules/workbox-broadcast-update": {
+      "version": "7.4.1",
+      "resolved": "https://registry.npmjs.org/workbox-broadcast-update/-/workbox-broadcast-update-7.4.1.tgz",
+      "integrity": "sha512-uAlgslKLvbQY+suirIdnBCSYrcgBhjp81Nj4l1lj/Jmj0MJO2CJERnCJjT0GFVwmReV0N+zs78K6gqd5gr9/+A==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "workbox-core": "7.4.1"
+      }
+    },
+    "node_modules/workbox-build": {
+      "version": "7.4.1",
+      "resolved": "https://registry.npmjs.org/workbox-build/-/workbox-build-7.4.1.tgz",
+      "integrity": "sha512-SDhxIvEAde9Gy/5w4Yo1Jh/M49Z0qE3q0oteyE8zGq0DScxFqVBcCtIXFuLtmtxRQZCMbf0prco4VyEu3KBQuw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@apideck/better-ajv-errors": "^0.3.1",
+        "@babel/core": "^7.24.4",
+        "@babel/preset-env": "^7.11.0",
+        "@babel/runtime": "^7.11.2",
+        "@rollup/plugin-babel": "^6.1.0",
+        "@rollup/plugin-node-resolve": "^16.0.3",
+        "@rollup/plugin-replace": "^6.0.3",
+        "@rollup/plugin-terser": "^1.0.0",
+        "@trickfilm400/rollup-plugin-off-main-thread": "^3.0.0-pre1",
+        "ajv": "^8.6.0",
+        "common-tags": "^1.8.0",
+        "eta": "^4.5.1",
+        "fast-json-stable-stringify": "^2.1.0",
+        "fs-extra": "^9.0.1",
+        "glob": "^11.0.1",
+        "pretty-bytes": "^5.3.0",
+        "rollup": "^4.53.3",
+        "source-map": "^0.8.0-beta.0",
+        "stringify-object": "^3.3.0",
+        "strip-comments": "^2.0.1",
+        "tempy": "^0.6.0",
+        "upath": "^1.2.0",
+        "workbox-background-sync": "7.4.1",
+        "workbox-broadcast-update": "7.4.1",
+        "workbox-cacheable-response": "7.4.1",
+        "workbox-core": "7.4.1",
+        "workbox-expiration": "7.4.1",
+        "workbox-google-analytics": "7.4.1",
+        "workbox-navigation-preload": "7.4.1",
+        "workbox-precaching": "7.4.1",
+        "workbox-range-requests": "7.4.1",
+        "workbox-recipes": "7.4.1",
+        "workbox-routing": "7.4.1",
+        "workbox-strategies": "7.4.1",
+        "workbox-streams": "7.4.1",
+        "workbox-sw": "7.4.1",
+        "workbox-window": "7.4.1"
+      },
+      "engines": {
+        "node": ">=20.0.0"
+      }
+    },
+    "node_modules/workbox-build/node_modules/pretty-bytes": {
+      "version": "5.6.0",
+      "resolved": "https://registry.npmjs.org/pretty-bytes/-/pretty-bytes-5.6.0.tgz",
+      "integrity": "sha512-FFw039TmrBqFK8ma/7OL3sDz/VytdtJr044/QUJtH0wK9lb9jLq9tJyIxUwtQJHwar2BqtiA4iCWSwo9JLkzFg==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=6"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/workbox-cacheable-response": {
+      "version": "7.4.1",
+      "resolved": "https://registry.npmjs.org/workbox-cacheable-response/-/workbox-cacheable-response-7.4.1.tgz",
+      "integrity": "sha512-8xaFoJdDc2OjrlbbL3gEeBO1WKcMwRqwLRupgqahYXu75yXajPLuwrbXMrIGZuWYXrQwk0xDjOxZ/ujCy/oJYw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "workbox-core": "7.4.1"
+      }
+    },
+    "node_modules/workbox-core": {
+      "version": "7.4.1",
+      "resolved": "https://registry.npmjs.org/workbox-core/-/workbox-core-7.4.1.tgz",
+      "integrity": "sha512-DT+vu46eh/2vRsSHTY4Xmc32Z1rr9PRlQUXr1Dx30ZuXRWwOsvZgGgcwxcasubQLQmbTNYZjv44LkBAQ4tT5tQ==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/workbox-expiration": {
+      "version": "7.4.1",
+      "resolved": "https://registry.npmjs.org/workbox-expiration/-/workbox-expiration-7.4.1.tgz",
+      "integrity": "sha512-lRKUF7b+OGbeXkQk1s6MHXOa3d7Xxf7Of31W6c6hCfipfIyrtdWZ89stq21AHZMaoG7VNFoHply4Ox+rU31TWg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "idb": "^7.0.1",
+        "workbox-core": "7.4.1"
+      }
+    },
+    "node_modules/workbox-google-analytics": {
+      "version": "7.4.1",
+      "resolved": "https://registry.npmjs.org/workbox-google-analytics/-/workbox-google-analytics-7.4.1.tgz",
+      "integrity": "sha512-Mks1JwLEt++ZAkF6sS1OpSh9RtAMIsiDgRpK+codiHGIPXeaUOgi4cPc3GFadUl8V5QPeypEk8Oxgl3HlwVzHw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "workbox-background-sync": "7.4.1",
+        "workbox-core": "7.4.1",
+        "workbox-routing": "7.4.1",
+        "workbox-strategies": "7.4.1"
+      }
+    },
+    "node_modules/workbox-navigation-preload": {
+      "version": "7.4.1",
+      "resolved": "https://registry.npmjs.org/workbox-navigation-preload/-/workbox-navigation-preload-7.4.1.tgz",
+      "integrity": "sha512-C4KVsjPcYKJOhr631AxR9XoG2rLF3QiTk5aMv36MXOjtWvm8axwNFAtKUPGsWUwLXXAMgYM1En7fsvndaXeXRQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "workbox-core": "7.4.1"
+      }
+    },
+    "node_modules/workbox-precaching": {
+      "version": "7.4.1",
+      "resolved": "https://registry.npmjs.org/workbox-precaching/-/workbox-precaching-7.4.1.tgz",
+      "integrity": "sha512-cdr/9qByww7yzEp7zg/qI4ukUrrNjQLgN+ONQRpjy/VqGQXwkgHwr00KksGJK8v0VifwDXBb8a4cWNZH71jn3Q==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "workbox-core": "7.4.1",
+        "workbox-routing": "7.4.1",
+        "workbox-strategies": "7.4.1"
+      }
+    },
+    "node_modules/workbox-range-requests": {
+      "version": "7.4.1",
+      "resolved": "https://registry.npmjs.org/workbox-range-requests/-/workbox-range-requests-7.4.1.tgz",
+      "integrity": "sha512-7i2oxAUE82gHdAJBCAQ04JzNOdRPqzuOzGfoUyJpFSmeqBNYGPrAH8GPoPjUQTfp+NycwrD2H68VtuF8qxv0vQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "workbox-core": "7.4.1"
+      }
+    },
+    "node_modules/workbox-recipes": {
+      "version": "7.4.1",
+      "resolved": "https://registry.npmjs.org/workbox-recipes/-/workbox-recipes-7.4.1.tgz",
+      "integrity": "sha512-gnbVfmV4/TtmQaM4x9AtuXhcdstJsep3XMVeztOrQVPT+R6+6DeBjGTCQ7fFCXm+4GEHUA5VEBTyi5+4gWGeog==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "workbox-cacheable-response": "7.4.1",
+        "workbox-core": "7.4.1",
+        "workbox-expiration": "7.4.1",
+        "workbox-precaching": "7.4.1",
+        "workbox-routing": "7.4.1",
+        "workbox-strategies": "7.4.1"
+      }
+    },
+    "node_modules/workbox-routing": {
+      "version": "7.4.1",
+      "resolved": "https://registry.npmjs.org/workbox-routing/-/workbox-routing-7.4.1.tgz",
+      "integrity": "sha512-yubJGErZOusuidAenaL5ypfhQOa7urxP/f8E0ws7FPb4039RiWXUWBAyUkmUoOL/BcQGen3h0J8872d51IYxtA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "workbox-core": "7.4.1"
+      }
+    },
+    "node_modules/workbox-strategies": {
+      "version": "7.4.1",
+      "resolved": "https://registry.npmjs.org/workbox-strategies/-/workbox-strategies-7.4.1.tgz",
+      "integrity": "sha512-GZxpaw9NbmOelj7667uZ2kpk5BFpOGbO4X0qjwh5ls8XQ8C+Lha5LQchTiUzsTFSS+NlUpftYAyOVXvQUrcqOQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "workbox-core": "7.4.1"
+      }
+    },
+    "node_modules/workbox-streams": {
+      "version": "7.4.1",
+      "resolved": "https://registry.npmjs.org/workbox-streams/-/workbox-streams-7.4.1.tgz",
+      "integrity": "sha512-HWWtraKUbJknd9kgqGcpQ3G114HOPYvqs8HaJMDs2ebLNAimDkVDaWfAXE6Ybl+m8U6KsCE6pWyLYuigWmnAXw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "workbox-core": "7.4.1",
+        "workbox-routing": "7.4.1"
+      }
+    },
+    "node_modules/workbox-sw": {
+      "version": "7.4.1",
+      "resolved": "https://registry.npmjs.org/workbox-sw/-/workbox-sw-7.4.1.tgz",
+      "integrity": "sha512-fez5f2DUlDJWTFYkCWQpY10N8gtztd849NswCbVFk0QlcSM4HT5A8x4g4ii650yem4I8tHY0R7JZahwp3ltIPw==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/workbox-window": {
+      "version": "7.4.1",
+      "resolved": "https://registry.npmjs.org/workbox-window/-/workbox-window-7.4.1.tgz",
+      "integrity": "sha512-notZDH2u8VXaqyuD7xaqIfEFi6SRM4SUSd7ewe9PDsVqADuepxX2ZMY3uvuZGxzY5ZOsGC/vD3A/3smFtJt4/A==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@types/trusted-types": "^2.0.2",
+        "workbox-core": "7.4.1"
+      }
+    },
+    "node_modules/xml-name-validator": {
+      "version": "4.0.0",
+      "resolved": "https://registry.npmjs.org/xml-name-validator/-/xml-name-validator-4.0.0.tgz",
+      "integrity": "sha512-ICP2e+jsHvAj2E2lIHxa5tjXRlKDJo4IdvPvCXbXQGdzSfmSpNVyIKMvoZHjDY9DP0zV17iI85o90vRFXNccRw==",
+      "dev": true,
+      "license": "Apache-2.0",
+      "engines": {
+        "node": ">=12"
+      }
+    },
+    "node_modules/yallist": {
+      "version": "3.1.1",
+      "resolved": "https://registry.npmjs.org/yallist/-/yallist-3.1.1.tgz",
+      "integrity": "sha512-a4UGQaWPH59mOXUYnAG2ewncQS4i4F43Tv3JoAM+s2VDAmS9NsK8GpDMLrCHPksFT7h3K6TOoUNn2pb7RoXx4g==",
+      "dev": true,
+      "license": "ISC"
+    },
+    "node_modules/yocto-queue": {
+      "version": "0.1.0",
+      "resolved": "https://registry.npmjs.org/yocto-queue/-/yocto-queue-0.1.0.tgz",
+      "integrity": "sha512-rVksvsnNCdJ/ohGc6xgPwyN8eheCxsiLM8mxuE/t/mOVqJewPuO1miLpTHQiRgTKCLexL4MeAFVagts7HmNZ2Q==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=10"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    }
+  }
+}
diff --git a/package.json b/package.json
new file mode 100644
index 0000000..7b28ab6
--- /dev/null
+++ b/package.json
@@ -0,0 +1,45 @@
+{
+  "name": "trainus",
+  "private": true,
+  "version": "1.0.0",
+  "type": "module",
+  "scripts": {
+    "dev": "vite",
+    "build": "vite build",
+    "preview": "vite preview",
+    "format": "prettier --write .",
+    "format:check": "prettier --check .",
+    "lint": "eslint src",
+    "lint:fix": "eslint src --fix",
+    "test": "cd tests && .venv/bin/python -m pytest --browser firefox -v",
+    "test:chromium": "cd tests && .venv/bin/python -m pytest --browser chromium -v",
+    "test:parallel": "cd tests && .venv/bin/python -m pytest --browser firefox --browser chromium --dist loadfile -n auto -v",
+    "test:parallel:firefox": "cd tests && .venv/bin/python -m pytest --browser firefox --dist loadfile -n auto -v",
+    "test:parallel:chromium": "cd tests && .venv/bin/python -m pytest --browser chromium --dist loadfile -n auto -v",
+    "test:parallel:n": "cd tests && .venv/bin/python -m pytest --browser firefox --browser chromium --dist loadfile -n ${WORKERS:-4} -v",
+    "site:dev": "cd website && hugo server --buildDrafts --port 1313",
+    "site:build": "cd website && hugo --minify"
+  },
+  "dependencies": {
+    "@sqlite.org/sqlite-wasm": "^3.51.2-build7",
+    "bootstrap-icons": "^1.13.1",
+    "chart.js": "^4.5.1",
+    "dompurify": "^3.4.7",
+    "i18next": "^25.8.17",
+    "i18next-vue": "^5.4.0",
+    "marked": "^18.0.4",
+    "vue": "^3.5.25",
+    "vue-chartjs": "^5.3.3",
+    "vue-router": "^4.6.4"
+  },
+  "devDependencies": {
+    "@eslint/js": "^10.0.1",
+    "@vitejs/plugin-vue": "^6.0.2",
+    "eslint": "^10.5.0",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-plugin-vue": "^10.9.2",
+    "prettier": "^3.8.1",
+    "vite": "^7.3.1",
+    "vite-plugin-pwa": "^1.3.0"
+  }
+}
diff --git a/public/icon-192.png b/public/icon-192.png
new file mode 100644
index 0000000..fbe09e5
Binary files /dev/null and b/public/icon-192.png differ
diff --git a/public/icon-512.png b/public/icon-512.png
new file mode 100644
index 0000000..806c65d
Binary files /dev/null and b/public/icon-512.png differ
diff --git a/public/icon.svg b/public/icon.svg
new file mode 100644
index 0000000..9812483
--- /dev/null
+++ b/public/icon.svg
@@ -0,0 +1,10 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
+  <defs>
+    <linearGradient id="bg" x1="0%" y1="0%" x2="100%" y2="100%">
+      <stop offset="0%" stop-color="#1E7FC0"/>
+      <stop offset="100%" stop-color="#12A892"/>
+    </linearGradient>
+  </defs>
+  <rect width="512" height="512" rx="112" fill="url(#bg)"/>
+  <path d="m256 28-32 128c-32-16-64-48-96-96 0 48 0 96 32 128-32 17-64 0-96-32 0 32 0 80 48 112-32 16-64 0-80-32 0 48 16 96 48 128-16 16-48 0-64-16 0 64 48 112 112 144h76.8l16.7-68.6-17.2-86.1-97.9 5s20.3-75.2 34.9-103.7c5-9.6 7.2-18 20-18.3 11.3 0 20.4 9.8 20.4 21.9 0 12-9.1 21.8-20.4 21.8-2.3 0-4.6-.5-6.6-1.3l-5.1 46.8c29.6-8.9 56.9-18.8 84-30.9 0-.1-.1-.2-.1-.3-6.2-8.8-10.4-21.5-10.4-35.7 0-14.1 4.1-26.8 10.4-35.7 6.1-8.9 14.1-13.7 22.5-13.7 8.5 0 16.5 4.8 22.6 13.7 6.2 8.9 10.2 21.6 10.2 35.7 0 14.2-4 26.9-10.2 35.7-.1.3-.5.7-.6.9 27.3 12.1 56.1 20.6 84.3 30.3l-5-46.8c-2.2.8-4.3 1.3-6.7 1.3-11.2 0-20.3-9.8-20.3-21.8 0-12.1 9.1-21.9 20.3-21.9 12.8.3 15.2 8.7 20 18.3 14.8 28.5 35 103.7 35 103.7l-97.9-5-17.2 86.1 16.7 68.6H384c64-32 112-80 112-144-16 16-48 32-64 16 32-32 48-80 48-128-16 32-48 48-80 32 48-32 48-80 48-112-32 32-64 48-96 32 32-32 32-80 32-128-32 48-64 80-96 96z" fill="#fff" fill-opacity="0.92"/>
+</svg>
diff --git a/public/manifest.json b/public/manifest.json
new file mode 100644
index 0000000..acc1e15
--- /dev/null
+++ b/public/manifest.json
@@ -0,0 +1,25 @@
+{
+  "name": "TrainUs",
+  "short_name": "TrainUs",
+  "description": "Local-first fitness training app",
+  "lang": "en",
+  "start_url": "./",
+  "scope": "./",
+  "display": "standalone",
+  "background_color": "#1a1a1a",
+  "theme_color": "#1a1a1a",
+  "icons": [
+    {
+      "src": "./icon-192.png",
+      "sizes": "192x192",
+      "type": "image/png",
+      "purpose": "any"
+    },
+    {
+      "src": "./icon-512.png",
+      "sizes": "512x512",
+      "type": "image/png",
+      "purpose": "maskable"
+    }
+  ]
+}
diff --git a/public/mighty-force.svg b/public/mighty-force.svg
new file mode 100644
index 0000000..9f19c48
--- /dev/null
+++ b/public/mighty-force.svg
@@ -0,0 +1 @@
+<svg style="height: 512px; width: 512px;" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512"><path d="M0 0h512v512H0z" fill="#000" fill-opacity="1"></path><g class="" style="" transform="translate(0,0)"><path d="m256 28-32 128c-32-16-64-48-96-96 0 48 0 96 32 128-32 17-64 0-96-32 0 32 0 80 48 112-32 16-64 0-80-32 0 48 16 96 48 128-16 16-48 0-64-16 0 64 48 112 112 144h76.8l16.7-68.6-17.2-86.1-97.9 5s20.3-75.2 34.9-103.7c5-9.6 7.2-18 20-18.3 11.3 0 20.4 9.8 20.4 21.9 0 12-9.1 21.8-20.4 21.8-2.3 0-4.6-.5-6.6-1.3l-5.1 46.8c29.6-8.9 56.9-18.8 84-30.9 0-.1-.1-.2-.1-.3-6.2-8.8-10.4-21.5-10.4-35.7 0-14.1 4.1-26.8 10.4-35.7 6.1-8.9 14.1-13.7 22.5-13.7 8.5 0 16.5 4.8 22.6 13.7 6.2 8.9 10.2 21.6 10.2 35.7 0 14.2-4 26.9-10.2 35.7-.1.3-.5.7-.6.9 27.3 12.1 56.1 20.6 84.3 30.3l-5-46.8c-2.2.8-4.3 1.3-6.7 1.3-11.2 0-20.3-9.8-20.3-21.8 0-12.1 9.1-21.9 20.3-21.9 12.8.3 15.2 8.7 20 18.3 14.8 28.5 35 103.7 35 103.7l-97.9-5-17.2 86.1 16.7 68.6H384c64-32 112-80 112-144-16 16-48 32-64 16 32-32 48-80 48-128-16 32-48 48-80 32 48-32 48-80 48-112-32 32-64 48-96 32 32-32 32-80 32-128-32 48-64 80-96 96z" fill="#fff" fill-opacity="1"></path></g></svg>
\ No newline at end of file
diff --git a/scripts/release.sh b/scripts/release.sh
new file mode 100755
index 0000000..ec0ed8f
--- /dev/null
+++ b/scripts/release.sh
@@ -0,0 +1,234 @@
+#!/usr/bin/env bash
+# TrainUs release script — local steps only.
+# Prepares a release commit, tag, source archive, and a draft release notes file.
+# Everything that touches Forgejo or a remote server is left to you (see checklist at the end).
+# Usage: ./scripts/release.sh
+set -euo pipefail
+
+GREEN='\033[0;32m'; YELLOW='\033[1;33m'; CYAN='\033[0;36m'; BOLD='\033[1m'; NC='\033[0m'
+RED='\033[0;31m'; DIM='\033[2m'
+info()  { echo -e "  ${GREEN}✓${NC} $*"; }
+doing() { echo -e "\n${CYAN}▶${NC} $*"; }
+warn()  { echo -e "  ${YELLOW}⚠${NC} $*"; }
+error() { echo -e "\n${RED}✗ Error:${NC} $*" >&2; exit 1; }
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+ROOT_DIR="$(cd "$SCRIPT_DIR/.." && pwd)"
+cd "$ROOT_DIR"
+
+# ── Prerequisites ─────────────────────────────────────────────────────────────
+echo ""
+echo -e "${BOLD}Checking prerequisites...${NC}"
+
+command -v npm >/dev/null 2>&1 || error "npm is not installed."
+command -v git >/dev/null 2>&1 || error "git is not installed."
+info "npm and git are available."
+
+if [[ -n "$(git status --porcelain)" ]]; then
+  error "Working tree is not clean. Commit or stash your changes before releasing."
+fi
+info "Working tree is clean."
+
+CURRENT_BRANCH=$(git rev-parse --abbrev-ref HEAD)
+if [[ "$CURRENT_BRANCH" != "main" ]]; then
+  warn "Current branch is '$CURRENT_BRANCH', not 'main'."
+fi
+info "On branch: $CURRENT_BRANCH"
+
+# ── Commits since last release ────────────────────────────────────────────────
+echo ""
+echo -e "${BOLD}Changes since last release${NC}"
+
+LAST_TAG=$(git describe --tags --abbrev=0 HEAD 2>/dev/null || echo "")
+
+if [[ -n "$LAST_TAG" ]]; then
+  echo "  Last release: $LAST_TAG"
+  echo "  Commits since $LAST_TAG:"
+  echo ""
+  COMMIT_LOG=$(git log "${LAST_TAG}..HEAD" --oneline --no-merges)
+else
+  warn "No previous tag found — listing all commits."
+  echo ""
+  COMMIT_LOG=$(git log --oneline --no-merges)
+fi
+
+if [[ -z "$COMMIT_LOG" ]]; then
+  warn "No commits since $LAST_TAG. Are you sure you want to release?"
+else
+  while IFS= read -r line; do
+    echo -e "  ${DIM}${line}${NC}"
+  done <<< "$COMMIT_LOG"
+fi
+
+echo ""
+
+# ── Version ───────────────────────────────────────────────────────────────────
+echo -e "${BOLD}Version${NC}"
+CURRENT_VERSION=$(node -p "require('./package.json').version")
+echo "  Current version: $CURRENT_VERSION"
+echo -n "  New version (semver, e.g. 1.1.0): "
+read -r VERSION
+
+[[ "$VERSION" =~ ^[0-9]+\.[0-9]+\.[0-9]+$ ]] \
+  || error "Invalid format. Use MAJOR.MINOR.PATCH without a 'v' prefix."
+
+TAG="v$VERSION"
+ARCHIVE="trainus-${TAG}-src.zip"
+NOTES_FILE="trainus-${TAG}-notes.md"
+
+git tag --list | grep -q "^${TAG}$" \
+  && error "Tag $TAG already exists locally."
+
+# ── Plan ──────────────────────────────────────────────────────────────────────
+echo ""
+echo -e "${BOLD}The script will perform the following steps in order:${NC}"
+echo ""
+echo "  1. Bump version in package.json and package-lock.json"
+echo "       $CURRENT_VERSION  →  $VERSION"
+echo ""
+echo "  2. Build the production app"
+echo "       npm run build  →  dist/"
+echo ""
+echo "  3. Create a release commit on branch '$CURRENT_BRANCH'"
+echo "       git commit -m \"chore: release $TAG\""
+echo ""
+echo "  4. Create an annotated git tag (local only, not pushed)"
+echo "       git tag -a $TAG -m \"Release $TAG\""
+echo ""
+echo "  5. Create a source archive of the current commit"
+echo "       $ARCHIVE  (tracked files only, no node_modules, no dist)"
+echo ""
+echo "  6. Generate a draft release notes file for you to edit"
+echo "       $NOTES_FILE  (pre-filled with the commit list above)"
+echo ""
+echo -e "${YELLOW}Nothing will be pushed or sent anywhere. All steps are local.${NC}"
+echo ""
+echo -n "  Continue? [y/N] "
+read -r CONFIRM
+[[ "$CONFIRM" =~ ^[Yy]$ ]] || { echo "  Aborted."; exit 0; }
+
+# ── Step 1 — Bump version ─────────────────────────────────────────────────────
+doing "Step 1/6 — Bumping version in package.json and package-lock.json"
+echo "  Running: npm version $VERSION --no-git-tag-version"
+npm version "$VERSION" --no-git-tag-version --silent
+info "package.json and package-lock.json updated to $VERSION."
+
+# ── Step 2 — Build ────────────────────────────────────────────────────────────
+doing "Step 2/6 — Building the production app"
+echo "  Running: npm run build"
+npm run build
+info "Build complete. Output is in dist/."
+
+# ── Step 3 — Commit ───────────────────────────────────────────────────────────
+doing "Step 3/6 — Creating release commit"
+echo "  Running: git add package.json package-lock.json"
+echo "           git commit -m \"chore: release $TAG\""
+git add package.json package-lock.json
+git commit -m "chore: release $TAG"
+info "Commit created: chore: release $TAG"
+
+# ── Step 4 — Tag ──────────────────────────────────────────────────────────────
+doing "Step 4/6 — Creating annotated git tag"
+echo "  Running: git tag -a $TAG -m \"Release $TAG\""
+git tag -a "$TAG" -m "Release $TAG"
+info "Tag $TAG created locally."
+
+# ── Step 5 — Archive ──────────────────────────────────────────────────────────
+doing "Step 5/6 — Creating source archive"
+echo "  Running: git archive --format=zip HEAD --output=$ARCHIVE"
+git archive --format=zip HEAD --output="$ARCHIVE"
+info "Archive created: $ARCHIVE"
+echo "  Contains: all files tracked by git at commit $(git rev-parse --short HEAD)."
+echo "  Excludes: node_modules/, dist/, .git/, and any untracked files."
+
+# ── Step 6 — Release notes file ───────────────────────────────────────────────
+doing "Step 6/6 — Generating draft release notes"
+echo "  Writing: $NOTES_FILE"
+
+if [[ -n "$LAST_TAG" ]]; then
+  RANGE_LABEL="since $LAST_TAG"
+else
+  RANGE_LABEL="(no previous tag — all commits)"
+fi
+
+{
+  echo "# TrainUs $TAG — Release notes"
+  echo ""
+  echo "<!-- Edit this file before pasting into Forgejo. Delete comments. -->"
+  echo ""
+  echo "## What's new"
+  echo ""
+  echo "<!-- Describe new features. -->"
+  echo ""
+  echo "-"
+  echo ""
+  echo "## Bug fixes"
+  echo ""
+  echo "<!-- List bug fixes, or remove this section if none. -->"
+  echo ""
+  echo "-"
+  echo ""
+  echo "## Breaking changes"
+  echo ""
+  echo "None."
+  echo ""
+  echo "---"
+  echo ""
+  echo "## Commits $RANGE_LABEL"
+  echo ""
+  echo "<!-- For reference — trim or reword before publishing. -->"
+  echo ""
+  if [[ -n "$COMMIT_LOG" ]]; then
+    while IFS= read -r line; do
+      echo "- $line"
+    done <<< "$COMMIT_LOG"
+  else
+    echo "- (none)"
+  fi
+} > "$NOTES_FILE"
+
+info "Draft release notes written to $NOTES_FILE."
+echo "  Open it in your editor, rewrite the notes, then paste into Forgejo."
+
+# ── Done — Manual checklist ───────────────────────────────────────────────────
+echo ""
+echo -e "${GREEN}${BOLD}Local release steps complete.${NC}"
+echo ""
+echo -e "${BOLD}Artifacts created:${NC}"
+echo "  $ARCHIVE       ← attach to the Forgejo release"
+echo "  $NOTES_FILE    ← edit and paste as the release body"
+echo ""
+echo -e "${BOLD}Manual steps remaining:${NC}"
+echo ""
+echo -e "  ${BOLD}1. Edit the release notes${NC}"
+echo "       Open $NOTES_FILE and rewrite the notes into polished prose."
+echo ""
+echo -e "  ${BOLD}2. Push the commit and tag to Forgejo${NC}"
+echo "       git push origin $CURRENT_BRANCH"
+echo "       git push origin $TAG"
+echo ""
+echo -e "  ${BOLD}3. Create the release on Forgejo${NC}"
+echo "       Go to your repository → Releases → New release"
+echo "       Tag:    $TAG"
+echo "       Title:  TrainUs $TAG"
+echo "       Body:   paste the contents of $NOTES_FILE"
+echo "       Attach: $ARCHIVE"
+echo "       Publish the release."
+echo ""
+echo -e "  ${BOLD}4. Deploy the app${NC}"
+echo "       Upload the contents of dist/ to your static host."
+echo ""
+echo -e "  ${BOLD}5. Deploy the website${NC}"
+echo "       npm run site:build"
+echo "       Upload the contents of website/public/ to your website host."
+echo ""
+echo -e "  ${BOLD}6. Publish the release blog post${NC}"
+echo "       Duplicate website/content/blog/release-template.en.md"
+echo "       Rename it: $(date +%Y-%m-%d)-release-${TAG}.en.md"
+echo "       Fill in the placeholders — set draft: false when ready."
+echo "       Write the French version yourself."
+echo "       Rebuild and redeploy the website (step 5)."
+echo ""
+echo -e "  ${BOLD}7. Clean up local artifacts${NC}"
+echo "       Once uploaded and published: rm $ARCHIVE $NOTES_FILE"
+echo ""
diff --git a/scripts/screenshots/README.md b/scripts/screenshots/README.md
new file mode 100644
index 0000000..08531a5
--- /dev/null
+++ b/scripts/screenshots/README.md
@@ -0,0 +1,46 @@
+# Screenshot scripts
+
+Small, standalone Playwright (Python) scripts that drive the app in a browser to produce PNGs for visual investigations or documentation figures.
+
+These are **not tests** — they contain no assertions. For the automated test suite, see `tests/`.
+
+## Prerequisites
+
+- Playwright for Python installed (see `tests/requirements.txt`):
+  ```bash
+  pip install -r tests/requirements.txt
+  python -m playwright install firefox chromium
+  ```
+- Vite dev server running on port 5199:
+  ```bash
+  npm run dev -- --port 5199 --strictPort
+  ```
+
+## Running
+
+```bash
+# All pages, modals and dialogs (seeds DB automatically)
+python scripts/screenshots/all_pages.py
+python scripts/screenshots/all_pages.py --browser chromium
+python scripts/screenshots/all_pages.py --width 390 --height 844   # mobile viewport
+python scripts/screenshots/all_pages.py --out-dir /tmp/shots
+
+# Exercise list only
+python scripts/screenshots/exercise_list.py --help
+python scripts/screenshots/exercise_list.py                       # Firefox, 1920x1080
+python scripts/screenshots/exercise_list.py --browser chromium
+python scripts/screenshots/exercise_list.py --width 2560 --height 1440
+python scripts/screenshots/exercise_list.py --out /tmp/custom.png
+```
+
+## Output location
+
+By default, PNGs are written to `tmp/` at the project root (which is gitignored). Override with `--out PATH` if you need a different location.
+
+## Conventions for new scripts
+
+- One script per page/flow; name it after the page (e.g., `exercise_list.py`, `combo_detail.py`).
+- Use `argparse` with at least these flags: `--url`, `--browser`, `--width`, `--height`, `--out`.
+- Default the output to `tmp/<script-name>-<browser>-<WxH>.png`.
+- Seed the database through the UI if the target page requires data; skip seeding when cards already exist so the script is idempotent.
+- Keep the script free of assertions — if you want to verify behavior, add a test under `tests/` instead.
diff --git a/scripts/screenshots/all_pages.py b/scripts/screenshots/all_pages.py
new file mode 100644
index 0000000..56f81aa
--- /dev/null
+++ b/scripts/screenshots/all_pages.py
@@ -0,0 +1,380 @@
+"""
+Capture screenshots of every view, modal, and dialog in the TrainUs app.
+
+The app is driven in English by default (use --lang fr for French screenshots)
+with a seeded database so each screenshot shows meaningful content rather
+than empty states.
+
+Intended for visual investigations and documentation figures — not a test.
+
+Prerequisites:
+    - Playwright for Python installed (see `tests/requirements.txt`)
+    - Playwright browsers installed: `python -m playwright install firefox chromium`
+    - Vite dev server running: `npm run dev -- --port 5199 --strictPort`
+
+Usage (from project root):
+
+    python scripts/screenshots/all_pages.py
+    python scripts/screenshots/all_pages.py --browser chromium
+    python scripts/screenshots/all_pages.py --lang fr
+    python scripts/screenshots/all_pages.py --out-dir /tmp/screenshots
+    python scripts/screenshots/all_pages.py --no-mobile
+
+Options:
+
+    --url URL        App URL (default: http://localhost:5199)
+    --browser NAME   firefox | chromium | webkit (default: firefox)
+    --lang LANG      en | fr (default: en)
+    --out-dir PATH   Output directory root (default: tmp/screenshots)
+    --no-mobile      Skip the mobile (390×844) pass
+
+Exit code: 0 on success, 1 on failure.
+"""
+
+from __future__ import annotations
+
+import argparse
+import os
+import sys
+import time
+import traceback
+from pathlib import Path
+
+from playwright.sync_api import Page, sync_playwright
+
+
+# ---------------------------------------------------------------------------
+# Seed helpers
+# ---------------------------------------------------------------------------
+
+_SEED_SCRIPT = """
+async () => {
+    const uuid = await window.__repos.settings.get('user_uuid');
+
+    // ── exercises ──────────────────────────────────────────────────────────
+    const ex1 = await window.__repos.exercises.create({
+        title: 'Push-ups',
+        description: '**Classic** bodyweight push-up.\\n\\n- Keep your back straight\\n- Full range of motion',
+        asymmetric: false, alternate: false, image_urls: [], video_urls: [],
+        default_reps: 15, default_weight: 0, created_by: uuid
+    });
+    const ex2 = await window.__repos.exercises.create({
+        title: 'Squats',
+        description: 'Bodyweight squat — great for legs and glutes.',
+        asymmetric: false, alternate: false, image_urls: [], video_urls: [],
+        default_reps: 20, default_weight: 0, created_by: uuid
+    });
+    const ex3 = await window.__repos.exercises.create({
+        title: 'Deadlift',
+        description: 'Barbell deadlift — compound posterior-chain movement.',
+        asymmetric: false, alternate: false, image_urls: [], video_urls: [],
+        default_reps: 5, default_weight: 100, created_by: uuid
+    });
+    const ex4 = await window.__repos.exercises.create({
+        title: 'Single-leg Romanian Deadlift',
+        description: 'Balance and hamstring exercise.\\n\\n*Asymmetric — alternate sides.*',
+        asymmetric: true, alternate: true, image_urls: [], video_urls: [],
+        default_reps: 10, default_weight: 20, created_by: uuid
+    });
+
+    // ── regular combo ──────────────────────────────────────────────────────
+    const comboId = await window.__repos.combos.create({
+        title: 'Morning HIIT',
+        description: 'Quick high-intensity warm-up combo.',
+        type: 'NONE', timer_config: null, created_by: uuid
+    });
+    await window.__repos.combos.setExercises(comboId, [
+        { exerciseId: ex1, position: 0, defaultReps: 15, defaultWeight: 0 },
+        { exerciseId: ex2, position: 1, defaultReps: 20, defaultWeight: 0 }
+    ]);
+
+    // ── AMRAP combo ────────────────────────────────────────────────────────
+    const amrapComboId = await window.__repos.combos.create({
+        title: 'AMRAP Blast',
+        description: '3-minute AMRAP: push-ups and squats. As many rounds as possible!',
+        type: 'AMRAP', timer_config: {}, created_by: uuid
+    });
+    await window.__repos.combos.setExercises(amrapComboId, [
+        { exerciseId: ex1, position: 0, defaultReps: 10, defaultWeight: 0 },
+        { exerciseId: ex2, position: 1, defaultReps: 15, defaultWeight: 0 }
+    ]);
+
+    // ── regular session ────────────────────────────────────────────────────
+    const sessId = await window.__repos.sessions.create({
+        title: 'Full-Body Workout A',
+        description: 'A balanced full-body session combining strength and cardio.',
+        created_by: uuid
+    });
+    await window.__repos.sessions.setItems(sessId, [
+        { item_id: ex3, item_type: 'exercise', repetitions: 5, weight: 100.0 },
+        { item_id: comboId, item_type: 'combo', repetitions: 3, weight: 0.0 }
+    ]);
+
+    // ── AMRAP session (repetitions = minutes for AMRAP type) ───────────────
+    const amrapSessId = await window.__repos.sessions.create({
+        title: 'AMRAP Cardio',
+        description: '3-minute AMRAP push-up/squat circuit.',
+        created_by: uuid
+    });
+    await window.__repos.sessions.setItems(amrapSessId, [
+        { item_id: amrapComboId, item_type: 'combo', repetitions: 3, weight: 0.0 }
+    ]);
+
+    // ── collection ─────────────────────────────────────────────────────────
+    const colId = await window.__repos.collections.create({
+        label: 'Week 1 Plan', created_by: uuid
+    });
+    await window.__repos.collections.setSessions(colId, [sessId]);
+
+    // ── execution log so the home page shows history ───────────────────────
+    const now = Date.now();
+    const logId = await window.__repos.executionLogs.create({
+        session_id: sessId,
+        started_at: new Date(now - 3600000).toISOString(),
+        finished_at: new Date(now - 3000000).toISOString()
+    });
+    await window.__repos.executionLogs.addItem({
+        log_id: logId, exercise_id: ex3, combo_id: null,
+        round_number: 1, reps_done: 5, weight_used: 100, side: null,
+        completed: true, timestamp: new Date(now - 3500000).toISOString()
+    });
+    await window.__repos.executionLogs.addItem({
+        log_id: logId, exercise_id: ex1, combo_id: comboId,
+        round_number: 1, reps_done: 15, weight_used: 0, side: null,
+        completed: true, timestamp: new Date(now - 3400000).toISOString()
+    });
+
+    return { ex1, ex2, ex3, ex4, comboId, amrapComboId, sessId, amrapSessId, colId, logId };
+}
+"""
+
+_COUNT_SCRIPT = """
+async () => (await window.__repos.exercises.getAll()).length
+"""
+
+
+def wait_for_db(page: Page, url: str) -> None:
+    page.goto(url)
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-ready') === 'true'",
+        timeout=15000,
+    )
+
+
+def ensure_language(page: Page, lang: str) -> None:
+    current = page.evaluate("async () => window.__repos.settings.get('language')")
+    if current != lang:
+        page.evaluate(f"async () => window.__repos.settings.set('language', '{lang}')")
+        page.reload()
+        page.wait_for_function(
+            "document.documentElement.getAttribute('data-db-ready') === 'true'",
+            timeout=15000,
+        )
+
+
+def has_data(page: Page) -> bool:
+    return page.evaluate(_COUNT_SCRIPT) > 0
+
+
+# ---------------------------------------------------------------------------
+# Screenshot helpers
+# ---------------------------------------------------------------------------
+
+def shot(page: Page, out_dir: Path, name: str, full_page: bool = True) -> None:
+    time.sleep(0.4)
+    path = out_dir / f"{name}.png"
+    page.screenshot(path=str(path), full_page=full_page)
+    print(f"  ✓  {path.name}")
+
+
+def goto(page: Page, url: str, route: str, wait_selector: str | None = None) -> None:
+    page.goto(f"{url}/#/{route}", wait_until="domcontentloaded")
+    if wait_selector:
+        page.wait_for_selector(wait_selector, timeout=8000)
+    else:
+        time.sleep(0.3)
+
+
+# ---------------------------------------------------------------------------
+# Main capture flow
+# ---------------------------------------------------------------------------
+
+def capture_all(page: Page, url: str, out_dir: Path, lang: str) -> None:
+    wait_for_db(page, url)
+    ensure_language(page, lang)
+
+    if not has_data(page):
+        print("  Seeding database…")
+        ids = page.evaluate(_SEED_SCRIPT)
+        print("  Seed complete.")
+    else:
+        raise RuntimeError("DB already has data — start with a fresh browser context")
+
+    sess_id      = ids['sessId']
+    amrap_sess_id = ids['amrapSessId']
+    col_id       = ids['colId']
+
+    # ── home (shows recent execution history after seed) ──────────────────
+    goto(page, url, "home")
+    shot(page, out_dir, "home")
+
+    # ── exercises ─────────────────────────────────────────────────────────
+    goto(page, url, "exercises", '[data-testid="exercise-new-btn"]')
+    shot(page, out_dir, "exercises")
+
+    exercises = page.evaluate("async () => window.__repos.exercises.getAll()")
+    ex_id = exercises[0]["id"]
+
+    goto(page, url, f"exercises/{ex_id}", '[data-testid="exercise-detail-title"]')
+    shot(page, out_dir, "exercise-detail")
+
+    goto(page, url, f"exercises/{ex_id}/edit", '[data-testid="exercise-title"]')
+    shot(page, out_dir, "exercise-edit")
+
+    goto(page, url, "exercises/new", '[data-testid="exercise-title"]')
+    shot(page, out_dir, "exercise-new")
+
+    # ── combos ────────────────────────────────────────────────────────────
+    goto(page, url, "combos", '[data-testid="combo-new-btn"]')
+    shot(page, out_dir, "combos")
+
+    combos = page.evaluate("async () => window.__repos.combos.getAll()")
+    combo_id = combos[0]["id"]
+
+    goto(page, url, f"combos/{combo_id}", '[data-testid="combo-detail-title"]')
+    shot(page, out_dir, "combo-detail")
+
+    goto(page, url, f"combos/{combo_id}/edit", '[data-testid="combo-title"]')
+    shot(page, out_dir, "combo-edit")
+
+    goto(page, url, "combos/new", '[data-testid="combo-title"]')
+    shot(page, out_dir, "combo-new")
+
+    # ── sessions ──────────────────────────────────────────────────────────
+    goto(page, url, "sessions", '[data-testid="session-new-btn"]')
+    shot(page, out_dir, "sessions")
+
+    goto(page, url, f"sessions/{sess_id}", '[data-testid="session-detail-title"]')
+    shot(page, out_dir, "session-detail")
+
+    goto(page, url, f"sessions/{sess_id}/edit", '[data-testid="session-title"]')
+    shot(page, out_dir, "session-edit")
+
+    goto(page, url, "sessions/new", '[data-testid="session-title"]')
+    shot(page, out_dir, "session-new")
+
+    # ── session execute — regular (progress bar + current step) ───────────
+    goto(page, url, f"sessions/{sess_id}/execute", '[data-testid="execute-progress"]')
+    shot(page, out_dir, "session-execute")
+
+    # ── session execute — AMRAP timer running ─────────────────────────────
+    # Navigate away first so Vue Router remounts SessionExecuteView (it reuses
+    # the component when only params change, so onMounted/init() won't re-run
+    # unless we force a different route in between).
+    goto(page, url, "sessions", '[data-testid="session-new-btn"]')
+    goto(page, url, f"sessions/{amrap_sess_id}/execute", '[data-testid="execute-timer"]')
+    shot(page, out_dir, "session-execute-amrap")
+
+    # ── collections ───────────────────────────────────────────────────────
+    goto(page, url, "collections", '[data-testid="collection-new-btn"]')
+    shot(page, out_dir, "collections")
+
+    goto(page, url, f"collections/{col_id}", '[data-testid="collection-detail-title"]')
+    shot(page, out_dir, "collection-detail")
+
+    goto(page, url, f"collections/{col_id}/edit", '[data-testid="collection-label"]')
+    shot(page, out_dir, "collection-edit")
+
+    goto(page, url, "collections/new", '[data-testid="collection-label"]')
+    shot(page, out_dir, "collection-new")
+
+    # ── stats ─────────────────────────────────────────────────────────────
+    goto(page, url, "stats", '[data-testid="stats-date-range"]')
+    shot(page, out_dir, "stats")
+
+    # ── settings — viewport-height slices (page is tall) ──────────────────
+    goto(page, url, "settings", '[data-testid="settings-language"]')
+    page.evaluate("window.scrollTo(0, 0)")
+    shot(page, out_dir, "settings-top", full_page=False)
+    page.evaluate("window.scrollTo(0, document.body.scrollHeight)")
+    time.sleep(0.2)
+    shot(page, out_dir, "settings-bottom", full_page=False)
+
+    # ── about dialog ──────────────────────────────────────────────────────
+    page.evaluate("window.scrollTo(0, 0)")
+    page.click('[data-testid="settings-about"]')
+    page.wait_for_selector('[data-testid="modal-card"]')
+    shot(page, out_dir, "about-dialog")
+
+    # ── license dialog (stacked on about) ─────────────────────────────────
+    page.click('[data-testid="about-license-btn"]')
+    page.wait_for_selector('[data-testid="license-dialog-content"]')
+    shot(page, out_dir, "license-dialog")
+
+    close_btns = page.locator('[data-testid="modal-close"]')
+    close_btns.last.click()
+    close_btns.first.click()
+
+
+# ---------------------------------------------------------------------------
+# CLI
+# ---------------------------------------------------------------------------
+
+def parse_args(argv: list[str]) -> argparse.Namespace:
+    parser = argparse.ArgumentParser(
+        description=__doc__,
+        formatter_class=argparse.RawDescriptionHelpFormatter,
+    )
+    parser.add_argument("--url", default=os.environ.get("APP_URL", "http://localhost:5199"))
+    parser.add_argument("--browser", default="firefox", choices=["firefox", "chromium", "webkit"])
+    parser.add_argument("--lang", default="en", choices=["en", "fr"])
+    parser.add_argument("--out-dir", default=None)
+    parser.add_argument("--no-mobile", action="store_true")
+    return parser.parse_args(argv)
+
+
+def default_out_dir(browser: str, lang: str, width: int, height: int) -> Path:
+    project_root = Path(__file__).resolve().parents[2]
+    prefix = browser if lang == "en" else f"{lang}-{browser}"
+    return project_root / "tmp" / "screenshots" / f"{prefix}-{width}x{height}"
+
+
+def main(argv: list[str] | None = None) -> int:
+    args = parse_args(argv or sys.argv[1:])
+
+    passes = [(1920, 1080)]
+    if not args.no_mobile:
+        passes.append((390, 844))
+
+    with sync_playwright() as p:
+        for (w, h) in passes:
+            out_dir = (
+                Path(args.out_dir) / f"{args.browser}-{w}x{h}"
+                if args.out_dir
+                else default_out_dir(args.browser, args.lang, w, h)
+            )
+            out_dir.mkdir(parents=True, exist_ok=True)
+
+            print(f"\n── {args.browser}  {w}×{h}  →  {out_dir}")
+
+            browser_type = getattr(p, args.browser)
+            browser = browser_type.launch(headless=True)
+            try:
+                context = browser.new_context(viewport={"width": w, "height": h})
+                page = context.new_page()
+                page.on("dialog", lambda dialog: dialog.accept())
+                capture_all(page, args.url, out_dir, args.lang)
+                count = len(list(out_dir.glob("*.png")))
+                print(f"\n  Done — {count} screenshots saved")
+            except Exception as exc:
+                print(f"\n  ERROR: {exc}", file=sys.stderr)
+                traceback.print_exc()
+                return 1
+            finally:
+                browser.close()
+
+    return 0
+
+
+if __name__ == "__main__":
+    sys.exit(main())
diff --git a/scripts/screenshots/combo_timers.py b/scripts/screenshots/combo_timers.py
new file mode 100644
index 0000000..c5904c1
--- /dev/null
+++ b/scripts/screenshots/combo_timers.py
@@ -0,0 +1,241 @@
+"""
+Capture screenshots of EMOM and TABATA combo timers in Execution Mode,
+including the TABATA rest screen — not covered by all_pages.py (which only
+seeds an AMRAP combo).
+
+The app is driven in English by default (use --lang fr for French
+screenshots) with a seeded database so each screenshot shows meaningful
+content rather than empty states.
+
+Intended for visual investigations and documentation figures — not a test.
+
+Prerequisites:
+    - Playwright for Python installed (see `tests/requirements.txt`)
+    - Playwright browsers installed: `python -m playwright install firefox chromium`
+    - Vite dev server running: `npm run dev -- --port 5199 --strictPort`
+
+Usage (from project root):
+
+    python scripts/screenshots/combo_timers.py
+    python scripts/screenshots/combo_timers.py --browser chromium
+    python scripts/screenshots/combo_timers.py --lang fr
+    python scripts/screenshots/combo_timers.py --out-dir /tmp/screenshots
+
+Options:
+
+    --url URL        App URL (default: http://localhost:5199)
+    --browser NAME   firefox | chromium | webkit (default: firefox)
+    --lang LANG      en | fr (default: en)
+    --width N        Viewport width in px (default: 1920)
+    --height N       Viewport height in px (default: 1080)
+    --out-dir PATH   Output directory (default: tmp/screenshots/combo-timers-<lang>-<browser>-<W>x<H>)
+
+Exit code: 0 on success, 1 on failure.
+"""
+
+from __future__ import annotations
+
+import argparse
+import os
+import sys
+import time
+import traceback
+from pathlib import Path
+
+from playwright.sync_api import Page, sync_playwright
+
+
+# ---------------------------------------------------------------------------
+# Seed helpers
+# ---------------------------------------------------------------------------
+
+# TABATA work/rest kept short (6s / 5s) so the script doesn't have to wait
+# long to reach the rest screen.
+_SEED_SCRIPT = """
+async () => {
+    const uuid = await window.__repos.settings.get('user_uuid');
+
+    const ex1 = await window.__repos.exercises.create({
+        title: 'Jumping Jacks',
+        description: 'Cardio warm-up movement.',
+        asymmetric: false, alternate: false, image_urls: [], video_urls: [],
+        default_reps: 20, default_weight: 0, created_by: uuid
+    });
+    const ex2 = await window.__repos.exercises.create({
+        title: 'Mountain Climbers',
+        description: 'Core and cardio movement.',
+        asymmetric: false, alternate: false, image_urls: [], video_urls: [],
+        default_reps: 20, default_weight: 0, created_by: uuid
+    });
+
+    // ── EMOM combo — work phase is always a 60s slot per exercise ─────────
+    const emomComboId = await window.__repos.combos.create({
+        title: 'EMOM Cardio', description: '3-minute EMOM.',
+        type: 'EMOM', timer_config: {}, created_by: uuid
+    });
+    await window.__repos.combos.setExercises(emomComboId, [
+        { exerciseId: ex1, position: 0, defaultReps: 20, defaultWeight: 0 }
+    ]);
+    const emomSessId = await window.__repos.sessions.create({
+        title: 'EMOM Session', description: '', created_by: uuid
+    });
+    await window.__repos.sessions.setItems(emomSessId, [
+        { item_id: emomComboId, item_type: 'combo', repetitions: 3, weight: 0.0 }
+    ]);
+
+    // ── TABATA combo ────────────────────────────────────────────────────
+    const tabataComboId = await window.__repos.combos.create({
+        title: 'TABATA Blast', description: 'Work/rest intervals.',
+        type: 'TABATA', timer_config: { workTime: 6, restTime: 5 }, created_by: uuid
+    });
+    await window.__repos.combos.setExercises(tabataComboId, [
+        { exerciseId: ex1, position: 0, defaultReps: 0, defaultWeight: 0 },
+        { exerciseId: ex2, position: 1, defaultReps: 0, defaultWeight: 0 }
+    ]);
+    const tabataSessId = await window.__repos.sessions.create({
+        title: 'TABATA Session', description: '', created_by: uuid
+    });
+    await window.__repos.sessions.setItems(tabataSessId, [
+        { item_id: tabataComboId, item_type: 'combo', repetitions: 4, weight: 0.0 }
+    ]);
+
+    return { emomSessId, tabataSessId };
+}
+"""
+
+_COUNT_SCRIPT = """
+async () => (await window.__repos.exercises.getAll()).length
+"""
+
+
+def wait_for_db(page: Page, url: str) -> None:
+    page.goto(url)
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-ready') === 'true'",
+        timeout=15000,
+    )
+
+
+def ensure_language(page: Page, lang: str) -> None:
+    current = page.evaluate("async () => window.__repos.settings.get('language')")
+    if current != lang:
+        page.evaluate(f"async () => window.__repos.settings.set('language', '{lang}')")
+        page.reload()
+        page.wait_for_function(
+            "document.documentElement.getAttribute('data-db-ready') === 'true'",
+            timeout=15000,
+        )
+
+
+def has_data(page: Page) -> bool:
+    return page.evaluate(_COUNT_SCRIPT) > 0
+
+
+# ---------------------------------------------------------------------------
+# Screenshot helpers
+# ---------------------------------------------------------------------------
+
+def shot(page: Page, out_dir: Path, name: str, full_page: bool = True) -> None:
+    time.sleep(0.3)
+    path = out_dir / f"{name}.png"
+    page.screenshot(path=str(path), full_page=full_page)
+    print(f"  ✓  {path.name}")
+
+
+def goto(page: Page, url: str, route: str, wait_selector: str | None = None) -> None:
+    page.goto(f"{url}/#/{route}", wait_until="domcontentloaded")
+    if wait_selector:
+        page.wait_for_selector(wait_selector, timeout=8000)
+    else:
+        time.sleep(0.3)
+
+
+# ---------------------------------------------------------------------------
+# Main capture flow
+# ---------------------------------------------------------------------------
+
+def capture(page: Page, url: str, out_dir: Path, lang: str) -> None:
+    wait_for_db(page, url)
+    ensure_language(page, lang)
+
+    if not has_data(page):
+        print("  Seeding database…")
+        ids = page.evaluate(_SEED_SCRIPT)
+        print("  Seed complete.")
+    else:
+        raise RuntimeError("DB already has data — start with a fresh browser context")
+
+    # ── EMOM — work phase starts immediately ───────────────────────────────
+    goto(page, url, f"sessions/{ids['emomSessId']}/execute", '[data-testid="execute-timer"]')
+    shot(page, out_dir, "combo-emom")
+
+    # ── TABATA — work phase ─────────────────────────────────────────────
+    # Navigate away first so Vue Router remounts SessionExecuteView (it reuses
+    # the component when only params change, see all_pages.py for the same
+    # workaround).
+    goto(page, url, "sessions", '[data-testid="session-new-btn"]')
+    goto(page, url, f"sessions/{ids['tabataSessId']}/execute", '[data-testid="execute-timer"]')
+    shot(page, out_dir, "combo-tabata-work")
+
+    # ── TABATA — rest phase (work duration is 6s in the seed above) ────────
+    page.wait_for_selector('[data-testid="execute-tabata-rest"]', timeout=12000)
+    shot(page, out_dir, "combo-tabata-rest")
+
+
+# ---------------------------------------------------------------------------
+# CLI
+# ---------------------------------------------------------------------------
+
+def parse_args(argv: list[str]) -> argparse.Namespace:
+    parser = argparse.ArgumentParser(
+        description=__doc__,
+        formatter_class=argparse.RawDescriptionHelpFormatter,
+    )
+    parser.add_argument("--url", default=os.environ.get("APP_URL", "http://localhost:5199"))
+    parser.add_argument("--browser", default="firefox", choices=["firefox", "chromium", "webkit"])
+    parser.add_argument("--lang", default="en", choices=["en", "fr"])
+    parser.add_argument("--width", type=int, default=1920)
+    parser.add_argument("--height", type=int, default=1080)
+    parser.add_argument("--out-dir", default=None)
+    return parser.parse_args(argv)
+
+
+def default_out_dir(browser: str, lang: str, width: int, height: int) -> Path:
+    project_root = Path(__file__).resolve().parents[2]
+    prefix = f"combo-timers-{browser}" if lang == "en" else f"combo-timers-{lang}-{browser}"
+    return project_root / "tmp" / "screenshots" / f"{prefix}-{width}x{height}"
+
+
+def main(argv: list[str] | None = None) -> int:
+    args = parse_args(argv or sys.argv[1:])
+    out_dir = (
+        Path(args.out_dir)
+        if args.out_dir
+        else default_out_dir(args.browser, args.lang, args.width, args.height)
+    )
+    out_dir.mkdir(parents=True, exist_ok=True)
+
+    print(f"\n── {args.browser}  {args.width}×{args.height}  →  {out_dir}")
+
+    with sync_playwright() as p:
+        browser_type = getattr(p, args.browser)
+        browser = browser_type.launch(headless=True)
+        try:
+            context = browser.new_context(viewport={"width": args.width, "height": args.height})
+            page = context.new_page()
+            page.on("dialog", lambda dialog: dialog.accept())
+            capture(page, args.url, out_dir, args.lang)
+            count = len(list(out_dir.glob("*.png")))
+            print(f"\n  Done — {count} screenshots saved")
+        except Exception as exc:
+            print(f"\n  ERROR: {exc}", file=sys.stderr)
+            traceback.print_exc()
+            return 1
+        finally:
+            browser.close()
+
+    return 0
+
+
+if __name__ == "__main__":
+    sys.exit(main())
diff --git a/scripts/screenshots/exercise_list.py b/scripts/screenshots/exercise_list.py
new file mode 100644
index 0000000..cda2489
--- /dev/null
+++ b/scripts/screenshots/exercise_list.py
@@ -0,0 +1,130 @@
+"""
+Screenshot the Exercise List page at a configurable viewport.
+
+Intended for visual investigations (e.g., layout discussions, documentation
+figures). Not a test — no assertions; see `tests/` for the test suite.
+
+Prerequisites:
+    - Playwright for Python installed (see `tests/requirements.txt`)
+    - Playwright browsers installed: `python -m playwright install firefox chromium`
+
+Typical usage (from project root):
+
+    # 1. Start the Vite dev server in one terminal
+    npm run dev -- --port 5199 --strictPort
+
+    # 2. In another terminal, run the script
+    python scripts/screenshots/exercise_list.py
+
+Options (all optional, override via CLI flags):
+
+    --url URL            App URL (default: http://localhost:5199)
+    --browser NAME       firefox | chromium | webkit (default: firefox)
+    --width N            Viewport width in px (default: 1920)
+    --height N           Viewport height in px (default: 1080)
+    --out PATH           Output file path (default: tmp/exercise-list-<browser>-<W>x<H>.png)
+    --no-seed            Do not create sample exercises (use the existing DB as-is)
+
+Exit code: 0 on success, 1 on failure.
+"""
+
+from __future__ import annotations
+
+import argparse
+import os
+import sys
+import time
+from pathlib import Path
+
+from playwright.sync_api import sync_playwright
+
+
+SAMPLE_EXERCISES = [
+    {"title": "Push-ups", "desc": "Classic bodyweight push-up", "reps": "15"},
+    {"title": "Squats", "desc": "Bodyweight squat", "reps": "20"},
+    {"title": "Plank", "desc": "Core stability hold", "reps": "60"},
+]
+
+
+def ensure_sample_exercises(page, url: str) -> None:
+    """Create a few exercises via the UI so the list has visible cards.
+
+    No-op if the list already contains at least one card.
+    """
+    page.goto(f"{url}/#/exercises", wait_until="networkidle")
+    cards = page.locator('[data-testid^="exercise-card-"]')
+    if cards.count() > 0:
+        return
+
+    for ex in SAMPLE_EXERCISES:
+        page.goto(f"{url}/#/exercises/new", wait_until="networkidle")
+        page.wait_for_selector('[data-testid="exercise-title"]', timeout=10000)
+        page.locator('[data-testid="exercise-title"]').fill(ex["title"])
+        page.locator('[data-testid="exercise-description"]').fill(ex["desc"])
+        page.locator('[data-testid="exercise-reps"]').fill(ex["reps"])
+        page.locator('[data-testid="exercise-save"]').click()
+        # After save the app navigates to the detail page; just wait for URL
+        # to move away from `/new`.
+        page.wait_for_function(
+            "() => !location.hash.endsWith('/exercises/new')",
+            timeout=5000,
+        )
+
+
+def parse_args(argv: list[str]) -> argparse.Namespace:
+    parser = argparse.ArgumentParser(description=__doc__, formatter_class=argparse.RawDescriptionHelpFormatter)
+    parser.add_argument("--url", default=os.environ.get("APP_URL", "http://localhost:5199"))
+    parser.add_argument("--browser", default="firefox", choices=["firefox", "chromium", "webkit"])
+    parser.add_argument("--width", type=int, default=1920)
+    parser.add_argument("--height", type=int, default=1080)
+    parser.add_argument("--out", default=None, help="Output file path")
+    parser.add_argument("--no-seed", action="store_true", help="Skip creating sample exercises")
+    return parser.parse_args(argv)
+
+
+def default_out_path(browser: str, width: int, height: int) -> Path:
+    """Default output goes to tmp/ at the project root (gitignored)."""
+    project_root = Path(__file__).resolve().parents[2]
+    tmp_dir = project_root / "tmp"
+    tmp_dir.mkdir(parents=True, exist_ok=True)
+    return tmp_dir / f"exercise-list-{browser}-{width}x{height}.png"
+
+
+def main(argv: list[str] | None = None) -> int:
+    args = parse_args(argv or sys.argv[1:])
+    out_path = Path(args.out) if args.out else default_out_path(args.browser, args.width, args.height)
+    out_path.parent.mkdir(parents=True, exist_ok=True)
+
+    viewport = {"width": args.width, "height": args.height}
+
+    with sync_playwright() as p:
+        browser_type = getattr(p, args.browser)
+        browser = browser_type.launch(headless=True)
+        try:
+            context = browser.new_context(viewport=viewport)
+            page = context.new_page()
+
+            page.goto(args.url, wait_until="networkidle")
+            # Wait for the app to finish DB init overlay, if any.
+            try:
+                page.wait_for_selector(".db-overlay", state="detached", timeout=10000)
+            except Exception:
+                pass
+
+            if not args.no_seed:
+                ensure_sample_exercises(page, args.url)
+
+            page.goto(f"{args.url}/#/exercises", wait_until="networkidle")
+            page.wait_for_selector('[data-testid^="exercise-card-"]', timeout=5000)
+            # Let layout settle before capturing.
+            time.sleep(0.5)
+
+            page.screenshot(path=str(out_path), full_page=True)
+            print(f"Saved screenshot: {out_path}")
+            return 0
+        finally:
+            browser.close()
+
+
+if __name__ == "__main__":
+    sys.exit(main())
diff --git a/scripts/screenshots/overview_shots.py b/scripts/screenshots/overview_shots.py
new file mode 100644
index 0000000..4f5463c
--- /dev/null
+++ b/scripts/screenshots/overview_shots.py
@@ -0,0 +1,82 @@
+"""One-off: capture the Exercises list screen (desktop + mobile, en + fr)
+to replace the home-page overview screenshots in demarrage-rapide docs."""
+
+from __future__ import annotations
+
+import time
+from pathlib import Path
+
+from playwright.sync_api import sync_playwright
+
+URL = "http://localhost:5199"
+OUT_DIR = Path("/tmp/overview-shots")
+OUT_DIR.mkdir(parents=True, exist_ok=True)
+
+SEED_SCRIPT = """
+async () => {
+    const uuid = await window.__repos.settings.get('user_uuid');
+    await window.__repos.exercises.create({
+        title: 'Push-ups',
+        description: 'Classic bodyweight push-up.',
+        asymmetric: false, alternate: false, image_urls: [], video_urls: [],
+        default_reps: 15, default_weight: 0, created_by: uuid
+    });
+    await window.__repos.exercises.create({
+        title: 'Squats',
+        description: 'Bodyweight squat — great for legs and glutes.',
+        asymmetric: false, alternate: false, image_urls: [], video_urls: [],
+        default_reps: 20, default_weight: 0, created_by: uuid
+    });
+    await window.__repos.exercises.create({
+        title: 'Deadlift',
+        description: 'Barbell deadlift — compound posterior-chain movement.',
+        asymmetric: false, alternate: false, image_urls: [], video_urls: [],
+        default_reps: 5, default_weight: 100, created_by: uuid
+    });
+}
+"""
+
+
+def wait_for_db(page):
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-ready') === 'true'",
+        timeout=15000,
+    )
+
+
+def capture(browser, lang: str, width: int, height: int, name: str):
+    context = browser.new_context(viewport={"width": width, "height": height})
+    page = context.new_page()
+    page.goto(URL)
+    wait_for_db(page)
+    page.evaluate(f"async () => window.__repos.settings.set('language', '{lang}')")
+    page.reload()
+    wait_for_db(page)
+
+    count = page.evaluate("async () => (await window.__repos.exercises.getAll()).length")
+    if count == 0:
+        page.evaluate(SEED_SCRIPT)
+
+    page.goto(f"{URL}/#/exercises")
+    page.wait_for_selector('[data-testid="exercise-new-btn"]', timeout=8000)
+    time.sleep(0.5)
+    out_path = OUT_DIR / f"{name}.{lang}.png"
+    page.screenshot(path=str(out_path), full_page=True)
+    print(f"saved {out_path}")
+    context.close()
+
+
+def main():
+    with sync_playwright() as p:
+        browser = p.firefox.launch(headless=True)
+        try:
+            capture(browser, "en", 1920, 1080, "overview-desktop")
+            capture(browser, "fr", 1920, 1080, "overview-desktop")
+            capture(browser, "en", 390, 844, "overview-mobile")
+            capture(browser, "fr", 390, 844, "overview-mobile")
+        finally:
+            browser.close()
+
+
+if __name__ == "__main__":
+    main()
diff --git a/src/App.vue b/src/App.vue
new file mode 100644
index 0000000..57e5875
--- /dev/null
+++ b/src/App.vue
@@ -0,0 +1,313 @@
+<script setup>
+import { useTranslation } from 'i18next-vue'
+import { computed, onMounted, ref } from 'vue'
+import { useRoute } from 'vue-router'
+import BackupReminder from './components/BackupReminder.vue'
+import InstallPrompt from './components/InstallPrompt.vue'
+import SaveFileDialog from './components/SaveFileDialog.vue'
+import { db } from './db/database.js'
+import { useBackupDownload } from './composables/useBackupDownload.js'
+
+const { t } = useTranslation()
+const route = useRoute()
+
+function onNavKeydown(event) {
+  if (!['ArrowRight', 'ArrowLeft', 'ArrowUp', 'ArrowDown'].includes(event.key)) return
+  const links = Array.from(event.currentTarget.querySelectorAll('a'))
+  const idx = links.indexOf(document.activeElement)
+  if (idx === -1) return
+  event.preventDefault()
+  const isForward = event.key === 'ArrowRight' || event.key === 'ArrowDown'
+  links[(idx + (isForward ? 1 : -1) + links.length) % links.length].focus()
+}
+
+const dbReady = ref(false)
+const dbError = ref(null)
+const migrationPending = ref(null)
+
+if (window.__dbReady) {
+  window.__dbReady
+    .then((status) => {
+      if (status && status.migrationPending) {
+        migrationPending.value = status.migrationPending
+      } else {
+        dbReady.value = true
+      }
+    })
+    .catch((err) => {
+      dbError.value = err.message || String(err)
+    })
+}
+
+const dbErrorBody = computed(() => {
+  if (dbError.value === 'DB_NEWER_THAN_APP') return t('error.dbNewerThanApp')
+  if (dbError.value === 'DB_MIGRATION_FAILED') return t('error.dbMigrationFailed')
+  return t('error.browserNotCompatible')
+})
+
+// Blocking migration screen: backup is mandatory before the update can run
+const backupDownloaded = ref(false)
+const migrating = ref(false)
+const { downloadBackup } = useBackupDownload()
+
+async function onMigrationBackup() {
+  const saved = await downloadBackup()
+  if (saved) backupDownloaded.value = true
+}
+
+async function onMigrationUpdate() {
+  migrating.value = true
+  try {
+    await db.runPendingMigrations()
+    migrationPending.value = null
+    document.documentElement.removeAttribute('data-db-migration')
+    document.documentElement.setAttribute('data-db-ready', 'true')
+    dbReady.value = true
+  } catch (err) {
+    dbError.value = err.message || String(err)
+    document.documentElement.setAttribute('data-db-error', dbError.value)
+  } finally {
+    migrating.value = false
+  }
+}
+
+const dbConnectionLost = ref(false)
+onMounted(() => {
+  window.addEventListener('db-connection-lost', () => {
+    dbConnectionLost.value = true
+  })
+})
+
+function reloadPage() {
+  window.location.reload()
+}
+
+const pageTitle = computed(() => {
+  const name = route.name
+  // Map sub-route names to their parent nav key
+  const navKeyMap = {
+    'exercise-new': 'exercises',
+    'exercise-detail': 'exercises',
+    'exercise-edit': 'exercises',
+    'combo-new': 'combos',
+    'combo-detail': 'combos',
+    'combo-edit': 'combos',
+    'session-new': 'sessions',
+    'session-detail': 'sessions',
+    'session-edit': 'sessions',
+    'session-execute': 'sessions',
+    'collection-new': 'collections',
+    'collection-detail': 'collections',
+    'collection-edit': 'collections',
+  }
+  const navKey = navKeyMap[name] || name
+  if (navKey && t(`nav.${navKey}`, '')) {
+    return t(`nav.${navKey}`)
+  }
+  return t('app.name')
+})
+</script>
+
+<template>
+  <div v-if="dbConnectionLost" class="db-overlay" data-testid="db-connection-lost">
+    <div class="db-overlay-card">
+      <i class="bi bi-plug db-error-icon"></i>
+      <h1>{{ $t('error.dbInitFailed') }}</h1>
+      <p>{{ $t('error.dbConnectionLost') }}</p>
+      <button class="btn btn-primary" style="margin-top: 1rem" @click="reloadPage">
+        {{ $t('error.reload') }}
+      </button>
+    </div>
+  </div>
+
+  <div v-else-if="dbError" class="db-overlay" data-testid="db-error">
+    <div class="db-overlay-card">
+      <i class="bi bi-exclamation-triangle db-error-icon"></i>
+      <h1>{{ $t('error.dbInitFailed') }}</h1>
+      <p>{{ dbErrorBody }}</p>
+    </div>
+  </div>
+
+  <div v-else-if="migrationPending" class="db-overlay" data-testid="db-migration">
+    <div class="db-overlay-card">
+      <i class="bi bi-database-up db-migration-icon"></i>
+      <h1>{{ $t('migration.title') }}</h1>
+      <p>
+        {{ $t('migration.body', { from: migrationPending.from, to: migrationPending.to }) }}
+      </p>
+      <p>{{ $t('migration.backupRequired') }}</p>
+      <div class="db-migration-actions">
+        <button class="btn btn-primary" data-testid="migration-backup" @click="onMigrationBackup">
+          <i class="bi bi-download"></i>
+          {{ $t('migration.downloadBackup') }}
+        </button>
+        <button
+          class="btn btn-primary"
+          data-testid="migration-update"
+          :disabled="!backupDownloaded || migrating"
+          @click="onMigrationUpdate"
+        >
+          <span v-if="migrating" class="spinner spinner-inline"></span>
+          {{ migrating ? $t('migration.updating') : $t('migration.update') }}
+        </button>
+      </div>
+    </div>
+  </div>
+
+  <div v-else-if="!dbReady" class="db-overlay" data-testid="db-loading">
+    <div class="db-overlay-card">
+      <div class="spinner"></div>
+      <p class="loading-text">{{ $t('app.loading') }}</p>
+    </div>
+  </div>
+
+  <template v-else>
+    <BackupReminder :key="route.fullPath" />
+    <InstallPrompt />
+    <nav class="navbar" :aria-label="$t('nav.mainNav')" @keydown="onNavKeydown">
+      <div class="navbar-brand">{{ $t('app.name') }}</div>
+
+      <router-link to="/home">
+        <i class="bi bi-house"></i>
+        <span>{{ $t('nav.home') }}</span>
+      </router-link>
+
+      <router-link to="/exercises">
+        <i class="bi bi-person-arms-up"></i>
+        <span>{{ $t('nav.exercises') }}</span>
+      </router-link>
+
+      <router-link to="/combos">
+        <i class="bi bi-layers"></i>
+        <span>{{ $t('nav.combos') }}</span>
+      </router-link>
+
+      <router-link to="/sessions">
+        <i class="bi bi-journal-text"></i>
+        <span>{{ $t('nav.sessions') }}</span>
+      </router-link>
+
+      <router-link to="/collections">
+        <i class="bi bi-collection"></i>
+        <span>{{ $t('nav.collections') }}</span>
+      </router-link>
+
+      <div class="navbar-spacer"></div>
+
+      <router-link to="/stats">
+        <i class="bi bi-graph-up"></i>
+        <span>{{ $t('nav.stats') }}</span>
+      </router-link>
+
+      <router-link to="/settings">
+        <i class="bi bi-gear"></i>
+        <span>{{ $t('nav.settings') }}</span>
+      </router-link>
+    </nav>
+
+    <div class="content">
+      <div class="actionbar">
+        <h1>{{ pageTitle }}</h1>
+        <div id="actionbar-actions"></div>
+      </div>
+
+      <div class="content-body">
+        <router-view />
+      </div>
+    </div>
+  </template>
+
+  <SaveFileDialog />
+</template>
+
+<style scoped>
+.db-overlay {
+  position: fixed;
+  inset: 0;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  background: var(--color-background, #f5f5f5);
+  z-index: 9999;
+  padding: 2rem;
+}
+
+.db-overlay-card {
+  text-align: center;
+  max-width: 480px;
+}
+
+.db-error-icon {
+  font-size: 3rem;
+  color: var(--color-danger, #dc3545);
+}
+
+.db-migration-icon {
+  font-size: 3rem;
+  color: var(--color-primary, #4a90d9);
+}
+
+.db-migration-actions {
+  display: flex;
+  justify-content: center;
+  gap: 1rem;
+  margin-top: 1.5rem;
+}
+
+.spinner-inline {
+  width: 1em;
+  height: 1em;
+  border-width: 2px;
+  display: inline-block;
+  vertical-align: -0.15em;
+  margin: 0 0.35em 0 0;
+}
+
+.db-overlay-card h1 {
+  margin: 1rem 0 0.5rem;
+  font-size: 1.5rem;
+}
+
+.db-overlay-card p {
+  color: var(--color-text-secondary, #666);
+  line-height: 1.5;
+}
+
+.spinner {
+  width: 48px;
+  height: 48px;
+  border: 4px solid var(--color-border, #ddd);
+  border-top-color: var(--color-primary, #4a90d9);
+  border-radius: 50%;
+  margin: 0 auto 1rem;
+  animation: spin 0.8s linear infinite;
+}
+
+@keyframes spin {
+  to {
+    transform: rotate(360deg);
+  }
+}
+
+.loading-text {
+  font-size: 1.1rem;
+}
+
+.btn {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  gap: 6px;
+  padding: 8px 18px;
+  border-radius: 8px;
+  border: none;
+  cursor: pointer;
+  font-size: 14px;
+  font-weight: 500;
+}
+
+.btn-primary {
+  background: var(--btn-primary-bg, #4a90d9);
+  color: var(--btn-primary-color, #fff);
+}
+</style>
diff --git a/src/assets/license.md b/src/assets/license.md
new file mode 100644
index 0000000..bc16720
--- /dev/null
+++ b/src/assets/license.md
@@ -0,0 +1,660 @@
+# GNU AFFERO GENERAL PUBLIC LICENSE
+
+Version 3, 19 November 2007
+
+Copyright (C) 2007 Free Software Foundation, Inc.
+<https://fsf.org/>
+
+Everyone is permitted to copy and distribute verbatim copies of this
+license document, but changing it is not allowed.
+
+## Preamble
+
+The GNU Affero General Public License is a free, copyleft license for
+software and other kinds of works, specifically designed to ensure
+cooperation with the community in the case of network server software.
+
+The licenses for most software and other practical works are designed
+to take away your freedom to share and change the works. By contrast,
+our General Public Licenses are intended to guarantee your freedom to
+share and change all versions of a program--to make sure it remains
+free software for all its users.
+
+When we speak of free software, we are referring to freedom, not
+price. Our General Public Licenses are designed to make sure that you
+have the freedom to distribute copies of free software (and charge for
+them if you wish), that you receive source code or can get it if you
+want it, that you can change the software or use pieces of it in new
+free programs, and that you know you can do these things.
+
+Developers that use our General Public Licenses protect your rights
+with two steps: (1) assert copyright on the software, and (2) offer
+you this License which gives you legal permission to copy, distribute
+and/or modify the software.
+
+A secondary benefit of defending all users' freedom is that
+improvements made in alternate versions of the program, if they
+receive widespread use, become available for other developers to
+incorporate. Many developers of free software are heartened and
+encouraged by the resulting cooperation. However, in the case of
+software used on network servers, this result may fail to come about.
+The GNU General Public License permits making a modified version and
+letting the public access it on a server without ever releasing its
+source code to the public.
+
+The GNU Affero General Public License is designed specifically to
+ensure that, in such cases, the modified source code becomes available
+to the community. It requires the operator of a network server to
+provide the source code of the modified version running there to the
+users of that server. Therefore, public use of a modified version, on
+a publicly accessible server, gives the public access to the source
+code of the modified version.
+
+An older license, called the Affero General Public License and
+published by Affero, was designed to accomplish similar goals. This is
+a different license, not a version of the Affero GPL, but Affero has
+released a new version of the Affero GPL which permits relicensing
+under this license.
+
+The precise terms and conditions for copying, distribution and
+modification follow.
+
+## TERMS AND CONDITIONS
+
+### 0. Definitions.
+
+"This License" refers to version 3 of the GNU Affero General Public
+License.
+
+"Copyright" also means copyright-like laws that apply to other kinds
+of works, such as semiconductor masks.
+
+"The Program" refers to any copyrightable work licensed under this
+License. Each licensee is addressed as "you". "Licensees" and
+"recipients" may be individuals or organizations.
+
+To "modify" a work means to copy from or adapt all or part of the work
+in a fashion requiring copyright permission, other than the making of
+an exact copy. The resulting work is called a "modified version" of
+the earlier work or a work "based on" the earlier work.
+
+A "covered work" means either the unmodified Program or a work based
+on the Program.
+
+To "propagate" a work means to do anything with it that, without
+permission, would make you directly or secondarily liable for
+infringement under applicable copyright law, except executing it on a
+computer or modifying a private copy. Propagation includes copying,
+distribution (with or without modification), making available to the
+public, and in some countries other activities as well.
+
+To "convey" a work means any kind of propagation that enables other
+parties to make or receive copies. Mere interaction with a user
+through a computer network, with no transfer of a copy, is not
+conveying.
+
+An interactive user interface displays "Appropriate Legal Notices" to
+the extent that it includes a convenient and prominently visible
+feature that (1) displays an appropriate copyright notice, and (2)
+tells the user that there is no warranty for the work (except to the
+extent that warranties are provided), that licensees may convey the
+work under this License, and how to view a copy of this License. If
+the interface presents a list of user commands or options, such as a
+menu, a prominent item in the list meets this criterion.
+
+### 1. Source Code.
+
+The "source code" for a work means the preferred form of the work for
+making modifications to it. "Object code" means any non-source form of
+a work.
+
+A "Standard Interface" means an interface that either is an official
+standard defined by a recognized standards body, or, in the case of
+interfaces specified for a particular programming language, one that
+is widely used among developers working in that language.
+
+The "System Libraries" of an executable work include anything, other
+than the work as a whole, that (a) is included in the normal form of
+packaging a Major Component, but which is not part of that Major
+Component, and (b) serves only to enable use of the work with that
+Major Component, or to implement a Standard Interface for which an
+implementation is available to the public in source code form. A
+"Major Component", in this context, means a major essential component
+(kernel, window system, and so on) of the specific operating system
+(if any) on which the executable work runs, or a compiler used to
+produce the work, or an object code interpreter used to run it.
+
+The "Corresponding Source" for a work in object code form means all
+the source code needed to generate, install, and (for an executable
+work) run the object code and to modify the work, including scripts to
+control those activities. However, it does not include the work's
+System Libraries, or general-purpose tools or generally available free
+programs which are used unmodified in performing those activities but
+which are not part of the work. For example, Corresponding Source
+includes interface definition files associated with source files for
+the work, and the source code for shared libraries and dynamically
+linked subprograms that the work is specifically designed to require,
+such as by intimate data communication or control flow between those
+subprograms and other parts of the work.
+
+The Corresponding Source need not include anything that users can
+regenerate automatically from other parts of the Corresponding Source.
+
+The Corresponding Source for a work in source code form is that same
+work.
+
+### 2. Basic Permissions.
+
+All rights granted under this License are granted for the term of
+copyright on the Program, and are irrevocable provided the stated
+conditions are met. This License explicitly affirms your unlimited
+permission to run the unmodified Program. The output from running a
+covered work is covered by this License only if the output, given its
+content, constitutes a covered work. This License acknowledges your
+rights of fair use or other equivalent, as provided by copyright law.
+
+You may make, run and propagate covered works that you do not convey,
+without conditions so long as your license otherwise remains in force.
+You may convey covered works to others for the sole purpose of having
+them make modifications exclusively for you, or provide you with
+facilities for running those works, provided that you comply with the
+terms of this License in conveying all material for which you do not
+control copyright. Those thus making or running the covered works for
+you must do so exclusively on your behalf, under your direction and
+control, on terms that prohibit them from making any copies of your
+copyrighted material outside their relationship with you.
+
+Conveying under any other circumstances is permitted solely under the
+conditions stated below. Sublicensing is not allowed; section 10 makes
+it unnecessary.
+
+### 3. Protecting Users' Legal Rights From Anti-Circumvention Law.
+
+No covered work shall be deemed part of an effective technological
+measure under any applicable law fulfilling obligations under article
+11 of the WIPO copyright treaty adopted on 20 December 1996, or
+similar laws prohibiting or restricting circumvention of such
+measures.
+
+When you convey a covered work, you waive any legal power to forbid
+circumvention of technological measures to the extent such
+circumvention is effected by exercising rights under this License with
+respect to the covered work, and you disclaim any intention to limit
+operation or modification of the work as a means of enforcing, against
+the work's users, your or third parties' legal rights to forbid
+circumvention of technological measures.
+
+### 4. Conveying Verbatim Copies.
+
+You may convey verbatim copies of the Program's source code as you
+receive it, in any medium, provided that you conspicuously and
+appropriately publish on each copy an appropriate copyright notice;
+keep intact all notices stating that this License and any
+non-permissive terms added in accord with section 7 apply to the code;
+keep intact all notices of the absence of any warranty; and give all
+recipients a copy of this License along with the Program.
+
+You may charge any price or no price for each copy that you convey,
+and you may offer support or warranty protection for a fee.
+
+### 5. Conveying Modified Source Versions.
+
+You may convey a work based on the Program, or the modifications to
+produce it from the Program, in the form of source code under the
+terms of section 4, provided that you also meet all of these
+conditions:
+
+- a) The work must carry prominent notices stating that you modified
+  it, and giving a relevant date.
+- b) The work must carry prominent notices stating that it is
+  released under this License and any conditions added under
+  section 7. This requirement modifies the requirement in section 4
+  to "keep intact all notices".
+- c) You must license the entire work, as a whole, under this
+  License to anyone who comes into possession of a copy. This
+  License will therefore apply, along with any applicable section 7
+  additional terms, to the whole of the work, and all its parts,
+  regardless of how they are packaged. This License gives no
+  permission to license the work in any other way, but it does not
+  invalidate such permission if you have separately received it.
+- d) If the work has interactive user interfaces, each must display
+  Appropriate Legal Notices; however, if the Program has interactive
+  interfaces that do not display Appropriate Legal Notices, your
+  work need not make them do so.
+
+A compilation of a covered work with other separate and independent
+works, which are not by their nature extensions of the covered work,
+and which are not combined with it such as to form a larger program,
+in or on a volume of a storage or distribution medium, is called an
+"aggregate" if the compilation and its resulting copyright are not
+used to limit the access or legal rights of the compilation's users
+beyond what the individual works permit. Inclusion of a covered work
+in an aggregate does not cause this License to apply to the other
+parts of the aggregate.
+
+### 6. Conveying Non-Source Forms.
+
+You may convey a covered work in object code form under the terms of
+sections 4 and 5, provided that you also convey the machine-readable
+Corresponding Source under the terms of this License, in one of these
+ways:
+
+- a) Convey the object code in, or embodied in, a physical product
+  (including a physical distribution medium), accompanied by the
+  Corresponding Source fixed on a durable physical medium
+  customarily used for software interchange.
+- b) Convey the object code in, or embodied in, a physical product
+  (including a physical distribution medium), accompanied by a
+  written offer, valid for at least three years and valid for as
+  long as you offer spare parts or customer support for that product
+  model, to give anyone who possesses the object code either (1) a
+  copy of the Corresponding Source for all the software in the
+  product that is covered by this License, on a durable physical
+  medium customarily used for software interchange, for a price no
+  more than your reasonable cost of physically performing this
+  conveying of source, or (2) access to copy the Corresponding
+  Source from a network server at no charge.
+- c) Convey individual copies of the object code with a copy of the
+  written offer to provide the Corresponding Source. This
+  alternative is allowed only occasionally and noncommercially, and
+  only if you received the object code with such an offer, in accord
+  with subsection 6b.
+- d) Convey the object code by offering access from a designated
+  place (gratis or for a charge), and offer equivalent access to the
+  Corresponding Source in the same way through the same place at no
+  further charge. You need not require recipients to copy the
+  Corresponding Source along with the object code. If the place to
+  copy the object code is a network server, the Corresponding Source
+  may be on a different server (operated by you or a third party)
+  that supports equivalent copying facilities, provided you maintain
+  clear directions next to the object code saying where to find the
+  Corresponding Source. Regardless of what server hosts the
+  Corresponding Source, you remain obligated to ensure that it is
+  available for as long as needed to satisfy these requirements.
+- e) Convey the object code using peer-to-peer transmission,
+  provided you inform other peers where the object code and
+  Corresponding Source of the work are being offered to the general
+  public at no charge under subsection 6d.
+
+A separable portion of the object code, whose source code is excluded
+from the Corresponding Source as a System Library, need not be
+included in conveying the object code work.
+
+A "User Product" is either (1) a "consumer product", which means any
+tangible personal property which is normally used for personal,
+family, or household purposes, or (2) anything designed or sold for
+incorporation into a dwelling. In determining whether a product is a
+consumer product, doubtful cases shall be resolved in favor of
+coverage. For a particular product received by a particular user,
+"normally used" refers to a typical or common use of that class of
+product, regardless of the status of the particular user or of the way
+in which the particular user actually uses, or expects or is expected
+to use, the product. A product is a consumer product regardless of
+whether the product has substantial commercial, industrial or
+non-consumer uses, unless such uses represent the only significant
+mode of use of the product.
+
+"Installation Information" for a User Product means any methods,
+procedures, authorization keys, or other information required to
+install and execute modified versions of a covered work in that User
+Product from a modified version of its Corresponding Source. The
+information must suffice to ensure that the continued functioning of
+the modified object code is in no case prevented or interfered with
+solely because modification has been made.
+
+If you convey an object code work under this section in, or with, or
+specifically for use in, a User Product, and the conveying occurs as
+part of a transaction in which the right of possession and use of the
+User Product is transferred to the recipient in perpetuity or for a
+fixed term (regardless of how the transaction is characterized), the
+Corresponding Source conveyed under this section must be accompanied
+by the Installation Information. But this requirement does not apply
+if neither you nor any third party retains the ability to install
+modified object code on the User Product (for example, the work has
+been installed in ROM).
+
+The requirement to provide Installation Information does not include a
+requirement to continue to provide support service, warranty, or
+updates for a work that has been modified or installed by the
+recipient, or for the User Product in which it has been modified or
+installed. Access to a network may be denied when the modification
+itself materially and adversely affects the operation of the network
+or violates the rules and protocols for communication across the
+network.
+
+Corresponding Source conveyed, and Installation Information provided,
+in accord with this section must be in a format that is publicly
+documented (and with an implementation available to the public in
+source code form), and must require no special password or key for
+unpacking, reading or copying.
+
+### 7. Additional Terms.
+
+"Additional permissions" are terms that supplement the terms of this
+License by making exceptions from one or more of its conditions.
+Additional permissions that are applicable to the entire Program shall
+be treated as though they were included in this License, to the extent
+that they are valid under applicable law. If additional permissions
+apply only to part of the Program, that part may be used separately
+under those permissions, but the entire Program remains governed by
+this License without regard to the additional permissions.
+
+When you convey a copy of a covered work, you may at your option
+remove any additional permissions from that copy, or from any part of
+it. (Additional permissions may be written to require their own
+removal in certain cases when you modify the work.) You may place
+additional permissions on material, added by you to a covered work,
+for which you have or can give appropriate copyright permission.
+
+Notwithstanding any other provision of this License, for material you
+add to a covered work, you may (if authorized by the copyright holders
+of that material) supplement the terms of this License with terms:
+
+- a) Disclaiming warranty or limiting liability differently from the
+  terms of sections 15 and 16 of this License; or
+- b) Requiring preservation of specified reasonable legal notices or
+  author attributions in that material or in the Appropriate Legal
+  Notices displayed by works containing it; or
+- c) Prohibiting misrepresentation of the origin of that material,
+  or requiring that modified versions of such material be marked in
+  reasonable ways as different from the original version; or
+- d) Limiting the use for publicity purposes of names of licensors
+  or authors of the material; or
+- e) Declining to grant rights under trademark law for use of some
+  trade names, trademarks, or service marks; or
+- f) Requiring indemnification of licensors and authors of that
+  material by anyone who conveys the material (or modified versions
+  of it) with contractual assumptions of liability to the recipient,
+  for any liability that these contractual assumptions directly
+  impose on those licensors and authors.
+
+All other non-permissive additional terms are considered "further
+restrictions" within the meaning of section 10. If the Program as you
+received it, or any part of it, contains a notice stating that it is
+governed by this License along with a term that is a further
+restriction, you may remove that term. If a license document contains
+a further restriction but permits relicensing or conveying under this
+License, you may add to a covered work material governed by the terms
+of that license document, provided that the further restriction does
+not survive such relicensing or conveying.
+
+If you add terms to a covered work in accord with this section, you
+must place, in the relevant source files, a statement of the
+additional terms that apply to those files, or a notice indicating
+where to find the applicable terms.
+
+Additional terms, permissive or non-permissive, may be stated in the
+form of a separately written license, or stated as exceptions; the
+above requirements apply either way.
+
+### 8. Termination.
+
+You may not propagate or modify a covered work except as expressly
+provided under this License. Any attempt otherwise to propagate or
+modify it is void, and will automatically terminate your rights under
+this License (including any patent licenses granted under the third
+paragraph of section 11).
+
+However, if you cease all violation of this License, then your license
+from a particular copyright holder is reinstated (a) provisionally,
+unless and until the copyright holder explicitly and finally
+terminates your license, and (b) permanently, if the copyright holder
+fails to notify you of the violation by some reasonable means prior to
+60 days after the cessation.
+
+Moreover, your license from a particular copyright holder is
+reinstated permanently if the copyright holder notifies you of the
+violation by some reasonable means, this is the first time you have
+received notice of violation of this License (for any work) from that
+copyright holder, and you cure the violation prior to 30 days after
+your receipt of the notice.
+
+Termination of your rights under this section does not terminate the
+licenses of parties who have received copies or rights from you under
+this License. If your rights have been terminated and not permanently
+reinstated, you do not qualify to receive new licenses for the same
+material under section 10.
+
+### 9. Acceptance Not Required for Having Copies.
+
+You are not required to accept this License in order to receive or run
+a copy of the Program. Ancillary propagation of a covered work
+occurring solely as a consequence of using peer-to-peer transmission
+to receive a copy likewise does not require acceptance. However,
+nothing other than this License grants you permission to propagate or
+modify any covered work. These actions infringe copyright if you do
+not accept this License. Therefore, by modifying or propagating a
+covered work, you indicate your acceptance of this License to do so.
+
+### 10. Automatic Licensing of Downstream Recipients.
+
+Each time you convey a covered work, the recipient automatically
+receives a license from the original licensors, to run, modify and
+propagate that work, subject to this License. You are not responsible
+for enforcing compliance by third parties with this License.
+
+An "entity transaction" is a transaction transferring control of an
+organization, or substantially all assets of one, or subdividing an
+organization, or merging organizations. If propagation of a covered
+work results from an entity transaction, each party to that
+transaction who receives a copy of the work also receives whatever
+licenses to the work the party's predecessor in interest had or could
+give under the previous paragraph, plus a right to possession of the
+Corresponding Source of the work from the predecessor in interest, if
+the predecessor has it or can get it with reasonable efforts.
+
+You may not impose any further restrictions on the exercise of the
+rights granted or affirmed under this License. For example, you may
+not impose a license fee, royalty, or other charge for exercise of
+rights granted under this License, and you may not initiate litigation
+(including a cross-claim or counterclaim in a lawsuit) alleging that
+any patent claim is infringed by making, using, selling, offering for
+sale, or importing the Program or any portion of it.
+
+### 11. Patents.
+
+A "contributor" is a copyright holder who authorizes use under this
+License of the Program or a work on which the Program is based. The
+work thus licensed is called the contributor's "contributor version".
+
+A contributor's "essential patent claims" are all patent claims owned
+or controlled by the contributor, whether already acquired or
+hereafter acquired, that would be infringed by some manner, permitted
+by this License, of making, using, or selling its contributor version,
+but do not include claims that would be infringed only as a
+consequence of further modification of the contributor version. For
+purposes of this definition, "control" includes the right to grant
+patent sublicenses in a manner consistent with the requirements of
+this License.
+
+Each contributor grants you a non-exclusive, worldwide, royalty-free
+patent license under the contributor's essential patent claims, to
+make, use, sell, offer for sale, import and otherwise run, modify and
+propagate the contents of its contributor version.
+
+In the following three paragraphs, a "patent license" is any express
+agreement or commitment, however denominated, not to enforce a patent
+(such as an express permission to practice a patent or covenant not to
+sue for patent infringement). To "grant" such a patent license to a
+party means to make such an agreement or commitment not to enforce a
+patent against the party.
+
+If you convey a covered work, knowingly relying on a patent license,
+and the Corresponding Source of the work is not available for anyone
+to copy, free of charge and under the terms of this License, through a
+publicly available network server or other readily accessible means,
+then you must either (1) cause the Corresponding Source to be so
+available, or (2) arrange to deprive yourself of the benefit of the
+patent license for this particular work, or (3) arrange, in a manner
+consistent with the requirements of this License, to extend the patent
+license to downstream recipients. "Knowingly relying" means you have
+actual knowledge that, but for the patent license, your conveying the
+covered work in a country, or your recipient's use of the covered work
+in a country, would infringe one or more identifiable patents in that
+country that you have reason to believe are valid.
+
+If, pursuant to or in connection with a single transaction or
+arrangement, you convey, or propagate by procuring conveyance of, a
+covered work, and grant a patent license to some of the parties
+receiving the covered work authorizing them to use, propagate, modify
+or convey a specific copy of the covered work, then the patent license
+you grant is automatically extended to all recipients of the covered
+work and works based on it.
+
+A patent license is "discriminatory" if it does not include within the
+scope of its coverage, prohibits the exercise of, or is conditioned on
+the non-exercise of one or more of the rights that are specifically
+granted under this License. You may not convey a covered work if you
+are a party to an arrangement with a third party that is in the
+business of distributing software, under which you make payment to the
+third party based on the extent of your activity of conveying the
+work, and under which the third party grants, to any of the parties
+who would receive the covered work from you, a discriminatory patent
+license (a) in connection with copies of the covered work conveyed by
+you (or copies made from those copies), or (b) primarily for and in
+connection with specific products or compilations that contain the
+covered work, unless you entered into that arrangement, or that patent
+license was granted, prior to 28 March 2007.
+
+Nothing in this License shall be construed as excluding or limiting
+any implied license or other defenses to infringement that may
+otherwise be available to you under applicable patent law.
+
+### 12. No Surrender of Others' Freedom.
+
+If conditions are imposed on you (whether by court order, agreement or
+otherwise) that contradict the conditions of this License, they do not
+excuse you from the conditions of this License. If you cannot convey a
+covered work so as to satisfy simultaneously your obligations under
+this License and any other pertinent obligations, then as a
+consequence you may not convey it at all. For example, if you agree to
+terms that obligate you to collect a royalty for further conveying
+from those to whom you convey the Program, the only way you could
+satisfy both those terms and this License would be to refrain entirely
+from conveying the Program.
+
+### 13. Remote Network Interaction; Use with the GNU General Public License.
+
+Notwithstanding any other provision of this License, if you modify the
+Program, your modified version must prominently offer all users
+interacting with it remotely through a computer network (if your
+version supports such interaction) an opportunity to receive the
+Corresponding Source of your version by providing access to the
+Corresponding Source from a network server at no charge, through some
+standard or customary means of facilitating copying of software. This
+Corresponding Source shall include the Corresponding Source for any
+work covered by version 3 of the GNU General Public License that is
+incorporated pursuant to the following paragraph.
+
+Notwithstanding any other provision of this License, you have
+permission to link or combine any covered work with a work licensed
+under version 3 of the GNU General Public License into a single
+combined work, and to convey the resulting work. The terms of this
+License will continue to apply to the part which is the covered work,
+but the work with which it is combined will remain governed by version
+3 of the GNU General Public License.
+
+### 14. Revised Versions of this License.
+
+The Free Software Foundation may publish revised and/or new versions
+of the GNU Affero General Public License from time to time. Such new
+versions will be similar in spirit to the present version, but may
+differ in detail to address new problems or concerns.
+
+Each version is given a distinguishing version number. If the Program
+specifies that a certain numbered version of the GNU Affero General
+Public License "or any later version" applies to it, you have the
+option of following the terms and conditions either of that numbered
+version or of any later version published by the Free Software
+Foundation. If the Program does not specify a version number of the
+GNU Affero General Public License, you may choose any version ever
+published by the Free Software Foundation.
+
+If the Program specifies that a proxy can decide which future versions
+of the GNU Affero General Public License can be used, that proxy's
+public statement of acceptance of a version permanently authorizes you
+to choose that version for the Program.
+
+Later license versions may give you additional or different
+permissions. However, no additional obligations are imposed on any
+author or copyright holder as a result of your choosing to follow a
+later version.
+
+### 15. Disclaimer of Warranty.
+
+THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY
+APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT
+HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT
+WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT
+LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+A PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND
+PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE PROGRAM PROVE
+DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, REPAIR OR
+CORRECTION.
+
+### 16. Limitation of Liability.
+
+IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
+WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MODIFIES AND/OR
+CONVEYS THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES,
+INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES
+ARISING OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT
+NOT LIMITED TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR
+LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM
+TO OPERATE WITH ANY OTHER PROGRAMS), EVEN IF SUCH HOLDER OR OTHER
+PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
+
+### 17. Interpretation of Sections 15 and 16.
+
+If the disclaimer of warranty and limitation of liability provided
+above cannot be given local legal effect according to their terms,
+reviewing courts shall apply local law that most closely approximates
+an absolute waiver of all civil liability in connection with the
+Program, unless a warranty or assumption of liability accompanies a
+copy of the Program in return for a fee.
+
+END OF TERMS AND CONDITIONS
+
+## How to Apply These Terms to Your New Programs
+
+If you develop a new program, and you want it to be of the greatest
+possible use to the public, the best way to achieve this is to make it
+free software which everyone can redistribute and change under these
+terms.
+
+To do so, attach the following notices to the program. It is safest to
+attach them to the start of each source file to most effectively state
+the exclusion of warranty; and each file should have at least the
+"copyright" line and a pointer to where the full notice is found.
+
+        <one line to give the program's name and a brief idea of what it does.>
+        Copyright (C) <year>  <name of author>
+
+        This program is free software: you can redistribute it and/or modify
+        it under the terms of the GNU Affero General Public License as
+        published by the Free Software Foundation, either version 3 of the
+        License, or (at your option) any later version.
+
+        This program is distributed in the hope that it will be useful,
+        but WITHOUT ANY WARRANTY; without even the implied warranty of
+        MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+        GNU Affero General Public License for more details.
+
+        You should have received a copy of the GNU Affero General Public License
+        along with this program.  If not, see <https://www.gnu.org/licenses/>.
+
+Also add information on how to contact you by electronic and paper
+mail.
+
+If your software can interact with users remotely through a computer
+network, you should also make sure that it provides a way for users to
+get its source. For example, if your program is a web application, its
+interface could display a "Source" link that leads users to an archive
+of the code. There are many ways you could offer source, and different
+solutions will be better for different programs; see section 13 for
+the specific requirements.
+
+You should also get your employer (if you work as a programmer) or
+school, if any, to sign a "copyright disclaimer" for the program, if
+necessary. For more information on this, and how to apply and follow
+the GNU AGPL, see <https://www.gnu.org/licenses/>.
diff --git a/src/assets/notice.md b/src/assets/notice.md
new file mode 100644
index 0000000..30532be
--- /dev/null
+++ b/src/assets/notice.md
@@ -0,0 +1,15 @@
+**TrainUs — an open, local-first, offline-capable fitness tracking application where you can create and share your own training sessions.**  
+Copyright (C) 2026 [David Florance](http://kaivalya.eu)
+
+This program is free software: you can redistribute it and/or modify
+it under the terms of the GNU Affero General Public License as
+published by the Free Software Foundation, either version 3 of the
+License, or (at your option) any later version.
+
+This program is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+GNU Affero General Public License for more details.
+
+You should have received a copy of the GNU Affero General Public License
+along with this program. If not, see <http://www.gnu.org/licenses/>.
diff --git a/src/components/AboutDialog.vue b/src/components/AboutDialog.vue
new file mode 100644
index 0000000..82e4985
--- /dev/null
+++ b/src/components/AboutDialog.vue
@@ -0,0 +1,131 @@
+<script setup>
+import { ref } from 'vue'
+import { SCHEMA_VERSION } from '../db/schema.js'
+import ModalDialog from './ModalDialog.vue'
+import LicenseDialog from './LicenseDialog.vue'
+import noticeText from '../assets/notice.md?raw'
+import { renderMarkdown } from '../utils/markdown.js'
+
+defineEmits(['close'])
+
+const appVersion = __APP_VERSION__
+const dbVersion = SCHEMA_VERSION
+const showLicense = ref(false)
+const noticeHtml = renderMarkdown(noticeText)
+</script>
+
+<template>
+  <ModalDialog :title="$t('about.title')" @close="$emit('close')">
+    <div class="about-row">
+      <span class="about-label">{{ $t('about.appVersion') }}</span>
+      <span class="about-value" data-testid="about-app-version">{{ appVersion }}</span>
+    </div>
+
+    <div class="about-row">
+      <span class="about-label">{{ $t('about.dbVersion') }}</span>
+      <span class="about-value" data-testid="about-db-version">{{ dbVersion }}</span>
+    </div>
+
+    <div class="about-row">
+      <span class="about-label">{{ $t('about.author') }}</span>
+      <span class="about-value">David Florance</span>
+    </div>
+
+    <div class="about-row">
+      <span class="about-label">{{ $t('about.license') }}</span>
+      <span class="about-value" data-testid="about-license-name">GNU AGPL v3</span>
+    </div>
+
+    <div class="about-row">
+      <span class="about-label">{{ $t('about.links') }}</span>
+      <span class="about-value about-links">
+        <a
+          href="https://kaivalya.eu/app-git/kaivalya/trainUs"
+          class="about-link"
+          data-testid="about-repo-link"
+        >
+          <i class="bi bi-github"></i>
+          {{ $t('about.repository') }}
+        </a>
+        <a
+          href="https://kaivalya.eu/projects/trainUs"
+          class="about-link"
+          data-testid="about-website-link"
+        >
+          <i class="bi bi-globe"></i>
+          {{ $t('about.website') }}
+        </a>
+      </span>
+    </div>
+
+    <div class="about-notice" data-testid="about-notice" v-html="noticeHtml"></div>
+
+    <div class="about-license-row">
+      <button class="btn" data-testid="about-license-btn" @click="showLicense = true">
+        <i class="bi bi-file-text"></i>
+        {{ $t('about.licenseBtn') }}
+      </button>
+    </div>
+
+    <LicenseDialog v-if="showLicense" @close="showLicense = false" />
+  </ModalDialog>
+</template>
+
+<style scoped>
+.about-row {
+  display: flex;
+  align-items: flex-start;
+  gap: 12px;
+  padding: 10px 0;
+  border-bottom: 1px solid var(--border-color);
+  font-size: 14px;
+}
+
+.about-label {
+  flex: 0 0 auto;
+  white-space: nowrap;
+  color: var(--front-color2);
+  font-weight: 500;
+}
+
+.about-value {
+  flex: 1;
+  font-weight: 600;
+  word-break: break-all;
+}
+
+.about-links {
+  display: flex;
+  flex-direction: column;
+  gap: 6px;
+}
+
+.about-link {
+  display: flex;
+  align-items: center;
+  gap: 6px;
+  color: var(--front-color1);
+  font-weight: 500;
+}
+
+.about-link i {
+  font-size: 15px;
+}
+
+.about-notice {
+  margin-top: 16px;
+  padding: 12px;
+  background: var(--bg-color2);
+  border-radius: 8px;
+  font-size: 12px;
+  line-height: 1.6;
+  color: var(--front-color2);
+  word-break: break-word;
+}
+
+.about-license-row {
+  margin-top: 12px;
+  display: flex;
+  align-items: center;
+}
+</style>
diff --git a/src/components/BackupReminder.vue b/src/components/BackupReminder.vue
new file mode 100644
index 0000000..b6ffb99
--- /dev/null
+++ b/src/components/BackupReminder.vue
@@ -0,0 +1,117 @@
+<script setup>
+import { onMounted, ref, watch } from 'vue'
+import { useRouter } from 'vue-router'
+import { useBackupStatus } from '../composables/useBackupStatus.js'
+import ModalDialog from './ModalDialog.vue'
+
+const router = useRouter()
+const { visible, daysSinceBackup, lastBackupAt, load, isStale, sessionReminderShown } =
+  useBackupStatus()
+
+const showModal = ref(false)
+
+onMounted(async () => {
+  await load()
+  if (!sessionReminderShown.value) {
+    sessionReminderShown.value = true
+    if (isStale.value) {
+      showModal.value = true
+    }
+  }
+})
+
+watch(
+  () => router.currentRoute.value.fullPath,
+  async () => {
+    await load()
+  },
+)
+
+function handleClick() {
+  router.push('/settings')
+}
+
+function dismissModal() {
+  showModal.value = false
+}
+
+function goToSettings() {
+  showModal.value = false
+  router.push('/settings')
+}
+</script>
+
+<template>
+  <ModalDialog v-if="showModal" :title="$t('backup.modal.title')" @close="dismissModal">
+    <div data-testid="backup-modal">
+      <p class="modal-message">
+        {{
+          lastBackupAt
+            ? $t('backup.modal.body', { days: daysSinceBackup })
+            : $t('backup.modal.bodyNever')
+        }}
+      </p>
+      <div class="modal-actions">
+        <button class="btn" data-testid="backup-modal-dismiss" @click="dismissModal">
+          {{ $t('backup.modal.dismiss') }}
+        </button>
+        <button class="btn btn-primary" data-testid="backup-modal-settings" @click="goToSettings">
+          {{ $t('backup.modal.goToSettings') }}
+        </button>
+      </div>
+    </div>
+  </ModalDialog>
+
+  <Teleport to="#actionbar-actions" defer>
+    <button
+      v-if="visible"
+      class="backup-reminder-btn"
+      data-testid="backup-reminder"
+      :title="
+        lastBackupAt
+          ? $t('backup.reminder.tooltip', { days: daysSinceBackup })
+          : $t('backup.reminder.tooltipNever')
+      "
+      :aria-label="
+        lastBackupAt
+          ? $t('backup.reminder.tooltip', { days: daysSinceBackup })
+          : $t('backup.reminder.tooltipNever')
+      "
+      @click="handleClick"
+    >
+      <i class="bi bi-exclamation-triangle-fill"></i>
+    </button>
+  </Teleport>
+</template>
+
+<style scoped>
+.backup-reminder-btn {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+  padding: 4px 12px;
+  border: none;
+  border-radius: 4px;
+  background-color: var(--warning-color, #f0ad4e);
+  color: #fff;
+  font-size: 14px;
+  cursor: pointer;
+}
+
+.backup-reminder-btn i {
+  font-size: 16px;
+}
+
+.modal-message {
+  margin-bottom: 16px;
+  line-height: 1.5;
+}
+
+.modal-actions {
+  display: flex;
+  justify-content: flex-end;
+  gap: 8px;
+  padding-top: 16px;
+  border-top: 1px solid var(--border-color);
+}
+</style>
diff --git a/src/components/CleanJournalDialog.vue b/src/components/CleanJournalDialog.vue
new file mode 100644
index 0000000..58c5a6c
--- /dev/null
+++ b/src/components/CleanJournalDialog.vue
@@ -0,0 +1,196 @@
+<script setup>
+import { ref, watch } from 'vue'
+import { useTranslation } from 'i18next-vue'
+import ModalDialog from './ModalDialog.vue'
+import { useExecutionLogs } from '../composables/useExecutionLogs.js'
+
+const emit = defineEmits(['close', 'cleaned'])
+
+const { t } = useTranslation()
+const { getCountByDateRange, removeByDateRange } = useExecutionLogs()
+
+const today = new Date().toISOString().slice(0, 10)
+
+const fromDate = ref('')
+const toDate = ref('')
+const matchCount = ref(null)
+const confirmed = ref(false)
+const deleting = ref(false)
+const fromError = ref('')
+const toError = ref('')
+
+watch([fromDate, toDate], async () => {
+  confirmed.value = false
+  fromError.value = ''
+  toError.value = ''
+  matchCount.value = null
+  if (!fromDate.value || !toDate.value) return
+  if (fromDate.value > toDate.value) {
+    toError.value = t('cleanJournal.errorToBeforeFrom')
+    return
+  }
+  matchCount.value = await getCountByDateRange(fromDate.value, toDate.value)
+})
+
+async function onConfirm() {
+  if (!fromDate.value || !toDate.value || fromDate.value > toDate.value) return
+  if (!confirmed.value) return
+  deleting.value = true
+  try {
+    await removeByDateRange(fromDate.value, toDate.value)
+    emit('cleaned')
+    emit('close')
+  } finally {
+    deleting.value = false
+  }
+}
+</script>
+
+<template>
+  <ModalDialog :title="$t('cleanJournal.title')" @close="emit('close')">
+    <p class="hint">{{ $t('cleanJournal.hint') }}</p>
+
+    <div class="date-fields">
+      <div class="date-field">
+        <label for="clean-from">{{ $t('cleanJournal.from') }}</label>
+        <input
+          id="clean-from"
+          v-model="fromDate"
+          data-testid="clean-journal-from"
+          type="date"
+          :max="today"
+        />
+      </div>
+      <div class="date-field">
+        <label for="clean-to">{{ $t('cleanJournal.to') }}</label>
+        <input
+          id="clean-to"
+          v-model="toDate"
+          data-testid="clean-journal-to"
+          type="date"
+          :max="today"
+        />
+        <p v-if="toError" class="field-error" data-testid="clean-journal-date-error">
+          {{ toError }}
+        </p>
+      </div>
+    </div>
+
+    <p
+      v-if="matchCount !== null"
+      class="match-count"
+      :class="{ 'match-zero': matchCount === 0 }"
+      data-testid="clean-journal-count"
+    >
+      <i class="bi bi-info-circle"></i>
+      {{ $t('cleanJournal.matchCount', { count: matchCount }) }}
+    </p>
+
+    <label
+      v-if="matchCount !== null && matchCount > 0"
+      class="checkbox-label"
+      data-testid="clean-journal-confirm-label"
+    >
+      <input v-model="confirmed" type="checkbox" data-testid="clean-journal-confirm-checkbox" />
+      <span>{{ $t('cleanJournal.confirmLabel') }}</span>
+    </label>
+
+    <div class="confirm-actions">
+      <button class="btn" data-testid="clean-journal-cancel" @click="emit('close')">
+        {{ $t('import.cancel') }}
+      </button>
+      <button
+        class="btn btn-danger"
+        data-testid="clean-journal-delete"
+        :disabled="!confirmed || deleting || matchCount === 0 || matchCount === null"
+        @click="onConfirm"
+      >
+        <i class="bi bi-trash"></i>
+        {{ $t('cleanJournal.deleteBtn') }}
+      </button>
+    </div>
+  </ModalDialog>
+</template>
+
+<style scoped>
+.hint {
+  font-size: 14px;
+  color: var(--front-color2);
+  margin-bottom: 12px;
+}
+
+.date-fields {
+  display: flex;
+  gap: 16px;
+  flex-wrap: wrap;
+}
+
+.date-field {
+  display: flex;
+  flex-direction: column;
+  gap: 4px;
+  flex: 1;
+  min-width: 130px;
+}
+
+.date-field label {
+  font-size: 14px;
+  font-weight: 600;
+}
+
+.field-error {
+  color: var(--btn-danger-bg);
+  font-size: 13px;
+  margin: 0;
+}
+
+.match-count {
+  margin-top: 12px;
+  font-size: 14px;
+  display: flex;
+  align-items: center;
+  gap: 6px;
+  color: var(--btn-danger-bg);
+}
+
+.match-count.match-zero {
+  color: var(--front-color2);
+}
+
+.checkbox-label {
+  display: flex;
+  align-items: flex-start;
+  gap: 8px;
+  margin-top: 12px;
+  font-size: 14px;
+  cursor: pointer;
+  word-wrap: break-word;
+  overflow-wrap: break-word;
+}
+
+.checkbox-label input[type='checkbox'] {
+  margin-top: 2px;
+  flex-shrink: 0;
+  width: 16px;
+  height: 16px;
+}
+
+.checkbox-label span {
+  flex: 1 1 0;
+  min-width: 0;
+}
+
+.confirm-actions {
+  display: flex;
+  justify-content: flex-end;
+  gap: 8px;
+  margin-top: 16px;
+  padding-top: 16px;
+  border-top: 1px solid var(--border-color);
+}
+
+.confirm-actions button:disabled {
+  opacity: 0.5;
+  cursor: not-allowed;
+}
+</style>
diff --git a/src/components/CreditsDialog.vue b/src/components/CreditsDialog.vue
new file mode 100644
index 0000000..3e294b7
--- /dev/null
+++ b/src/components/CreditsDialog.vue
@@ -0,0 +1,151 @@
+<script setup>
+import ModalDialog from './ModalDialog.vue'
+
+defineEmits(['close'])
+</script>
+
+<template>
+  <ModalDialog :title="$t('credits.title')" @close="$emit('close')">
+    <p class="credits-intro">{{ $t('credits.intro') }}</p>
+
+    <div class="credit-item">
+      <div class="credit-header">
+        <i class="bi bi-lightning-charge-fill credit-icon"></i>
+        <strong>{{ $t('credits.appIcon.name') }}</strong>
+      </div>
+      <p class="credit-detail">{{ $t('credits.appIcon.description') }}</p>
+      <p class="credit-meta">
+        <span class="credit-license">CC BY 3.0</span>
+        &mdash;
+        <a href="https://game-icons.net" target="_blank" rel="noopener noreferrer">
+          game-icons.net
+        </a>
+        &mdash;
+        {{ $t('credits.appIcon.author') }}
+      </p>
+      <p class="credit-note">{{ $t('credits.gameIcons') }}</p>
+    </div>
+
+    <div class="credit-item">
+      <div class="credit-header">
+        <i class="bi bi-grid-3x3-gap-fill credit-icon"></i>
+        <strong>{{ $t('credits.bootstrapIcons.name') }}</strong>
+      </div>
+      <p class="credit-detail">{{ $t('credits.bootstrapIcons.description') }}</p>
+      <p class="credit-meta">
+        <span class="credit-license">MIT</span>
+        &mdash;
+        <a href="https://icons.getbootstrap.com" target="_blank" rel="noopener noreferrer">
+          icons.getbootstrap.com
+        </a>
+      </p>
+    </div>
+
+    <div class="credit-item">
+      <div class="credit-header">
+        <i class="bi bi-box-seam credit-icon"></i>
+        <strong>{{ $t('credits.thirdParties.title') }}</strong>
+      </div>
+      <p class="credit-detail credit-links">
+        <a href="https://vuejs.org" target="_blank" rel="noopener noreferrer">Vue</a>,
+        <a href="https://router.vuejs.org" target="_blank" rel="noopener noreferrer">Vue Router</a>,
+        <a href="https://vitejs.dev" target="_blank" rel="noopener noreferrer">Vite</a>,
+        <a href="https://sqlite.org/wasm/" target="_blank" rel="noopener noreferrer">SQLite WASM</a
+        >, <a href="https://www.chartjs.org" target="_blank" rel="noopener noreferrer">Chart.js</a>,
+        <a href="https://vue-chartjs.org" target="_blank" rel="noopener noreferrer">vue-chartjs</a>,
+        <a href="https://www.i18next.com" target="_blank" rel="noopener noreferrer">i18next</a>,
+        <a href="https://i18next.github.io/i18next-vue/" target="_blank" rel="noopener noreferrer"
+          >i18next-vue</a
+        >, <a href="https://prettier.io" target="_blank" rel="noopener noreferrer">Prettier</a>,
+        <a href="https://vite-pwa-org.netlify.app" target="_blank" rel="noopener noreferrer"
+          >vite-plugin-pwa</a
+        >, <a href="https://marked.js.org" target="_blank" rel="noopener noreferrer">marked</a>,
+        <a href="https://github.com/cure53/DOMPurify" target="_blank" rel="noopener noreferrer"
+          >DOMPurify</a
+        >
+      </p>
+    </div>
+
+    <div class="credit-item">
+      <div class="credit-header">
+        <i class="bi bi-check2-square credit-icon"></i>
+        <strong>{{ $t('credits.testingTools.title') }}</strong>
+      </div>
+      <p class="credit-detail credit-links">
+        <a href="https://playwright.dev/python/" target="_blank" rel="noopener noreferrer"
+          >Playwright</a
+        >, <a href="https://pytest.org" target="_blank" rel="noopener noreferrer">pytest</a>
+      </p>
+    </div>
+  </ModalDialog>
+</template>
+
+<style scoped>
+.credits-intro {
+  font-size: 14px;
+  color: var(--front-color2);
+  margin: 0 0 20px;
+}
+
+.credit-item {
+  padding: 14px 0;
+  border-bottom: 1px solid var(--border-color);
+}
+
+.credit-item:last-child {
+  border-bottom: none;
+  padding-bottom: 0;
+}
+
+.credit-header {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+  margin-bottom: 6px;
+}
+
+.credit-icon {
+  font-size: 16px;
+  color: var(--front-color2);
+}
+
+.credit-detail {
+  font-size: 13px;
+  color: var(--front-color2);
+  margin: 0 0 6px;
+}
+
+.credit-meta {
+  font-size: 13px;
+  margin: 0;
+  display: flex;
+  align-items: center;
+  gap: 6px;
+  flex-wrap: wrap;
+}
+
+.credit-license {
+  display: inline-block;
+  padding: 1px 7px;
+  border-radius: 10px;
+  background-color: var(--btn-primary-bg);
+  color: var(--btn-primary-color);
+  font-size: 11px;
+  font-weight: 600;
+}
+
+.credit-links {
+  line-height: 1.8;
+}
+
+.credit-note {
+  font-size: 12px;
+  color: var(--front-color2);
+  margin: 6px 0 0;
+  font-style: italic;
+}
+
+a {
+  color: var(--front-color1);
+}
+</style>
diff --git a/src/components/ExportFilterDialog.vue b/src/components/ExportFilterDialog.vue
new file mode 100644
index 0000000..882706d
--- /dev/null
+++ b/src/components/ExportFilterDialog.vue
@@ -0,0 +1,104 @@
+<script setup>
+import { ref } from 'vue'
+import ModalDialog from './ModalDialog.vue'
+
+const emit = defineEmits(['close', 'export'])
+
+const filters = ref({
+  exercises: true,
+  combos: true,
+  sessions: true,
+  collections: true,
+  executionLogs: false,
+  settings: false,
+})
+
+function onExport() {
+  emit('export', { ...filters.value })
+}
+</script>
+
+<template>
+  <ModalDialog :title="$t('export.filterTitle')" @close="$emit('close')">
+    <p class="text-muted">{{ $t('export.filterDescription') }}</p>
+
+    <div class="filter-list">
+      <label class="filter-item" data-testid="export-filter-exercises">
+        <input v-model="filters.exercises" type="checkbox" />
+        <span>{{ $t('nav.exercises') }}</span>
+      </label>
+      <label class="filter-item" data-testid="export-filter-combos">
+        <input v-model="filters.combos" type="checkbox" />
+        <span>{{ $t('nav.combos') }}</span>
+      </label>
+      <label class="filter-item" data-testid="export-filter-sessions">
+        <input v-model="filters.sessions" type="checkbox" />
+        <span>{{ $t('nav.sessions') }}</span>
+      </label>
+      <label class="filter-item" data-testid="export-filter-collections">
+        <input v-model="filters.collections" type="checkbox" />
+        <span>{{ $t('nav.collections') }}</span>
+      </label>
+      <label class="filter-item" data-testid="export-filter-execution-logs">
+        <input v-model="filters.executionLogs" type="checkbox" />
+        <span>{{ $t('export.executionLogs') }}</span>
+      </label>
+      <label class="filter-item" data-testid="export-filter-settings">
+        <input v-model="filters.settings" type="checkbox" />
+        <span>{{ $t('export.settings') }}</span>
+      </label>
+    </div>
+
+    <div class="export-actions">
+      <button class="btn" data-testid="export-filter-cancel" @click="$emit('close')">
+        {{ $t('import.cancel') }}
+      </button>
+      <button
+        class="btn btn-primary"
+        data-testid="export-filter-confirm"
+        :disabled="
+          !filters.exercises &&
+          !filters.combos &&
+          !filters.sessions &&
+          !filters.collections &&
+          !filters.executionLogs &&
+          !filters.settings
+        "
+        @click="onExport"
+      >
+        <i class="bi bi-download"></i>
+        {{ $t('settings.exportData') }}
+      </button>
+    </div>
+  </ModalDialog>
+</template>
+
+<style scoped>
+.filter-list {
+  margin: 16px 0;
+}
+
+.filter-item {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+  padding: 8px 0;
+  cursor: pointer;
+  font-size: 15px;
+}
+
+.filter-item input[type='checkbox'] {
+  width: 16px;
+  height: 16px;
+  flex-shrink: 0;
+}
+
+.export-actions {
+  display: flex;
+  justify-content: flex-end;
+  gap: 8px;
+  margin-top: 16px;
+  padding-top: 16px;
+  border-top: 1px solid var(--border-color);
+}
+</style>
diff --git a/src/components/ImportDialog.vue b/src/components/ImportDialog.vue
new file mode 100644
index 0000000..8e0cb02
--- /dev/null
+++ b/src/components/ImportDialog.vue
@@ -0,0 +1,862 @@
+<script setup>
+import { ref, computed, onMounted } from 'vue'
+import { useTranslation } from 'i18next-vue'
+import ModalDialog from './ModalDialog.vue'
+import { useJsonImport, COLLISION_ACTION } from '../composables/useJsonImport.js'
+
+const props = defineProps({
+  envelope: { type: Object, required: true },
+  localUuid: { type: String, required: true },
+  asMine: { type: Boolean, default: false },
+})
+
+const emit = defineEmits(['close', 'done'])
+
+const { t } = useTranslation()
+const { analyzeAll, applyAllImport } = useJsonImport()
+
+// State machine: 'loading' | 'suffix' | 'preview' | 'collisions' | 'applying' | 'report'
+const step = ref('loading')
+const analysis = ref(null)
+const applying = ref(false)
+const report = ref(null)
+
+// Suffix input for different-user imports
+const suffixInput = ref('')
+const suffixError = ref('')
+
+// Collision resolutions per entity type (also receives cross-user title-conflict
+// resolutions once they're discovered in onApply — see crossUserConflictsChecked)
+const exerciseResolutions = ref([])
+const comboResolutions = ref([])
+const sessionResolutions = ref([])
+const collectionResolutions = ref([])
+
+// Guards against re-running findTitleConflicts after the user has already resolved them
+const crossUserConflictsChecked = ref(false)
+
+const summary = computed(() => analysis.value?.summary || {})
+
+const totalEntityCount = computed(() => {
+  let count = 0
+  if (analysis.value?.exercises) count += analysis.value.exercises.total
+  if (analysis.value?.combos) count += analysis.value.combos.total
+  if (analysis.value?.sessions) count += analysis.value.sessions.total
+  if (analysis.value?.collections) count += analysis.value.collections.total
+  if (analysis.value?.executionLogs) count += analysis.value.executionLogs.total
+  return count
+})
+
+// Derived from the resolution refs directly (not from `analysis`) so it stays correct
+// whether resolutions came from same-user id/title collisions or cross-user title conflicts.
+const hasCollisions = computed(() => totalCollisions.value > 0)
+
+const totalCollisions = computed(
+  () =>
+    exerciseResolutions.value.length +
+    comboResolutions.value.length +
+    sessionResolutions.value.length +
+    collectionResolutions.value.length,
+)
+
+onMounted(async () => {
+  analysis.value = await analyzeAll(props.envelope, { asMine: props.asMine })
+  const a = analysis.value
+
+  if (a.summary.isSameUser) {
+    // Initialize collision resolutions (id and title conflicts are both bucketed
+    // into sameUserCollisions by useJsonImport.js)
+    if (a.exercises?.sameUserCollisions?.length) {
+      exerciseResolutions.value = a.exercises.sameUserCollisions.map((c) => ({
+        ...c,
+        action: COLLISION_ACTION.SKIP,
+      }))
+    }
+    if (a.combos?.sameUserCollisions?.length) {
+      comboResolutions.value = a.combos.sameUserCollisions.map((c) => ({
+        ...c,
+        action: COLLISION_ACTION.SKIP,
+      }))
+    }
+    if (a.sessions?.sameUserCollisions?.length) {
+      sessionResolutions.value = a.sessions.sameUserCollisions.map((c) => ({
+        ...c,
+        action: COLLISION_ACTION.SKIP,
+      }))
+    }
+    if (a.collections?.sameUserCollisions?.length) {
+      collectionResolutions.value = a.collections.sameUserCollisions.map((c) => ({
+        ...c,
+        action: COLLISION_ACTION.SKIP,
+      }))
+    }
+    step.value = hasCollisions.value ? 'collisions' : 'preview'
+  } else {
+    if (a.suffixInfo?.needsSuffix) {
+      suffixInput.value = a.summary.exporterName
+      step.value = 'suffix'
+    } else {
+      step.value = 'preview'
+    }
+  }
+})
+
+// --- Actions ---
+
+/**
+ * Check title conflicts for a list of different-user entities against existing data.
+ * Returns the matched existing row alongside the entry so the caller can offer
+ * Replace/Skip against it (same as same-user collisions) instead of forcing a rename.
+ */
+async function findTitleConflicts(entries, entityType, titleField, suffix, getAll) {
+  if (!entries?.length) return []
+  const allEntities = await getAll()
+  const conflicts = []
+  for (const entry of entries) {
+    const suffixedTitle = `${entry.imported[titleField]} [${suffix}]`
+    if (entry.action === 'update' && entry.existing?.[titleField] === suffixedTitle) continue
+    const conflict = allEntities.find(
+      (e) => e[titleField] === suffixedTitle && e.id !== entry.imported.id,
+    )
+    if (conflict) {
+      conflicts.push({ entity: entityType, entry, existing: conflict })
+    }
+  }
+  return conflicts
+}
+
+async function onApply() {
+  applying.value = true
+  step.value = 'applying'
+
+  try {
+    const a = analysis.value
+
+    // For different-user imports, check title conflicts (on the suffixed title) once,
+    // before applying. Found conflicts are folded into the same resolution arrays used
+    // for same-user collisions, so the existing Replace/Skip screen handles them too.
+    if (!a.summary.isSameUser && !crossUserConflictsChecked.value) {
+      crossUserConflictsChecked.value = true
+      const suffix = a.suffixInfo?.existingSuffix || suffixInput.value.trim()
+
+      const [exConflicts, coConflicts, seConflicts, clConflicts] = await Promise.all([
+        findTitleConflicts(a.exercises?.differentUser, 'exercise', 'title', suffix, async () => {
+          const { exerciseRepository } = await import('../db/repositories/exerciseRepository.js')
+          return exerciseRepository.getAll()
+        }),
+        findTitleConflicts(a.combos?.differentUser, 'combo', 'title', suffix, async () => {
+          const { comboRepository } = await import('../db/repositories/comboRepository.js')
+          return comboRepository.getAll()
+        }),
+        findTitleConflicts(a.sessions?.differentUser, 'session', 'title', suffix, async () => {
+          const { sessionRepository } = await import('../db/repositories/sessionRepository.js')
+          return sessionRepository.getAll()
+        }),
+        findTitleConflicts(
+          a.collections?.differentUser,
+          'collection',
+          'label',
+          suffix,
+          async () => {
+            const { collectionRepository } =
+              await import('../db/repositories/collectionRepository.js')
+            return collectionRepository.getAll()
+          },
+        ),
+      ])
+
+      const conflicts = [...exConflicts, ...coConflicts, ...seConflicts, ...clConflicts]
+
+      if (conflicts.length > 0) {
+        for (const conflict of conflicts) {
+          const resolutions = getResolutionsForType(conflict.entity)
+          resolutions.value.push({
+            imported: conflict.entry.imported,
+            existing: conflict.existing,
+            action: COLLISION_ACTION.SKIP,
+          })
+        }
+        step.value = 'collisions'
+        applying.value = false
+        return
+      }
+    }
+
+    // Apply import
+    report.value = await applyAllImport(analysis.value, {
+      suffix: analysis.value.suffixInfo?.existingSuffix || suffixInput.value.trim(),
+      exerciseResolutions: exerciseResolutions.value,
+      comboResolutions: comboResolutions.value,
+      sessionResolutions: sessionResolutions.value,
+      collectionResolutions: collectionResolutions.value,
+    })
+
+    step.value = 'report'
+  } catch (e) {
+    report.value = {
+      exercises: { imported: 0, skipped: 0, replaced: 0, updated: 0 },
+      combos: { imported: 0, skipped: 0, replaced: 0, updated: 0 },
+      sessions: { imported: 0, skipped: 0, replaced: 0, updated: 0 },
+      collections: { imported: 0, skipped: 0, replaced: 0, updated: 0 },
+      executionLogs: { imported: 0, skipped: 0 },
+      settings: { imported: 0 },
+      errors: [e.message],
+    }
+    step.value = 'report'
+  } finally {
+    applying.value = false
+  }
+}
+
+async function onConfirmSuffix() {
+  const trimmed = suffixInput.value.trim()
+  if (!trimmed) {
+    suffixError.value = t('import.suffixRequired')
+    return
+  }
+
+  const { suffixRepository } = await import('../db/repositories/suffixRepository.js')
+  const existing = await suffixRepository.getBySuffix(trimmed)
+  if (existing && existing.user_uuid !== analysis.value.summary.exporterUuid) {
+    suffixError.value = t('import.suffixTaken')
+    return
+  }
+
+  suffixError.value = ''
+  step.value = 'preview'
+}
+
+function setAllCollisions(entityType, action) {
+  const resolutions = getResolutionsForType(entityType)
+  resolutions.value = resolutions.value.map((c) => ({ ...c, action }))
+}
+
+function setCollisionAction(entityType, index, action) {
+  const resolutions = getResolutionsForType(entityType)
+  resolutions.value[index] = { ...resolutions.value[index], action }
+}
+
+function getResolutionsForType(entityType) {
+  switch (entityType) {
+    case 'exercise':
+      return exerciseResolutions
+    case 'combo':
+      return comboResolutions
+    case 'session':
+      return sessionResolutions
+    case 'collection':
+      return collectionResolutions
+    default:
+      return { value: [] }
+  }
+}
+
+function onDone() {
+  emit('done', report.value)
+}
+
+function formatDate(isoString) {
+  try {
+    return new Date(isoString).toLocaleDateString()
+  } catch {
+    return isoString
+  }
+}
+
+const totalImported = computed(() => {
+  if (!report.value) return 0
+  let count = 0
+  for (const key of ['exercises', 'combos', 'sessions', 'collections', 'executionLogs']) {
+    const r = report.value[key]
+    if (r) {
+      count += (r.imported || 0) + (r.replaced || 0) + (r.updated || 0)
+    }
+  }
+  return count
+})
+
+const totalSkipped = computed(() => {
+  if (!report.value) return 0
+  let count = 0
+  for (const key of ['exercises', 'combos', 'sessions', 'collections', 'executionLogs']) {
+    const r = report.value[key]
+    if (r) count += r.skipped || 0
+  }
+  return count
+})
+</script>
+
+<template>
+  <ModalDialog
+    :title="asMine ? $t('import.titleAsMine') : $t('import.title')"
+    wide
+    @close="$emit('close')"
+  >
+    <!-- Loading -->
+    <div v-if="step === 'loading'" class="import-loading" data-testid="import-loading">
+      <i class="bi bi-arrow-repeat spin"></i>
+      <p>{{ $t('app.loading') }}</p>
+    </div>
+
+    <!-- Suffix prompt -->
+    <div v-else-if="step === 'suffix'" class="import-suffix" data-testid="import-suffix-step">
+      <p>{{ $t('import.suffixExplanation', { name: summary.exporterName }) }}</p>
+      <div class="form-group">
+        <label for="suffix-input">{{ $t('import.suffixLabel') }}</label>
+        <input
+          id="suffix-input"
+          v-model="suffixInput"
+          type="text"
+          data-testid="import-suffix-input"
+          :placeholder="$t('import.suffixPlaceholder')"
+          @keyup.enter="onConfirmSuffix"
+        />
+        <p v-if="suffixError" class="field-error" data-testid="import-suffix-error">
+          {{ suffixError }}
+        </p>
+      </div>
+      <p class="text-muted import-suffix-preview">
+        {{ $t('import.suffixPreview', { title: 'Push-ups', suffix: suffixInput.trim() || '...' }) }}
+      </p>
+      <div class="import-actions">
+        <button class="btn" data-testid="import-cancel" @click="$emit('close')">
+          {{ $t('import.cancel') }}
+        </button>
+        <button
+          class="btn btn-primary"
+          data-testid="import-suffix-confirm"
+          @click="onConfirmSuffix"
+        >
+          {{ $t('import.continue') }}
+        </button>
+      </div>
+    </div>
+
+    <!-- Preview -->
+    <div v-else-if="step === 'preview'" class="import-preview" data-testid="import-preview-step">
+      <div class="import-summary">
+        <p>
+          <strong>{{ totalEntityCount }}</strong>
+          {{ $t('import.totalCount', { count: totalEntityCount }) }}
+        </p>
+        <p class="text-muted">
+          {{
+            $t('import.from', { name: summary.exporterName, date: formatDate(summary.exportDate) })
+          }}
+        </p>
+        <p
+          v-if="!summary.isSameUser && (analysis.suffixInfo?.existingSuffix || suffixInput.trim())"
+          class="text-muted"
+        >
+          {{
+            $t('import.usingSuffix', {
+              suffix: analysis.suffixInfo?.existingSuffix || suffixInput.trim(),
+            })
+          }}
+        </p>
+        <!-- Entity breakdown -->
+        <ul class="entity-breakdown">
+          <li v-if="analysis.exercises">
+            {{ analysis.exercises.total }} {{ $t('nav.exercises') }}
+          </li>
+          <li v-if="analysis.combos">{{ analysis.combos.total }} {{ $t('nav.combos') }}</li>
+          <li v-if="analysis.sessions">{{ analysis.sessions.total }} {{ $t('nav.sessions') }}</li>
+          <li v-if="analysis.collections">
+            {{ analysis.collections.total }} {{ $t('nav.collections') }}
+          </li>
+          <li v-if="analysis.executionLogs">
+            {{ analysis.executionLogs.total }} {{ $t('import.executionLogs') }}
+          </li>
+        </ul>
+      </div>
+      <div class="import-actions">
+        <button class="btn" data-testid="import-cancel" @click="$emit('close')">
+          {{ $t('import.cancel') }}
+        </button>
+        <button class="btn btn-primary" data-testid="import-apply" @click="onApply">
+          {{ $t('import.apply') }}
+        </button>
+      </div>
+    </div>
+
+    <!-- Same-user collisions -->
+    <div
+      v-else-if="step === 'collisions'"
+      class="import-collisions"
+      data-testid="import-collisions-step"
+    >
+      <p>{{ $t('import.collisionExplanation', { count: totalCollisions }) }}</p>
+
+      <!-- Exercises collisions -->
+      <div
+        v-if="exerciseResolutions.length > 0"
+        class="collision-group"
+        data-testid="collision-group-exercises"
+      >
+        <h4>{{ $t('nav.exercises') }}</h4>
+        <div class="collision-batch">
+          <button
+            class="btn btn-sm"
+            data-testid="exercise-replace-all"
+            @click="setAllCollisions('exercise', COLLISION_ACTION.REPLACE)"
+          >
+            {{ $t('import.replaceAll') }}
+          </button>
+          <button
+            class="btn btn-sm"
+            data-testid="exercise-skip-all"
+            @click="setAllCollisions('exercise', COLLISION_ACTION.SKIP)"
+          >
+            {{ $t('import.skipAll') }}
+          </button>
+        </div>
+        <div
+          v-for="(collision, index) in exerciseResolutions"
+          :key="collision.imported.id"
+          class="collision-item"
+          :data-testid="'collision-item-exercise-' + index"
+        >
+          <div class="collision-info">
+            <strong>{{ collision.imported.title }}</strong>
+          </div>
+          <div class="collision-actions">
+            <button
+              class="btn btn-sm"
+              :class="{ 'btn-primary': collision.action === COLLISION_ACTION.REPLACE }"
+              :data-testid="'collision-replace-exercise-' + index"
+              @click="setCollisionAction('exercise', index, COLLISION_ACTION.REPLACE)"
+            >
+              {{ $t('import.replace') }}
+            </button>
+            <button
+              class="btn btn-sm"
+              :class="{ 'btn-primary': collision.action === COLLISION_ACTION.SKIP }"
+              :data-testid="'collision-skip-exercise-' + index"
+              @click="setCollisionAction('exercise', index, COLLISION_ACTION.SKIP)"
+            >
+              {{ $t('import.skip') }}
+            </button>
+          </div>
+        </div>
+      </div>
+
+      <!-- Combos collisions -->
+      <div
+        v-if="comboResolutions.length > 0"
+        class="collision-group"
+        data-testid="collision-group-combos"
+      >
+        <h4>{{ $t('nav.combos') }}</h4>
+        <div class="collision-batch">
+          <button
+            class="btn btn-sm"
+            data-testid="combo-replace-all"
+            @click="setAllCollisions('combo', COLLISION_ACTION.REPLACE)"
+          >
+            {{ $t('import.replaceAll') }}
+          </button>
+          <button
+            class="btn btn-sm"
+            data-testid="combo-skip-all"
+            @click="setAllCollisions('combo', COLLISION_ACTION.SKIP)"
+          >
+            {{ $t('import.skipAll') }}
+          </button>
+        </div>
+        <div
+          v-for="(collision, index) in comboResolutions"
+          :key="collision.imported.id"
+          class="collision-item"
+          :data-testid="'collision-item-combo-' + index"
+        >
+          <div class="collision-info">
+            <strong>{{ collision.imported.title }}</strong>
+          </div>
+          <div class="collision-actions">
+            <button
+              class="btn btn-sm"
+              :class="{ 'btn-primary': collision.action === COLLISION_ACTION.REPLACE }"
+              :data-testid="'collision-replace-combo-' + index"
+              @click="setCollisionAction('combo', index, COLLISION_ACTION.REPLACE)"
+            >
+              {{ $t('import.replace') }}
+            </button>
+            <button
+              class="btn btn-sm"
+              :class="{ 'btn-primary': collision.action === COLLISION_ACTION.SKIP }"
+              :data-testid="'collision-skip-combo-' + index"
+              @click="setCollisionAction('combo', index, COLLISION_ACTION.SKIP)"
+            >
+              {{ $t('import.skip') }}
+            </button>
+          </div>
+        </div>
+      </div>
+
+      <!-- Sessions collisions -->
+      <div
+        v-if="sessionResolutions.length > 0"
+        class="collision-group"
+        data-testid="collision-group-sessions"
+      >
+        <h4>{{ $t('nav.sessions') }}</h4>
+        <div class="collision-batch">
+          <button
+            class="btn btn-sm"
+            data-testid="session-replace-all"
+            @click="setAllCollisions('session', COLLISION_ACTION.REPLACE)"
+          >
+            {{ $t('import.replaceAll') }}
+          </button>
+          <button
+            class="btn btn-sm"
+            data-testid="session-skip-all"
+            @click="setAllCollisions('session', COLLISION_ACTION.SKIP)"
+          >
+            {{ $t('import.skipAll') }}
+          </button>
+        </div>
+        <div
+          v-for="(collision, index) in sessionResolutions"
+          :key="collision.imported.id"
+          class="collision-item"
+          :data-testid="'collision-item-session-' + index"
+        >
+          <div class="collision-info">
+            <strong>{{ collision.imported.title }}</strong>
+          </div>
+          <div class="collision-actions">
+            <button
+              class="btn btn-sm"
+              :class="{ 'btn-primary': collision.action === COLLISION_ACTION.REPLACE }"
+              :data-testid="'collision-replace-session-' + index"
+              @click="setCollisionAction('session', index, COLLISION_ACTION.REPLACE)"
+            >
+              {{ $t('import.replace') }}
+            </button>
+            <button
+              class="btn btn-sm"
+              :class="{ 'btn-primary': collision.action === COLLISION_ACTION.SKIP }"
+              :data-testid="'collision-skip-session-' + index"
+              @click="setCollisionAction('session', index, COLLISION_ACTION.SKIP)"
+            >
+              {{ $t('import.skip') }}
+            </button>
+          </div>
+        </div>
+      </div>
+
+      <!-- Collections collisions -->
+      <div
+        v-if="collectionResolutions.length > 0"
+        class="collision-group"
+        data-testid="collision-group-collections"
+      >
+        <h4>{{ $t('nav.collections') }}</h4>
+        <div class="collision-batch">
+          <button
+            class="btn btn-sm"
+            data-testid="collection-replace-all"
+            @click="setAllCollisions('collection', COLLISION_ACTION.REPLACE)"
+          >
+            {{ $t('import.replaceAll') }}
+          </button>
+          <button
+            class="btn btn-sm"
+            data-testid="collection-skip-all"
+            @click="setAllCollisions('collection', COLLISION_ACTION.SKIP)"
+          >
+            {{ $t('import.skipAll') }}
+          </button>
+        </div>
+        <div
+          v-for="(collision, index) in collectionResolutions"
+          :key="collision.imported.id"
+          class="collision-item"
+          :data-testid="'collision-item-collection-' + index"
+        >
+          <div class="collision-info">
+            <strong>{{ collision.imported.label }}</strong>
+          </div>
+          <div class="collision-actions">
+            <button
+              class="btn btn-sm"
+              :class="{ 'btn-primary': collision.action === COLLISION_ACTION.REPLACE }"
+              :data-testid="'collision-replace-collection-' + index"
+              @click="setCollisionAction('collection', index, COLLISION_ACTION.REPLACE)"
+            >
+              {{ $t('import.replace') }}
+            </button>
+            <button
+              class="btn btn-sm"
+              :class="{ 'btn-primary': collision.action === COLLISION_ACTION.SKIP }"
+              :data-testid="'collision-skip-collection-' + index"
+              @click="setCollisionAction('collection', index, COLLISION_ACTION.SKIP)"
+            >
+              {{ $t('import.skip') }}
+            </button>
+          </div>
+        </div>
+      </div>
+
+      <div class="import-actions">
+        <button class="btn" data-testid="import-cancel" @click="$emit('close')">
+          {{ $t('import.cancel') }}
+        </button>
+        <button class="btn btn-primary" data-testid="import-apply" @click="onApply">
+          {{ $t('import.apply') }}
+        </button>
+      </div>
+    </div>
+
+    <!-- Applying -->
+    <div v-else-if="step === 'applying'" class="import-loading" data-testid="import-applying">
+      <i class="bi bi-arrow-repeat spin"></i>
+      <p>{{ $t('import.importing') }}</p>
+    </div>
+
+    <!-- Report -->
+    <div v-else-if="step === 'report'" class="import-report" data-testid="import-report-step">
+      <div
+        class="report-summary"
+        :class="report.errors?.length ? 'report-has-errors' : 'report-ok'"
+      >
+        <i :class="report.errors?.length ? 'bi bi-exclamation-triangle' : 'bi bi-check-circle'"></i>
+        <strong>{{ $t('import.reportTitle') }}</strong>
+      </div>
+      <ul class="report-details">
+        <li v-if="totalImported" data-testid="import-report-imported">
+          {{ $t('import.reportTotalImported', { count: totalImported }) }}
+        </li>
+        <li v-if="totalSkipped" data-testid="import-report-skipped">
+          {{ $t('import.reportSkipped', { count: totalSkipped }) }}
+        </li>
+        <!-- Per-entity breakdown -->
+        <li v-if="report.exercises?.imported" data-testid="import-report-exercises-imported">
+          {{ $t('import.reportImported', { count: report.exercises.imported }) }}
+          {{ $t('nav.exercises') }}
+        </li>
+        <li v-if="report.exercises?.replaced" data-testid="import-report-exercises-replaced">
+          {{ $t('import.reportReplaced', { count: report.exercises.replaced }) }}
+          {{ $t('nav.exercises') }}
+        </li>
+        <li v-if="report.exercises?.updated" data-testid="import-report-exercises-updated">
+          {{ $t('import.reportUpdated', { count: report.exercises.updated }) }}
+          {{ $t('nav.exercises') }}
+        </li>
+        <li v-if="report.combos?.imported" data-testid="import-report-combos-imported">
+          {{ $t('import.reportImported', { count: report.combos.imported }) }}
+          {{ $t('nav.combos') }}
+        </li>
+        <li v-if="report.combos?.replaced" data-testid="import-report-combos-replaced">
+          {{ $t('import.reportReplaced', { count: report.combos.replaced }) }}
+          {{ $t('nav.combos') }}
+        </li>
+        <li v-if="report.combos?.updated" data-testid="import-report-combos-updated">
+          {{ $t('import.reportUpdated', { count: report.combos.updated }) }}
+          {{ $t('nav.combos') }}
+        </li>
+        <li v-if="report.sessions?.imported" data-testid="import-report-sessions-imported">
+          {{ $t('import.reportImported', { count: report.sessions.imported }) }}
+          {{ $t('nav.sessions') }}
+        </li>
+        <li v-if="report.sessions?.replaced" data-testid="import-report-sessions-replaced">
+          {{ $t('import.reportReplaced', { count: report.sessions.replaced }) }}
+          {{ $t('nav.sessions') }}
+        </li>
+        <li v-if="report.sessions?.updated" data-testid="import-report-sessions-updated">
+          {{ $t('import.reportUpdated', { count: report.sessions.updated }) }}
+          {{ $t('nav.sessions') }}
+        </li>
+        <li v-if="report.collections?.imported" data-testid="import-report-collections-imported">
+          {{ $t('import.reportImported', { count: report.collections.imported }) }}
+          {{ $t('nav.collections') }}
+        </li>
+        <li v-if="report.collections?.replaced" data-testid="import-report-collections-replaced">
+          {{ $t('import.reportReplaced', { count: report.collections.replaced }) }}
+          {{ $t('nav.collections') }}
+        </li>
+        <li v-if="report.collections?.updated" data-testid="import-report-collections-updated">
+          {{ $t('import.reportUpdated', { count: report.collections.updated }) }}
+          {{ $t('nav.collections') }}
+        </li>
+        <li v-if="report.executionLogs?.imported" data-testid="import-report-logs-imported">
+          {{ $t('import.reportImported', { count: report.executionLogs.imported }) }}
+          {{ $t('import.executionLogs') }}
+        </li>
+        <li v-if="report.settings?.imported" data-testid="import-report-settings-imported">
+          {{ $t('import.reportImported', { count: report.settings.imported }) }}
+          {{ $t('nav.settings') }}
+        </li>
+        <li
+          v-for="(err, i) in report.errors"
+          :key="i"
+          class="report-error-item"
+          :data-testid="'import-report-error-' + i"
+        >
+          {{ err }}
+        </li>
+      </ul>
+      <div class="import-actions">
+        <button class="btn btn-primary" data-testid="import-done" @click="onDone">
+          {{ $t('import.done') }}
+        </button>
+      </div>
+    </div>
+  </ModalDialog>
+</template>
+
+<style scoped>
+.import-loading {
+  text-align: center;
+  padding: 20px 0;
+}
+
+.import-loading .spin {
+  font-size: 32px;
+  display: inline-block;
+  animation: spin 1s linear infinite;
+}
+
+@keyframes spin {
+  from {
+    transform: rotate(0deg);
+  }
+  to {
+    transform: rotate(360deg);
+  }
+}
+
+.import-summary {
+  margin-bottom: 16px;
+}
+
+.import-summary p {
+  margin: 4px 0;
+}
+
+.entity-breakdown {
+  list-style: disc;
+  padding-left: 20px;
+  margin: 8px 0 0;
+  font-size: 14px;
+  color: var(--color-text-muted);
+}
+
+.entity-breakdown li {
+  margin-bottom: 2px;
+}
+
+.import-actions {
+  display: flex;
+  justify-content: flex-end;
+  gap: 8px;
+  margin-top: 16px;
+  padding-top: 16px;
+  border-top: 1px solid var(--border-color);
+}
+
+.form-group {
+  margin: 12px 0;
+}
+
+.form-group label {
+  display: block;
+  font-weight: 600;
+  font-size: 14px;
+  margin-bottom: 4px;
+}
+
+.field-error {
+  color: var(--btn-danger-bg);
+  font-size: 13px;
+  margin: 4px 0 0;
+}
+
+.import-suffix-preview {
+  font-size: 13px;
+  font-style: italic;
+}
+
+.collision-group {
+  margin-bottom: 16px;
+}
+
+.collision-group h4 {
+  margin: 0 0 8px;
+  font-size: 15px;
+  font-weight: 600;
+}
+
+.collision-batch {
+  display: flex;
+  gap: 8px;
+  margin-bottom: 8px;
+}
+
+.collision-item {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  padding: 8px 0;
+  border-bottom: 1px solid var(--border-color);
+}
+
+.collision-info {
+  flex: 1;
+  min-width: 0;
+}
+
+.collision-info strong {
+  display: block;
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+}
+
+.collision-info .text-muted {
+  font-size: 12px;
+}
+
+.collision-actions {
+  display: flex;
+  gap: 4px;
+  flex-shrink: 0;
+  margin-left: 8px;
+}
+
+.btn-sm {
+  font-size: 12px;
+  padding: 4px 10px;
+}
+
+.report-summary {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+  font-size: 16px;
+  margin-bottom: 12px;
+}
+
+.report-ok {
+  color: #28a745;
+}
+
+.report-has-errors {
+  color: var(--btn-danger-bg);
+}
+
+.report-details {
+  list-style: disc;
+  padding-left: 20px;
+  font-size: 14px;
+}
+
+.report-details li {
+  margin-bottom: 4px;
+}
+
+.report-error-item {
+  color: var(--btn-danger-bg);
+}
+</style>
diff --git a/src/components/InstallPrompt.vue b/src/components/InstallPrompt.vue
new file mode 100644
index 0000000..217d5b9
--- /dev/null
+++ b/src/components/InstallPrompt.vue
@@ -0,0 +1,65 @@
+<script setup>
+import { ref } from 'vue'
+import { useInstallPrompt } from '../composables/useInstallPrompt.js'
+
+const { canInstall, install } = useInstallPrompt()
+const dismissed = ref(false)
+</script>
+
+<template>
+  <Teleport v-if="canInstall && !dismissed" to="#actionbar-actions" defer>
+    <button
+      class="install-btn"
+      data-testid="install-prompt-btn"
+      :aria-label="$t('install.button')"
+      :title="$t('install.button')"
+      @click="install"
+    >
+      <i class="bi bi-download"></i>
+    </button>
+    <button
+      class="install-dismiss-btn"
+      data-testid="install-prompt-dismiss"
+      :aria-label="$t('install.dismiss')"
+      :title="$t('install.dismiss')"
+      @click="dismissed = true"
+    >
+      <i class="bi bi-x-lg"></i>
+    </button>
+  </Teleport>
+</template>
+
+<style scoped>
+.install-btn {
+  display: flex;
+  align-items: center;
+  gap: 6px;
+  padding: 4px 10px;
+  border: 1px solid var(--btn-primary-bg);
+  border-radius: 4px;
+  background: transparent;
+  color: var(--actionbar-font-color);
+  font-size: 14px;
+  cursor: pointer;
+}
+
+.install-btn:hover {
+  background: rgba(255, 255, 255, 0.1);
+}
+
+.install-dismiss-btn {
+  background: none;
+  border: none;
+  color: var(--actionbar-font-color);
+  cursor: pointer;
+  padding: 4px;
+  font-size: 16px;
+  display: flex;
+  align-items: center;
+  opacity: 0.7;
+}
+
+.install-dismiss-btn:hover {
+  opacity: 1;
+}
+</style>
diff --git a/src/components/LicenseDialog.vue b/src/components/LicenseDialog.vue
new file mode 100644
index 0000000..491c6b2
--- /dev/null
+++ b/src/components/LicenseDialog.vue
@@ -0,0 +1,23 @@
+<script setup>
+import licenseText from '../assets/license.md?raw'
+import { renderMarkdown } from '../utils/markdown.js'
+import ModalDialog from './ModalDialog.vue'
+
+defineEmits(['close'])
+
+const licenseHtml = renderMarkdown(licenseText)
+</script>
+
+<template>
+  <ModalDialog :title="$t('about.licenseBtn')" wide @close="$emit('close')">
+    <div class="license-body" data-testid="license-dialog-content" v-html="licenseHtml"></div>
+  </ModalDialog>
+</template>
+
+<style scoped>
+.license-body {
+  font-size: 13px;
+  line-height: 1.7;
+  color: var(--front-color1);
+}
+</style>
diff --git a/src/components/ModalDialog.vue b/src/components/ModalDialog.vue
new file mode 100644
index 0000000..c8a85d5
--- /dev/null
+++ b/src/components/ModalDialog.vue
@@ -0,0 +1,116 @@
+<script setup>
+import { useId, onMounted, ref } from 'vue'
+
+defineProps({
+  title: { type: String, default: '' },
+  wide: { type: Boolean, default: false },
+})
+
+const emit = defineEmits(['close'])
+
+const uid = useId()
+const cardRef = ref(null)
+
+onMounted(() => {
+  cardRef.value?.focus()
+})
+</script>
+
+<template>
+  <Teleport to="body">
+    <div
+      class="modal-overlay"
+      data-testid="modal-overlay"
+      @click.self="emit('close')"
+      @keydown.esc="emit('close')"
+    >
+      <div
+        ref="cardRef"
+        class="modal-card"
+        :class="{ 'modal-wide': wide }"
+        data-testid="modal-card"
+        role="dialog"
+        aria-modal="true"
+        :aria-labelledby="title ? `modal-title-${uid}` : undefined"
+        tabindex="-1"
+      >
+        <div v-if="title" class="modal-header">
+          <h3 :id="`modal-title-${uid}`" data-testid="modal-title">{{ title }}</h3>
+          <button
+            class="modal-close-btn"
+            data-testid="modal-close"
+            :aria-label="$t('modal.close')"
+            @click="emit('close')"
+          >
+            <i class="bi bi-x-lg"></i>
+          </button>
+        </div>
+        <div class="modal-body">
+          <slot />
+        </div>
+      </div>
+    </div>
+  </Teleport>
+</template>
+
+<style scoped>
+.modal-overlay {
+  position: fixed;
+  inset: 0;
+  background: rgba(0, 0, 0, 0.5);
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  z-index: 10000;
+  padding: 16px;
+}
+
+.modal-card {
+  background: var(--bg-color1);
+  border: 1px solid var(--border-color);
+  border-radius: 12px;
+  width: 100%;
+  max-width: 480px;
+  max-height: 85vh;
+  overflow-y: auto;
+  box-shadow: 0 8px 32px rgba(0, 0, 0, 0.2);
+  outline: none;
+}
+
+.modal-wide {
+  max-width: 600px;
+}
+
+.modal-header {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  padding: 16px 20px;
+  border-bottom: 1px solid var(--border-color);
+}
+
+.modal-header h3 {
+  font-size: 17px;
+  font-weight: 600;
+  margin: 0;
+}
+
+.modal-close-btn {
+  background: none;
+  border: none;
+  color: var(--front-color1);
+  font-size: 18px;
+  cursor: pointer;
+  padding: 4px;
+  line-height: 1;
+  opacity: 0.7;
+}
+
+.modal-close-btn:hover {
+  opacity: 1;
+}
+
+.modal-body {
+  padding: 20px;
+}
+</style>
diff --git a/src/components/SaveFileDialog.vue b/src/components/SaveFileDialog.vue
new file mode 100644
index 0000000..b32188b
--- /dev/null
+++ b/src/components/SaveFileDialog.vue
@@ -0,0 +1,84 @@
+<script setup>
+import { nextTick, ref, watch } from 'vue'
+import ModalDialog from './ModalDialog.vue'
+import { useSaveFilePrompt } from '../composables/useSaveFilePrompt.js'
+
+const { pendingSave, confirmFilename, cancelFilename } = useSaveFilePrompt()
+
+const stem = ref('')
+const inputRef = ref(null)
+
+watch(pendingSave, async (save) => {
+  if (!save) return
+  stem.value = save.defaultStem
+  await nextTick()
+  inputRef.value?.focus()
+  inputRef.value?.select()
+})
+
+function onSave() {
+  confirmFilename(stem.value)
+}
+</script>
+
+<template>
+  <ModalDialog v-if="pendingSave" :title="$t('saveFile.title')" @close="cancelFilename">
+    <label class="save-file-label" for="save-file-input">{{ $t('saveFile.label') }}</label>
+    <div class="save-file-input-row">
+      <input
+        id="save-file-input"
+        ref="inputRef"
+        v-model="stem"
+        type="text"
+        class="save-file-input"
+        data-testid="save-file-input"
+        @keydown.enter="onSave"
+      />
+      <span class="save-file-extension" data-testid="save-file-extension">{{
+        pendingSave.extension
+      }}</span>
+    </div>
+    <div class="save-file-actions">
+      <button class="btn" data-testid="save-file-cancel" @click="cancelFilename">
+        {{ $t('saveFile.cancel') }}
+      </button>
+      <button class="btn btn-primary" data-testid="save-file-confirm" @click="onSave">
+        {{ $t('saveFile.save') }}
+      </button>
+    </div>
+  </ModalDialog>
+</template>
+
+<style scoped>
+.save-file-label {
+  display: block;
+  font-size: 13px;
+  color: var(--front-color2);
+  margin-bottom: 6px;
+}
+
+.save-file-input-row {
+  display: flex;
+  align-items: center;
+  gap: 4px;
+}
+
+.save-file-input {
+  flex: 1;
+  min-width: 0;
+}
+
+.save-file-extension {
+  color: var(--front-color2);
+  white-space: nowrap;
+}
+
+.save-file-actions {
+  display: flex;
+  justify-content: flex-end;
+  gap: 8px;
+  margin-top: 16px;
+  padding-top: 16px;
+  border-top: 1px solid var(--border-color);
+}
+</style>
diff --git a/src/components/TimerDisplay.vue b/src/components/TimerDisplay.vue
new file mode 100644
index 0000000..852b608
--- /dev/null
+++ b/src/components/TimerDisplay.vue
@@ -0,0 +1,75 @@
+<script setup>
+import { computed } from 'vue'
+
+const props = defineProps({
+  remaining: { type: Number, required: true },
+  isPaused: { type: Boolean, default: false },
+  pauseLabel: { type: String, default: 'Pause' },
+  resumeLabel: { type: String, default: 'Resume' },
+})
+
+const emit = defineEmits(['toggle-pause'])
+
+const formatted = computed(() => {
+  const s = Math.max(0, props.remaining)
+  const m = Math.floor(s / 60)
+  const sec = s % 60
+  return `${String(m).padStart(2, '0')}:${String(sec).padStart(2, '0')}`
+})
+</script>
+
+<template>
+  <div class="timer-display">
+    <span class="timer-countdown" :class="{ 'timer-low': remaining > 0 && remaining < 10 }">
+      {{ formatted }}
+    </span>
+    <button
+      class="timer-pause-btn btn-primary"
+      :aria-label="isPaused ? resumeLabel : pauseLabel"
+      @click="emit('toggle-pause')"
+    >
+      <i :class="isPaused ? 'bi bi-play-fill' : 'bi bi-pause-fill'"></i>
+      {{ isPaused ? resumeLabel : pauseLabel }}
+    </button>
+  </div>
+</template>
+
+<style scoped>
+.timer-display {
+  display: flex;
+  flex-direction: column;
+  align-items: center;
+  gap: 10px;
+  margin: 12px 0;
+}
+
+.timer-countdown {
+  font-size: 48px;
+  font-weight: 700;
+  font-variant-numeric: tabular-nums;
+  letter-spacing: 0.02em;
+  color: var(--color-text);
+  transition: color 0.3s;
+}
+
+.timer-low {
+  color: var(--btn-danger-bg, #dc3545);
+}
+
+.timer-pause-btn {
+  display: inline-flex;
+  align-items: center;
+  gap: 6px;
+  padding: 6px 16px;
+  border: 1px solid var(--border-color);
+  border-radius: 8px;
+  cursor: pointer;
+  font-size: 14px;
+  font-weight: 500;
+  transition: opacity 0.15s;
+}
+
+.timer-pause-btn:hover {
+  opacity: 0.8;
+}
+</style>
diff --git a/src/composables/useAudioCues.js b/src/composables/useAudioCues.js
new file mode 100644
index 0000000..9470806
--- /dev/null
+++ b/src/composables/useAudioCues.js
@@ -0,0 +1,33 @@
+let audioCtx = null
+
+function getCtx() {
+  if (!audioCtx) audioCtx = new AudioContext()
+  return audioCtx
+}
+
+function _beep(freq, duration, gain) {
+  try {
+    const ctx = getCtx()
+    if (ctx.state === 'suspended') ctx.resume()
+    const osc = ctx.createOscillator()
+    const gainNode = ctx.createGain()
+    osc.connect(gainNode)
+    gainNode.connect(ctx.destination)
+    osc.frequency.value = freq
+    gainNode.gain.value = gain
+    osc.start()
+    osc.stop(ctx.currentTime + duration)
+  } catch (_e) {
+    // Ignore audio errors — beep is best-effort
+  }
+}
+
+export function useAudioCues() {
+  function playBip(volume = 1.0) {
+    _beep(440, 0.1, 0.6 * volume)
+  }
+  function playBIP(volume = 1.0) {
+    _beep(880, 0.3, 1.0 * volume)
+  }
+  return { playBip, playBIP }
+}
diff --git a/src/composables/useBackupDownload.js b/src/composables/useBackupDownload.js
new file mode 100644
index 0000000..00fff40
--- /dev/null
+++ b/src/composables/useBackupDownload.js
@@ -0,0 +1,31 @@
+import { db } from '../db/database.js'
+import { formatBackupFilename } from '../utils/backupFilename.js'
+import { useBackupStatus } from './useBackupStatus.js'
+import { useSaveFilePrompt } from './useSaveFilePrompt.js'
+
+export function useBackupDownload() {
+  const { markBackedUp } = useBackupStatus()
+  const { promptFilename } = useSaveFilePrompt()
+
+  /**
+   * Prompts for a filename, exports the database, triggers a file download,
+   * and records last_backup_at. Returns false without side effects if cancelled.
+   */
+  async function downloadBackup() {
+    const filename = await promptFilename(formatBackupFilename(__APP_VERSION__))
+    if (!filename) return false
+
+    const bytes = await db.exportDatabase()
+    const blob = new Blob([bytes], { type: 'application/x-sqlite3' })
+    const url = URL.createObjectURL(blob)
+    const a = document.createElement('a')
+    a.href = url
+    a.download = filename
+    a.click()
+    URL.revokeObjectURL(url)
+    await markBackedUp()
+    return true
+  }
+
+  return { downloadBackup }
+}
diff --git a/src/composables/useBackupStatus.js b/src/composables/useBackupStatus.js
new file mode 100644
index 0000000..e47490b
--- /dev/null
+++ b/src/composables/useBackupStatus.js
@@ -0,0 +1,81 @@
+import { ref, computed } from 'vue'
+import { useSettings } from './useSettings.js'
+
+const DEFAULT_REMINDER_DAYS = 7
+
+const lastBackupAt = ref(null)
+const dbCreatedAt = ref(null)
+const backupReminderDays = ref(DEFAULT_REMINDER_DAYS)
+const sessionReminderShown = ref(false)
+
+export function useBackupStatus() {
+  const { get, set } = useSettings()
+
+  async function load() {
+    const lastBackupAtStr = await get('last_backup_at')
+    if (lastBackupAtStr) {
+      lastBackupAt.value = new Date(lastBackupAtStr)
+    } else {
+      lastBackupAt.value = null
+    }
+
+    const dbCreatedAtStr = await get('db_created_at')
+    if (dbCreatedAtStr) {
+      dbCreatedAt.value = new Date(dbCreatedAtStr)
+    } else {
+      dbCreatedAt.value = null
+    }
+
+    const daysStr = await get('backup_reminder_days')
+    const parsed = parseInt(daysStr, 10)
+    if (!isNaN(parsed) && parsed >= 1 && parsed <= 365) {
+      backupReminderDays.value = parsed
+    } else {
+      if (daysStr !== null && daysStr !== undefined) {
+        console.warn(
+          `[useBackupStatus] Invalid backup_reminder_days value: "${daysStr}", falling back to ${DEFAULT_REMINDER_DAYS}`,
+        )
+      }
+      backupReminderDays.value = DEFAULT_REMINDER_DAYS
+    }
+  }
+
+  const daysSinceBackup = computed(() => {
+    const effectiveDate = lastBackupAt.value || dbCreatedAt.value
+    if (!effectiveDate) return null
+    const now = new Date()
+    const diffMs = now.getTime() - effectiveDate.getTime()
+    return Math.floor(diffMs / (1000 * 60 * 60 * 24))
+  })
+
+  const isStale = computed(() => {
+    const effectiveDate = lastBackupAt.value || dbCreatedAt.value
+    if (!effectiveDate) return true
+    const now = new Date()
+    const diffMs = now.getTime() - effectiveDate.getTime()
+    const thresholdMs = backupReminderDays.value * 86_400_000
+    return diffMs > thresholdMs
+  })
+
+  const visible = computed(() => {
+    return isStale.value
+  })
+
+  async function markBackedUp() {
+    const now = new Date().toISOString()
+    await set('last_backup_at', now)
+    lastBackupAt.value = new Date(now)
+  }
+
+  return {
+    lastBackupAt,
+    dbCreatedAt,
+    daysSinceBackup,
+    isStale,
+    visible,
+    load,
+    markBackedUp,
+    backupReminderDays,
+    sessionReminderShown,
+  }
+}
diff --git a/src/composables/useCollections.js b/src/composables/useCollections.js
new file mode 100644
index 0000000..2679f3d
--- /dev/null
+++ b/src/composables/useCollections.js
@@ -0,0 +1,54 @@
+import { ref } from 'vue'
+import { collectionRepository } from '../db/repositories/collectionRepository.js'
+
+export function useCollections() {
+  const collections = ref([])
+  const loading = ref(false)
+  const error = ref(null)
+
+  async function fetchAll() {
+    loading.value = true
+    error.value = null
+    try {
+      collections.value = await collectionRepository.getAll()
+    } catch (e) {
+      error.value = e.message
+    } finally {
+      loading.value = false
+    }
+  }
+
+  async function create(data) {
+    const id = await collectionRepository.create(data)
+    await fetchAll()
+    return id
+  }
+
+  async function update(id, data) {
+    await collectionRepository.update(id, data)
+    await fetchAll()
+  }
+
+  async function remove(id) {
+    await collectionRepository.delete(id)
+    await fetchAll()
+  }
+
+  async function search(query) {
+    loading.value = true
+    error.value = null
+    try {
+      collections.value = await collectionRepository.search(query)
+    } catch (e) {
+      error.value = e.message
+    } finally {
+      loading.value = false
+    }
+  }
+
+  async function getById(id) {
+    return collectionRepository.getById(id)
+  }
+
+  return { collections, loading, error, fetchAll, create, update, remove, search, getById }
+}
diff --git a/src/composables/useCombos.js b/src/composables/useCombos.js
new file mode 100644
index 0000000..dcdcbc7
--- /dev/null
+++ b/src/composables/useCombos.js
@@ -0,0 +1,54 @@
+import { ref } from 'vue'
+import { comboRepository } from '../db/repositories/comboRepository.js'
+
+export function useCombos() {
+  const combos = ref([])
+  const loading = ref(false)
+  const error = ref(null)
+
+  async function fetchAll() {
+    loading.value = true
+    error.value = null
+    try {
+      combos.value = await comboRepository.getAll()
+    } catch (e) {
+      error.value = e.message
+    } finally {
+      loading.value = false
+    }
+  }
+
+  async function create(data) {
+    const id = await comboRepository.create(data)
+    await fetchAll()
+    return id
+  }
+
+  async function update(id, data) {
+    await comboRepository.update(id, data)
+    await fetchAll()
+  }
+
+  async function remove(id) {
+    await comboRepository.delete(id)
+    await fetchAll()
+  }
+
+  async function search(query) {
+    loading.value = true
+    error.value = null
+    try {
+      combos.value = await comboRepository.search(query)
+    } catch (e) {
+      error.value = e.message
+    } finally {
+      loading.value = false
+    }
+  }
+
+  async function getById(id) {
+    return comboRepository.getById(id)
+  }
+
+  return { combos, loading, error, fetchAll, create, update, remove, search, getById }
+}
diff --git a/src/composables/useDatabase.js b/src/composables/useDatabase.js
new file mode 100644
index 0000000..ca38749
--- /dev/null
+++ b/src/composables/useDatabase.js
@@ -0,0 +1,42 @@
+import { ref, readonly } from 'vue'
+import { db } from '../db/database.js'
+
+const initialized = ref(false)
+const initializing = ref(false)
+const dbInfo = ref(null)
+const error = ref(null)
+const migrationPending = ref(null)
+
+export function useDatabase() {
+  async function init() {
+    if (initialized.value || initializing.value) return dbInfo.value
+    initializing.value = true
+    try {
+      dbInfo.value = await db.init()
+      migrationPending.value = db.migrationPending
+      initialized.value = !db.migrationPending
+      return dbInfo.value
+    } catch (e) {
+      error.value = e.message
+      throw e
+    } finally {
+      initializing.value = false
+    }
+  }
+
+  async function runPendingMigrations() {
+    await db.runPendingMigrations()
+    migrationPending.value = null
+    initialized.value = true
+  }
+
+  return {
+    initialized: readonly(initialized),
+    initializing: readonly(initializing),
+    dbInfo: readonly(dbInfo),
+    error: readonly(error),
+    migrationPending: readonly(migrationPending),
+    init,
+    runPendingMigrations,
+  }
+}
diff --git a/src/composables/useExecutionLogs.js b/src/composables/useExecutionLogs.js
new file mode 100644
index 0000000..452475d
--- /dev/null
+++ b/src/composables/useExecutionLogs.js
@@ -0,0 +1,69 @@
+import { ref } from 'vue'
+import { executionLogRepository } from '../db/repositories/executionLogRepository.js'
+
+export function useExecutionLogs() {
+  const logs = ref([])
+  const loading = ref(false)
+  const error = ref(null)
+
+  async function fetchAll() {
+    loading.value = true
+    error.value = null
+    try {
+      logs.value = await executionLogRepository.getAll()
+    } catch (e) {
+      error.value = e.message
+    } finally {
+      loading.value = false
+    }
+  }
+
+  async function fetchBySession(sessionId) {
+    loading.value = true
+    error.value = null
+    try {
+      logs.value = await executionLogRepository.getBySessionId(sessionId)
+    } catch (e) {
+      error.value = e.message
+    } finally {
+      loading.value = false
+    }
+  }
+
+  async function create(data) {
+    const id = await executionLogRepository.create(data)
+    await fetchAll()
+    return id
+  }
+
+  async function remove(id) {
+    await executionLogRepository.delete(id)
+    await fetchAll()
+  }
+
+  async function getById(id) {
+    return executionLogRepository.getById(id)
+  }
+
+  async function getCountByDateRange(from, to) {
+    return executionLogRepository.getCountByDateRange(from, to)
+  }
+
+  async function removeByDateRange(from, to) {
+    await executionLogRepository.deleteByDateRange(from, to)
+    await fetchAll()
+  }
+
+  return {
+    logs,
+    loading,
+    error,
+    fetchAll,
+    fetchBySession,
+    create,
+    remove,
+    getById,
+    getCountByDateRange,
+    removeByDateRange,
+  }
+}
diff --git a/src/composables/useExercises.js b/src/composables/useExercises.js
new file mode 100644
index 0000000..57797d0
--- /dev/null
+++ b/src/composables/useExercises.js
@@ -0,0 +1,54 @@
+import { ref } from 'vue'
+import { exerciseRepository } from '../db/repositories/exerciseRepository.js'
+
+export function useExercises() {
+  const exercises = ref([])
+  const loading = ref(false)
+  const error = ref(null)
+
+  async function fetchAll() {
+    loading.value = true
+    error.value = null
+    try {
+      exercises.value = await exerciseRepository.getAll()
+    } catch (e) {
+      error.value = e.message
+    } finally {
+      loading.value = false
+    }
+  }
+
+  async function create(data) {
+    const id = await exerciseRepository.create(data)
+    await fetchAll()
+    return id
+  }
+
+  async function update(id, data) {
+    await exerciseRepository.update(id, data)
+    await fetchAll()
+  }
+
+  async function remove(id) {
+    await exerciseRepository.delete(id)
+    await fetchAll()
+  }
+
+  async function search(query) {
+    loading.value = true
+    error.value = null
+    try {
+      exercises.value = await exerciseRepository.search(query)
+    } catch (e) {
+      error.value = e.message
+    } finally {
+      loading.value = false
+    }
+  }
+
+  async function getById(id) {
+    return exerciseRepository.getById(id)
+  }
+
+  return { exercises, loading, error, fetchAll, create, update, remove, search, getById }
+}
diff --git a/src/composables/useHtmlExport.js b/src/composables/useHtmlExport.js
new file mode 100644
index 0000000..21c2d47
--- /dev/null
+++ b/src/composables/useHtmlExport.js
@@ -0,0 +1,268 @@
+import i18next from 'i18next'
+import { formatDate, formatDuration, formatItemDuration } from '../utils/dateFormatter.js'
+import { useSaveFilePrompt } from './useSaveFilePrompt.js'
+
+function escHtml(str) {
+  return String(str ?? '')
+    .replace(/&/g, '&amp;')
+    .replace(/</g, '&lt;')
+    .replace(/>/g, '&gt;')
+    .replace(/"/g, '&quot;')
+}
+
+function enrichItemsWithTiming(log) {
+  const items = log.items || []
+  return items.map((item, i) => {
+    const curr = item.timestamp ? new Date(item.timestamp).getTime() : null
+    const prev =
+      i === 0
+        ? log.started_at
+          ? new Date(log.started_at).getTime()
+          : null
+        : items[i - 1].timestamp
+          ? new Date(items[i - 1].timestamp).getTime()
+          : null
+    return { ...item, duration_ms: curr && prev ? curr - prev : null }
+  })
+}
+
+function groupItems(items) {
+  if (!items || items.length === 0) return []
+  const result = []
+  const comboMap = {}
+  for (const item of items) {
+    if (!item.combo_id) {
+      result.push({ type: 'exercise', item })
+    } else {
+      if (!comboMap[item.combo_id]) {
+        comboMap[item.combo_id] = {
+          type: 'combo',
+          combo_id: item.combo_id,
+          combo_title: item.combo_title,
+          exercises: [],
+        }
+        result.push(comboMap[item.combo_id])
+      }
+      comboMap[item.combo_id].exercises.push(item)
+    }
+  }
+  return result
+}
+
+function comboRounds(group) {
+  const hasRounds = group.exercises.some((ex) => ex.round_number != null)
+  if (!hasRounds) return [group.exercises]
+  const map = {}
+  for (const ex of group.exercises) {
+    const rn = ex.round_number ?? 0
+    if (!map[rn]) map[rn] = []
+    map[rn].push(ex)
+  }
+  return Object.entries(map)
+    .sort(([a], [b]) => Number(a) - Number(b))
+    .map(([, exes]) => exes)
+}
+
+function itemParens(item) {
+  const parts = [item.reps_done, item.weight_used]
+  const dur = formatItemDuration(item.duration_ms)
+  if (dur) parts.push(dur)
+  return `(${parts.join(',')})`
+}
+
+function renderSessionItemsHtml(log) {
+  const groups = groupItems(enrichItemsWithTiming(log))
+  if (!groups.length) return ''
+  return groups
+    .map((group, gi) => {
+      const sep = gi > 0 ? ', ' : ''
+      if (group.type === 'exercise') {
+        return `${sep}${escHtml(group.item.exercise_title)} ${escHtml(itemParens(group.item))}`
+      }
+      const rounds = comboRounds(group)
+      const roundsHtml = rounds
+        .map((round, ri) => {
+          const exsHtml = round
+            .map((ex, ei) => {
+              const sep2 = ri > 0 || ei > 0 ? ', ' : ''
+              return `${sep2}${escHtml(ex.exercise_title)} ${escHtml(itemParens(ex))}`
+            })
+            .join('')
+          return ri > 0 ? ` // ${exsHtml}` : exsHtml
+        })
+        .join('')
+      return `${sep}${escHtml(group.combo_title)} ×${rounds.length} : <em>{${roundsHtml}}</em>`
+    })
+    .join('')
+}
+
+async function fetchIconAsBase64() {
+  try {
+    const res = await fetch('/icon.svg')
+    if (!res.ok) return null
+    const text = await res.text()
+    const bytes = new TextEncoder().encode(text)
+    const binStr = Array.from(bytes, (b) => String.fromCharCode(b)).join('')
+    return `data:image/svg+xml;base64,${btoa(binStr)}`
+  } catch {
+    return null
+  }
+}
+
+async function downloadHtml(defaultFilename, html) {
+  const { promptFilename } = useSaveFilePrompt()
+  const filename = await promptFilename(defaultFilename)
+  if (!filename) return
+
+  const blob = new Blob([html], { type: 'text/html' })
+  const url = URL.createObjectURL(blob)
+  const a = document.createElement('a')
+  a.href = url
+  a.download = filename
+  a.click()
+  URL.revokeObjectURL(url)
+}
+
+export function useHtmlExport() {
+  async function exportHomeAsHtml({
+    count7Days,
+    count30Days,
+    recentSessions,
+    historyByDay,
+    historyFrom,
+    historyTo,
+  }) {
+    const lang = i18next.language || 'en'
+    const t = i18next.t.bind(i18next)
+    const iconDataUrl = await fetchIconAsBase64()
+    const exportDate = formatDate(new Date(), lang)
+
+    const iconHtml = iconDataUrl
+      ? `<img src="${iconDataUrl}" alt="TrainUs" class="app-icon" />`
+      : ''
+
+    const recentHtml = recentSessions
+      .map((log) => {
+        const duration = formatDuration(log.started_at, log.finished_at)
+        const date = formatDate(log.started_at, lang)
+        const itemsLine = renderSessionItemsHtml(log)
+        return `
+        <div class="card">
+          <div class="session-header">
+            <span class="session-title">${escHtml(log.session_title)}</span>
+            <span class="session-meta">
+              <span class="session-date">${escHtml(date)}</span>
+              ${duration ? `<span class="session-duration">&#x23F1; ${escHtml(duration)}</span>` : ''}
+            </span>
+          </div>
+          ${itemsLine ? `<div class="session-items">${itemsLine}</div>` : ''}
+        </div>`
+      })
+      .join('')
+
+    const historyHtml = historyByDay
+      .map(({ day, logs }) => {
+        const dayLabel = formatDate(day, lang)
+        const logsHtml = logs
+          .map((log) => {
+            const duration = formatDuration(log.started_at, log.finished_at)
+            const itemsLine = renderSessionItemsHtml(log)
+            return `
+            <div class="card card--sm">
+              <div class="session-header session-header--sm">
+                <span class="history-title">${escHtml(log.session_title)}</span>
+                ${duration ? `<span class="session-duration">&#x23F1; ${escHtml(duration)}</span>` : ''}
+              </div>
+              ${itemsLine ? `<div class="session-items session-items--sm">${itemsLine}</div>` : ''}
+            </div>`
+          })
+          .join('')
+        return `<div class="history-day"><h4 class="history-day-label">${escHtml(dayLabel)}</h4>${logsHtml}</div>`
+      })
+      .join('')
+
+    const html = `<!DOCTYPE html>
+<html lang="${escHtml(lang)}">
+<head>
+  <meta charset="UTF-8" />
+  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+  <title>TrainUs</title>
+  <style>
+    *, *::before, *::after { box-sizing: border-box; }
+    body { margin: 0 auto; padding: 24px 16px; font-family: Helvetica, sans-serif; color: #1a1a1a; background: #fff; max-width: 800px; }
+    h1, h2, h3, h4 { margin: 0; padding: 0; }
+    .app-header { display: flex; align-items: center; gap: 12px; margin-bottom: 4px; }
+    .app-icon { width: 36px; height: 36px; }
+    .app-name { font-size: 22px; font-weight: 700; }
+    .export-meta { font-size: 12px; color: #555; margin-bottom: 24px; }
+    .stats-cards { display: flex; gap: 16px; margin-bottom: 24px; }
+    .stat-card { flex: 1; display: flex; flex-direction: column; align-items: center; padding: 16px; border-radius: 8px; background: #f5f5f5; border: 1px solid #ddd; }
+    .stat-value { font-size: 32px; font-weight: 700; color: #2563eb; }
+    .stat-label { font-size: 13px; color: #555; text-align: center; margin-top: 4px; }
+    .section-title { font-size: 16px; font-weight: 600; margin-bottom: 10px; }
+    .recent-section { margin-bottom: 28px; }
+    .history-section { margin-bottom: 20px; }
+    .history-header { display: flex; align-items: baseline; gap: 10px; margin-bottom: 10px; }
+    .history-range { font-size: 12px; color: #555; }
+    .card { background: #f5f5f5; border: 1px solid #ddd; border-radius: 8px; padding: 16px; margin-bottom: 8px; }
+    .card--sm { padding: 10px 16px; }
+    .session-header { display: flex; align-items: center; gap: 8px; margin-bottom: 6px; }
+    .session-header--sm { margin-bottom: 4px; }
+    .session-title { flex: 1; font-size: 15px; font-weight: 600; }
+    .history-title { flex: 1; font-size: 14px; font-weight: 600; }
+    .session-meta { display: flex; align-items: center; gap: 8px; flex-shrink: 0; }
+    .session-date { font-size: 13px; color: #555; white-space: nowrap; }
+    .session-duration { font-size: 12px; color: #555; white-space: nowrap; }
+    .session-items { font-size: 13px; color: #1a1a1a; line-height: 1.6; }
+    .session-items--sm { font-size: 12px; }
+    .history-day { margin-bottom: 16px; }
+    .history-day-label { font-size: 13px; font-weight: 600; color: #555; margin-bottom: 6px; text-transform: uppercase; letter-spacing: 0.04em; }
+  </style>
+</head>
+<body>
+  <div class="app-header">
+    ${iconHtml}
+    <span class="app-name">TrainUs</span>
+  </div>
+  <p class="export-meta">${escHtml(t('home.exportedOn', { date: exportDate }))}</p>
+
+  <div class="stats-cards">
+    <div class="stat-card">
+      <span class="stat-value">${count7Days}</span>
+      <span class="stat-label">${escHtml(t('home.sessionsLast7Days'))}</span>
+    </div>
+    <div class="stat-card">
+      <span class="stat-value">${count30Days}</span>
+      <span class="stat-label">${escHtml(t('home.sessionsLast30Days'))}</span>
+    </div>
+  </div>
+
+  ${
+    recentSessions.length > 0
+      ? `<div class="recent-section">
+    <h3 class="section-title">${escHtml(t('home.recentSessions'))}</h3>
+    ${recentHtml}
+  </div>`
+      : ''
+  }
+
+  ${
+    historyByDay.length > 0
+      ? `<div class="history-section">
+    <div class="history-header">
+      <h3 class="section-title">${escHtml(t('home.history'))}</h3>
+      <span class="history-range">${escHtml(historyFrom)} – ${escHtml(historyTo)}</span>
+    </div>
+    ${historyHtml}
+  </div>`
+      : ''
+  }
+</body>
+</html>`
+
+    const date = new Date().toISOString().slice(0, 10)
+    await downloadHtml(`trainus-home-${date}.html`, html)
+  }
+
+  return { exportHomeAsHtml }
+}
diff --git a/src/composables/useInstallPrompt.js b/src/composables/useInstallPrompt.js
new file mode 100644
index 0000000..a53e6a5
--- /dev/null
+++ b/src/composables/useInstallPrompt.js
@@ -0,0 +1,29 @@
+import { ref } from 'vue'
+
+let deferredPrompt = null
+const canInstall = ref(false)
+
+window.addEventListener('beforeinstallprompt', (e) => {
+  e.preventDefault()
+  deferredPrompt = e
+  canInstall.value = true
+})
+
+window.addEventListener('appinstalled', () => {
+  deferredPrompt = null
+  canInstall.value = false
+})
+
+export function useInstallPrompt() {
+  async function install() {
+    if (!deferredPrompt) return
+    deferredPrompt.prompt()
+    const { outcome } = await deferredPrompt.userChoice
+    if (outcome === 'accepted') {
+      deferredPrompt = null
+      canInstall.value = false
+    }
+  }
+
+  return { canInstall, install }
+}
diff --git a/src/composables/useJsonExport.js b/src/composables/useJsonExport.js
new file mode 100644
index 0000000..8733139
--- /dev/null
+++ b/src/composables/useJsonExport.js
@@ -0,0 +1,293 @@
+import { settingsRepository } from '../db/repositories/settingsRepository.js'
+import { exerciseRepository } from '../db/repositories/exerciseRepository.js'
+import { comboRepository } from '../db/repositories/comboRepository.js'
+import { sessionRepository } from '../db/repositories/sessionRepository.js'
+import { collectionRepository } from '../db/repositories/collectionRepository.js'
+import { executionLogRepository } from '../db/repositories/executionLogRepository.js'
+import { buildEnvelope, downloadJson } from '../utils/jsonEnvelope.js'
+
+const SETTINGS_EXPORT_KEYS = ['user_name', 'language', 'theme', 'backup_reminder_days']
+
+function mergeById(existing = [], additional = []) {
+  const map = new Map(existing.map((item) => [item.id, item]))
+  for (const item of additional) {
+    if (!map.has(item.id)) map.set(item.id, item)
+  }
+  return [...map.values()]
+}
+
+/** Exercises referenced by a combo's exercise list, fetched as full entities. */
+async function collectComboDependencies(combos) {
+  const exerciseIds = new Set()
+  for (const combo of combos) {
+    for (const ex of combo.exercises || []) {
+      exerciseIds.add(ex.exercise_id)
+    }
+  }
+  const exercises = (
+    await Promise.all([...exerciseIds].map((id) => exerciseRepository.getById(id)))
+  ).filter(Boolean)
+  return { exercises }
+}
+
+/** Combos and exercises referenced by a session's items, including the combos' own exercises. */
+async function collectSessionDependencies(sessions) {
+  const exerciseIds = new Set()
+  const comboIds = new Set()
+  for (const session of sessions) {
+    for (const item of session.items || []) {
+      if (item.item_type === 'exercise') exerciseIds.add(item.item_id)
+      if (item.item_type === 'combo') comboIds.add(item.item_id)
+    }
+  }
+  const combos = (await Promise.all([...comboIds].map((id) => comboRepository.getById(id)))).filter(
+    Boolean,
+  )
+  const { exercises: comboExercises } = await collectComboDependencies(combos)
+  for (const exercise of comboExercises) {
+    exerciseIds.add(exercise.id)
+  }
+  const exercises = (
+    await Promise.all([...exerciseIds].map((id) => exerciseRepository.getById(id)))
+  ).filter(Boolean)
+  return { combos, exercises }
+}
+
+/** Sessions referenced by a collection, plus their transitive combo/exercise dependencies. */
+async function collectCollectionDependencies(collections) {
+  const sessionIds = new Set()
+  for (const collection of collections) {
+    for (const s of collection.sessions || []) {
+      sessionIds.add(s.session_id)
+    }
+  }
+  const sessions = (
+    await Promise.all([...sessionIds].map((id) => sessionRepository.getById(id)))
+  ).filter(Boolean)
+  const { combos, exercises } = await collectSessionDependencies(sessions)
+  return { sessions, combos, exercises }
+}
+
+/**
+ * Composable for exporting all entity types as JSON.
+ */
+export function useJsonExport() {
+  async function getExporter() {
+    const name = await settingsRepository.get('user_name')
+    const uuid = await settingsRepository.get('user_uuid')
+    return { name: name || 'User', uuid }
+  }
+
+  async function exportAllExercises(query) {
+    const exercises = query
+      ? await exerciseRepository.search(query)
+      : await exerciseRepository.getAll()
+    const exporter = await getExporter()
+    const envelope = buildEnvelope({ exercises }, exporter)
+    const json = JSON.stringify(envelope, null, 2)
+    const date = new Date().toISOString().slice(0, 10)
+    await downloadJson(`trainus-exercises-${date}.json`, json)
+  }
+
+  async function exportExercise(exerciseId) {
+    const exercise = await exerciseRepository.getById(exerciseId)
+    if (!exercise) throw new Error('Exercise not found')
+    const exporter = await getExporter()
+    const envelope = buildEnvelope({ exercises: [exercise] }, exporter)
+    const json = JSON.stringify(envelope, null, 2)
+    const date = new Date().toISOString().slice(0, 10)
+    await downloadJson(`trainus-exercises-${date}.json`, json)
+  }
+
+  async function exportAllCombos(query) {
+    const combos = query
+      ? await comboRepository.searchWithExercises(query)
+      : await comboRepository.getAllWithExercises()
+    const { exercises } = await collectComboDependencies(combos)
+    const exporter = await getExporter()
+    const envelope = buildEnvelope({ combos, exercises }, exporter)
+    const json = JSON.stringify(envelope, null, 2)
+    const date = new Date().toISOString().slice(0, 10)
+    await downloadJson(`trainus-combos-${date}.json`, json)
+  }
+
+  async function exportCombo(comboId) {
+    const combo = await comboRepository.getById(comboId)
+    if (!combo) throw new Error('Combo not found')
+    const { exercises } = await collectComboDependencies([combo])
+    const exporter = await getExporter()
+    const envelope = buildEnvelope({ combos: [combo], exercises }, exporter)
+    const json = JSON.stringify(envelope, null, 2)
+    const date = new Date().toISOString().slice(0, 10)
+    await downloadJson(`trainus-combos-${date}.json`, json)
+  }
+
+  async function exportAllSessions(query) {
+    const sessions = query
+      ? await sessionRepository.searchWithItems(query)
+      : await sessionRepository.getAllWithItems()
+    const { combos, exercises } = await collectSessionDependencies(sessions)
+    const exporter = await getExporter()
+    const envelope = buildEnvelope({ sessions, combos, exercises }, exporter)
+    const json = JSON.stringify(envelope, null, 2)
+    const date = new Date().toISOString().slice(0, 10)
+    await downloadJson(`trainus-sessions-${date}.json`, json)
+  }
+
+  async function exportSession(sessionId) {
+    const session = await sessionRepository.getById(sessionId)
+    if (!session) throw new Error('Session not found')
+    const { combos, exercises } = await collectSessionDependencies([session])
+    const exporter = await getExporter()
+    const envelope = buildEnvelope({ sessions: [session], combos, exercises }, exporter)
+    const json = JSON.stringify(envelope, null, 2)
+    const date = new Date().toISOString().slice(0, 10)
+    await downloadJson(`trainus-sessions-${date}.json`, json)
+  }
+
+  async function exportAllCollections(query) {
+    const collections = query
+      ? await collectionRepository.searchWithSessions(query)
+      : await collectionRepository.getAllWithSessions()
+    const { sessions, combos, exercises } = await collectCollectionDependencies(collections)
+    const exporter = await getExporter()
+    const envelope = buildEnvelope({ collections, sessions, combos, exercises }, exporter)
+    const json = JSON.stringify(envelope, null, 2)
+    const date = new Date().toISOString().slice(0, 10)
+    await downloadJson(`trainus-collections-${date}.json`, json)
+  }
+
+  async function exportCollection(collectionId) {
+    const collection = await collectionRepository.getById(collectionId)
+    if (!collection) throw new Error('Collection not found')
+    const { sessions, combos, exercises } = await collectCollectionDependencies([collection])
+    const exporter = await getExporter()
+    const envelope = buildEnvelope(
+      { collections: [collection], sessions, combos, exercises },
+      exporter,
+    )
+    const json = JSON.stringify(envelope, null, 2)
+    const date = new Date().toISOString().slice(0, 10)
+    await downloadJson(`trainus-collections-${date}.json`, json)
+  }
+
+  async function exportAllExecutionLogs() {
+    const executionLogs = await executionLogRepository.getAllWithItems()
+    const exporter = await getExporter()
+    const envelope = buildEnvelope({ executionLogs }, exporter)
+    const json = JSON.stringify(envelope, null, 2)
+    const date = new Date().toISOString().slice(0, 10)
+    await downloadJson(`trainus-logs-${date}.json`, json)
+  }
+
+  async function exportSettings() {
+    const allSettings = await settingsRepository.getAll()
+    const data = {}
+    for (const key of SETTINGS_EXPORT_KEYS) {
+      if (allSettings[key] !== undefined) {
+        data[key] = allSettings[key]
+      }
+    }
+    const exporter = await getExporter()
+    const envelope = buildEnvelope({ settings: data }, exporter)
+    const json = JSON.stringify(envelope, null, 2)
+    const date = new Date().toISOString().slice(0, 10)
+    await downloadJson(`trainus-settings-${date}.json`, json)
+  }
+
+  async function exportAll() {
+    const [exercises, combos, sessions, collections, executionLogs] = await Promise.all([
+      exerciseRepository.getAll(),
+      comboRepository.getAllWithExercises(),
+      sessionRepository.getAllWithItems(),
+      collectionRepository.getAllWithSessions(),
+      executionLogRepository.getAllWithItems(),
+    ])
+
+    const allSettings = await settingsRepository.getAll()
+    const settingsData = {}
+    for (const key of SETTINGS_EXPORT_KEYS) {
+      if (allSettings[key] !== undefined) {
+        settingsData[key] = allSettings[key]
+      }
+    }
+
+    const data = { exercises, combos, sessions, collections, executionLogs, settings: settingsData }
+    const exporter = await getExporter()
+    const envelope = buildEnvelope(data, exporter)
+    const json = JSON.stringify(envelope, null, 2)
+    const date = new Date().toISOString().slice(0, 10)
+    await downloadJson(`trainus-full-${date}.json`, json)
+  }
+
+  async function exportByFilter(options = {}) {
+    const data = {}
+    const exporter = await getExporter()
+
+    if (options.exercises) {
+      data.exercises = await exerciseRepository.getAll()
+    }
+    if (options.combos) {
+      data.combos = await comboRepository.getAllWithExercises()
+    }
+    if (options.sessions) {
+      data.sessions = await sessionRepository.getAllWithItems()
+    }
+    if (options.collections) {
+      data.collections = await collectionRepository.getAllWithSessions()
+    }
+
+    // Bundle dependencies so a partial selection (e.g. sessions without combos/exercises)
+    // still produces a self-contained, importable export.
+    if (data.collections) {
+      const deps = await collectCollectionDependencies(data.collections)
+      data.sessions = mergeById(data.sessions, deps.sessions)
+      data.combos = mergeById(data.combos, deps.combos)
+      data.exercises = mergeById(data.exercises, deps.exercises)
+    }
+    if (data.sessions) {
+      const deps = await collectSessionDependencies(data.sessions)
+      data.combos = mergeById(data.combos, deps.combos)
+      data.exercises = mergeById(data.exercises, deps.exercises)
+    }
+    if (data.combos) {
+      const deps = await collectComboDependencies(data.combos)
+      data.exercises = mergeById(data.exercises, deps.exercises)
+    }
+
+    if (options.executionLogs) {
+      data.executionLogs = await executionLogRepository.getAllWithItems()
+    }
+    if (options.settings) {
+      const allSettings = await settingsRepository.getAll()
+      const settingsData = {}
+      for (const key of SETTINGS_EXPORT_KEYS) {
+        if (allSettings[key] !== undefined) {
+          settingsData[key] = allSettings[key]
+        }
+      }
+      data.settings = settingsData
+    }
+
+    const envelope = buildEnvelope(data, exporter)
+    const json = JSON.stringify(envelope, null, 2)
+    const date = new Date().toISOString().slice(0, 10)
+    const filename = `trainus-data-${date}.json`
+    await downloadJson(filename, json)
+  }
+
+  return {
+    exportAllExercises,
+    exportExercise,
+    exportAllCombos,
+    exportCombo,
+    exportAllSessions,
+    exportSession,
+    exportAllCollections,
+    exportCollection,
+    exportAllExecutionLogs,
+    exportSettings,
+    exportAll,
+    exportByFilter,
+  }
+}
diff --git a/src/composables/useJsonImport.js b/src/composables/useJsonImport.js
new file mode 100644
index 0000000..a102a39
--- /dev/null
+++ b/src/composables/useJsonImport.js
@@ -0,0 +1,587 @@
+import { ref } from 'vue'
+import { settingsRepository } from '../db/repositories/settingsRepository.js'
+import { exerciseRepository } from '../db/repositories/exerciseRepository.js'
+import { comboRepository } from '../db/repositories/comboRepository.js'
+import { sessionRepository } from '../db/repositories/sessionRepository.js'
+import { collectionRepository } from '../db/repositories/collectionRepository.js'
+import { executionLogRepository } from '../db/repositories/executionLogRepository.js'
+import { suffixRepository } from '../db/repositories/suffixRepository.js'
+import { parseEnvelope, pickJsonFile } from '../utils/jsonEnvelope.js'
+
+export const COLLISION_ACTION = {
+  REPLACE: 'replace',
+  SKIP: 'skip',
+}
+
+const SETTINGS_SKIP_KEYS = ['user_uuid', 'app_version', 'db_created_at', 'last_backup_at']
+
+/**
+ * Composable for importing data from JSON files.
+ */
+export function useJsonImport() {
+  const importing = ref(false)
+  const error = ref(null)
+
+  async function loadFile() {
+    const text = await pickJsonFile()
+    if (!text) return { envelope: null, error: null, cancelled: true }
+
+    const result = parseEnvelope(text)
+    return { envelope: result.envelope, error: result.error, cancelled: false }
+  }
+
+  async function ensureSuffix(uuid, name, suffix) {
+    const existing = await suffixRepository.getByUuid(uuid)
+    if (existing) return existing.suffix
+
+    await suffixRepository.create({ user_uuid: uuid, user_name: name, suffix })
+    return suffix
+  }
+
+  // --- Full multi-entity import ---
+
+  async function analyzeAll(envelope, { asMine = false } = {}) {
+    const localUuid = await settingsRepository.get('user_uuid')
+    const exporterUuid = envelope.metadata.exportedBy.uuid
+    const exporterName = envelope.metadata.exportedBy.name
+    const exportDate = envelope.metadata.exportDate
+    const isSameUser = asMine || exporterUuid === localUuid
+
+    const result = {
+      summary: {
+        exporterName,
+        exporterUuid,
+        exportDate,
+        isSameUser,
+        asMine,
+        hasExercises: !!envelope.data.exercises?.length,
+        hasCombos: !!envelope.data.combos?.length,
+        hasSessions: !!envelope.data.sessions?.length,
+        hasCollections: !!envelope.data.collections?.length,
+        hasExecutionLogs: !!envelope.data.executionLogs?.length,
+        hasSettings: !!envelope.data.settings,
+      },
+      exercises: null,
+      combos: null,
+      sessions: null,
+      collections: null,
+      executionLogs: null,
+      settings: null,
+    }
+
+    // Analyze exercises
+    if (envelope.data.exercises?.length) {
+      result.exercises = await _analyzeEntityList(
+        envelope.data.exercises,
+        exerciseRepository,
+        'title',
+        exporterUuid,
+        isSameUser,
+      )
+    }
+
+    // Analyze combos
+    if (envelope.data.combos?.length) {
+      result.combos = await _analyzeEntityList(
+        envelope.data.combos,
+        comboRepository,
+        'title',
+        exporterUuid,
+        isSameUser,
+      )
+    }
+
+    // Analyze sessions
+    if (envelope.data.sessions?.length) {
+      result.sessions = await _analyzeEntityList(
+        envelope.data.sessions,
+        sessionRepository,
+        'title',
+        exporterUuid,
+        isSameUser,
+      )
+    }
+
+    // Analyze collections
+    if (envelope.data.collections?.length) {
+      result.collections = await _analyzeEntityList(
+        envelope.data.collections,
+        collectionRepository,
+        'label',
+        exporterUuid,
+        isSameUser,
+      )
+    }
+
+    // Analyze execution logs (no title collision, just ID existence)
+    if (envelope.data.executionLogs?.length) {
+      result.executionLogs = await _analyzeEntityList(
+        envelope.data.executionLogs,
+        executionLogRepository,
+        null,
+        exporterUuid,
+        isSameUser,
+      )
+    }
+
+    // Settings
+    if (envelope.data.settings) {
+      result.settings = envelope.data.settings
+    }
+
+    // Suffix handling for different-user imports
+    if (!isSameUser) {
+      const suffixEntry = await suffixRepository.getByUuid(exporterUuid)
+      result.suffixInfo = {
+        needsSuffix: !suffixEntry,
+        existingSuffix: suffixEntry?.suffix || null,
+      }
+    }
+
+    return result
+  }
+
+  async function _analyzeEntityList(entities, repository, titleField, exporterUuid, isSameUser) {
+    const result = {
+      total: entities.length,
+      noCollision: [],
+      sameUserCollisions: [],
+      differentUser: [],
+    }
+
+    // Same-user title conflicts (different id, same title) are detected once up front
+    // (O(n) instead of O(n²)) and folded into sameUserCollisions alongside id conflicts.
+    let titleMap = null
+    if (isSameUser && titleField) {
+      const allRows = await repository.getAll()
+      titleMap = new Map(allRows.map((row) => [row[titleField], row]))
+    }
+
+    for (const entity of entities) {
+      const existing = await repository.getById(entity.id)
+
+      if (isSameUser) {
+        if (existing) {
+          result.sameUserCollisions.push({ imported: entity, existing })
+        } else {
+          const titleMatch = titleMap?.get(entity[titleField])
+          if (titleMatch) {
+            result.sameUserCollisions.push({ imported: entity, existing: titleMatch })
+          } else {
+            result.noCollision.push(entity)
+          }
+        }
+      } else {
+        if (existing && existing.created_by === exporterUuid) {
+          result.differentUser.push({ imported: entity, existing, action: 'update' })
+        } else if (existing) {
+          result.differentUser.push({ imported: entity, existing, action: 'new_id' })
+        } else {
+          result.differentUser.push({ imported: entity, existing: null, action: 'insert' })
+        }
+      }
+    }
+
+    return result
+  }
+
+  async function applyAllImport(analysis, options = {}) {
+    const {
+      suffix,
+      exerciseResolutions = [],
+      comboResolutions = [],
+      sessionResolutions = [],
+      collectionResolutions = [],
+    } = options
+
+    const localUuid = await settingsRepository.get('user_uuid')
+    const exporterUuid = analysis.summary.exporterUuid
+    const exporterName = analysis.summary.exporterName
+    const isSameUser = analysis.summary.isSameUser
+
+    const idMap = { exercise: {}, combo: {}, session: {}, collection: {}, executionLog: {} }
+    const report = {
+      exercises: { imported: 0, skipped: 0, replaced: 0, updated: 0 },
+      combos: { imported: 0, skipped: 0, replaced: 0, updated: 0 },
+      sessions: { imported: 0, skipped: 0, replaced: 0, updated: 0 },
+      collections: { imported: 0, skipped: 0, replaced: 0, updated: 0 },
+      executionLogs: { imported: 0, skipped: 0 },
+      settings: { imported: 0 },
+      errors: [],
+    }
+
+    // Register suffix if needed
+    if (!isSameUser && analysis.suffixInfo?.needsSuffix && suffix) {
+      await ensureSuffix(exporterUuid, exporterName, suffix)
+    }
+
+    const effectiveSuffix = suffix || analysis.suffixInfo?.existingSuffix
+
+    // 1. Import exercises
+    if (analysis.exercises) {
+      await _importEntityList(
+        analysis.exercises,
+        exerciseRepository,
+        'title',
+        isSameUser,
+        localUuid,
+        exporterUuid,
+        effectiveSuffix,
+        exerciseResolutions,
+        idMap.exercise,
+        report.exercises,
+        report.errors,
+      )
+    }
+
+    // 2. Import combos (remap exercise_id references)
+    if (analysis.combos) {
+      await _importEntityList(
+        analysis.combos,
+        comboRepository,
+        'title',
+        isSameUser,
+        localUuid,
+        exporterUuid,
+        effectiveSuffix,
+        comboResolutions,
+        idMap.combo,
+        report.combos,
+        report.errors,
+        { remapExercises: idMap.exercise },
+        async (comboId, combo) => {
+          if (combo.exercises?.length) {
+            const exercises = combo.exercises.map((ex) => ({
+              exerciseId: ex.exercise_id,
+              defaultReps: ex.default_reps ?? 1,
+              defaultWeight: ex.default_weight ?? 0,
+            }))
+            await comboRepository.setExercises(comboId, exercises)
+          }
+        },
+      )
+    }
+
+    // 3. Import sessions (remap exercise_id and combo_id references)
+    if (analysis.sessions) {
+      await _importEntityList(
+        analysis.sessions,
+        sessionRepository,
+        'title',
+        isSameUser,
+        localUuid,
+        exporterUuid,
+        effectiveSuffix,
+        sessionResolutions,
+        idMap.session,
+        report.sessions,
+        report.errors,
+        { remapExercises: idMap.exercise, remapCombos: idMap.combo },
+        async (sessionId, session) => {
+          if (session.items?.length) {
+            const items = session.items.map((item) => ({
+              item_id: item.item_id,
+              item_type: item.item_type,
+              repetitions: item.repetitions ?? 1,
+              weight: item.weight ?? 0,
+            }))
+            await sessionRepository.setItems(sessionId, items)
+          }
+        },
+      )
+    }
+
+    // 4. Import collections (remap session_id references)
+    if (analysis.collections) {
+      await _importEntityList(
+        analysis.collections,
+        collectionRepository,
+        'label',
+        isSameUser,
+        localUuid,
+        exporterUuid,
+        effectiveSuffix,
+        collectionResolutions,
+        idMap.collection,
+        report.collections,
+        report.errors,
+        { remapSessions: idMap.session },
+        async (collectionId, collection) => {
+          if (collection.sessions?.length) {
+            const sessionIds = collection.sessions.map((s) => s.session_id)
+            await collectionRepository.setSessions(collectionId, sessionIds)
+          }
+        },
+      )
+    }
+
+    // 5. Import execution logs (remap session_id and exercise_id)
+    if (analysis.executionLogs) {
+      await _importExecutionLogs(
+        analysis.executionLogs,
+        isSameUser,
+        localUuid,
+        exporterUuid,
+        idMap,
+        report.executionLogs,
+        report.errors,
+      )
+    }
+
+    // 6. Import settings — only for same-user restores; skip entirely for cross-user imports
+    if (analysis.settings && isSameUser) {
+      for (const [key, value] of Object.entries(analysis.settings)) {
+        if (!SETTINGS_SKIP_KEYS.includes(key)) {
+          await settingsRepository.set(key, value)
+          report.settings.imported++
+        }
+      }
+    } else if (analysis.settings && !isSameUser) {
+      report.settings = { skipped: true }
+    }
+
+    return report
+  }
+
+  async function _importEntityList(
+    analysis,
+    repository,
+    titleField,
+    isSameUser,
+    localUuid,
+    exporterUuid,
+    suffix,
+    resolutions,
+    idMap,
+    report,
+    errors,
+    remapOptions = {},
+    setNestedData = null,
+  ) {
+    const resolutionMap = {}
+    for (const r of resolutions) {
+      resolutionMap[r.imported.id] = r
+    }
+
+    // Import no-collision entities (same-user path)
+    for (const entity of analysis.noCollision) {
+      try {
+        const finalEntity = _prepareEntity(
+          entity,
+          titleField,
+          isSameUser ? localUuid : exporterUuid,
+          suffix,
+          remapOptions,
+        )
+        await repository.createWithId(entity.id, finalEntity)
+        idMap[entity.id] = entity.id
+        report.imported++
+        if (setNestedData) {
+          try {
+            await setNestedData(entity.id, finalEntity)
+          } catch (ne) {
+            errors.push(ne.message)
+          }
+        }
+      } catch (e) {
+        errors.push(e.message)
+      }
+    }
+
+    // Handle same-user collisions (id match or title match — both resolve against the
+    // existing row, so idMap correctly redirects same-batch references either way)
+    for (const collision of analysis.sameUserCollisions) {
+      const resolution = resolutionMap[collision.imported.id]
+      if (!resolution || resolution.action === COLLISION_ACTION.SKIP) {
+        report.skipped++
+        idMap[collision.imported.id] = collision.existing.id
+        continue
+      }
+
+      if (resolution.action === COLLISION_ACTION.REPLACE) {
+        try {
+          const finalEntity = _prepareEntity(
+            collision.imported,
+            titleField,
+            localUuid,
+            null,
+            remapOptions,
+          )
+          await repository.replaceAll(collision.existing.id, finalEntity)
+          idMap[collision.imported.id] = collision.existing.id
+          report.replaced++
+          if (setNestedData) {
+            try {
+              await setNestedData(collision.existing.id, finalEntity)
+            } catch (ne) {
+              errors.push(ne.message)
+            }
+          }
+        } catch (e) {
+          errors.push(e.message)
+        }
+      }
+    }
+
+    // Handle different-user entities. A resolution here means a title conflict was found
+    // (on the suffixed title) against an existing row — redirect to it instead of the
+    // default id-based action.
+    for (const entry of analysis.differentUser) {
+      const resolution = resolutionMap[entry.imported.id]
+      try {
+        if (resolution) {
+          if (resolution.action === COLLISION_ACTION.SKIP) {
+            report.skipped++
+            idMap[entry.imported.id] = resolution.existing.id
+            continue
+          }
+
+          const finalEntity = _prepareEntity(
+            entry.imported,
+            titleField,
+            exporterUuid,
+            suffix,
+            remapOptions,
+          )
+          await repository.replaceAll(resolution.existing.id, finalEntity)
+          idMap[entry.imported.id] = resolution.existing.id
+          report.replaced++
+          if (setNestedData) {
+            try {
+              await setNestedData(resolution.existing.id, finalEntity)
+            } catch (ne) {
+              errors.push(ne.message)
+            }
+          }
+          continue
+        }
+
+        const entityId = entry.action === 'new_id' ? crypto.randomUUID() : entry.imported.id
+        const finalEntity = _prepareEntity(
+          entry.imported,
+          titleField,
+          exporterUuid,
+          suffix,
+          remapOptions,
+        )
+
+        if (entry.action === 'update') {
+          await repository.replaceAll(entityId, finalEntity)
+          idMap[entry.imported.id] = entityId
+          report.updated++
+        } else {
+          await repository.createWithId(entityId, finalEntity)
+          idMap[entry.imported.id] = entityId
+          report.imported++
+        }
+
+        if (setNestedData) {
+          try {
+            await setNestedData(entityId, finalEntity)
+          } catch (ne) {
+            errors.push(ne.message)
+          }
+        }
+      } catch (e) {
+        errors.push(e.message)
+      }
+    }
+  }
+
+  function _prepareEntity(entity, titleField, createdBy, suffix, remapOptions) {
+    const cloned = { ...entity }
+    cloned.created_by = createdBy
+
+    // Apply title/suffix
+    if (titleField) {
+      cloned[titleField] = suffix ? `${entity[titleField]} [${suffix}]` : entity[titleField]
+    }
+
+    // Remap combo exercises
+    if (remapOptions.remapExercises && cloned.exercises?.length) {
+      cloned.exercises = cloned.exercises.map((ex) => ({
+        ...ex,
+        exercise_id: remapOptions.remapExercises[ex.exercise_id] || ex.exercise_id,
+      }))
+    }
+
+    // Remap session items
+    if ((remapOptions.remapExercises || remapOptions.remapCombos) && cloned.items?.length) {
+      cloned.items = cloned.items.map((item) => {
+        if (item.item_type === 'exercise' && remapOptions.remapExercises) {
+          return { ...item, item_id: remapOptions.remapExercises[item.item_id] || item.item_id }
+        }
+        if (item.item_type === 'combo' && remapOptions.remapCombos) {
+          return { ...item, item_id: remapOptions.remapCombos[item.item_id] || item.item_id }
+        }
+        return item
+      })
+    }
+
+    // Remap collection sessions
+    if (remapOptions.remapSessions && cloned.sessions?.length) {
+      cloned.sessions = cloned.sessions.map((s) => ({
+        ...s,
+        session_id: remapOptions.remapSessions[s.session_id] || s.session_id,
+      }))
+    }
+
+    return cloned
+  }
+
+  async function _importExecutionLogs(
+    analysis,
+    isSameUser,
+    localUuid,
+    exporterUuid,
+    idMap,
+    report,
+    errors,
+  ) {
+    // Collect all logs to import from the three analysis buckets
+    const logsToImport = [
+      ...(analysis.noCollision || []).map((log) => ({ log, action: 'insert' })),
+      ...(analysis.sameUserCollisions || []).map((e) => ({ log: e.imported, action: 'insert' })),
+      ...(analysis.differentUser || []).map((e) => ({ log: e.imported, action: e.action })),
+    ]
+
+    for (const { log, action } of logsToImport) {
+      try {
+        const remappedSessionId = idMap.session[log.session_id] || log.session_id
+        const sessionExists = await sessionRepository.getById(remappedSessionId)
+        if (!sessionExists) {
+          report.skipped++
+          continue
+        }
+
+        const logId = action === 'new_id' ? crypto.randomUUID() : log.id
+        await executionLogRepository.createWithId(logId, {
+          ...log,
+          session_id: remappedSessionId,
+        })
+
+        if (log.items?.length) {
+          const remappedItems = log.items.map((item) => ({
+            ...item,
+            ...(action === 'new_id' ? { id: crypto.randomUUID(), log_id: logId } : {}),
+            exercise_id: idMap.exercise[item.exercise_id] || item.exercise_id,
+          }))
+          await executionLogRepository.addItems(logId, remappedItems)
+        }
+
+        report.imported++
+      } catch (e) {
+        errors.push(e.message)
+      }
+    }
+  }
+
+  return {
+    importing,
+    error,
+    loadFile,
+    ensureSuffix,
+    analyzeAll,
+    applyAllImport,
+  }
+}
diff --git a/src/composables/useKeyboardShortcut.js b/src/composables/useKeyboardShortcut.js
new file mode 100644
index 0000000..641374e
--- /dev/null
+++ b/src/composables/useKeyboardShortcut.js
@@ -0,0 +1,30 @@
+import { onMounted, onBeforeUnmount } from 'vue'
+
+/**
+ * Registers a keyboard shortcut listener for a single key.
+ *
+ * @param {string} key - The key to listen for (e.g. 'e', 'n', 'escape', 'enter')
+ * @param {Function} handler - Callback to invoke when the key is pressed
+ * @param {boolean|object} options - Legacy boolean (preventDefault) or options object:
+ *   - preventDefault {boolean} - Whether to call event.preventDefault() (default: true)
+ *   - ctrl {boolean} - Require Ctrl to be held (default: false)
+ *   - ignoreInputs {boolean} - Skip when focus is in input/textarea/select (default: true)
+ */
+export function useKeyboardShortcut(key, handler, options = {}) {
+  if (typeof options === 'boolean') options = { preventDefault: options }
+  const { preventDefault = true, ctrl = false, ignoreInputs = true } = options
+
+  function onKeydown(event) {
+    if (event.key.toLowerCase() !== key.toLowerCase()) return
+    if (ctrl && !event.ctrlKey) return
+
+    const tag = event.target.tagName.toLowerCase()
+    if (ignoreInputs && (tag === 'input' || tag === 'textarea' || tag === 'select')) return
+
+    if (preventDefault) event.preventDefault()
+    handler()
+  }
+
+  onMounted(() => window.addEventListener('keydown', onKeydown))
+  onBeforeUnmount(() => window.removeEventListener('keydown', onKeydown))
+}
diff --git a/src/composables/useListNavigation.js b/src/composables/useListNavigation.js
new file mode 100644
index 0000000..13fa876
--- /dev/null
+++ b/src/composables/useListNavigation.js
@@ -0,0 +1,55 @@
+import { ref, onMounted, onBeforeUnmount, nextTick } from 'vue'
+
+/**
+ * Provides keyboard navigation for a list of items using arrow keys.
+ *
+ * @param {number} itemCount - The number of items in the list
+ * @param {Function} onSelect - Callback when Enter is pressed on a focused item (receives index)
+ * @returns {{ focusedIndex: Ref<number>, onKeydown: Function, focusItem: Function }}
+ */
+export function useListNavigation(itemCount, onSelect) {
+  const focusedIndex = ref(-1)
+
+  function focusItem(index) {
+    focusedIndex.value = Math.max(0, Math.min(index, itemCount.value - 1))
+    nextTick(() => {
+      const el = document.querySelector(`[data-list-index="${focusedIndex.value}"]`)
+      el?.focus()
+    })
+  }
+
+  function onKeydown(event) {
+    const tag = event.target.tagName.toLowerCase()
+    if (tag === 'input' || tag === 'textarea' || tag === 'select') return
+
+    if (event.key === 'ArrowDown') {
+      event.preventDefault()
+      if (focusedIndex.value < 0) {
+        focusItem(0)
+      } else {
+        focusItem(focusedIndex.value + 1)
+      }
+    } else if (event.key === 'ArrowUp') {
+      event.preventDefault()
+      if (focusedIndex.value > 0) {
+        focusItem(focusedIndex.value - 1)
+      }
+    } else if (event.key === 'Enter' && focusedIndex.value >= 0) {
+      event.preventDefault()
+      onSelect(focusedIndex.value)
+    } else if (event.key === 'Escape' && focusedIndex.value >= 0) {
+      event.preventDefault()
+      focusedIndex.value = -1
+    }
+  }
+
+  onMounted(() => {
+    window.addEventListener('keydown', onKeydown)
+  })
+
+  onBeforeUnmount(() => {
+    window.removeEventListener('keydown', onKeydown)
+  })
+
+  return { focusedIndex, onKeydown, focusItem }
+}
diff --git a/src/composables/useOnlineStatus.js b/src/composables/useOnlineStatus.js
new file mode 100644
index 0000000..c0b6eb8
--- /dev/null
+++ b/src/composables/useOnlineStatus.js
@@ -0,0 +1,21 @@
+import { ref, onMounted, onUnmounted } from 'vue'
+
+export function useOnlineStatus() {
+  const isOnline = ref(navigator.onLine)
+
+  function update() {
+    isOnline.value = navigator.onLine
+  }
+
+  onMounted(() => {
+    window.addEventListener('online', update)
+    window.addEventListener('offline', update)
+  })
+
+  onUnmounted(() => {
+    window.removeEventListener('online', update)
+    window.removeEventListener('offline', update)
+  })
+
+  return { isOnline }
+}
diff --git a/src/composables/useSaveFilePrompt.js b/src/composables/useSaveFilePrompt.js
new file mode 100644
index 0000000..1025d2e
--- /dev/null
+++ b/src/composables/useSaveFilePrompt.js
@@ -0,0 +1,37 @@
+import { ref } from 'vue'
+
+const pendingSave = ref(null)
+
+function splitFilename(filename) {
+  const idx = filename.lastIndexOf('.')
+  if (idx <= 0) return { stem: filename, extension: '' }
+  return { stem: filename.slice(0, idx), extension: filename.slice(idx) }
+}
+
+/**
+ * Singleton prompt service backing the global <SaveFileDialog>.
+ * promptFilename() resolves to the chosen filename, or null if cancelled.
+ */
+export function useSaveFilePrompt() {
+  function promptFilename(defaultFilename) {
+    return new Promise((resolve) => {
+      const { stem, extension } = splitFilename(defaultFilename)
+      pendingSave.value = { defaultStem: stem, extension, resolve }
+    })
+  }
+
+  function confirmFilename(stem) {
+    const { defaultStem, extension, resolve } = pendingSave.value
+    const finalStem = stem.trim() || defaultStem
+    pendingSave.value = null
+    resolve(`${finalStem}${extension}`)
+  }
+
+  function cancelFilename() {
+    const { resolve } = pendingSave.value
+    pendingSave.value = null
+    resolve(null)
+  }
+
+  return { pendingSave, promptFilename, confirmFilename, cancelFilename }
+}
diff --git a/src/composables/useSessionExecution.js b/src/composables/useSessionExecution.js
new file mode 100644
index 0000000..ed85a13
--- /dev/null
+++ b/src/composables/useSessionExecution.js
@@ -0,0 +1,451 @@
+import { ref, computed } from 'vue'
+import { sessionRepository } from '../db/repositories/sessionRepository.js'
+import { comboRepository } from '../db/repositories/comboRepository.js'
+import { exerciseRepository } from '../db/repositories/exerciseRepository.js'
+import { executionLogRepository } from '../db/repositories/executionLogRepository.js'
+import { settingsRepository } from '../db/repositories/settingsRepository.js'
+import { useTimer } from './useTimer.js'
+import { useAudioCues } from './useAudioCues.js'
+
+export function useSessionExecution(sessionId) {
+  const sessionTitle = ref('')
+  const queue = ref([])
+  const currentIndex = ref(0)
+  const logId = ref(null)
+  const showFinalRound = ref(false)
+  const sessionDone = ref(false)
+  const loading = ref(true)
+  const error = ref(null)
+
+  const currentReps = ref(0)
+  const currentWeight = ref(0.0)
+  const currentSide = ref('left')
+
+  // Timer state
+  const timerPhase = ref(null) // 'work' | 'rest' | 'amrap' | null
+  const isAmrapTimeUp = ref(false)
+  const currentAmrapComboId = ref(null)
+
+  const {
+    remaining: timerRemaining,
+    isPaused: timerPaused,
+    start: startTimer,
+    pause: pauseTimer,
+    resume: resumeTimer,
+    stop: stopTimer,
+  } = useTimer()
+  const { playBip, playBIP } = useAudioCues()
+  const audioVolume = ref(0.5)
+
+  const currentStep = computed(() => queue.value[currentIndex.value] || null)
+  const nextStep = computed(() => queue.value[currentIndex.value + 1] || null)
+  const totalSteps = computed(() => queue.value.length)
+  const timerActive = computed(() => timerPhase.value !== null && !isAmrapTimeUp.value)
+
+  function loadStepState() {
+    const step = currentStep.value
+    if (!step) return
+    currentReps.value = step.prefillReps
+    currentWeight.value = step.prefillWeight
+    currentSide.value = step.prefillSide
+    _startStepTimer(step)
+  }
+
+  function _emomSounds(remaining) {
+    if (remaining === 30 || remaining === 2 || remaining === 1) playBip(audioVolume.value)
+  }
+
+  function _amrapLastMinuteSounds(remaining) {
+    if (remaining === 30 || remaining === 2 || remaining === 1) playBip(audioVolume.value)
+  }
+
+  function _tabataCountdown(remaining, totalTime) {
+    const half = Math.floor(totalTime / 2)
+    if (remaining === half) playBip(audioVolume.value)
+    if (remaining === 2 || remaining === 1) playBip(audioVolume.value)
+  }
+
+  function _startStepTimer(step) {
+    if (step.comboType === 'EMOM') {
+      timerPhase.value = 'work'
+      startTimer(60, {
+        onTick: _emomSounds,
+        onExpire: _onEmomExpire,
+      })
+    } else if (step.comboType === 'TABATA') {
+      _startWorkPhase(step)
+    } else if (step.comboType === 'AMRAP') {
+      _maybeStartAmrapTimer(step)
+    } else {
+      timerPhase.value = null
+    }
+  }
+
+  function _onEmomExpire() {
+    playBIP(audioVolume.value)
+    const step = currentStep.value
+    if (!step) return
+    timerPhase.value = null
+    _saveStepToLog(step).then(() => _advance())
+  }
+
+  function _startWorkPhase(step) {
+    timerPhase.value = 'work'
+    playBIP(audioVolume.value)
+    startTimer(step.workTime, {
+      onTick: (r) => _tabataCountdown(r, step.workTime),
+      onExpire: () => _startRestPhase(step),
+    })
+  }
+
+  function _startRestPhase(step) {
+    timerPhase.value = 'rest'
+    playBIP(audioVolume.value)
+    startTimer(step.restTime, {
+      onTick: (r) => _tabataCountdown(r, step.restTime),
+      onExpire: async () => {
+        timerPhase.value = null
+        if (step.isFinalComboStep) {
+          showFinalRound.value = true
+        } else {
+          await _advance()
+        }
+      },
+    })
+  }
+
+  function _maybeStartAmrapTimer(step) {
+    if (step.comboId === currentAmrapComboId.value) return
+    currentAmrapComboId.value = step.comboId
+    isAmrapTimeUp.value = false
+    timerPhase.value = 'amrap'
+
+    const durationSec = step.amrapMinutes * 60
+    const halfDuration = Math.round(durationSec / 2)
+    let lastElapsedMin = 0
+
+    startTimer(durationSec, {
+      onTick: (r) => {
+        if (r <= 60) {
+          _amrapLastMinuteSounds(r)
+        } else {
+          const elapsed = Math.floor((durationSec - r) / 60)
+          const isNewMinute = elapsed > lastElapsedMin
+          if (isNewMinute) lastElapsedMin = elapsed
+          if (r === halfDuration) {
+            playBIP(audioVolume.value)
+          } else if (isNewMinute) {
+            playBip(audioVolume.value)
+          }
+        }
+      },
+      onExpire: () => {
+        playBIP(audioVolume.value)
+        timerPhase.value = null
+        isAmrapTimeUp.value = true
+      },
+    })
+  }
+
+  async function init() {
+    loading.value = true
+    error.value = null
+    try {
+      const volumeStr = await settingsRepository.get('audio_volume')
+      const parsed = parseInt(volumeStr, 10)
+      audioVolume.value = isNaN(parsed) ? 0.5 : parsed / 100
+
+      const session = await sessionRepository.getById(sessionId)
+      if (!session) throw new Error('Session not found')
+      sessionTitle.value = session.title
+
+      const prefillMap = await executionLogRepository.getLastItemsBySession(sessionId)
+
+      const steps = []
+      for (const item of session.items) {
+        if (item.item_type === 'exercise') {
+          const ex = await exerciseRepository.getById(item.item_id)
+          const pf = prefillMap[item.item_id] || {}
+          steps.push({
+            exerciseId: item.item_id,
+            exerciseTitle: item.title,
+            prefillReps: pf.reps_done ?? item.repetitions,
+            prefillWeight: pf.weight_used ?? item.weight,
+            prefillSide: pf.side || 'left',
+            comboId: null,
+            comboTitle: null,
+            comboType: null,
+            workTime: null,
+            restTime: null,
+            amrapMinutes: null,
+            roundNumber: null,
+            totalRounds: null,
+            asymmetric: ex?.asymmetric || false,
+            alternate: ex?.alternate || false,
+            isFinalComboStep: false,
+            comboExercises: null,
+          })
+        } else if (item.item_type === 'combo') {
+          const combo = await comboRepository.getById(item.item_id)
+          if (!combo || !combo.exercises.length) continue
+
+          const comboType = combo.type || 'NONE'
+          const timerCfg = combo.timer_config || {}
+          const workTime = timerCfg.workTime ?? 20
+          const restTime = timerCfg.restTime ?? 10
+          const amrapMinutes = item.repetitions || 1
+
+          // AMRAP: treat repetitions as minutes, unroll just 1 round in queue
+          // EMOM: repetitions = total duration in minutes; rounds = floor(minutes / exercises)
+          // TABATA/NONE: repetitions = number of full combo rounds
+          const totalRounds =
+            comboType === 'AMRAP'
+              ? 1
+              : comboType === 'EMOM' && combo.exercises.length > 0
+                ? Math.max(1, Math.floor((item.repetitions || 1) / combo.exercises.length))
+                : item.repetitions || 1
+
+          for (let round = 1; round <= totalRounds; round++) {
+            for (let ei = 0; ei < combo.exercises.length; ei++) {
+              const ex = combo.exercises[ei]
+              const pf = prefillMap[ex.exercise_id] || {}
+              const isLast = ei === combo.exercises.length - 1 && round === totalRounds
+              steps.push({
+                exerciseId: ex.exercise_id,
+                exerciseTitle: ex.title,
+                prefillReps: pf.reps_done ?? ex.default_reps,
+                prefillWeight: pf.weight_used ?? ex.default_weight,
+                prefillSide: pf.side || 'left',
+                comboId: item.item_id,
+                comboTitle: combo.title,
+                comboType,
+                workTime,
+                restTime,
+                amrapMinutes,
+                roundNumber: round,
+                totalRounds,
+                asymmetric: ex.asymmetric || false,
+                alternate: ex.alternate || false,
+                isFinalComboStep: isLast,
+                comboExercises: combo.exercises,
+              })
+            }
+          }
+        }
+      }
+      queue.value = steps
+
+      logId.value = await executionLogRepository.create({
+        session_id: sessionId,
+        started_at: new Date().toISOString(),
+        finished_at: null,
+      })
+
+      loadStepState()
+    } catch (e) {
+      error.value = e.message
+    } finally {
+      loading.value = false
+    }
+  }
+
+  async function _saveStepToLog(step) {
+    await executionLogRepository.addItem({
+      log_id: logId.value,
+      exercise_id: step.exerciseId,
+      combo_id: step.comboId || null,
+      round_number: step.roundNumber || null,
+      reps_done: currentReps.value,
+      weight_used: currentWeight.value,
+      side: step.asymmetric ? currentSide.value : null,
+      completed: true,
+      timestamp: new Date().toISOString(),
+    })
+    step.actualReps = currentReps.value
+    step.actualWeight = currentWeight.value
+    step.actualSide = currentSide.value
+  }
+
+  async function markDone() {
+    const step = currentStep.value
+    if (!step || sessionDone.value) return
+
+    // Stop running step timer (EMOM or TABATA work phase)
+    if (step.comboType === 'EMOM' || (step.comboType === 'TABATA' && timerPhase.value === 'work')) {
+      stopTimer()
+      timerPhase.value = null
+    }
+
+    await _saveStepToLog(step)
+
+    if (step.comboType === 'TABATA') {
+      _startRestPhase(step)
+    } else if (step.comboType === 'EMOM') {
+      // EMOM always auto-advances, no final-round screen
+      await _advance()
+    } else if (step.comboType === 'AMRAP') {
+      if (step.isFinalComboStep) {
+        if (isAmrapTimeUp.value) {
+          await _advance()
+        } else {
+          // Auto-cycle: add one more round silently
+          _addAmrapRound()
+        }
+      } else {
+        await _advance()
+      }
+    } else {
+      if (step.isFinalComboStep) {
+        showFinalRound.value = true
+      } else {
+        await _advance()
+      }
+    }
+  }
+
+  function _appendRound({ resetFinalRound = false } = {}) {
+    const step = currentStep.value
+    if (!step?.comboId || !step?.comboExercises) return
+
+    const newRound = step.roundNumber + 1
+    const exercises = step.comboExercises
+    const lastRoundSteps = queue.value.filter(
+      (s) => s.comboId === step.comboId && s.roundNumber === step.roundNumber,
+    )
+
+    const newSteps = exercises.map((ex, i) => {
+      const prev = lastRoundSteps.find((s) => s.exerciseId === ex.exercise_id)
+      return {
+        exerciseId: ex.exercise_id,
+        exerciseTitle: ex.title,
+        prefillReps: prev?.actualReps ?? prev?.prefillReps ?? ex.default_reps,
+        prefillWeight: prev?.actualWeight ?? prev?.prefillWeight ?? ex.default_weight,
+        prefillSide: prev?.actualSide || 'left',
+        comboId: step.comboId,
+        comboTitle: step.comboTitle,
+        comboType: step.comboType,
+        workTime: step.workTime,
+        restTime: step.restTime,
+        amrapMinutes: step.amrapMinutes,
+        roundNumber: newRound,
+        totalRounds: newRound,
+        asymmetric: ex.asymmetric || false,
+        alternate: ex.alternate || false,
+        isFinalComboStep: i === exercises.length - 1,
+        comboExercises: exercises,
+      }
+    })
+
+    queue.value.splice(currentIndex.value + 1, 0, ...newSteps)
+    if (resetFinalRound) showFinalRound.value = false
+    currentIndex.value++
+    loadStepState()
+  }
+
+  function _addAmrapRound() {
+    _appendRound()
+  }
+
+  async function continueAfterCombo() {
+    showFinalRound.value = false
+    await _advance()
+  }
+
+  async function continueAfterAmrap() {
+    isAmrapTimeUp.value = false
+    currentAmrapComboId.value = null
+    stopTimer()
+    // Skip any remaining steps belonging to this AMRAP combo
+    const comboId = currentStep.value?.comboId
+    while (
+      currentIndex.value < queue.value.length &&
+      queue.value[currentIndex.value]?.comboId === comboId
+    ) {
+      currentIndex.value++
+    }
+    if (currentIndex.value >= queue.value.length) {
+      await _finish()
+    } else {
+      loadStepState()
+    }
+  }
+
+  function addOneMoreRound() {
+    _appendRound({ resetFinalRound: true })
+  }
+
+  function togglePause() {
+    if (timerPaused.value) {
+      resumeTimer()
+    } else {
+      pauseTimer()
+    }
+  }
+
+  async function _advance() {
+    currentIndex.value++
+    if (currentIndex.value >= queue.value.length) {
+      stopTimer()
+      timerPhase.value = null
+      await _finish()
+    } else {
+      // If the new step is a different AMRAP combo, stop the current AMRAP timer
+      const nextStep = currentStep.value
+      if (nextStep?.comboType !== 'AMRAP' || nextStep?.comboId !== currentAmrapComboId.value) {
+        if (currentAmrapComboId.value) {
+          stopTimer()
+          currentAmrapComboId.value = null
+          timerPhase.value = null
+        }
+      }
+      loadStepState()
+    }
+  }
+
+  async function _finish() {
+    await executionLogRepository.update(logId.value, {
+      finished_at: new Date().toISOString(),
+      status: 'completed',
+    })
+    sessionDone.value = true
+  }
+
+  async function exit() {
+    if (sessionDone.value) return
+    stopTimer()
+    timerPhase.value = null
+    await executionLogRepository.update(logId.value, {
+      finished_at: new Date().toISOString(),
+      status: 'aborted',
+    })
+    sessionDone.value = true
+  }
+
+  return {
+    sessionTitle,
+    queue,
+    currentIndex,
+    currentStep,
+    nextStep,
+    totalSteps,
+    showFinalRound,
+    sessionDone,
+    loading,
+    error,
+    currentReps,
+    currentWeight,
+    currentSide,
+    timerPhase,
+    timerRemaining,
+    timerPaused,
+    timerActive,
+    isAmrapTimeUp,
+    init,
+    markDone,
+    continueAfterCombo,
+    continueAfterAmrap,
+    addOneMoreRound,
+    togglePause,
+    exit,
+  }
+}
diff --git a/src/composables/useSessions.js b/src/composables/useSessions.js
new file mode 100644
index 0000000..f96596e
--- /dev/null
+++ b/src/composables/useSessions.js
@@ -0,0 +1,54 @@
+import { ref } from 'vue'
+import { sessionRepository } from '../db/repositories/sessionRepository.js'
+
+export function useSessions() {
+  const sessions = ref([])
+  const loading = ref(false)
+  const error = ref(null)
+
+  async function fetchAll() {
+    loading.value = true
+    error.value = null
+    try {
+      sessions.value = await sessionRepository.getAll()
+    } catch (e) {
+      error.value = e.message
+    } finally {
+      loading.value = false
+    }
+  }
+
+  async function create(data) {
+    const id = await sessionRepository.create(data)
+    await fetchAll()
+    return id
+  }
+
+  async function update(id, data) {
+    await sessionRepository.update(id, data)
+    await fetchAll()
+  }
+
+  async function remove(id) {
+    await sessionRepository.delete(id)
+    await fetchAll()
+  }
+
+  async function search(query) {
+    loading.value = true
+    error.value = null
+    try {
+      sessions.value = await sessionRepository.search(query)
+    } catch (e) {
+      error.value = e.message
+    } finally {
+      loading.value = false
+    }
+  }
+
+  async function getById(id) {
+    return sessionRepository.getById(id)
+  }
+
+  return { sessions, loading, error, fetchAll, create, update, remove, search, getById }
+}
diff --git a/src/composables/useSettings.js b/src/composables/useSettings.js
new file mode 100644
index 0000000..dd1b5a8
--- /dev/null
+++ b/src/composables/useSettings.js
@@ -0,0 +1,27 @@
+import { ref } from 'vue'
+import { settingsRepository } from '../db/repositories/settingsRepository.js'
+
+export function useSettings() {
+  const settings = ref({})
+  const loading = ref(false)
+
+  async function fetchAll() {
+    loading.value = true
+    try {
+      settings.value = await settingsRepository.getAll()
+    } finally {
+      loading.value = false
+    }
+  }
+
+  async function get(key) {
+    return settingsRepository.get(key)
+  }
+
+  async function set(key, value) {
+    await settingsRepository.set(key, value)
+    settings.value = { ...settings.value, [key]: value }
+  }
+
+  return { settings, loading, fetchAll, get, set }
+}
diff --git a/src/composables/useStats.js b/src/composables/useStats.js
new file mode 100644
index 0000000..5f16b68
--- /dev/null
+++ b/src/composables/useStats.js
@@ -0,0 +1,111 @@
+import { ref, watch } from 'vue'
+import { executionLogRepository } from '../db/repositories/executionLogRepository.js'
+
+export function useStats() {
+  const dateRange = ref('30d')
+  const frequencyGroupBy = ref('week')
+  const selectedExerciseId = ref('')
+
+  const totalSessions = ref(0)
+  const totalExercises = ref(0)
+  const streak = ref(0)
+  const loggedExercises = ref([])
+  const frequencyRaw = ref([])
+  const volumeRaw = ref([])
+  const progressionRaw = ref([])
+  const loading = ref(false)
+
+  function getSinceDate(range) {
+    if (range === 'all') return null
+    const d = new Date()
+    d.setHours(0, 0, 0, 0)
+    if (range === '7d') d.setDate(d.getDate() - 7)
+    else if (range === '30d') d.setDate(d.getDate() - 30)
+    else if (range === '3m') d.setMonth(d.getMonth() - 3)
+    return d.toISOString()
+  }
+
+  function computeStreak(days) {
+    if (!days.length) return 0
+    // Use UTC midnight to match SQLite DATE() which extracts UTC dates
+    const daySet = new Set(days.map((r) => r.day))
+    const cur = new Date()
+    cur.setUTCHours(0, 0, 0, 0)
+    let count = 0
+    while (true) {
+      const dateStr = cur.toISOString().slice(0, 10)
+      if (daySet.has(dateStr)) {
+        count++
+        cur.setUTCDate(cur.getUTCDate() - 1)
+      } else {
+        break
+      }
+    }
+    return count
+  }
+
+  async function loadFrequency() {
+    const since = getSinceDate(dateRange.value)
+    frequencyRaw.value = await executionLogRepository.getFrequencyData(
+      since,
+      frequencyGroupBy.value,
+    )
+  }
+
+  async function loadProgression() {
+    if (!selectedExerciseId.value) {
+      progressionRaw.value = []
+      return
+    }
+    const since = getSinceDate(dateRange.value)
+    progressionRaw.value = await executionLogRepository.getProgressionData(
+      selectedExerciseId.value,
+      since,
+    )
+  }
+
+  async function loadAll() {
+    loading.value = true
+    try {
+      const since = getSinceDate(dateRange.value)
+      const [sessions, exercises, days, frequency, volume, logged] = await Promise.all([
+        executionLogRepository.getTotalSessionsSince(since),
+        executionLogRepository.getTotalExercisesDone(since),
+        executionLogRepository.getDistinctSessionDays(),
+        executionLogRepository.getFrequencyData(since, frequencyGroupBy.value),
+        executionLogRepository.getVolumeData(since),
+        executionLogRepository.getLoggedExercises(),
+      ])
+      totalSessions.value = sessions
+      totalExercises.value = exercises
+      streak.value = computeStreak(days)
+      frequencyRaw.value = frequency
+      volumeRaw.value = volume
+      loggedExercises.value = logged
+      await loadProgression()
+    } finally {
+      loading.value = false
+    }
+  }
+
+  watch(dateRange, loadAll)
+  watch(frequencyGroupBy, loadFrequency)
+  watch(selectedExerciseId, loadProgression)
+
+  return {
+    dateRange,
+    frequencyGroupBy,
+    selectedExerciseId,
+    totalSessions,
+    totalExercises,
+    streak,
+    loggedExercises,
+    frequencyRaw,
+    volumeRaw,
+    progressionRaw,
+    loading,
+    loadAll,
+    loadProgression,
+    getSinceDate,
+  }
+}
diff --git a/src/composables/useTimer.js b/src/composables/useTimer.js
new file mode 100644
index 0000000..26f2e8e
--- /dev/null
+++ b/src/composables/useTimer.js
@@ -0,0 +1,92 @@
+import { ref, onUnmounted } from 'vue'
+
+export function useTimer() {
+  const remaining = ref(0)
+  const isPaused = ref(false)
+  let intervalId = null
+  let onTickFn = null
+  let onExpireFn = null
+  let endsAt = 0
+  let pausedAt = 0
+  let lastRemaining = 0
+
+  function start(seconds, { onTick, onExpire } = {}) {
+    _clear()
+    remaining.value = seconds
+    lastRemaining = seconds
+    isPaused.value = false
+    onTickFn = onTick || null
+    onExpireFn = onExpire || null
+    endsAt = Date.now() + seconds * 1000
+    intervalId = setInterval(_step, 250)
+  }
+
+  function _step() {
+    if (isPaused.value) return
+
+    const now = Date.now()
+    const newRemaining = Math.max(0, Math.ceil((endsAt - now) / 1000))
+
+    if (newRemaining < lastRemaining) {
+      // Fire onTick for each integer second that passed (catches skipped seconds)
+      for (let s = lastRemaining - 1; s >= newRemaining; s--) {
+        if (s > 0) onTickFn?.(s)
+      }
+      lastRemaining = newRemaining
+    }
+
+    remaining.value = newRemaining
+
+    if (newRemaining <= 0) {
+      _clear()
+      onExpireFn?.()
+    }
+  }
+
+  function pause() {
+    if (isPaused.value) return
+    isPaused.value = true
+    pausedAt = Date.now()
+  }
+
+  function resume() {
+    if (!isPaused.value) return
+    // Shift endsAt forward by the paused duration
+    endsAt += Date.now() - pausedAt
+    isPaused.value = false
+  }
+
+  function stop() {
+    _clear()
+    remaining.value = 0
+    isPaused.value = false
+    onTickFn = null
+    onExpireFn = null
+    endsAt = 0
+    pausedAt = 0
+    lastRemaining = 0
+  }
+
+  function _clear() {
+    if (intervalId) {
+      clearInterval(intervalId)
+      intervalId = null
+    }
+  }
+
+  // Recompute remaining immediately when the tab becomes visible
+  function _onVisibilityChange() {
+    if (!document.hidden && !isPaused.value && intervalId) {
+      _step()
+    }
+  }
+
+  document.addEventListener('visibilitychange', _onVisibilityChange)
+
+  onUnmounted(() => {
+    _clear()
+    document.removeEventListener('visibilitychange', _onVisibilityChange)
+  })
+
+  return { remaining, isPaused, start, pause, resume, stop }
+}
diff --git a/src/db/database.js b/src/db/database.js
new file mode 100644
index 0000000..da39c6c
--- /dev/null
+++ b/src/db/database.js
@@ -0,0 +1,160 @@
+class Database {
+  constructor() {
+    this._worker = null
+    this._messageId = 0
+    this._pending = new Map()
+    this._initPromise = null
+    this._broken = false
+    this.info = null
+    // Set when the DB is older than the app: { from, to }. The app must show
+    // the blocking migration screen and call runPendingMigrations().
+    this.migrationPending = null
+  }
+
+  async init() {
+    if (this._initPromise) return this._initPromise
+    this._initPromise = this._doInit()
+    return this._initPromise
+  }
+
+  async _doInit() {
+    this._worker = new Worker(new URL('./worker.js', import.meta.url), { type: 'module' })
+    this._worker.onmessage = (e) => this._handleMessage(e)
+    this._worker.onerror = (e) => this._handleError(e)
+
+    // Initialize SQLite + OPFS
+    // Compute the absolute base URL at runtime so the worker can locate
+    // sqlite3.wasm correctly regardless of the deployment subdirectory.
+    const wasmBaseUrl = new URL(import.meta.env.BASE_URL, window.location.href).href
+    this.info = await this._send('init', {
+      dbName: __APP_NAME__,
+      wasmBaseUrl,
+    })
+
+    // Detect the schema state (creates the schema on a fresh DB)
+    const status = await this._send('getSchemaStatus')
+
+    if (status.status === 'incompatible') {
+      throw new Error('DB_NEWER_THAN_APP')
+    }
+
+    if (status.status === 'migration-pending') {
+      // Pause: the UI must obtain a user backup, then call runPendingMigrations().
+      // The DB is open (exportDatabase works) but defaults are not initialized yet.
+      this.migrationPending = { from: status.from, to: status.to }
+      return this.info
+    }
+
+    // Initialize default settings
+    await this._initDefaults()
+
+    return this.info
+  }
+
+  async runPendingMigrations() {
+    const result = await this._send('runMigrations')
+    if (result.status === 'migration-failed') {
+      console.error('DB migration failed:', result)
+      throw new Error('DB_MIGRATION_FAILED')
+    }
+    this.migrationPending = null
+    await this._initDefaults()
+    return result
+  }
+
+  async _initDefaults() {
+    // Check if user_uuid exists (first launch detection)
+    const existing = await this._send('selectOne', {
+      sql: "SELECT value FROM settings WHERE key = 'user_uuid'",
+    })
+
+    if (!existing) {
+      const uuid = crypto.randomUUID()
+      const defaults = [
+        ['user_uuid', uuid],
+        ['user_name', 'User'],
+        ['language', 'en'],
+        ['theme', 'light'],
+        ['db_created_at', new Date().toISOString()],
+      ]
+      for (const [key, value] of defaults) {
+        await this._send('exec', {
+          sql: 'INSERT OR IGNORE INTO settings (key, value) VALUES (?, ?)',
+          params: [key, value],
+        })
+      }
+    }
+
+    // Always update app_version to current
+    await this._send('exec', {
+      sql: 'INSERT OR REPLACE INTO settings (key, value) VALUES (?, ?)',
+      params: ['app_version', __APP_VERSION__],
+    })
+  }
+
+  _handleMessage(e) {
+    const { id, result, error } = e.data
+    const resolver = this._pending.get(id)
+    if (resolver) {
+      this._pending.delete(id)
+      if (error) resolver.reject(new Error(error))
+      else resolver.resolve(result)
+    }
+  }
+
+  _handleError(e) {
+    console.error('DB Worker error:', e)
+    this._broken = true
+    for (const [, { reject }] of this._pending) {
+      reject(new Error('Worker crashed'))
+    }
+    this._pending.clear()
+    window.dispatchEvent(new CustomEvent('db-connection-lost'))
+  }
+
+  _send(type, args = {}) {
+    if (this._broken) {
+      return Promise.reject(new Error('DB connection lost'))
+    }
+    return new Promise((resolve, reject) => {
+      const id = ++this._messageId
+      this._pending.set(id, { resolve, reject })
+      this._worker.postMessage({ id, type, ...args })
+    })
+  }
+
+  async batch(statements) {
+    return this._send('batch', { statements })
+  }
+
+  async exec(sql, params) {
+    return this._send('exec', { sql, params })
+  }
+
+  async run(sql, params) {
+    return this._send('run', { sql, params })
+  }
+
+  async selectAll(sql, params) {
+    return this._send('selectAll', { sql, params })
+  }
+
+  async selectOne(sql, params) {
+    return this._send('selectOne', { sql, params })
+  }
+
+  async exportDatabase() {
+    return this._send('exportDb')
+  }
+
+  async importDatabase(bytes) {
+    return this._send('importDb', { bytes })
+  }
+
+  async resetDatabase() {
+    await this._send('resetDb')
+    await this._initDefaults()
+  }
+}
+
+export const db = new Database()
diff --git a/src/db/releases.js b/src/db/releases.js
new file mode 100644
index 0000000..f5f01c8
--- /dev/null
+++ b/src/db/releases.js
@@ -0,0 +1,83 @@
+export const RELEASES = [
+  {
+    schemaVersion: 1,
+    appVersion: '1.0.0',
+    dbBreak: false,
+    migrationScript: null,
+  },
+]
+
+/**
+ * Minimum tables a valid TrainUs DB must contain.
+ */
+export const REQUIRED_TABLES = ['schema_version', 'settings']
+
+/**
+ * Ordered migration scripts to bring a live DB from `fromVersion` up to `toVersion`.
+ * Returns [{ schemaVersion, script }] for releases in (fromVersion, toVersion], ascending.
+ * A release with `migrationScript: null` and `dbBreak: false` is a valid no-op migration
+ * (only the schema_version row is stamped). Every schemaVersion bump must ship exactly
+ * one RELEASES entry.
+ * Throws if a release in range has `dbBreak: true` without a migration script.
+ */
+export function getMigrationScripts(fromVersion, toVersion) {
+  const releasesInRange = RELEASES.filter(
+    (r) => r.schemaVersion > fromVersion && r.schemaVersion <= toVersion,
+  ).sort((a, b) => a.schemaVersion - b.schemaVersion)
+
+  const blocked = releasesInRange.find((r) => r.dbBreak && !r.migrationScript)
+  if (blocked) {
+    throw new Error(`Missing migration script for breaking schema version ${blocked.schemaVersion}`)
+  }
+
+  return releasesInRange.map((r) => ({
+    schemaVersion: r.schemaVersion,
+    script: r.migrationScript,
+  }))
+}
+
+/**
+ * Check if two schema versions are compatible.
+ * Returns { compatible, needsAdapt, scripts } where:
+ * - compatible: true if migration path exists (or same version)
+ * - needsAdapt: true if migration scripts need to run
+ * - scripts: array of SQL migration scripts to run sequentially
+ */
+export function checkCompatibility(importedVersion, currentVersion) {
+  if (importedVersion === currentVersion) {
+    return { compatible: true, needsAdapt: false, scripts: [] }
+  }
+
+  // Determine direction: upgrading imported data to current schema
+  const ascending = importedVersion < currentVersion
+  const fromVersion = Math.min(importedVersion, currentVersion)
+  const toVersion = Math.max(importedVersion, currentVersion)
+
+  // Collect releases between fromVersion (exclusive) and toVersion (inclusive)
+  const releasesInRange = RELEASES.filter(
+    (r) => r.schemaVersion > fromVersion && r.schemaVersion <= toVersion,
+  ).sort((a, b) => a.schemaVersion - b.schemaVersion)
+
+  const hasBreak = releasesInRange.some((r) => r.dbBreak)
+
+  if (!hasBreak) {
+    // No breaking changes in the range — compatible without adaptation
+    return { compatible: true, needsAdapt: false, scripts: [] }
+  }
+
+  // There are breaking changes — collect migration scripts
+  const scriptsNeeded = ascending
+    ? releasesInRange.filter((r) => r.dbBreak)
+    : releasesInRange.filter((r) => r.dbBreak).reverse()
+
+  const missingScript = scriptsNeeded.some((r) => !r.migrationScript)
+  if (missingScript) {
+    return { compatible: false, needsAdapt: true, scripts: [] }
+  }
+
+  return {
+    compatible: true,
+    needsAdapt: true,
+    scripts: scriptsNeeded.map((r) => r.migrationScript),
+  }
+}
diff --git a/src/db/repositories/collectionRepository.js b/src/db/repositories/collectionRepository.js
new file mode 100644
index 0000000..193745e
--- /dev/null
+++ b/src/db/repositories/collectionRepository.js
@@ -0,0 +1,122 @@
+import { db } from '../database.js'
+import { escapeLike } from '../../utils/escapeLike.js'
+
+export const collectionRepository = {
+  async create(collection) {
+    const id = crypto.randomUUID()
+    await db.run('INSERT INTO collection (id, label, created_by) VALUES (?, ?, ?)', [
+      id,
+      collection.label,
+      collection.created_by,
+    ])
+    return id
+  },
+
+  async getById(id) {
+    const row = await db.selectOne('SELECT * FROM collection WHERE id = ?', [id])
+    if (!row) return null
+    row.sessions = await this.getSessions(id)
+    return row
+  },
+
+  async getAll() {
+    const collections = await db.selectAll('SELECT * FROM collection ORDER BY label')
+    for (const c of collections) {
+      const row = await db.selectOne(
+        'SELECT COUNT(*) AS sessionCount FROM collection_session WHERE collection_id = ?',
+        [c.id],
+      )
+      c.sessionCount = row ? row.sessionCount : 0
+    }
+    return collections
+  },
+
+  async getAllWithSessions() {
+    const collections = await db.selectAll('SELECT * FROM collection ORDER BY label')
+    for (const c of collections) {
+      c.sessions = await this.getSessions(c.id)
+      const row = await db.selectOne(
+        'SELECT COUNT(*) AS sessionCount FROM collection_session WHERE collection_id = ?',
+        [c.id],
+      )
+      c.sessionCount = row ? row.sessionCount : 0
+    }
+    return collections
+  },
+
+  async searchWithSessions(query) {
+    const collections = await this.search(query)
+    for (const c of collections) {
+      c.sessions = await this.getSessions(c.id)
+      const row = await db.selectOne(
+        'SELECT COUNT(*) AS sessionCount FROM collection_session WHERE collection_id = ?',
+        [c.id],
+      )
+      c.sessionCount = row ? row.sessionCount : 0
+    }
+    return collections
+  },
+
+  async update(id, data) {
+    return db.run('UPDATE collection SET label = ? WHERE id = ?', [data.label, id])
+  },
+
+  async delete(id) {
+    return db.run('DELETE FROM collection WHERE id = ?', [id])
+  },
+
+  async createWithId(id, collection) {
+    await db.run('INSERT INTO collection (id, label, created_by) VALUES (?, ?, ?)', [
+      id,
+      collection.label,
+      collection.created_by,
+    ])
+    return id
+  },
+
+  async replaceAll(id, collection) {
+    await db.run(
+      `UPDATE collection SET label = ?, created_by = ?
+       WHERE id = ?`,
+      [collection.label, collection.created_by, id],
+    )
+  },
+
+  async search(query) {
+    return db.selectAll("SELECT * FROM collection WHERE label LIKE ? ESCAPE '\\' ORDER BY label", [
+      `%${escapeLike(query)}%`,
+    ])
+  },
+
+  async getSessions(collectionId) {
+    return db.selectAll(
+      `SELECT cs.position, cs.session_id, s.title
+       FROM collection_session cs
+       JOIN session s ON s.id = cs.session_id
+       WHERE cs.collection_id = ?
+       ORDER BY cs.position`,
+      [collectionId],
+    )
+  },
+
+  async getRawSessions(collectionId) {
+    return db.selectAll(
+      `SELECT cs.position, cs.session_id
+       FROM collection_session cs
+       WHERE cs.collection_id = ?
+       ORDER BY cs.position`,
+      [collectionId],
+    )
+  },
+
+  async setSessions(collectionId, sessionIds) {
+    const statements = [
+      { sql: 'DELETE FROM collection_session WHERE collection_id = ?', params: [collectionId] },
+      ...sessionIds.map((sessionId, i) => ({
+        sql: 'INSERT INTO collection_session (collection_id, session_id, position) VALUES (?, ?, ?)',
+        params: [collectionId, sessionId, i],
+      })),
+    ]
+    await db.batch(statements)
+  },
+}
diff --git a/src/db/repositories/comboRepository.js b/src/db/repositories/comboRepository.js
new file mode 100644
index 0000000..0702677
--- /dev/null
+++ b/src/db/repositories/comboRepository.js
@@ -0,0 +1,151 @@
+import { db } from '../database.js'
+import { escapeLike } from '../../utils/escapeLike.js'
+
+function deserialize(row) {
+  return {
+    ...row,
+    timer_config: JSON.parse(row.timer_config || '{}'),
+  }
+}
+
+export const comboRepository = {
+  async create(combo) {
+    const id = crypto.randomUUID()
+    await db.run(
+      `INSERT INTO combo (id, title, description, type, timer_config, created_by)
+       VALUES (?, ?, ?, ?, ?, ?)`,
+      [
+        id,
+        combo.title,
+        combo.description || '',
+        combo.type,
+        JSON.stringify(combo.timer_config || {}),
+        combo.created_by,
+      ],
+    )
+    return id
+  },
+
+  async getById(id) {
+    const row = await db.selectOne('SELECT * FROM combo WHERE id = ?', [id])
+    if (!row) return null
+    const combo = deserialize(row)
+    combo.exercises = await this.getExercises(id)
+    return combo
+  },
+
+  async getAll() {
+    const rows = await db.selectAll('SELECT * FROM combo ORDER BY title')
+    return rows.map(deserialize)
+  },
+
+  async getAllWithExercises() {
+    const combos = await this.getAll()
+    for (const combo of combos) {
+      combo.exercises = await this.getExercises(combo.id)
+    }
+    return combos
+  },
+
+  async searchWithExercises(query) {
+    const combos = await this.search(query)
+    for (const combo of combos) {
+      combo.exercises = await this.getExercises(combo.id)
+    }
+    return combos
+  },
+
+  async update(id, data) {
+    return db.run(
+      `UPDATE combo SET title = ?, description = ?, type = ?, timer_config = ?
+       WHERE id = ?`,
+      [data.title, data.description || '', data.type, JSON.stringify(data.timer_config || {}), id],
+    )
+  },
+
+  async delete(id) {
+    return db.run('DELETE FROM combo WHERE id = ?', [id])
+  },
+
+  async createWithId(id, combo) {
+    await db.run(
+      `INSERT INTO combo (id, title, description, type, timer_config, created_by)
+       VALUES (?, ?, ?, ?, ?, ?)`,
+      [
+        id,
+        combo.title,
+        combo.description || '',
+        combo.type,
+        JSON.stringify(combo.timer_config || {}),
+        combo.created_by,
+      ],
+    )
+    return id
+  },
+
+  async replaceAll(id, combo) {
+    await db.run(
+      `UPDATE combo SET title = ?, description = ?, type = ?, timer_config = ?, created_by = ?
+       WHERE id = ?`,
+      [
+        combo.title,
+        combo.description || '',
+        combo.type,
+        JSON.stringify(combo.timer_config || {}),
+        combo.created_by,
+        id,
+      ],
+    )
+  },
+
+  async search(query) {
+    const rows = await db.selectAll(
+      "SELECT * FROM combo WHERE title LIKE ? ESCAPE '\\' ORDER BY title",
+      [`%${escapeLike(query)}%`],
+    )
+    return rows.map(deserialize)
+  },
+
+  async getExercises(comboId) {
+    const rows = await db.selectAll(
+      `SELECT ce.position, ce.exercise_id, ce.default_reps, ce.default_weight,
+              e.title, e.asymmetric, e.alternate
+       FROM combo_exercise ce
+       JOIN exercise e ON e.id = ce.exercise_id
+       WHERE ce.combo_id = ?
+       ORDER BY ce.position`,
+      [comboId],
+    )
+    return rows.map((r) => ({
+      ...r,
+      asymmetric: Boolean(r.asymmetric),
+      alternate: Boolean(r.alternate),
+    }))
+  },
+
+  async getRawExercises(comboId) {
+    return db.selectAll(
+      `SELECT ce.position, ce.exercise_id, ce.default_reps, ce.default_weight
+       FROM combo_exercise ce
+       WHERE ce.combo_id = ?
+       ORDER BY ce.position`,
+      [comboId],
+    )
+  },
+
+  async setExercises(comboId, exercises) {
+    const statements = [
+      { sql: 'DELETE FROM combo_exercise WHERE combo_id = ?', params: [comboId] },
+      ...exercises.map((exercise, i) => {
+        const exerciseId = typeof exercise === 'string' ? exercise : exercise.exerciseId
+        const defaultReps = typeof exercise === 'object' ? exercise.defaultReps || 1 : 1
+        const defaultWeight = typeof exercise === 'object' ? exercise.defaultWeight || 0.0 : 0.0
+        return {
+          sql: 'INSERT INTO combo_exercise (combo_id, exercise_id, position, default_reps, default_weight) VALUES (?, ?, ?, ?, ?)',
+          params: [comboId, exerciseId, i, defaultReps, defaultWeight],
+        }
+      }),
+    ]
+    await db.batch(statements)
+  },
+}
diff --git a/src/db/repositories/executionLogRepository.js b/src/db/repositories/executionLogRepository.js
new file mode 100644
index 0000000..cac6925
--- /dev/null
+++ b/src/db/repositories/executionLogRepository.js
@@ -0,0 +1,304 @@
+import { db } from '../database.js'
+import { escapeLike } from '../../utils/escapeLike.js'
+
+export const executionLogRepository = {
+  async create(log) {
+    const id = crypto.randomUUID()
+    await db.run(
+      `INSERT INTO execution_log (id, session_id, started_at, finished_at, status)
+       VALUES (?, ?, ?, ?, ?)`,
+      [id, log.session_id, log.started_at, log.finished_at || null, log.status || 'completed'],
+    )
+    return id
+  },
+
+  async getById(id) {
+    const row = await db.selectOne('SELECT * FROM execution_log WHERE id = ?', [id])
+    if (!row) return null
+    row.items = await this.getItems(id)
+    return row
+  },
+
+  async getAll() {
+    return db.selectAll('SELECT * FROM execution_log ORDER BY started_at DESC')
+  },
+
+  async getBySessionId(sessionId) {
+    return db.selectAll(
+      'SELECT * FROM execution_log WHERE session_id = ? ORDER BY started_at DESC',
+      [sessionId],
+    )
+  },
+
+  async update(id, data) {
+    if (data.status !== undefined) {
+      return db.run('UPDATE execution_log SET finished_at = ?, status = ? WHERE id = ?', [
+        data.finished_at,
+        data.status,
+        id,
+      ])
+    }
+    return db.run('UPDATE execution_log SET finished_at = ? WHERE id = ?', [data.finished_at, id])
+  },
+
+  async delete(id) {
+    return db.run('DELETE FROM execution_log WHERE id = ?', [id])
+  },
+
+  async search(query) {
+    return db.selectAll(
+      `SELECT el.* FROM execution_log el
+       JOIN session s ON s.id = el.session_id
+       WHERE s.title LIKE ? ESCAPE '\\'
+       ORDER BY el.started_at DESC`,
+      [`%${escapeLike(query)}%`],
+    )
+  },
+
+  async getItems(logId) {
+    return db.selectAll(`SELECT * FROM execution_log_item WHERE log_id = ? ORDER BY timestamp`, [
+      logId,
+    ])
+  },
+
+  async addItem(item) {
+    const id = crypto.randomUUID()
+    await db.run(
+      `INSERT INTO execution_log_item (id, log_id, exercise_id, combo_id, round_number, reps_done, weight_used, side, completed, timestamp)
+       VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`,
+      [
+        id,
+        item.log_id,
+        item.exercise_id,
+        item.combo_id || null,
+        item.round_number || null,
+        item.reps_done || 0,
+        item.weight_used || 0,
+        item.side || null,
+        item.completed ? 1 : 0,
+        item.timestamp || new Date().toISOString(),
+      ],
+    )
+    return id
+  },
+
+  async createWithId(id, log) {
+    await db.run(
+      `INSERT INTO execution_log (id, session_id, started_at, finished_at, status)
+       VALUES (?, ?, ?, ?, ?)`,
+      [id, log.session_id, log.started_at, log.finished_at || null, log.status || 'completed'],
+    )
+    return id
+  },
+
+  async addItems(logId, items) {
+    if (!items.length) return
+    const statements = items.map((item) => ({
+      sql: `INSERT INTO execution_log_item (id, log_id, exercise_id, combo_id, round_number, reps_done, weight_used, side, completed, timestamp)
+            VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`,
+      params: [
+        item.id,
+        logId,
+        item.exercise_id,
+        item.combo_id || null,
+        item.round_number || null,
+        item.reps_done || 0,
+        item.weight_used || 0,
+        item.side || null,
+        item.completed ? 1 : 0,
+        item.timestamp || new Date().toISOString(),
+      ],
+    }))
+    await db.batch(statements)
+  },
+
+  async getLastItemsBySession(sessionId) {
+    const log = await db.selectOne(
+      'SELECT id FROM execution_log WHERE session_id = ? ORDER BY started_at DESC LIMIT 1',
+      [sessionId],
+    )
+    if (!log) return {}
+    const items = await db.selectAll(
+      'SELECT exercise_id, reps_done, weight_used, side FROM execution_log_item WHERE log_id = ? ORDER BY timestamp',
+      [log.id],
+    )
+    const map = {}
+    for (const item of items) {
+      map[item.exercise_id] = {
+        reps_done: item.reps_done,
+        weight_used: item.weight_used,
+        side: item.side,
+      }
+    }
+    return map
+  },
+
+  async getTotalSessionsSince(since = null) {
+    if (!since) {
+      const row = await db.selectOne(
+        "SELECT COUNT(*) AS count FROM execution_log WHERE status = 'completed'",
+      )
+      return row ? row.count : 0
+    }
+    return this.getCountSince(since)
+  },
+
+  async getTotalExercisesDone(since = null) {
+    let sql = `SELECT COUNT(*) AS count FROM execution_log_item eli
+               JOIN execution_log el ON el.id = eli.log_id
+               WHERE eli.completed = 1`
+    const params = []
+    if (since) {
+      sql += ' AND el.started_at >= ?'
+      params.push(since)
+    }
+    const row = await db.selectOne(sql, params)
+    return row ? row.count : 0
+  },
+
+  async getDistinctSessionDays() {
+    return db.selectAll(
+      `SELECT DATE(started_at) AS day FROM execution_log GROUP BY DATE(started_at) ORDER BY day DESC`,
+    )
+  },
+
+  async getFrequencyData(since = null, groupBy = 'week') {
+    const fmt = groupBy === 'month' ? '%Y-%m' : '%Y-%W'
+    let sql = `SELECT strftime('${fmt}', started_at) AS period, COUNT(*) AS count FROM execution_log WHERE status = 'completed'`
+    const params = []
+    if (since) {
+      sql += ' AND started_at >= ?'
+      params.push(since)
+    }
+    sql += ' GROUP BY period ORDER BY period'
+    return db.selectAll(sql, params)
+  },
+
+  async getVolumeData(since = null) {
+    let sql = `SELECT el.id, DATE(el.started_at) AS day, el.started_at,
+                      SUM(eli.reps_done * eli.weight_used) AS volume
+               FROM execution_log el
+               JOIN execution_log_item eli ON eli.log_id = el.id
+               WHERE eli.completed = 1`
+    const params = []
+    if (since) {
+      sql += ' AND el.started_at >= ?'
+      params.push(since)
+    }
+    sql += ' GROUP BY el.id ORDER BY el.started_at'
+    return db.selectAll(sql, params)
+  },
+
+  async getLoggedExercises() {
+    return db.selectAll(
+      `SELECT DISTINCT e.id, e.title
+       FROM exercise e
+       JOIN execution_log_item eli ON eli.exercise_id = e.id
+       ORDER BY e.title`,
+    )
+  },
+
+  async getProgressionData(exerciseId, since = null) {
+    let sql = `SELECT el.started_at,
+                      SUM(eli.reps_done) AS total_reps,
+                      MAX(eli.weight_used) AS max_weight
+               FROM execution_log el
+               JOIN execution_log_item eli ON eli.log_id = el.id
+               WHERE eli.exercise_id = ? AND eli.completed = 1`
+    const params = [exerciseId]
+    if (since) {
+      sql += ' AND el.started_at >= ?'
+      params.push(since)
+    }
+    sql += ' GROUP BY el.id ORDER BY el.started_at'
+    return db.selectAll(sql, params)
+  },
+
+  async getRecent(limit = 3) {
+    return db.selectAll(
+      `SELECT el.*, s.title AS session_title
+       FROM execution_log el
+       JOIN session s ON s.id = el.session_id
+       ORDER BY el.started_at DESC
+       LIMIT ?`,
+      [limit],
+    )
+  },
+
+  async getItemsWithTitles(logId) {
+    return db.selectAll(
+      `SELECT eli.*, e.title AS exercise_title,
+              c.title AS combo_title, c.type AS combo_type
+       FROM execution_log_item eli
+       JOIN exercise e ON e.id = eli.exercise_id
+       LEFT JOIN combo c ON c.id = eli.combo_id
+       WHERE eli.log_id = ?
+       ORDER BY eli.timestamp`,
+      [logId],
+    )
+  },
+
+  async getRecentWithItems(limit = 4) {
+    const logs = await db.selectAll(
+      `SELECT el.*, s.title AS session_title
+       FROM execution_log el
+       JOIN session s ON s.id = el.session_id
+       ORDER BY el.started_at DESC
+       LIMIT ?`,
+      [limit],
+    )
+    for (const log of logs) {
+      log.items = await this.getItemsWithTitles(log.id)
+    }
+    return logs
+  },
+
+  async getAllWithItems() {
+    const logs = await db.selectAll(
+      `SELECT el.*, s.title AS session_title
+       FROM execution_log el
+       JOIN session s ON s.id = el.session_id
+       ORDER BY el.started_at DESC`,
+    )
+    for (const log of logs) {
+      log.items = await this.getItemsWithTitles(log.id)
+    }
+    return logs
+  },
+
+  async getCountSince(isoDate) {
+    const row = await db.selectOne(
+      `SELECT COUNT(*) AS count FROM execution_log WHERE status = 'completed' AND started_at >= ?`,
+      [isoDate],
+    )
+    return row ? row.count : 0
+  },
+
+  async countItemsByExercise(exerciseId) {
+    const row = await db.selectOne(
+      `SELECT COUNT(*) AS count FROM execution_log_item WHERE exercise_id = ?`,
+      [exerciseId],
+    )
+    return row ? row.count : 0
+  },
+
+  async countLogsBySession(sessionId) {
+    const row = await db.selectOne(
+      `SELECT COUNT(*) AS count FROM execution_log WHERE session_id = ?`,
+      [sessionId],
+    )
+    return row ? row.count : 0
+  },
+
+  async getCountByDateRange(from, to) {
+    const row = await db.selectOne(
+      `SELECT COUNT(*) AS count FROM execution_log WHERE DATE(started_at) BETWEEN ? AND ?`,
+      [from, to],
+    )
+    return row ? row.count : 0
+  },
+
+  async deleteByDateRange(from, to) {
+    return db.run(`DELETE FROM execution_log WHERE DATE(started_at) BETWEEN ? AND ?`, [from, to])
+  },
+}
diff --git a/src/db/repositories/exerciseRepository.js b/src/db/repositories/exerciseRepository.js
new file mode 100644
index 0000000..bd1112a
--- /dev/null
+++ b/src/db/repositories/exerciseRepository.js
@@ -0,0 +1,126 @@
+import { db } from '../database.js'
+import { escapeLike } from '../../utils/escapeLike.js'
+
+function deserialize(row) {
+  return {
+    ...row,
+    asymmetric: Boolean(row.asymmetric),
+    alternate: Boolean(row.alternate),
+    image_urls: JSON.parse(row.image_urls || '[]'),
+    video_urls: JSON.parse(row.video_urls || '[]'),
+  }
+}
+
+export const exerciseRepository = {
+  async create(exercise) {
+    const id = crypto.randomUUID()
+    await db.run(
+      `INSERT INTO exercise (id, title, description, asymmetric, alternate,
+        image_urls, video_urls, default_reps, default_weight, created_by)
+       VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`,
+      [
+        id,
+        exercise.title,
+        exercise.description || '',
+        exercise.asymmetric ? 1 : 0,
+        exercise.alternate ? 1 : 0,
+        JSON.stringify(exercise.image_urls || []),
+        JSON.stringify(exercise.video_urls || []),
+        exercise.default_reps || 0,
+        exercise.default_weight || 0,
+        exercise.created_by,
+      ],
+    )
+    return id
+  },
+
+  async getById(id) {
+    const row = await db.selectOne('SELECT * FROM exercise WHERE id = ?', [id])
+    return row ? deserialize(row) : null
+  },
+
+  async getAll() {
+    const rows = await db.selectAll('SELECT * FROM exercise ORDER BY title')
+    return rows.map(deserialize)
+  },
+
+  async update(id, data) {
+    return db.run(
+      `UPDATE exercise SET title = ?, description = ?, asymmetric = ?,
+        alternate = ?, image_urls = ?, video_urls = ?,
+        default_reps = ?, default_weight = ?
+       WHERE id = ?`,
+      [
+        data.title,
+        data.description || '',
+        data.asymmetric ? 1 : 0,
+        data.alternate ? 1 : 0,
+        JSON.stringify(data.image_urls || []),
+        JSON.stringify(data.video_urls || []),
+        data.default_reps || 0,
+        data.default_weight || 0,
+        id,
+      ],
+    )
+  },
+
+  /**
+   * Insert an exercise with a specific ID (for import scenarios).
+   */
+  async createWithId(id, exercise) {
+    await db.run(
+      `INSERT INTO exercise (id, title, description, asymmetric, alternate,
+        image_urls, video_urls, default_reps, default_weight, created_by)
+       VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`,
+      [
+        id,
+        exercise.title,
+        exercise.description || '',
+        exercise.asymmetric ? 1 : 0,
+        exercise.alternate ? 1 : 0,
+        JSON.stringify(exercise.image_urls || []),
+        JSON.stringify(exercise.video_urls || []),
+        exercise.default_reps || 0,
+        exercise.default_weight || 0,
+        exercise.created_by,
+      ],
+    )
+    return id
+  },
+
+  /**
+   * Replace (update) all fields including created_by (for import overwrite).
+   */
+  async replaceAll(id, data) {
+    return db.run(
+      `UPDATE exercise SET title = ?, description = ?, asymmetric = ?,
+        alternate = ?, image_urls = ?, video_urls = ?,
+        default_reps = ?, default_weight = ?, created_by = ?
+       WHERE id = ?`,
+      [
+        data.title,
+        data.description || '',
+        data.asymmetric ? 1 : 0,
+        data.alternate ? 1 : 0,
+        JSON.stringify(data.image_urls || []),
+        JSON.stringify(data.video_urls || []),
+        data.default_reps || 0,
+        data.default_weight || 0,
+        data.created_by,
+        id,
+      ],
+    )
+  },
+
+  async delete(id) {
+    return db.run('DELETE FROM exercise WHERE id = ?', [id])
+  },
+
+  async search(query) {
+    const rows = await db.selectAll(
+      "SELECT * FROM exercise WHERE title LIKE ? ESCAPE '\\' ORDER BY title",
+      [`%${escapeLike(query)}%`],
+    )
+    return rows.map(deserialize)
+  },
+}
diff --git a/src/db/repositories/sessionRepository.js b/src/db/repositories/sessionRepository.js
new file mode 100644
index 0000000..46c4163
--- /dev/null
+++ b/src/db/repositories/sessionRepository.js
@@ -0,0 +1,124 @@
+import { db } from '../database.js'
+import { escapeLike } from '../../utils/escapeLike.js'
+
+export const sessionRepository = {
+  async create(session) {
+    const id = crypto.randomUUID()
+    await db.run(
+      `INSERT INTO session (id, title, description, created_by)
+       VALUES (?, ?, ?, ?)`,
+      [id, session.title, session.description || '', session.created_by],
+    )
+    return id
+  },
+
+  async getById(id) {
+    const row = await db.selectOne('SELECT * FROM session WHERE id = ?', [id])
+    if (!row) return null
+    row.items = await this.getItems(id)
+    return row
+  },
+
+  async getAll() {
+    return db.selectAll('SELECT * FROM session ORDER BY title')
+  },
+
+  async getAllWithItems() {
+    const sessions = await this.getAll()
+    for (const session of sessions) {
+      session.items = await this.getItems(session.id)
+    }
+    return sessions
+  },
+
+  async searchWithItems(query) {
+    const sessions = await this.search(query)
+    for (const session of sessions) {
+      session.items = await this.getItems(session.id)
+    }
+    return sessions
+  },
+
+  async update(id, data) {
+    return db.run('UPDATE session SET title = ?, description = ? WHERE id = ?', [
+      data.title,
+      data.description || '',
+      id,
+    ])
+  },
+
+  async delete(id) {
+    return db.run('DELETE FROM session WHERE id = ?', [id])
+  },
+
+  async createWithId(id, session) {
+    await db.run(
+      `INSERT INTO session (id, title, description, created_by)
+       VALUES (?, ?, ?, ?)`,
+      [id, session.title, session.description || '', session.created_by],
+    )
+    return id
+  },
+
+  async replaceAll(id, session) {
+    await db.run(
+      `UPDATE session SET title = ?, description = ?, created_by = ?
+       WHERE id = ?`,
+      [session.title, session.description || '', session.created_by, id],
+    )
+  },
+
+  async search(query) {
+    return db.selectAll("SELECT * FROM session WHERE title LIKE ? ESCAPE '\\' ORDER BY title", [
+      `%${escapeLike(query)}%`,
+    ])
+  },
+
+  async getItems(sessionId) {
+    const exerciseRows = await db.selectAll(
+      `SELECT si.position, si.item_id, si.item_type, si.repetitions, si.weight, e.title
+       FROM session_item si
+       JOIN exercise e ON e.id = si.item_id
+       WHERE si.session_id = ? AND si.item_type = 'exercise'
+       ORDER BY si.position`,
+      [sessionId],
+    )
+    const comboRows = await db.selectAll(
+      `SELECT si.position, si.item_id, si.item_type, si.repetitions, si.weight, c.title, c.type AS combo_type
+       FROM session_item si
+       JOIN combo c ON c.id = si.item_id
+       WHERE si.session_id = ? AND si.item_type = 'combo'
+       ORDER BY si.position`,
+      [sessionId],
+    )
+    return [...exerciseRows, ...comboRows].sort((a, b) => a.position - b.position)
+  },
+
+  async getRawItems(sessionId) {
+    return db.selectAll(
+      `SELECT si.position, si.item_id, si.item_type, si.repetitions, si.weight
+       FROM session_item si
+       WHERE si.session_id = ?
+       ORDER BY si.position`,
+      [sessionId],
+    )
+  },
+
+  async setItems(sessionId, items) {
+    const statements = [
+      { sql: 'DELETE FROM session_item WHERE session_id = ?', params: [sessionId] },
+      ...items.map((item, i) => ({
+        sql: 'INSERT INTO session_item (session_id, item_id, item_type, position, repetitions, weight) VALUES (?, ?, ?, ?, ?, ?)',
+        params: [
+          sessionId,
+          item.item_id,
+          item.item_type,
+          i,
+          item.repetitions || 1,
+          item.weight || 0.0,
+        ],
+      })),
+    ]
+    await db.batch(statements)
+  },
+}
diff --git a/src/db/repositories/settingsRepository.js b/src/db/repositories/settingsRepository.js
new file mode 100644
index 0000000..1e64290
--- /dev/null
+++ b/src/db/repositories/settingsRepository.js
@@ -0,0 +1,21 @@
+import { db } from '../database.js'
+
+export const settingsRepository = {
+  async get(key) {
+    const row = await db.selectOne('SELECT value FROM settings WHERE key = ?', [key])
+    return row ? row.value : null
+  },
+
+  async set(key, value) {
+    return db.run('INSERT OR REPLACE INTO settings (key, value) VALUES (?, ?)', [key, value])
+  },
+
+  async getAll() {
+    const rows = await db.selectAll('SELECT key, value FROM settings')
+    const map = {}
+    for (const row of rows) {
+      map[row.key] = row.value
+    }
+    return map
+  },
+}
diff --git a/src/db/repositories/suffixRepository.js b/src/db/repositories/suffixRepository.js
new file mode 100644
index 0000000..3cf8bf7
--- /dev/null
+++ b/src/db/repositories/suffixRepository.js
@@ -0,0 +1,69 @@
+import { db } from '../database.js'
+
+export const suffixRepository = {
+  async create(entry) {
+    await db.run('INSERT INTO suffix (user_uuid, user_name, suffix) VALUES (?, ?, ?)', [
+      entry.user_uuid,
+      entry.user_name,
+      entry.suffix,
+    ])
+  },
+
+  async getByUuid(userUuid) {
+    return db.selectOne('SELECT * FROM suffix WHERE user_uuid = ?', [userUuid])
+  },
+
+  async getBySuffix(suffix) {
+    return db.selectOne('SELECT * FROM suffix WHERE suffix = ?', [suffix])
+  },
+
+  async getAll() {
+    return db.selectAll('SELECT * FROM suffix ORDER BY user_name')
+  },
+
+  async update(userUuid, data) {
+    return db.run('UPDATE suffix SET user_name = ?, suffix = ? WHERE user_uuid = ?', [
+      data.user_name,
+      data.suffix,
+      userUuid,
+    ])
+  },
+
+  async delete(userUuid) {
+    return db.run('DELETE FROM suffix WHERE user_uuid = ?', [userUuid])
+  },
+
+  /**
+   * Renames a suffix across all entity title/label columns.
+   * Updates suffix table entry + all titles containing [OLD_SUFFIX] to [NEW_SUFFIX].
+   */
+  async renameSuffix(userUuid, newSuffix) {
+    const existing = await this.getByUuid(userUuid)
+    if (!existing) throw new Error('Suffix entry not found')
+
+    const oldPattern = `[${existing.suffix}]`
+    const newPattern = `[${newSuffix}]`
+
+    // Update suffix table
+    await db.run('UPDATE suffix SET suffix = ? WHERE user_uuid = ?', [newSuffix, userUuid])
+
+    // Update titles across entity tables
+    await db.run(
+      "UPDATE exercise SET title = REPLACE(title, ?, ?) WHERE title LIKE '%' || ? || '%'",
+      [oldPattern, newPattern, oldPattern],
+    )
+    await db.run("UPDATE combo SET title = REPLACE(title, ?, ?) WHERE title LIKE '%' || ? || '%'", [
+      oldPattern,
+      newPattern,
+      oldPattern,
+    ])
+    await db.run(
+      "UPDATE session SET title = REPLACE(title, ?, ?) WHERE title LIKE '%' || ? || '%'",
+      [oldPattern, newPattern, oldPattern],
+    )
+    await db.run(
+      "UPDATE collection SET label = REPLACE(label, ?, ?) WHERE label LIKE '%' || ? || '%'",
+      [oldPattern, newPattern, oldPattern],
+    )
+  },
+}
diff --git a/src/db/schema.js b/src/db/schema.js
new file mode 100644
index 0000000..282cb7d
--- /dev/null
+++ b/src/db/schema.js
@@ -0,0 +1,109 @@
+export const SCHEMA_VERSION = 1
+
+export const SCHEMA_SQL = `
+CREATE TABLE IF NOT EXISTS schema_version (
+  version INTEGER PRIMARY KEY,
+  applied_at TEXT NOT NULL DEFAULT (datetime('now'))
+);
+
+CREATE TABLE IF NOT EXISTS settings (
+  key TEXT PRIMARY KEY,
+  value TEXT
+);
+
+CREATE TABLE IF NOT EXISTS exercise (
+  id TEXT PRIMARY KEY,
+  title TEXT NOT NULL UNIQUE,
+  description TEXT DEFAULT '',
+  asymmetric INTEGER NOT NULL DEFAULT 0,
+  alternate INTEGER NOT NULL DEFAULT 0,
+  image_urls TEXT DEFAULT '[]',
+  video_urls TEXT DEFAULT '[]',
+  default_reps INTEGER NOT NULL DEFAULT 0,
+  default_weight REAL NOT NULL DEFAULT 0.0,
+  created_by TEXT NOT NULL
+);
+
+CREATE TABLE IF NOT EXISTS combo (
+  id TEXT PRIMARY KEY,
+  title TEXT NOT NULL UNIQUE,
+  description TEXT DEFAULT '',
+  type TEXT NOT NULL CHECK(type IN ('NONE', 'EMOM', 'AMRAP', 'TABATA')),
+  timer_config TEXT DEFAULT '{}',
+  created_by TEXT NOT NULL
+);
+
+CREATE TABLE IF NOT EXISTS combo_exercise (
+  combo_id TEXT NOT NULL,
+  exercise_id TEXT NOT NULL,
+  position INTEGER NOT NULL,
+  default_reps INTEGER NOT NULL DEFAULT 1,
+  default_weight REAL NOT NULL DEFAULT 0.0,
+  PRIMARY KEY (combo_id, position),
+  FOREIGN KEY (combo_id) REFERENCES combo(id) ON DELETE CASCADE,
+  FOREIGN KEY (exercise_id) REFERENCES exercise(id) ON DELETE CASCADE
+);
+
+CREATE TABLE IF NOT EXISTS session (
+  id TEXT PRIMARY KEY,
+  title TEXT NOT NULL UNIQUE,
+  description TEXT DEFAULT '',
+  created_by TEXT NOT NULL
+);
+
+CREATE TABLE IF NOT EXISTS session_item (
+  session_id TEXT NOT NULL,
+  item_id TEXT NOT NULL,
+  item_type TEXT NOT NULL CHECK(item_type IN ('exercise', 'combo')),
+  position INTEGER NOT NULL,
+  repetitions INTEGER NOT NULL DEFAULT 1,
+  weight REAL NOT NULL DEFAULT 0.0,
+  PRIMARY KEY (session_id, position),
+  FOREIGN KEY (session_id) REFERENCES session(id) ON DELETE CASCADE
+);
+
+CREATE TABLE IF NOT EXISTS collection (
+  id TEXT PRIMARY KEY,
+  label TEXT NOT NULL UNIQUE,
+  created_by TEXT NOT NULL
+);
+
+CREATE TABLE IF NOT EXISTS collection_session (
+  collection_id TEXT NOT NULL,
+  session_id TEXT NOT NULL,
+  position INTEGER NOT NULL,
+  PRIMARY KEY (collection_id, position),
+  FOREIGN KEY (collection_id) REFERENCES collection(id) ON DELETE CASCADE,
+  FOREIGN KEY (session_id) REFERENCES session(id) ON DELETE CASCADE
+);
+
+CREATE TABLE IF NOT EXISTS execution_log (
+  id TEXT PRIMARY KEY,
+  session_id TEXT NOT NULL,
+  started_at TEXT NOT NULL,
+  finished_at TEXT,
+  status TEXT NOT NULL DEFAULT 'completed' CHECK(status IN ('completed','aborted')),
+  FOREIGN KEY (session_id) REFERENCES session(id) ON DELETE CASCADE
+);
+
+CREATE TABLE IF NOT EXISTS execution_log_item (
+  id TEXT PRIMARY KEY,
+  log_id TEXT NOT NULL,
+  exercise_id TEXT NOT NULL,
+  combo_id TEXT DEFAULT NULL,
+  round_number INTEGER DEFAULT NULL,
+  reps_done INTEGER DEFAULT 0,
+  weight_used REAL DEFAULT 0.0,
+  side TEXT DEFAULT NULL,
+  completed INTEGER NOT NULL DEFAULT 0,
+  timestamp TEXT,
+  FOREIGN KEY (log_id) REFERENCES execution_log(id) ON DELETE CASCADE,
+  FOREIGN KEY (exercise_id) REFERENCES exercise(id) ON DELETE CASCADE
+);
+
+CREATE TABLE IF NOT EXISTS suffix (
+  user_uuid TEXT PRIMARY KEY,
+  user_name TEXT NOT NULL,
+  suffix TEXT NOT NULL UNIQUE
+);
+`
diff --git a/src/db/worker.js b/src/db/worker.js
new file mode 100644
index 0000000..f62b298
--- /dev/null
+++ b/src/db/worker.js
@@ -0,0 +1,395 @@
+import sqlite3InitModule from '@sqlite.org/sqlite-wasm'
+import { REQUIRED_TABLES, checkCompatibility, getMigrationScripts } from './releases.js'
+import { SCHEMA_SQL, SCHEMA_VERSION } from './schema.js'
+
+let db = null
+let sqlite3 = null
+
+async function initDatabase(config) {
+  const { dbName, wasmBaseUrl } = config
+
+  sqlite3 = await sqlite3InitModule({
+    locateFile: (file) => new URL(file, wasmBaseUrl).href,
+  })
+
+  const poolUtil = await sqlite3.installOpfsSAHPoolVfs({
+    directory: `.${dbName}`,
+    initialCapacity: 6,
+  })
+  db = new poolUtil.OpfsSAHPoolDb(`/${dbName}.db`)
+
+  db.exec('PRAGMA foreign_keys = ON')
+
+  return { vfs: 'opfs-sahpool', persistent: true }
+}
+
+function _readDbVersion() {
+  const tableRows = db.exec(
+    "SELECT name FROM sqlite_master WHERE type='table' AND name='schema_version'",
+    { returnValue: 'resultRows', rowMode: 'array' },
+  )
+  if (tableRows.length === 0) return null
+
+  const versionRows = db.exec('SELECT MAX(version) AS version FROM schema_version', {
+    returnValue: 'resultRows',
+    rowMode: 'object',
+  })
+  return versionRows.length > 0 ? versionRows[0].version : null
+}
+
+function handleGetSchemaStatus() {
+  const dbVersion = _readDbVersion()
+
+  if (dbVersion === null) {
+    // Fresh DB: create the schema and stamp the current version
+    db.exec(SCHEMA_SQL)
+    db.exec('INSERT INTO schema_version (version) VALUES (?)', { bind: [SCHEMA_VERSION] })
+    return { status: 'fresh', version: SCHEMA_VERSION }
+  }
+
+  if (dbVersion === SCHEMA_VERSION) {
+    return { status: 'up-to-date', version: dbVersion }
+  }
+
+  if (dbVersion > SCHEMA_VERSION) {
+    return { status: 'incompatible', dbVersion, appVersion: SCHEMA_VERSION }
+  }
+
+  // Older DB — the app must obtain a user backup before calling runMigrations
+  return { status: 'migration-pending', from: dbVersion, to: SCHEMA_VERSION }
+}
+
+function handleRunMigrations() {
+  const from = _readDbVersion()
+
+  if (from === null || from >= SCHEMA_VERSION) {
+    return { status: 'up-to-date', version: from }
+  }
+
+  let migrations
+  try {
+    migrations = getMigrationScripts(from, SCHEMA_VERSION)
+  } catch (e) {
+    return { status: 'migration-failed', from, to: SCHEMA_VERSION, message: e.message }
+  }
+
+  for (const { schemaVersion, script } of migrations) {
+    try {
+      db.exec('BEGIN')
+      if (script) db.exec(script)
+      db.exec('INSERT INTO schema_version (version) VALUES (?)', { bind: [schemaVersion] })
+      db.exec('COMMIT')
+    } catch (e) {
+      try {
+        db.exec('ROLLBACK')
+      } catch {
+        // no open transaction left to roll back
+      }
+      return {
+        status: 'migration-failed',
+        from,
+        to: SCHEMA_VERSION,
+        failedAt: schemaVersion,
+        message: e.message,
+      }
+    }
+  }
+
+  return { status: 'migrated', from, to: SCHEMA_VERSION }
+}
+
+function handleBatch(statements) {
+  db.exec('BEGIN IMMEDIATE')
+  try {
+    for (const { sql, params } of statements) {
+      db.exec(sql, { bind: params || undefined })
+    }
+    db.exec('COMMIT')
+    return true
+  } catch (e) {
+    try {
+      db.exec('ROLLBACK')
+    } catch (_e) {
+      // Ignore — the error we care about is `e`
+    }
+    throw e
+  }
+}
+
+function handleExec(sql, params) {
+  db.exec(sql, { bind: params || undefined })
+  return true
+}
+
+function handleRun(sql, params) {
+  db.exec(sql, { bind: params || undefined })
+  return { changes: sqlite3.capi.sqlite3_changes(db.pointer) }
+}
+
+function handleSelectAll(sql, params) {
+  return db.exec(sql, {
+    bind: params || undefined,
+    rowMode: 'object',
+    returnValue: 'resultRows',
+  })
+}
+
+function handleSelectOne(sql, params) {
+  const rows = db.exec(sql, {
+    bind: params || undefined,
+    rowMode: 'object',
+    returnValue: 'resultRows',
+  })
+  return rows.length > 0 ? rows[0] : null
+}
+
+function handleImportDb(bytes) {
+  const uint8 = bytes instanceof Uint8Array ? bytes : new Uint8Array(bytes)
+
+  // 1. Try loading the file into an in-memory DB via sqlite3_deserialize
+  let tempDb
+  try {
+    tempDb = new sqlite3.oo1.DB(':memory:')
+    const n = uint8.byteLength
+    const pBuf = sqlite3.wasm.alloc(n)
+    sqlite3.wasm.heap8u().set(uint8, pBuf)
+    const rc = sqlite3.capi.sqlite3_deserialize(
+      tempDb.pointer,
+      'main',
+      pBuf,
+      n,
+      n,
+      sqlite3.capi.SQLITE_DESERIALIZE_FREEONCLOSE | sqlite3.capi.SQLITE_DESERIALIZE_RESIZEABLE,
+    )
+    if (rc !== 0) {
+      const msg = sqlite3.capi.sqlite3_errmsg(tempDb.pointer)
+      tempDb.close()
+      return { success: false, error: 'INVALID_FILE', message: msg || `deserialize rc=${rc}` }
+    }
+    // Verify the DB can be read
+    tempDb.exec('SELECT count(*) FROM sqlite_master')
+  } catch (e) {
+    if (tempDb) tempDb.close()
+    return { success: false, error: 'INVALID_FILE', message: e.message }
+  }
+
+  // 2. Check required tables exist in the imported DB
+  const importedTableRows = tempDb.exec(
+    "SELECT name FROM sqlite_master WHERE type='table' AND name NOT LIKE 'sqlite_%'",
+    { returnValue: 'resultRows', rowMode: 'array' },
+  )
+  const importedTableNames = importedTableRows.map((r) => r[0])
+
+  for (const required of REQUIRED_TABLES) {
+    if (!importedTableNames.includes(required)) {
+      tempDb.close()
+      return {
+        success: false,
+        error: 'INCOMPLETE_DB',
+        message: `Missing required table: ${required}`,
+      }
+    }
+  }
+
+  // 3. Read schema versions from both DBs
+  const importedVersionRows = tempDb.exec(
+    'SELECT version FROM schema_version ORDER BY version DESC LIMIT 1',
+    { returnValue: 'resultRows', rowMode: 'array' },
+  )
+  const importedVersion = importedVersionRows.length > 0 ? importedVersionRows[0][0] : null
+
+  if (importedVersion === null) {
+    tempDb.close()
+    return {
+      success: false,
+      error: 'INCOMPLETE_DB',
+      message: 'No schema version found in imported DB',
+    }
+  }
+
+  const currentVersionRows = db.exec(
+    'SELECT version FROM schema_version ORDER BY version DESC LIMIT 1',
+    { returnValue: 'resultRows', rowMode: 'array' },
+  )
+  const currentVersion = currentVersionRows.length > 0 ? currentVersionRows[0][0] : null
+
+  // 4. Check compatibility
+  const compat = checkCompatibility(importedVersion, currentVersion)
+
+  if (!compat.compatible) {
+    tempDb.close()
+    return {
+      success: false,
+      error: 'INCOMPATIBLE_VERSION',
+      message: `Schema version ${importedVersion} is incompatible with current version ${currentVersion}`,
+      importedVersion,
+      currentVersion,
+    }
+  }
+
+  // 5. Run adapt scripts if needed
+  if (compat.needsAdapt) {
+    try {
+      for (const script of compat.scripts) {
+        tempDb.exec(script)
+      }
+    } catch (e) {
+      tempDb.close()
+      return { success: false, error: 'ADAPT_FAILED', message: e.message }
+    }
+  }
+
+  // 6. Get current DB tables
+  const currentTableRows = db.exec(
+    "SELECT name FROM sqlite_master WHERE type='table' AND name NOT LIKE 'sqlite_%'",
+    { returnValue: 'resultRows', rowMode: 'array' },
+  )
+  const currentTableNames = currentTableRows.map((r) => r[0])
+
+  // Only restore tables that exist in both databases
+  const tablesToRestore = importedTableNames.filter((t) => currentTableNames.includes(t))
+
+  // 7. Table-by-table copy inside a single transaction so a mid-restore
+  //    failure cannot leave the live DB partially wiped.
+  const report = {
+    success: true,
+    tablesRestored: [],
+    importedVersion,
+    currentVersion,
+    adapted: compat.needsAdapt,
+  }
+
+  db.exec('PRAGMA foreign_keys = OFF')
+
+  let restoreError = null
+  try {
+    db.exec('BEGIN IMMEDIATE')
+    for (const table of tablesToRestore) {
+      db.exec(`DELETE FROM "${table}"`)
+
+      const rows = tempDb.exec(`SELECT * FROM "${table}"`, {
+        returnValue: 'resultRows',
+        rowMode: 'object',
+      })
+
+      if (rows.length > 0) {
+        const cols = Object.keys(rows[0])
+        const currentColRows = db.exec(`PRAGMA table_info("${table}")`, {
+          returnValue: 'resultRows',
+          rowMode: 'object',
+        })
+        const currentCols = currentColRows.map((r) => r.name)
+        const colsToInsert = cols.filter((c) => currentCols.includes(c))
+
+        if (colsToInsert.length > 0) {
+          const quotedCols = colsToInsert.map((c) => `"${c}"`).join(', ')
+          const placeholders = colsToInsert.map(() => '?').join(', ')
+          const insertSql = `INSERT INTO "${table}" (${quotedCols}) VALUES (${placeholders})`
+          const stmt = db.prepare(insertSql)
+          try {
+            for (const row of rows) {
+              stmt.bind(colsToInsert.map((c) => row[c]))
+              stmt.stepReset()
+            }
+          } finally {
+            stmt.finalize()
+          }
+        }
+      }
+
+      report.tablesRestored.push({ table, rows: rows.length })
+    }
+    db.exec('COMMIT')
+  } catch (e) {
+    try {
+      db.exec('ROLLBACK')
+    } catch (_e) {
+      // Ignore — the error we care about is `e`
+    }
+    restoreError = e
+  } finally {
+    db.exec('PRAGMA foreign_keys = ON')
+    tempDb.close()
+  }
+
+  if (restoreError) {
+    return { success: false, error: 'RESTORE_FAILED', message: restoreError.message }
+  }
+  return report
+}
+
+function handleResetDb() {
+  const tables = [
+    'execution_log_item',
+    'execution_log',
+    'collection_session',
+    'session_item',
+    'combo_exercise',
+    'suffix',
+    'collection',
+    'session',
+    'combo',
+    'exercise',
+    'settings',
+    'schema_version',
+  ]
+
+  db.exec('PRAGMA foreign_keys = OFF')
+  try {
+    for (const table of tables) {
+      db.exec(`DROP TABLE IF EXISTS "${table}"`)
+    }
+    db.exec(SCHEMA_SQL)
+    db.exec('INSERT INTO schema_version (version) VALUES (?)', { bind: [SCHEMA_VERSION] })
+  } finally {
+    db.exec('PRAGMA foreign_keys = ON')
+  }
+  return { success: true }
+}
+
+self.onmessage = async (e) => {
+  const { id, type, ...args } = e.data
+  try {
+    let result
+    switch (type) {
+      case 'init':
+        result = await initDatabase(args)
+        break
+      case 'getSchemaStatus':
+        result = handleGetSchemaStatus()
+        break
+      case 'runMigrations':
+        result = handleRunMigrations()
+        break
+      case 'batch':
+        result = handleBatch(args.statements)
+        break
+      case 'exec':
+        result = handleExec(args.sql, args.params)
+        break
+      case 'run':
+        result = handleRun(args.sql, args.params)
+        break
+      case 'selectAll':
+        result = handleSelectAll(args.sql, args.params)
+        break
+      case 'selectOne':
+        result = handleSelectOne(args.sql, args.params)
+        break
+      case 'exportDb':
+        result = sqlite3.capi.sqlite3_js_db_export(db)
+        break
+      case 'importDb':
+        result = handleImportDb(args.bytes)
+        break
+      case 'resetDb':
+        result = handleResetDb()
+        break
+      default:
+        throw new Error(`Unknown message type: ${type}`)
+    }
+    self.postMessage({ id, result })
+  } catch (err) {
+    self.postMessage({ id, error: err.message })
+  }
+}
diff --git a/src/i18n/index.js b/src/i18n/index.js
new file mode 100644
index 0000000..cacfe0a
--- /dev/null
+++ b/src/i18n/index.js
@@ -0,0 +1,20 @@
+import i18next from 'i18next'
+import I18NextVue from 'i18next-vue'
+import en from './locales/en.json'
+import fr from './locales/fr.json'
+import da from './locales/da.json'
+
+i18next.init({
+  lng: 'en',
+  fallbackLng: 'en',
+  resources: {
+    en: { translation: en },
+    fr: { translation: fr },
+    da: { translation: da },
+  },
+  interpolation: {
+    escapeValue: false,
+  },
+})
+
+export { i18next, I18NextVue }
diff --git a/src/i18n/locales/da.json b/src/i18n/locales/da.json
new file mode 100644
index 0000000..1e6c85c
--- /dev/null
+++ b/src/i18n/locales/da.json
@@ -0,0 +1,460 @@
+{
+  "app": {
+    "name": "TrainUs",
+    "loading": "Indlæser…"
+  },
+  "common": {
+    "markdownHint": "Grundlæggende Markdown understøttes",
+    "back": "Tilbage",
+    "clearSearch": "Ryd søgning"
+  },
+  "error": {
+    "dbInitFailed": "Kunne ikke initialisere databasen",
+    "browserNotCompatible": "Din browser understøtter ikke de nødvendige lagringsfunktioner. Sørg for at bruge en nyere version af din browser og at du ikke er i privat browsing.",
+    "dbNewerThanApp": "Dine data blev oprettet af en nyere version af appen. Dine data er ikke blevet ændret. Genindlæs siden for at få den nyeste version af appen.",
+    "dbMigrationFailed": "Databaseopdateringen mislykkedes, og dine data blev ikke ændret. Genindlæs siden for at prøve igen, eller gendan den sikkerhedskopi, du lige har downloadet, hvis problemet fortsætter.",
+    "dbConnectionLost": "Databaseforbindelsen gik tabt på grund af en uventet fejl. Genindlæs siden for at genoprette forbindelsen.",
+    "reload": "Genindlæs"
+  },
+  "migration": {
+    "title": "Databaseopdatering påkrævet",
+    "body": "Appen er blevet opdateret, og din database skal migreres fra version {{from}} til version {{to}}.",
+    "backupRequired": "Før opdateringen skal du downloade en sikkerhedskopi af dine data. Opdateringen kan først starte, når sikkerhedskopien er gemt.",
+    "downloadBackup": "Download sikkerhedskopi",
+    "update": "Opdater",
+    "updating": "Opdaterer…"
+  },
+  "nav": {
+    "mainNav": "Hovednavigation",
+    "home": "Hjem",
+    "exercises": "Øvelser",
+    "combos": "Kombos",
+    "sessions": "Sessioner",
+    "collections": "Samlinger",
+    "stats": "Statistik",
+    "settings": "Indstillinger"
+  },
+  "home": {
+    "title": "Hjem",
+    "empty": "Ingen træningssessioner udført endnu. Start en session for at se din aktivitet her!",
+    "recentSessions": "Seneste sessioner",
+    "sessionsLast7Days": "Sessioner (de seneste 7 dage)",
+    "sessionsLast30Days": "Sessioner (de seneste 30 dage)",
+    "history": "Historik",
+    "exportHtml": "Eksportér som HTML",
+    "exportedOn": "Eksporteret den {{date}}"
+  },
+  "exercises": {
+    "title": "Øvelser",
+    "empty": "Ingen øvelser endnu. Opret din første øvelse for at komme i gang!",
+    "searchPlaceholder": "Søg i øvelser…",
+    "noResults": "Ingen øvelser matcher din søgning.",
+    "new": "Ny øvelse",
+    "edit": "Rediger øvelse",
+    "detail": "Øvelsesdetaljer",
+    "deleteConfirm": "Er du sikker på, at du vil slette \"{{title}}\"? Dette kan ikke fortrydes.",
+    "deleteConfirmWithHistory": "Er du sikker på, at du vil slette \"{{title}}\"? Dette sletter også {{count}} journalpost(er). Dette kan ikke fortrydes.",
+    "deleted": "Øvelse slettet.",
+    "form": {
+      "title": "Titel",
+      "titlePlaceholder": "f.eks. Armstrækninger",
+      "description": "Beskrivelse",
+      "descriptionPlaceholder": "Valgfri beskrivelse…",
+      "asymmetric": "Asymmetrisk øvelse",
+      "alternate": "Skift side ved hver gentagelse",
+      "alternateFalse": "Gennemfør alle gentagelser på én side, skift derefter",
+      "imageUrls": "Billed-URL'er",
+      "videoUrls": "Video-URL'er",
+      "urlPlaceholder": "https://…",
+      "addUrl": "Tilføj URL",
+      "removeUrl": "Fjern",
+      "defaultReps": "Standardgentagelser",
+      "defaultWeight": "Standardvægt (kg)",
+      "save": "Gem",
+      "cancel": "Annuller"
+    },
+    "reps": "gent.",
+    "weight": "kg",
+    "asymmetricLabel": "Asymmetrisk",
+    "alternateLabel": "Alternerende",
+    "delete": "Slet øvelse",
+    "videoOffline": "Videoer er ikke tilgængelige offline.",
+    "evenRepsHint": "Antal gentagelser skal være lige for asymmetriske øvelser."
+  },
+  "combos": {
+    "title": "Kombos",
+    "empty": "Ingen kombos endnu. Opret din første kombo for at komme i gang!",
+    "searchPlaceholder": "Søg i kombos…",
+    "noResults": "Ingen kombos matcher din søgning.",
+    "new": "Ny kombo",
+    "edit": "Rediger kombo",
+    "detail": "Kombodetailer",
+    "deleteConfirm": "Er du sikker på, at du vil slette \"{{title}}\"? Dette kan ikke fortrydes.",
+    "deleted": "Kombo slettet.",
+    "exercises": "øvelser",
+    "timerConfig": "Timer-konfiguration",
+    "delete": "Slet kombo",
+    "form": {
+      "title": "Titel",
+      "titlePlaceholder": "f.eks. Overkrop Blast",
+      "description": "Beskrivelse",
+      "descriptionPlaceholder": "Valgfri beskrivelse…",
+      "type": "Type",
+      "exercises": "Øvelser",
+      "selectExercise": "Vælg en øvelse",
+      "noExercises": "Ingen øvelser tilgængelige — opret øvelser først",
+      "addExercise": "Tilføj øvelse",
+      "reps": "Gent.",
+      "weight": "Vægt (kg)",
+      "save": "Gem",
+      "cancel": "Annuller"
+    },
+    "types": {
+      "none": "Ingen",
+      "emom": "EMOM",
+      "amrap": "AMRAP",
+      "tabata": "TABATA"
+    },
+    "timer": {
+      "emomDuration": "Varighed",
+      "amrapDuration": "Varighed",
+      "tabataWorkTime": "Arbejdstid (s)",
+      "tabataRestTime": "Hviletid (s)",
+      "tabataSeconds": "sekunder",
+      "minutes": "minutter",
+      "rounds": "runder"
+    }
+  },
+  "collections": {
+    "title": "Samlinger",
+    "empty": "Ingen samlinger endnu. Opret din første samling for at organisere dine sessioner!",
+    "searchPlaceholder": "Søg i samlinger…",
+    "noResults": "Ingen samlinger matcher din søgning.",
+    "new": "Ny samling",
+    "edit": "Rediger samling",
+    "detail": "Samlingsdetaljer",
+    "deleteConfirm": "Er du sikker på, at du vil slette \"{{label}}\"? Dette kan ikke fortrydes.",
+    "deleted": "Samling slettet.",
+    "sessions": "sessioner",
+    "delete": "Slet samling",
+    "form": {
+      "label": "Etiket",
+      "labelPlaceholder": "f.eks. Ugentlig træning",
+      "sessions": "Sessioner",
+      "selectSession": "Vælg en session",
+      "noSessions": "Ingen sessioner tilgængelige — opret sessioner først",
+      "addSession": "Tilføj session",
+      "save": "Gem",
+      "cancel": "Annuller"
+    }
+  },
+  "sessions": {
+    "title": "Sessioner",
+    "empty": "Ingen sessioner endnu.",
+    "searchPlaceholder": "Søg i sessioner…",
+    "noResults": "Ingen sessioner matcher din søgning.",
+    "new": "Ny session",
+    "edit": "Rediger session",
+    "detail": "Sessionsdetaljer",
+    "deleteConfirm": "Er du sikker på, at du vil slette \"{{title}}\"? Dette kan ikke fortrydes.",
+    "deleteConfirmWithHistory": "Er du sikker på, at du vil slette \"{{title}}\"? Dette sletter også {{count}} udførelseslog(ge). Dette kan ikke fortrydes.",
+    "deleted": "Session slettet.",
+    "items": "elementer",
+    "delete": "Slet session",
+    "itemType": {
+      "exercise": "Øvelse",
+      "combo": "Kombo"
+    },
+    "form": {
+      "title": "Titel",
+      "titlePlaceholder": "f.eks. Overkrop dag",
+      "description": "Beskrivelse",
+      "descriptionPlaceholder": "Valgfri beskrivelse…",
+      "items": "Elementer",
+      "reps": "Gent.",
+      "durationMin": "Varighed (min)",
+      "weight": "Vægt (kg)",
+      "selectExercise": "Vælg en øvelse",
+      "selectCombo": "Vælg en kombo",
+      "noExercises": "Ingen øvelser tilgængelige — opret øvelser først",
+      "noCombos": "Ingen kombos tilgængelige — opret kombos først",
+      "addItem": "Tilføj element",
+      "save": "Gem",
+      "cancel": "Annuller"
+    }
+  },
+  "stats": {
+    "title": "Statistik",
+    "empty": "Ingen data endnu. Udfør en session for at se din statistik.",
+    "usingSince": "Du har brugt TrainUs siden {{date}}",
+    "dateRange": {
+      "7d": "7 dage",
+      "30d": "30 dage",
+      "3m": "3 måneder",
+      "all": "Altid"
+    },
+    "summary": {
+      "sessions": "Sessioner",
+      "exercises": "Udførte øvelser",
+      "streak": "Dages streak"
+    },
+    "charts": {
+      "frequency": {
+        "title": "Frekvens",
+        "week": "Per uge",
+        "month": "Per måned",
+        "yLabel": "Sessioner",
+        "noData": "Ingen sessioner i denne periode."
+      },
+      "volume": {
+        "title": "Volumen",
+        "yLabel": "Volumen (kg·gent.)",
+        "noData": "Ingen volumedata i denne periode."
+      },
+      "progression": {
+        "title": "Progression",
+        "selectExercise": "Vælg en øvelse…",
+        "reps": "Gent.",
+        "weight": "Vægt (kg)",
+        "noData": "Ingen data for denne øvelse i denne periode."
+      }
+    }
+  },
+  "settings": {
+    "title": "Indstillinger",
+    "language": "Sprog",
+    "userName": "Brugernavn",
+    "userNamePlaceholder": "Indtast dit navn",
+    "nameRequired": "Navn må ikke være tomt",
+    "userId": "Bruger-id",
+    "theme": "Tema",
+    "themeLight": "Lys",
+    "themeDark": "Mørk",
+    "themeTrainus": "TrainUs",
+    "database": "Database",
+    "downloadDb": "Download database",
+    "downloadDbHint": "Download eller gendan den rå SQLite-databasefil.",
+    "restoreDb": "Gendan database",
+    "restoreDbWarning": "Dette vil erstatte ALLE nuværende data med indholdet af den valgte fil. Dette kan ikke fortrydes.\n\nNuværende appversion: {{version}}\n\nEr du sikker på, at du vil fortsætte?",
+    "restoreInProgress": "Gendanner database…",
+    "restoreSuccess": "Database gendannet",
+    "restoreError": "Gendannelse af database mislykkedes",
+    "restoreAdapted": "Skema tilpasset fra version {{from}} til {{to}}.",
+    "restoreRows": "række(r)",
+    "restoreDismiss": "OK",
+    "restoreErrorCodes": {
+      "INVALID_FILE": "Den valgte fil er ikke en gyldig SQLite-database eller er beskadiget.",
+      "INCOMPLETE_DB": "Den valgte fil er ikke en gyldig TrainUs-database (manglende påkrævede tabeller).",
+      "INCOMPATIBLE_VERSION": "Databaseversionen er inkompatibel, og ingen migreringsvej er tilgængelig.",
+      "ADAPT_FAILED": "Tilpasning af databaseskema mislykkedes.",
+      "RESTORE_FAILED": "Der opstod en fejl under gendannelse af data.",
+      "UNEXPECTED": "Der opstod en uventet fejl."
+    },
+    "exportImport": "Eksporter / Importer",
+    "exportAllData": "Eksporter alle data",
+    "exportData": "Eksporter data",
+    "importData": "Importer data",
+    "importAsMine": "Importer som mine",
+    "comingSoon": "Kommer snart i en fremtidig opdatering.",
+    "suffixManagement": "Importsuffikser",
+    "suffixHint": "Administrer suffikser til at skelne importerede øvelser fra andre brugere.",
+    "suffixDeleteConfirm": "Slet suffikset \"{{suffix}}\" for {{name}}? Importerede øvelser slettes ikke.",
+    "suffixDeleteTitle": "Slet suffiks",
+    "backupReminderInvalid": "Skal være mellem 1 og 365",
+    "initializeDb": "Initialiser database",
+    "initializeDbHint": "Slet alle data og nulstil databasen til dens indledende tilstand. Denne handling kan ikke fortrydes.",
+    "initializeDbTitle": "Initialiser database",
+    "initializeDbConfirm": "Jeg forstår, at dette vil slette alle mine data permanent og ikke kan fortrydes",
+    "backup": {
+      "lastBackup": "Seneste sikkerhedskopi: {{when}}",
+      "neverBackedUp": "Aldrig sikkerhedskopieret",
+      "reminderEvery": "Påmind mig hver",
+      "reminderEveryUnit": "dage"
+    },
+    "sound": "Lyd",
+    "soundVolume": "Lydstyrke",
+    "soundTest": "Test",
+    "credits": "Kreditering",
+    "manageJournal": "Administrer øvelseslogge",
+    "manageJournalHint": "Slet øvelseslogposter inden for et datointerval.",
+    "cleanJournalBtn": "Ryd journaldata"
+  },
+  "cleanJournal": {
+    "title": "Ryd journaldata",
+    "hint": "Vælg et datointerval for permanent at slette alle øvelseslogposter inden for det.",
+    "from": "Fra",
+    "to": "Til",
+    "errorToBeforeFrom": "Slutdato skal være på eller efter startdato.",
+    "matchCount_one": "{{count}} session vil blive slettet.",
+    "matchCount_other": "{{count}} sessioner vil blive slettet.",
+    "matchCount": "{{count}} session(er) vil blive slettet.",
+    "confirmLabel": "Jeg forstår, at dette permanent vil slette de valgte øvelseslogposter og ikke kan fortrydes.",
+    "deleteBtn": "Slet"
+  },
+  "credits": {
+    "title": "Kreditering",
+    "intro": "Open source-ikoner brugt i denne applikation:",
+    "appIcon": {
+      "name": "Mighty Force",
+      "description": "App-ikon, af Delapouite",
+      "author": "Delapouite"
+    },
+    "bootstrapIcons": {
+      "name": "Bootstrap Icons",
+      "description": "UI-ikoner brugt gennem hele applikationen"
+    },
+    "gameIcons": "game-icons.net vedligeholdes af Lorc, Delapouite & bidragydere",
+    "thirdParties": {
+      "title": "Tredjepartsbiblioteker"
+    },
+    "testingTools": {
+      "title": "Testværktøjer"
+    }
+  },
+  "export": {
+    "exercises": "Eksporter alle øvelser",
+    "exercise": "Eksporter denne øvelse",
+    "combos": "Eksporter alle kombos",
+    "combo": "Eksporter denne kombo",
+    "sessions": "Eksporter alle sessioner",
+    "session": "Eksporter denne session",
+    "collections": "Eksporter alle samlinger",
+    "collection": "Eksporter denne samling",
+    "executionLogs": "Udførelseslogge",
+    "settings": "Indstillinger",
+    "filterTitle": "Eksporter data",
+    "filterDescription": "Vælg hvilke datatyper der skal eksporteres."
+  },
+  "import": {
+    "title": "Importer data",
+    "titleAsMine": "Importer som mine",
+    "exercises": "Importer øvelser",
+    "importAsMine": "Importer som mine",
+    "cancel": "Annuller",
+    "continue": "Fortsæt",
+    "apply": "Importer",
+    "done": "Færdig",
+    "importing": "Importerer…",
+    "exerciseCount": "øvelse(r)",
+    "totalCount": "element(er)",
+    "executionLogs": "udførelseslog(ge)",
+    "from": "Fra {{name}} den {{date}}",
+    "usingSuffix": "Suffiks: [{{suffix}}]",
+    "suffixExplanation": "Disse elementer er fra {{name}}. Vælg et kort suffiks for at skelne dem fra dine egne.",
+    "suffixLabel": "Suffiks",
+    "suffixPlaceholder": "f.eks. JD",
+    "suffixPreview": "Titler vil se sådan ud: \"{{title}} [{{suffix}}]\"",
+    "suffixRequired": "Suffiks er påkrævet.",
+    "suffixTaken": "Dette suffiks bruges allerede af en anden bruger.",
+    "collisionExplanation": "{{count}} element(er) er i konflikt med eksisterende data. Vælg hvad der skal gøres for hvert:",
+    "replace": "Erstat",
+    "skip": "Spring over",
+    "replaceAll": "Erstat alle",
+    "skipAll": "Spring alle over",
+    "exportedOn": "Eksporteret den {{date}}",
+    "reportTitle": "Import fuldført",
+    "reportTotalImported": "{{count}} element(er) importeret",
+    "reportImported": "{{count}} importeret",
+    "reportReplaced": "{{count}} erstattet",
+    "reportUpdated": "{{count}} opdateret",
+    "reportSkipped": "{{count}} sprunget over",
+    "errors": {
+      "invalidJson": "Filen indeholder ikke gyldigt JSON.",
+      "invalidFormat": "Filformatet genkendes ikke.",
+      "missingMetadata": "Filen mangler metadata.",
+      "wrongApp": "Denne fil blev ikke eksporteret fra TrainUs.",
+      "missingSchema": "Filen mangler skemaversionsinformation.",
+      "newerSchema": "Denne fil blev eksporteret fra en nyere version af TrainUs. Opdater venligst applikationen.",
+      "missingData": "Filen indeholder ingen data.",
+      "missingExporter": "Filen mangler eksportørinformation."
+    }
+  },
+  "validation": {
+    "required": "Dette felt er påkrævet.",
+    "minValue": "Værdien skal være ≥ {{min}}.",
+    "invalidUrl": "Indtast en gyldig URL (https://…).",
+    "titleTaken": "En øvelse med denne titel findes allerede.",
+    "comboTitleTaken": "En kombo med denne titel findes allerede.",
+    "collectionLabelTaken": "En samling med denne etiket findes allerede."
+  },
+  "shortcuts": {
+    "edit": "— tryk E",
+    "new": "— tryk N",
+    "back": "— tryk Esc",
+    "save": "— Ctrl+Enter"
+  },
+  "execution": {
+    "start": "Start session",
+    "exit": "Afslut session",
+    "steps": "trin",
+    "now": "NU",
+    "next": "NÆSTE",
+    "round": "Runde",
+    "reps": "Gent.",
+    "weight": "Vægt",
+    "side": "Side",
+    "sideLeft": "VENSTRE",
+    "sideRight": "HØJRE",
+    "asymAlternate": "(1x{{left}} ↔ 1x{{right}}) × {{count}}",
+    "asymSequential": "{{count}}x {{left}} → {{count}}x {{right}}",
+    "done": "Færdig",
+    "continue": "Fortsæt",
+    "oneMoreRound": "En runde til",
+    "comboContext": "Kombo: {{title}} — Runde {{round}} af {{total}}",
+    "comboComplete": "{{title}} — {{rounds}} runde(r) fuldført",
+    "complete": "Session fuldført!",
+    "backToSession": "Tilbage til session",
+    "timer": {
+      "pause": "Pause",
+      "resume": "Genoptag",
+      "rest": "HVILE",
+      "nextExercise": "Næste:",
+      "timeUp": "Tiden er gået",
+      "timeUpTitle": "⏱ Tiden er gået — {{title}}"
+    },
+    "showDetails": "Vis øvelsesdetaljer",
+    "hideDetails": "Skjul øvelsesdetaljer",
+    "videoOffline": "Videoer er ikke tilgængelige offline.",
+    "leaveConfirm": "Du er midt i en session. Forlad alligevel? Sessionen vil blive markeret som afbrudt."
+  },
+  "backup": {
+    "reminder": {
+      "tooltip": "Seneste sikkerhedskopi for {{days}} dag(e) siden — klik for at sikkerhedskopiere",
+      "tooltipNever": "Ingen sikkerhedskopi endnu — klik for at oprette en"
+    },
+    "modal": {
+      "title": "Påmindelse om sikkerhedskopi",
+      "body": "Din seneste sikkerhedskopi var for {{days}} dag(e) siden. Vi anbefaler at sikkerhedskopiere dine data regelmæssigt.",
+      "bodyNever": "Du har aldrig sikkerhedskopieret dine data. Vi anbefaler at oprette en sikkerhedskopi.",
+      "dismiss": "Afvis",
+      "goToSettings": "Gå til indstillinger"
+    }
+  },
+  "install": {
+    "button": "Installer app",
+    "dismiss": "Afvis installationsprompt"
+  },
+  "modal": {
+    "close": "Luk dialog"
+  },
+  "saveFile": {
+    "title": "Gem fil",
+    "label": "Filnavn",
+    "cancel": "Annuller",
+    "save": "Gem"
+  },
+  "about": {
+    "title": "Om TrainUs",
+    "appVersion": "Applikationsversion",
+    "dbVersion": "Databaseversion",
+    "author": "Oprettet af",
+    "links": "Links",
+    "repository": "Repository",
+    "website": "Websted",
+    "license": "Licens",
+    "licenseBtn": "Se licens"
+  },
+  "license": {
+    "title": "Licens"
+  }
+}
diff --git a/src/i18n/locales/en.json b/src/i18n/locales/en.json
new file mode 100644
index 0000000..c46517a
--- /dev/null
+++ b/src/i18n/locales/en.json
@@ -0,0 +1,460 @@
+{
+  "app": {
+    "name": "TrainUs",
+    "loading": "Loading…"
+  },
+  "common": {
+    "markdownHint": "Basic Markdown supported",
+    "back": "Back",
+    "clearSearch": "Clear search"
+  },
+  "error": {
+    "dbInitFailed": "Unable to initialize the database",
+    "browserNotCompatible": "Your browser does not support the required storage features. Please make sure you are using a recent version of your browser and that you are not in private browsing mode.",
+    "dbNewerThanApp": "Your data was created by a newer version of the app. Your data has not been modified. Please reload the page to get the latest version of the app.",
+    "dbMigrationFailed": "The database update failed and your data was left unchanged. Reload the page to try again, or restore the backup you just downloaded if the problem persists.",
+    "dbConnectionLost": "The database connection was lost due to an unexpected error. Reload the page to reconnect.",
+    "reload": "Reload"
+  },
+  "migration": {
+    "title": "Database update required",
+    "body": "The app has been updated and your database needs to be migrated from version {{from}} to version {{to}}.",
+    "backupRequired": "Before updating, please download a backup of your data. The update can only start once the backup has been saved.",
+    "downloadBackup": "Download backup",
+    "update": "Update",
+    "updating": "Updating…"
+  },
+  "nav": {
+    "mainNav": "Main navigation",
+    "home": "Home",
+    "exercises": "Exercises",
+    "combos": "Combos",
+    "sessions": "Sessions",
+    "collections": "Collections",
+    "stats": "Statistics",
+    "settings": "Settings"
+  },
+  "home": {
+    "title": "Home",
+    "empty": "No training sessions executed yet. Start a session to see your activity here!",
+    "recentSessions": "Recent Sessions",
+    "sessionsLast7Days": "Sessions (last 7 days)",
+    "sessionsLast30Days": "Sessions (last 30 days)",
+    "history": "History",
+    "exportHtml": "Export as HTML",
+    "exportedOn": "Exported on {{date}}"
+  },
+  "exercises": {
+    "title": "Exercises",
+    "empty": "No exercises yet. Create your first exercise to get started!",
+    "searchPlaceholder": "Search exercises…",
+    "noResults": "No exercises match your search.",
+    "new": "New Exercise",
+    "edit": "Edit Exercise",
+    "detail": "Exercise Details",
+    "deleteConfirm": "Are you sure you want to delete \"{{title}}\"? This cannot be undone.",
+    "deleteConfirmWithHistory": "Are you sure you want to delete \"{{title}}\"? This will also delete {{count}} journal entry/entries. This cannot be undone.",
+    "deleted": "Exercise deleted.",
+    "form": {
+      "title": "Title",
+      "titlePlaceholder": "e.g. Push-ups",
+      "description": "Description",
+      "descriptionPlaceholder": "Optional description…",
+      "asymmetric": "Asymmetric exercise",
+      "alternate": "Alternate sides each repetition",
+      "alternateFalse": "Complete all reps on one side, then switch",
+      "imageUrls": "Image URLs",
+      "videoUrls": "Video URLs",
+      "urlPlaceholder": "https://…",
+      "addUrl": "Add URL",
+      "removeUrl": "Remove",
+      "defaultReps": "Default repetitions",
+      "defaultWeight": "Default weight (kg)",
+      "save": "Save",
+      "cancel": "Cancel"
+    },
+    "reps": "reps",
+    "weight": "kg",
+    "asymmetricLabel": "Asymmetric",
+    "alternateLabel": "Alternating",
+    "delete": "Delete exercise",
+    "videoOffline": "Videos are not available offline.",
+    "evenRepsHint": "Repetitions must be even for asymmetric exercises."
+  },
+  "combos": {
+    "title": "Combos",
+    "empty": "No combos yet. Create your first combo to get started!",
+    "searchPlaceholder": "Search combos…",
+    "noResults": "No combos match your search.",
+    "new": "New Combo",
+    "edit": "Edit Combo",
+    "detail": "Combo Details",
+    "deleteConfirm": "Are you sure you want to delete \"{{title}}\"? This cannot be undone.",
+    "deleted": "Combo deleted.",
+    "exercises": "exercises",
+    "timerConfig": "Timer Configuration",
+    "delete": "Delete combo",
+    "form": {
+      "title": "Title",
+      "titlePlaceholder": "e.g. Upper Body Blast",
+      "description": "Description",
+      "descriptionPlaceholder": "Optional description…",
+      "type": "Type",
+      "exercises": "Exercises",
+      "selectExercise": "Select an exercise",
+      "noExercises": "No exercises available — create exercises first",
+      "addExercise": "Add Exercise",
+      "reps": "Reps",
+      "weight": "Weight (kg)",
+      "save": "Save",
+      "cancel": "Cancel"
+    },
+    "types": {
+      "none": "None",
+      "emom": "EMOM",
+      "amrap": "AMRAP",
+      "tabata": "TABATA"
+    },
+    "timer": {
+      "emomDuration": "Duration",
+      "amrapDuration": "Duration",
+      "tabataWorkTime": "Work time (s)",
+      "tabataRestTime": "Rest time (s)",
+      "tabataSeconds": "seconds",
+      "minutes": "minutes",
+      "rounds": "rounds"
+    }
+  },
+  "collections": {
+    "title": "Collections",
+    "empty": "No collections yet. Create your first collection to organize your sessions!",
+    "searchPlaceholder": "Search collections…",
+    "noResults": "No collections match your search.",
+    "new": "New Collection",
+    "edit": "Edit Collection",
+    "detail": "Collection Details",
+    "deleteConfirm": "Are you sure you want to delete \"{{label}}\"? This cannot be undone.",
+    "deleted": "Collection deleted.",
+    "sessions": "sessions",
+    "delete": "Delete collection",
+    "form": {
+      "label": "Label",
+      "labelPlaceholder": "e.g. Weekly Training",
+      "sessions": "Sessions",
+      "selectSession": "Select a session",
+      "noSessions": "No sessions available — create sessions first",
+      "addSession": "Add Session",
+      "save": "Save",
+      "cancel": "Cancel"
+    }
+  },
+  "sessions": {
+    "title": "Sessions",
+    "empty": "No sessions yet.",
+    "searchPlaceholder": "Search sessions…",
+    "noResults": "No sessions match your search.",
+    "new": "New Session",
+    "edit": "Edit Session",
+    "detail": "Session Details",
+    "deleteConfirm": "Are you sure you want to delete \"{{title}}\"? This cannot be undone.",
+    "deleteConfirmWithHistory": "Are you sure you want to delete \"{{title}}\"? This will also delete {{count}} journal log(s). This cannot be undone.",
+    "deleted": "Session deleted.",
+    "items": "items",
+    "delete": "Delete session",
+    "itemType": {
+      "exercise": "Exercise",
+      "combo": "Combo"
+    },
+    "form": {
+      "title": "Title",
+      "titlePlaceholder": "e.g. Upper Body Day",
+      "description": "Description",
+      "descriptionPlaceholder": "Optional description…",
+      "items": "Items",
+      "reps": "Reps",
+      "durationMin": "Duration (min)",
+      "weight": "Weight (kg)",
+      "selectExercise": "Select an exercise",
+      "selectCombo": "Select a combo",
+      "noExercises": "No exercises available — create exercises first",
+      "noCombos": "No combos available — create combos first",
+      "addItem": "Add Item",
+      "save": "Save",
+      "cancel": "Cancel"
+    }
+  },
+  "stats": {
+    "title": "Statistics",
+    "empty": "No data yet. Execute a session to see your statistics.",
+    "usingSince": "You are using TrainUs since {{date}}",
+    "dateRange": {
+      "7d": "7 days",
+      "30d": "30 days",
+      "3m": "3 months",
+      "all": "All time"
+    },
+    "summary": {
+      "sessions": "Sessions",
+      "exercises": "Exercises done",
+      "streak": "Day streak"
+    },
+    "charts": {
+      "frequency": {
+        "title": "Frequency",
+        "week": "Per week",
+        "month": "Per month",
+        "yLabel": "Sessions",
+        "noData": "No sessions in this period."
+      },
+      "volume": {
+        "title": "Volume",
+        "yLabel": "Volume (kg·reps)",
+        "noData": "No volume data in this period."
+      },
+      "progression": {
+        "title": "Progression",
+        "selectExercise": "Select an exercise…",
+        "reps": "Reps",
+        "weight": "Weight (kg)",
+        "noData": "No data for this exercise in this period."
+      }
+    }
+  },
+  "settings": {
+    "title": "Settings",
+    "language": "Language",
+    "userName": "User Name",
+    "userNamePlaceholder": "Enter your name",
+    "nameRequired": "Name cannot be empty",
+    "userId": "User ID",
+    "theme": "Theme",
+    "themeLight": "Light",
+    "themeDark": "Dark",
+    "themeTrainus": "TrainUs",
+    "database": "Database",
+    "downloadDb": "Download Database",
+    "downloadDbHint": "Download or restore the raw SQLite database file.",
+    "restoreDb": "Restore Database",
+    "restoreDbWarning": "This will replace ALL current data with the contents of the selected file. This cannot be undone.\n\nCurrent app version: {{version}}\n\nAre you sure you want to continue?",
+    "restoreInProgress": "Restoring database…",
+    "restoreSuccess": "Database restored successfully",
+    "restoreError": "Database restore failed",
+    "restoreAdapted": "Schema adapted from version {{from}} to {{to}}.",
+    "restoreRows": "row(s)",
+    "restoreDismiss": "OK",
+    "restoreErrorCodes": {
+      "INVALID_FILE": "The selected file is not a valid SQLite database or is corrupted.",
+      "INCOMPLETE_DB": "The selected file is not a valid TrainUs database (missing required tables).",
+      "INCOMPATIBLE_VERSION": "The database version is incompatible and no migration path is available.",
+      "ADAPT_FAILED": "Failed to adapt the database schema to the current version.",
+      "RESTORE_FAILED": "An error occurred while restoring the data.",
+      "UNEXPECTED": "An unexpected error occurred."
+    },
+    "exportImport": "Export / Import",
+    "exportAllData": "Export All Data",
+    "exportData": "Export Data",
+    "importData": "Import Data",
+    "importAsMine": "Import as Mine",
+    "comingSoon": "Coming soon in a future update.",
+    "suffixManagement": "Import Suffixes",
+    "suffixHint": "Manage suffixes used to distinguish imported exercises from other users.",
+    "suffixDeleteConfirm": "Delete suffix \"{{suffix}}\" for {{name}}? This will not remove imported exercises.",
+    "suffixDeleteTitle": "Delete Suffix",
+    "backupReminderInvalid": "Must be between 1 and 365",
+    "initializeDb": "Initialize Database",
+    "initializeDbHint": "Delete all data and reset the database to its initial state. This action cannot be undone.",
+    "initializeDbTitle": "Initialize Database",
+    "initializeDbConfirm": "I understand that this will permanently delete all my data and cannot be reversed",
+    "backup": {
+      "lastBackup": "Last backup: {{when}}",
+      "neverBackedUp": "Never backed up",
+      "reminderEvery": "Remind me every",
+      "reminderEveryUnit": "days"
+    },
+    "sound": "Sound",
+    "soundVolume": "Volume",
+    "soundTest": "Test",
+    "credits": "Credits",
+    "manageJournal": "Manage Exercise Logs",
+    "manageJournalHint": "Delete exercise log entries within a date range.",
+    "cleanJournalBtn": "Clean Journal Data"
+  },
+  "cleanJournal": {
+    "title": "Clean Journal Data",
+    "hint": "Select a date range to permanently delete all exercise log entries within it.",
+    "from": "From",
+    "to": "To",
+    "errorToBeforeFrom": "End date must be on or after the start date.",
+    "matchCount_one": "{{count}} session will be deleted.",
+    "matchCount_other": "{{count}} sessions will be deleted.",
+    "matchCount": "{{count}} session(s) will be deleted.",
+    "confirmLabel": "I understand this will permanently delete the selected exercise log entries and cannot be undone.",
+    "deleteBtn": "Delete"
+  },
+  "credits": {
+    "title": "Credits",
+    "intro": "Open-source icons used in this application:",
+    "appIcon": {
+      "name": "Mighty Force",
+      "description": "App icon, by Delapouite",
+      "author": "Delapouite"
+    },
+    "bootstrapIcons": {
+      "name": "Bootstrap Icons",
+      "description": "UI icons used throughout the application"
+    },
+    "gameIcons": "game-icons.net is maintained by Lorc, Delapouite & contributors",
+    "thirdParties": {
+      "title": "Third-party libraries"
+    },
+    "testingTools": {
+      "title": "Testing Tools"
+    }
+  },
+  "export": {
+    "exercises": "Export all exercises",
+    "exercise": "Export this exercise",
+    "combos": "Export all combos",
+    "combo": "Export this combo",
+    "sessions": "Export all sessions",
+    "session": "Export this session",
+    "collections": "Export all collections",
+    "collection": "Export this collection",
+    "executionLogs": "Execution Logs",
+    "settings": "Settings",
+    "filterTitle": "Export Data",
+    "filterDescription": "Select which data types to export."
+  },
+  "import": {
+    "title": "Import Data",
+    "titleAsMine": "Import as Mine",
+    "exercises": "Import exercises",
+    "importAsMine": "Import as mine",
+    "cancel": "Cancel",
+    "continue": "Continue",
+    "apply": "Import",
+    "done": "Done",
+    "importing": "Importing…",
+    "exerciseCount": "exercise(s)",
+    "totalCount": "item(s)",
+    "executionLogs": "execution log(s)",
+    "from": "From {{name}} on {{date}}",
+    "usingSuffix": "Suffix: [{{suffix}}]",
+    "suffixExplanation": "These items are from {{name}}. Choose a short suffix to distinguish them from your own.",
+    "suffixLabel": "Suffix",
+    "suffixPlaceholder": "e.g. JD",
+    "suffixPreview": "Titles will look like: \"{{title}} [{{suffix}}]\"",
+    "suffixRequired": "Suffix is required.",
+    "suffixTaken": "This suffix is already used by another user.",
+    "collisionExplanation": "{{count}} item(s) conflict with existing data. Choose what to do for each:",
+    "replace": "Replace",
+    "skip": "Skip",
+    "replaceAll": "Replace All",
+    "skipAll": "Skip All",
+    "exportedOn": "Exported on {{date}}",
+    "reportTitle": "Import Complete",
+    "reportTotalImported": "{{count}} item(s) imported",
+    "reportImported": "{{count}} imported",
+    "reportReplaced": "{{count}} replaced",
+    "reportUpdated": "{{count}} updated",
+    "reportSkipped": "{{count}} skipped",
+    "errors": {
+      "invalidJson": "The file does not contain valid JSON.",
+      "invalidFormat": "The file format is not recognized.",
+      "missingMetadata": "The file is missing metadata.",
+      "wrongApp": "This file was not exported from TrainUs.",
+      "missingSchema": "The file is missing schema version information.",
+      "newerSchema": "This file was exported from a newer version of TrainUs. Please update the application.",
+      "missingData": "The file does not contain any data.",
+      "missingExporter": "The file is missing exporter information."
+    }
+  },
+  "validation": {
+    "required": "This field is required.",
+    "minValue": "Value must be ≥ {{min}}.",
+    "invalidUrl": "Please enter a valid URL (https://…).",
+    "titleTaken": "An exercise with this title already exists.",
+    "comboTitleTaken": "A combo with this title already exists.",
+    "collectionLabelTaken": "A collection with this label already exists."
+  },
+  "shortcuts": {
+    "edit": "— press E",
+    "new": "— press N",
+    "back": "— press Esc",
+    "save": "— Ctrl+Enter"
+  },
+  "execution": {
+    "start": "Start session",
+    "exit": "Exit session",
+    "steps": "steps",
+    "now": "NOW",
+    "next": "NEXT",
+    "round": "Round",
+    "reps": "Reps",
+    "weight": "Weight",
+    "side": "Side",
+    "sideLeft": "LEFT",
+    "sideRight": "RIGHT",
+    "asymAlternate": "(1x{{left}} ↔ 1x{{right}}) × {{count}}",
+    "asymSequential": "{{count}}x {{left}} → {{count}}x {{right}}",
+    "done": "Done",
+    "continue": "Continue",
+    "oneMoreRound": "One More Round",
+    "comboContext": "Combo: {{title}} — Round {{round}} of {{total}}",
+    "comboComplete": "{{title}} — {{rounds}} round(s) complete",
+    "complete": "Session complete!",
+    "backToSession": "Back to session",
+    "timer": {
+      "pause": "Pause",
+      "resume": "Resume",
+      "rest": "REST",
+      "nextExercise": "Next:",
+      "timeUp": "Time's up",
+      "timeUpTitle": "⏱ Time's up — {{title}}"
+    },
+    "showDetails": "Show exercise details",
+    "hideDetails": "Hide exercise details",
+    "videoOffline": "Videos are not available offline.",
+    "leaveConfirm": "You are in the middle of a session. Leave anyway? The session will be marked as aborted."
+  },
+  "backup": {
+    "reminder": {
+      "tooltip": "Last backup {{days}} day(s) ago — click to back up",
+      "tooltipNever": "No backup yet — click to create one"
+    },
+    "modal": {
+      "title": "Backup reminder",
+      "body": "Your last backup was {{days}} day(s) ago. We recommend backing up your data regularly.",
+      "bodyNever": "You have never backed up your data. We recommend creating a backup.",
+      "dismiss": "Dismiss",
+      "goToSettings": "Go to Settings"
+    }
+  },
+  "install": {
+    "button": "Install app",
+    "dismiss": "Dismiss install prompt"
+  },
+  "modal": {
+    "close": "Close dialog"
+  },
+  "saveFile": {
+    "title": "Save file",
+    "label": "File name",
+    "cancel": "Cancel",
+    "save": "Save"
+  },
+  "about": {
+    "title": "About TrainUs",
+    "appVersion": "Application Version",
+    "dbVersion": "Database Version",
+    "author": "Created by",
+    "links": "Links",
+    "repository": "Repository",
+    "website": "Website",
+    "license": "License",
+    "licenseBtn": "View License"
+  },
+  "license": {
+    "title": "License"
+  }
+}
diff --git a/src/i18n/locales/fr.json b/src/i18n/locales/fr.json
new file mode 100644
index 0000000..7252c89
--- /dev/null
+++ b/src/i18n/locales/fr.json
@@ -0,0 +1,460 @@
+{
+  "app": {
+    "name": "TrainUs",
+    "loading": "Chargement…"
+  },
+  "common": {
+    "markdownHint": "Markdown basique supporté",
+    "back": "Retour",
+    "clearSearch": "Effacer la recherche"
+  },
+  "error": {
+    "dbInitFailed": "Impossible d'initialiser la base de données",
+    "browserNotCompatible": "Votre navigateur ne prend pas en charge les fonctionnalités de stockage requises. Veuillez vous assurer d'utiliser une version récente de votre navigateur et de ne pas être en navigation privée.",
+    "dbNewerThanApp": "Vos données ont été créées par une version plus récente de l'application. Vos données n'ont pas été modifiées. Veuillez recharger la page pour obtenir la dernière version de l'application.",
+    "dbMigrationFailed": "La mise à jour de la base de données a échoué et vos données n'ont pas été modifiées. Rechargez la page pour réessayer, ou restaurez la sauvegarde que vous venez de télécharger si le problème persiste.",
+    "dbConnectionLost": "La connexion à la base de données a été perdue suite à une erreur inattendue. Rechargez la page pour vous reconnecter.",
+    "reload": "Recharger"
+  },
+  "migration": {
+    "title": "Mise à jour de la base de données requise",
+    "body": "L'application a été mise à jour et votre base de données doit être migrée de la version {{from}} vers la version {{to}}.",
+    "backupRequired": "Avant de mettre à jour, veuillez télécharger une sauvegarde de vos données. La mise à jour ne pourra démarrer qu'une fois la sauvegarde enregistrée.",
+    "downloadBackup": "Télécharger la sauvegarde",
+    "update": "Mettre à jour",
+    "updating": "Mise à jour…"
+  },
+  "nav": {
+    "mainNav": "Navigation principale",
+    "home": "Accueil",
+    "exercises": "Exercices",
+    "combos": "Combos",
+    "sessions": "Séances",
+    "collections": "Collections",
+    "stats": "Statistiques",
+    "settings": "Réglages"
+  },
+  "home": {
+    "title": "Accueil",
+    "empty": "Aucune séance exécutée pour le moment. Lancez une séance pour voir votre activité ici !",
+    "recentSessions": "Séances récentes",
+    "sessionsLast7Days": "Séances (7 derniers jours)",
+    "sessionsLast30Days": "Séances (30 derniers jours)",
+    "history": "Historique",
+    "exportHtml": "Exporter en HTML",
+    "exportedOn": "Exporté le {{date}}"
+  },
+  "exercises": {
+    "title": "Exercices",
+    "empty": "Aucun exercice pour le moment. Créez votre premier exercice pour commencer !",
+    "searchPlaceholder": "Rechercher des exercices…",
+    "noResults": "Aucun exercice ne correspond à votre recherche.",
+    "new": "Nouvel exercice",
+    "edit": "Modifier l'exercice",
+    "detail": "Détails de l'exercice",
+    "deleteConfirm": "Êtes-vous sûr de vouloir supprimer « {{title}} » ? Cette action est irréversible.",
+    "deleteConfirmWithHistory": "Êtes-vous sûr de vouloir supprimer « {{title}} » ? Cela supprimera également {{count}} entrée(s) du journal. Cette action est irréversible.",
+    "deleted": "Exercice supprimé.",
+    "form": {
+      "title": "Titre",
+      "titlePlaceholder": "ex. Pompes",
+      "description": "Description",
+      "descriptionPlaceholder": "Description facultative…",
+      "asymmetric": "Exercice asymétrique",
+      "alternate": "Alterner les côtés à chaque répétition",
+      "alternateFalse": "Compléter toutes les répétitions d'un côté, puis changer",
+      "imageUrls": "URLs des images",
+      "videoUrls": "URLs des vidéos",
+      "urlPlaceholder": "https://…",
+      "addUrl": "Ajouter une URL",
+      "removeUrl": "Supprimer",
+      "defaultReps": "Répétitions par défaut",
+      "defaultWeight": "Poids par défaut (kg)",
+      "save": "Enregistrer",
+      "cancel": "Annuler"
+    },
+    "reps": "reps",
+    "weight": "kg",
+    "asymmetricLabel": "Asymétrique",
+    "alternateLabel": "Alternance",
+    "delete": "Supprimer l'exercice",
+    "videoOffline": "Les vidéos ne sont pas disponibles hors ligne.",
+    "evenRepsHint": "Le nombre de répétitions doit être pair pour les exercices asymétriques."
+  },
+  "combos": {
+    "title": "Combos",
+    "empty": "Aucun combo pour le moment. Créez votre premier combo pour commencer !",
+    "searchPlaceholder": "Rechercher des combos…",
+    "noResults": "Aucun combo ne correspond à votre recherche.",
+    "new": "Nouveau Combo",
+    "edit": "Modifier le Combo",
+    "detail": "Détails du Combo",
+    "deleteConfirm": "Êtes-vous sûr de vouloir supprimer « {{title}} » ? Cette action est irréversible.",
+    "deleted": "Combo supprimé.",
+    "exercises": "exercices",
+    "timerConfig": "Configuration du minuteur",
+    "delete": "Supprimer le combo",
+    "form": {
+      "title": "Titre",
+      "titlePlaceholder": "ex. Upper Body Blast",
+      "description": "Description",
+      "descriptionPlaceholder": "Description facultative…",
+      "type": "Type",
+      "exercises": "Exercices",
+      "selectExercise": "Sélectionner un exercice",
+      "noExercises": "Aucun exercice disponible — créez d'abord des exercices",
+      "addExercise": "Ajouter Exercice",
+      "reps": "Reps",
+      "weight": "Poids (kg)",
+      "save": "Enregistrer",
+      "cancel": "Annuler"
+    },
+    "types": {
+      "none": "Aucun",
+      "emom": "EMOM",
+      "amrap": "AMRAP",
+      "tabata": "TABATA"
+    },
+    "timer": {
+      "emomDuration": "Durée",
+      "amrapDuration": "Durée",
+      "tabataWorkTime": "Temps de travail (s)",
+      "tabataRestTime": "Temps de repos (s)",
+      "tabataSeconds": "secondes",
+      "minutes": "minutes",
+      "rounds": "tours"
+    }
+  },
+  "collections": {
+    "title": "Collections",
+    "empty": "Aucune collection pour le moment. Créez votre première collection pour organiser vos séances !",
+    "searchPlaceholder": "Rechercher des collections…",
+    "noResults": "Aucune collection ne correspond à votre recherche.",
+    "new": "Nouvelle Collection",
+    "edit": "Modifier la Collection",
+    "detail": "Détails de la Collection",
+    "deleteConfirm": "Êtes-vous sûr de vouloir supprimer « {{label}} » ? Cette action est irréversible.",
+    "deleted": "Collection supprimée.",
+    "sessions": "séances",
+    "delete": "Supprimer la collection",
+    "form": {
+      "label": "Libellé",
+      "labelPlaceholder": "ex. Entraînement Hebdomadaire",
+      "sessions": "Séances",
+      "selectSession": "Sélectionner une séance",
+      "noSessions": "Aucune séance disponible — créez d'abord des séances",
+      "addSession": "Ajouter Séance",
+      "save": "Enregistrer",
+      "cancel": "Annuler"
+    }
+  },
+  "sessions": {
+    "title": "Séances",
+    "empty": "Aucune séance pour le moment.",
+    "searchPlaceholder": "Rechercher des séances…",
+    "noResults": "Aucune séance ne correspond à votre recherche.",
+    "new": "Nouvelle séance",
+    "edit": "Modifier la séance",
+    "detail": "Détails de la séance",
+    "deleteConfirm": "Êtes-vous sûr de vouloir supprimer « {{title}} » ? Cette action est irréversible.",
+    "deleteConfirmWithHistory": "Êtes-vous sûr de vouloir supprimer « {{title}} » ? Cela supprimera également {{count}} journal(aux) d'exécution. Cette action est irréversible.",
+    "deleted": "Séance supprimée.",
+    "items": "éléments",
+    "delete": "Supprimer la séance",
+    "itemType": {
+      "exercise": "Exercice",
+      "combo": "Combo"
+    },
+    "form": {
+      "title": "Titre",
+      "titlePlaceholder": "ex. Upper Body Day",
+      "description": "Description",
+      "descriptionPlaceholder": "Description facultative…",
+      "items": "Éléments",
+      "reps": "Reps",
+      "durationMin": "Durée (min)",
+      "weight": "Poids (kg)",
+      "selectExercise": "Sélectionner un exercice",
+      "selectCombo": "Sélectionner un combo",
+      "noExercises": "Aucun exercice disponible — créez d'abord des exercices",
+      "noCombos": "Aucun combo disponible — créez d'abord des combos",
+      "addItem": "Ajouter élément",
+      "save": "Enregistrer",
+      "cancel": "Annuler"
+    }
+  },
+  "stats": {
+    "title": "Statistiques",
+    "empty": "Pas encore de données. Exécutez une séance pour voir vos statistiques.",
+    "usingSince": "Vous utilisez TrainUs depuis le {{date}}",
+    "dateRange": {
+      "7d": "7 jours",
+      "30d": "30 jours",
+      "3m": "3 mois",
+      "all": "Tout"
+    },
+    "summary": {
+      "sessions": "Séances",
+      "exercises": "Exercices faits",
+      "streak": "Jours consécutifs"
+    },
+    "charts": {
+      "frequency": {
+        "title": "Fréquence",
+        "week": "Par semaine",
+        "month": "Par mois",
+        "yLabel": "Séances",
+        "noData": "Aucune séance dans cette période."
+      },
+      "volume": {
+        "title": "Volume",
+        "yLabel": "Volume (kg·rép.)",
+        "noData": "Aucune donnée de volume dans cette période."
+      },
+      "progression": {
+        "title": "Progression",
+        "selectExercise": "Sélectionner un exercice…",
+        "reps": "Rép.",
+        "weight": "Poids (kg)",
+        "noData": "Aucune donnée pour cet exercice dans cette période."
+      }
+    }
+  },
+  "settings": {
+    "title": "Réglages",
+    "language": "Langue",
+    "userName": "Nom d'utilisateur",
+    "userNamePlaceholder": "Entrez votre nom",
+    "nameRequired": "Le nom ne peut pas être vide",
+    "userId": "Identifiant",
+    "theme": "Thème",
+    "themeLight": "Clair",
+    "themeDark": "Sombre",
+    "themeTrainus": "TrainUs",
+    "database": "Base de données",
+    "downloadDb": "Télécharger la base de données",
+    "downloadDbHint": "Télécharger ou restaurer le fichier SQLite brut.",
+    "restoreDb": "Restaurer la base de données",
+    "restoreDbWarning": "Ceci va remplacer TOUTES les données actuelles par le contenu du fichier sélectionné. Cette action est irréversible.\n\nVersion actuelle de l'application : {{version}}\n\nÊtes-vous sûr de vouloir continuer ?",
+    "restoreInProgress": "Restauration en cours…",
+    "restoreSuccess": "Base de données restaurée avec succès",
+    "restoreError": "Échec de la restauration",
+    "restoreAdapted": "Schéma adapté de la version {{from}} à la version {{to}}.",
+    "restoreRows": "ligne(s)",
+    "restoreDismiss": "OK",
+    "restoreErrorCodes": {
+      "INVALID_FILE": "Le fichier sélectionné n'est pas une base de données SQLite valide ou est corrompu.",
+      "INCOMPLETE_DB": "Le fichier sélectionné n'est pas une base de données TrainUs valide (tables requises manquantes).",
+      "INCOMPATIBLE_VERSION": "La version de la base de données est incompatible et aucun chemin de migration n'est disponible.",
+      "ADAPT_FAILED": "Échec de l'adaptation du schéma de la base de données.",
+      "RESTORE_FAILED": "Une erreur est survenue lors de la restauration des données.",
+      "UNEXPECTED": "Une erreur inattendue est survenue."
+    },
+    "exportImport": "Exporter / Importer",
+    "exportAllData": "Exporter toutes les données",
+    "exportData": "Exporter les données",
+    "importData": "Importer les données",
+    "importAsMine": "Importer comme les miens",
+    "comingSoon": "Disponible dans une prochaine mise à jour.",
+    "suffixManagement": "Suffixes d'importation",
+    "suffixHint": "Gérez les suffixes utilisés pour distinguer les exercices importés d'autres utilisateurs.",
+    "suffixDeleteConfirm": "Supprimer le suffixe « {{suffix}} » pour {{name}} ? Les exercices importés ne seront pas supprimés.",
+    "suffixDeleteTitle": "Supprimer le suffixe",
+    "backupReminderInvalid": "Doit être entre 1 et 365",
+    "initializeDb": "Initialiser la base de données",
+    "initializeDbHint": "Supprimer toutes les données et réinitialiser la base de données à son état initial. Cette action est irréversible.",
+    "initializeDbTitle": "Initialiser la base de données",
+    "initializeDbConfirm": "Je comprends que cela supprimera définitivement toutes mes données et ne peut pas être annulé",
+    "backup": {
+      "lastBackup": "Dernière sauvegarde : {{when}}",
+      "neverBackedUp": "Jamais sauvegardé",
+      "reminderEvery": "Me rappeler tous les",
+      "reminderEveryUnit": "jours"
+    },
+    "sound": "Son",
+    "soundVolume": "Volume",
+    "soundTest": "Tester",
+    "credits": "Crédits",
+    "manageJournal": "Gérer les journaux d'exercices",
+    "manageJournalHint": "Supprimez les entrées du journal d'exercices sur une plage de dates.",
+    "cleanJournalBtn": "Nettoyer le journal"
+  },
+  "cleanJournal": {
+    "title": "Nettoyer le journal",
+    "hint": "Sélectionnez une plage de dates pour supprimer définitivement toutes les entrées du journal d'exercices.",
+    "from": "Du",
+    "to": "Au",
+    "errorToBeforeFrom": "La date de fin doit être égale ou postérieure à la date de début.",
+    "matchCount_one": "{{count}} séance sera supprimée.",
+    "matchCount_other": "{{count}} séances seront supprimées.",
+    "matchCount": "{{count}} séance(s) seront supprimée(s).",
+    "confirmLabel": "Je comprends que cette action supprimera définitivement les entrées du journal sélectionnées et ne peut pas être annulée.",
+    "deleteBtn": "Supprimer"
+  },
+  "credits": {
+    "title": "Crédits",
+    "intro": "Icônes open source utilisées dans cette application:",
+    "appIcon": {
+      "name": "Mighty Force",
+      "description": "Icône de l'application, par Delapouite",
+      "author": "Delapouite"
+    },
+    "bootstrapIcons": {
+      "name": "Bootstrap Icons",
+      "description": "Icônes d'interface utilisées dans toute l'application"
+    },
+    "gameIcons": "game-icons.net est maintenu par Lorc, Delapouite & contributeurs",
+    "thirdParties": {
+      "title": "Bibliothèques tierces"
+    },
+    "testingTools": {
+      "title": "Outils de test"
+    }
+  },
+  "export": {
+    "exercises": "Exporter tous les exercices",
+    "exercise": "Exporter cet exercice",
+    "combos": "Exporter tous les combos",
+    "combo": "Exporter ce combo",
+    "sessions": "Exporter toutes les séances",
+    "session": "Exporter cette séance",
+    "collections": "Exporter toutes les collections",
+    "collection": "Exporter cette collection",
+    "executionLogs": "Journaux d'exécution",
+    "settings": "Paramètres",
+    "filterTitle": "Exporter les données",
+    "filterDescription": "Sélectionnez les types de données à exporter."
+  },
+  "import": {
+    "title": "Importer des données",
+    "titleAsMine": "Importer comme les miens",
+    "exercises": "Importer des exercices",
+    "importAsMine": "Importer comme les miens",
+    "cancel": "Annuler",
+    "continue": "Continuer",
+    "apply": "Importer",
+    "done": "Terminé",
+    "importing": "Importation en cours…",
+    "exerciseCount": "exercice(s)",
+    "totalCount": "élément(s)",
+    "executionLogs": "journal(aux) d'exécution",
+    "from": "De {{name}} le {{date}}",
+    "usingSuffix": "Suffixe : [{{suffix}}]",
+    "suffixExplanation": "Ces éléments proviennent de {{name}}. Choisissez un court suffixe pour les distinguer des vôtres.",
+    "suffixLabel": "Suffixe",
+    "suffixPlaceholder": "ex. JD",
+    "suffixPreview": "Les titres ressembleront à : « {{title}} [{{suffix}}] »",
+    "suffixRequired": "Le suffixe est requis.",
+    "suffixTaken": "Ce suffixe est déjà utilisé par un autre utilisateur.",
+    "collisionExplanation": "{{count}} élément(s) sont en conflit avec des données existantes. Choisissez quoi faire pour chacun :",
+    "replace": "Remplacer",
+    "skip": "Ignorer",
+    "replaceAll": "Tout remplacer",
+    "skipAll": "Tout ignorer",
+    "exportedOn": "Exporté le {{date}}",
+    "reportTitle": "Importation terminée",
+    "reportTotalImported": "{{count}} élément(s) importé(s)",
+    "reportImported": "{{count}} importé(s)",
+    "reportReplaced": "{{count}} remplacé(s)",
+    "reportUpdated": "{{count}} mis à jour",
+    "reportSkipped": "{{count}} ignoré(s)",
+    "errors": {
+      "invalidJson": "Le fichier ne contient pas de JSON valide.",
+      "invalidFormat": "Le format du fichier n'est pas reconnu.",
+      "missingMetadata": "Le fichier ne contient pas de métadonnées.",
+      "wrongApp": "Ce fichier n'a pas été exporté depuis TrainUs.",
+      "missingSchema": "Le fichier ne contient pas d'information de version du schéma.",
+      "newerSchema": "Ce fichier a été exporté depuis une version plus récente de TrainUs. Veuillez mettre à jour l'application.",
+      "missingData": "Le fichier ne contient aucune donnée.",
+      "missingExporter": "Le fichier ne contient pas d'informations sur l'exportateur."
+    }
+  },
+  "validation": {
+    "required": "Ce champ est requis.",
+    "minValue": "La valeur doit être ≥ {{min}}.",
+    "invalidUrl": "Veuillez entrer une URL valide (https://…).",
+    "titleTaken": "Un exercice avec ce titre existe déjà.",
+    "comboTitleTaken": "Un combo avec ce titre existe déjà.",
+    "collectionLabelTaken": "Une collection avec ce libellé existe déjà."
+  },
+  "shortcuts": {
+    "edit": "— appuyez sur E",
+    "new": "— appuyez sur N",
+    "back": "— appuyez sur Échap",
+    "save": "— Ctrl+Entrée"
+  },
+  "execution": {
+    "start": "Démarrer la séance",
+    "exit": "Quitter la séance",
+    "steps": "étapes",
+    "now": "MAINTENANT",
+    "next": "SUIVANT",
+    "round": "Tour",
+    "reps": "Reps",
+    "weight": "Poids",
+    "side": "Côté",
+    "sideLeft": "GAUCHE",
+    "sideRight": "DROIT",
+    "asymAlternate": "(1x{{left}} ↔ 1x{{right}}) × {{count}}",
+    "asymSequential": "{{count}}x {{left}} → {{count}}x {{right}}",
+    "done": "Terminé",
+    "continue": "Continuer",
+    "oneMoreRound": "Un tour de plus",
+    "comboContext": "Combo : {{title}} — Tour {{round}} sur {{total}}",
+    "comboComplete": "{{title}} — {{rounds}} tour(s) terminé(s)",
+    "complete": "Séance terminée !",
+    "backToSession": "Retour à la séance",
+    "timer": {
+      "pause": "Pause",
+      "resume": "Reprendre",
+      "rest": "REPOS",
+      "nextExercise": "Suivant :",
+      "timeUp": "Temps écoulé",
+      "timeUpTitle": "⏱ Temps écoulé — {{title}}"
+    },
+    "showDetails": "Afficher les détails de l'exercice",
+    "hideDetails": "Masquer les détails de l'exercice",
+    "videoOffline": "Les vidéos ne sont pas disponibles hors ligne.",
+    "leaveConfirm": "Vous êtes en pleine séance. Partir quand même ? La séance sera marquée comme interrompue."
+  },
+  "backup": {
+    "reminder": {
+      "tooltip": "Dernière sauvegarde il y a {{days}} jour(s) — cliquez pour sauvegarder",
+      "tooltipNever": "Pas encore de sauvegarde — cliquez pour en créer une"
+    },
+    "modal": {
+      "title": "Rappel de sauvegarde",
+      "body": "Votre dernière sauvegarde remonte à {{days}} jour(s). Nous vous recommandons de sauvegarder régulièrement.",
+      "bodyNever": "Vous n'avez jamais effectué de sauvegarde. Nous vous recommandons d'en créer une.",
+      "dismiss": "Ignorer",
+      "goToSettings": "Aller aux paramètres"
+    }
+  },
+  "install": {
+    "button": "Installer l'application",
+    "dismiss": "Ignorer l'invitation à installer"
+  },
+  "modal": {
+    "close": "Fermer la boîte de dialogue"
+  },
+  "saveFile": {
+    "title": "Enregistrer le fichier",
+    "label": "Nom du fichier",
+    "cancel": "Annuler",
+    "save": "Enregistrer"
+  },
+  "about": {
+    "title": "À propos de TrainUs",
+    "appVersion": "Version de l'application",
+    "dbVersion": "Version de la base de données",
+    "author": "Créé par",
+    "links": "Liens",
+    "repository": "Dépôt",
+    "website": "Site web",
+    "license": "Licence",
+    "licenseBtn": "Voir la licence"
+  },
+  "license": {
+    "title": "Licence"
+  }
+}
diff --git a/src/main.js b/src/main.js
new file mode 100644
index 0000000..49d6ccf
--- /dev/null
+++ b/src/main.js
@@ -0,0 +1,65 @@
+import { createApp } from 'vue'
+import { i18next, I18NextVue } from './i18n'
+import router from './router'
+import { db } from './db/database.js'
+import { settingsRepository } from './db/repositories/settingsRepository.js'
+import { exerciseRepository } from './db/repositories/exerciseRepository.js'
+import { comboRepository } from './db/repositories/comboRepository.js'
+import { sessionRepository } from './db/repositories/sessionRepository.js'
+import { collectionRepository } from './db/repositories/collectionRepository.js'
+import { executionLogRepository } from './db/repositories/executionLogRepository.js'
+import { suffixRepository } from './db/repositories/suffixRepository.js'
+import 'bootstrap-icons/font/bootstrap-icons.css'
+import './styles/variables.css'
+import './styles/layout.css'
+import App from './App.vue'
+
+const app = createApp(App)
+app.use(I18NextVue, { i18next })
+app.use(router)
+
+// Initialize database (before mount so App.vue can subscribe to the promise)
+const dbReady = db
+  .init()
+  .then(async (info) => {
+    console.log('Database initialized:', info)
+
+    // Apply persisted settings before first render
+    const lang = await settingsRepository.get('language')
+    if (lang) {
+      i18next.changeLanguage(lang)
+    }
+    const theme = await settingsRepository.get('theme')
+    if (theme) {
+      document.documentElement.setAttribute('data-theme', theme)
+    }
+
+    if (db.migrationPending) {
+      // App stays paused: App.vue shows the blocking migration screen
+      document.documentElement.setAttribute('data-db-migration', 'pending')
+      return { migrationPending: db.migrationPending }
+    }
+
+    document.documentElement.setAttribute('data-db-ready', 'true')
+    return {}
+  })
+  .catch((err) => {
+    console.error('Database initialization failed:', err)
+    document.documentElement.setAttribute('data-db-error', err.message)
+    throw err
+  })
+
+// Expose for testing
+window.__db = db
+window.__dbReady = dbReady
+window.__repos = {
+  settings: settingsRepository,
+  exercises: exerciseRepository,
+  combos: comboRepository,
+  sessions: sessionRepository,
+  collections: collectionRepository,
+  executionLogs: executionLogRepository,
+  suffixes: suffixRepository,
+}
+
+app.mount('#app')
diff --git a/src/router/index.js b/src/router/index.js
new file mode 100644
index 0000000..6763bd3
--- /dev/null
+++ b/src/router/index.js
@@ -0,0 +1,119 @@
+import { createRouter, createWebHashHistory } from 'vue-router'
+
+const routes = [
+  {
+    path: '/',
+    redirect: '/home',
+  },
+  {
+    path: '/home',
+    name: 'home',
+    component: () => import('../views/HomeView.vue'),
+  },
+  {
+    path: '/exercises',
+    name: 'exercises',
+    component: () => import('../views/ExerciseListView.vue'),
+  },
+  {
+    path: '/exercises/new',
+    name: 'exercise-new',
+    component: () => import('../views/ExerciseFormView.vue'),
+  },
+  {
+    path: '/exercises/:id',
+    name: 'exercise-detail',
+    component: () => import('../views/ExerciseDetailView.vue'),
+  },
+  {
+    path: '/exercises/:id/edit',
+    name: 'exercise-edit',
+    component: () => import('../views/ExerciseFormView.vue'),
+  },
+  {
+    path: '/combos',
+    name: 'combos',
+    component: () => import('../views/ComboListView.vue'),
+  },
+  {
+    path: '/combos/new',
+    name: 'combo-new',
+    component: () => import('../views/ComboFormView.vue'),
+  },
+  {
+    path: '/combos/:id',
+    name: 'combo-detail',
+    component: () => import('../views/ComboDetailView.vue'),
+  },
+  {
+    path: '/combos/:id/edit',
+    name: 'combo-edit',
+    component: () => import('../views/ComboFormView.vue'),
+  },
+  {
+    path: '/sessions',
+    name: 'sessions',
+    component: () => import('../views/SessionListView.vue'),
+  },
+  {
+    path: '/sessions/new',
+    name: 'session-new',
+    component: () => import('../views/SessionFormView.vue'),
+  },
+  {
+    path: '/sessions/:id',
+    name: 'session-detail',
+    component: () => import('../views/SessionDetailView.vue'),
+  },
+  {
+    path: '/sessions/:id/edit',
+    name: 'session-edit',
+    component: () => import('../views/SessionFormView.vue'),
+  },
+  {
+    path: '/sessions/:id/execute',
+    name: 'session-execute',
+    component: () => import('../views/SessionExecuteView.vue'),
+  },
+  {
+    path: '/collections',
+    name: 'collections',
+    component: () => import('../views/CollectionsView.vue'),
+  },
+  {
+    path: '/collections/new',
+    name: 'collection-new',
+    component: () => import('../views/CollectionFormView.vue'),
+  },
+  {
+    path: '/collections/:id',
+    name: 'collection-detail',
+    component: () => import('../views/CollectionDetailView.vue'),
+  },
+  {
+    path: '/collections/:id/edit',
+    name: 'collection-edit',
+    component: () => import('../views/CollectionFormView.vue'),
+  },
+  {
+    path: '/stats',
+    name: 'stats',
+    component: () => import('../views/StatsView.vue'),
+  },
+  {
+    path: '/settings',
+    name: 'settings',
+    component: () => import('../views/SettingsView.vue'),
+  },
+  {
+    path: '/:pathMatch(.*)*',
+    redirect: '/home',
+  },
+]
+
+const router = createRouter({
+  history: createWebHashHistory(),
+  routes,
+})
+
+export default router
diff --git a/src/styles/layout.css b/src/styles/layout.css
new file mode 100644
index 0000000..b661850
--- /dev/null
+++ b/src/styles/layout.css
@@ -0,0 +1,276 @@
+/* Reset & base */
+*,
+*::before,
+*::after {
+  box-sizing: border-box;
+}
+
+html,
+body {
+  height: 100%;
+  overflow: hidden;
+}
+
+body {
+  margin: 0;
+  padding: 0;
+  font: var(--font-stack);
+  color: var(--front-color1);
+  background-color: var(--bg-color1);
+}
+
+h1 {
+  margin: 0;
+  padding: 0;
+  font-size: var(--h1-size);
+}
+
+h2,
+h3 {
+  margin: 0;
+  padding: 0;
+}
+
+a {
+  color: var(--btn-primary-bg);
+  text-decoration: none;
+}
+
+a:hover {
+  text-decoration: underline;
+}
+
+/* App layout */
+#app {
+  height: 100vh;
+  height: 100dvh;
+  display: flex;
+  overflow: hidden;
+}
+
+/* CONTENT */
+.content {
+  flex: 1;
+  min-width: 0;
+  display: flex;
+  flex-direction: column;
+  height: 100%;
+  overflow: hidden;
+}
+
+.content-body {
+  flex: 1;
+  overflow-y: auto;
+  padding: 16px;
+}
+
+/* ACTIONBAR */
+.actionbar {
+  display: flex;
+  background-color: var(--actionbar-bg-color);
+  color: var(--actionbar-font-color);
+  padding: 0 8px;
+  align-items: center;
+  height: var(--actionbar-height);
+  flex-shrink: 0;
+  z-index: 10;
+}
+
+.actionbar h1 {
+  flex: 1;
+  min-width: 0;
+  font-size: 20px;
+  padding-left: 8px;
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+}
+
+#actionbar-actions {
+  display: flex;
+  align-items: center;
+  flex-shrink: 0;
+  gap: 4px;
+}
+
+.actionbar button {
+  width: 40px;
+  min-width: 40px;
+  height: 36px;
+  padding: 0;
+  margin: 0;
+  background-color: rgba(255, 255, 255, 0.12);
+  border: 1px solid rgba(255, 255, 255, 0.3);
+  color: var(--actionbar-font-color);
+  cursor: pointer;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  border-radius: 4px;
+}
+
+.actionbar button:hover {
+  background-color: rgba(255, 255, 255, 0.28);
+  border-color: rgba(255, 255, 255, 0.5);
+}
+
+/* NAVBAR */
+.navbar {
+  margin: 0;
+  padding: 0;
+  width: var(--navbar-width);
+  flex-shrink: 0;
+  background-color: var(--navbar-bg-color);
+  overflow-y: auto;
+  z-index: 20;
+  display: flex;
+  flex-direction: column;
+}
+
+.navbar-brand {
+  text-align: center;
+  padding: 12px 8px;
+  font-size: var(--h1-size);
+  font-weight: bold;
+  color: var(--navbar-front-color);
+}
+
+.navbar a {
+  display: flex;
+  color: var(--navbar-front-color);
+  padding: 10px 12px;
+  text-decoration: none;
+  align-items: center;
+  gap: 8px;
+  font-size: 15px;
+}
+
+.navbar a i {
+  font-size: 20px;
+  width: 24px;
+  text-align: center;
+}
+
+.navbar a.router-link-active {
+  background-color: var(--bg-color1);
+  color: var(--front-color1);
+}
+
+.navbar a:hover:not(.router-link-active) {
+  background-color: var(--navbar-hover-bg-color);
+  color: var(--navbar-hover-front-color);
+}
+
+.navbar a:focus-visible {
+  outline: 2px solid var(--btn-primary-bg);
+  outline-offset: -2px;
+  background-color: var(--navbar-hover-bg-color);
+  color: var(--navbar-hover-front-color);
+}
+
+.navbar-spacer {
+  flex: 1;
+}
+
+/* RESPONSIVE — Tablet / Mobile */
+@media screen and (max-width: 700px) {
+  #app {
+    flex-direction: column;
+  }
+
+  .navbar {
+    order: 2;
+    width: 100%;
+    height: auto;
+    flex-direction: row;
+    justify-content: space-around;
+    padding: 4px 0;
+  }
+
+  .navbar-brand {
+    display: none;
+  }
+
+  .navbar-spacer {
+    display: none;
+  }
+
+  .navbar a {
+    flex-direction: column;
+    padding: 6px 8px;
+    font-size: 11px;
+    gap: 2px;
+  }
+
+  .navbar a i {
+    font-size: 22px;
+  }
+
+  .content {
+    order: 1;
+  }
+}
+
+@media screen and (max-width: 600px) {
+  .navbar a span {
+    display: none;
+  }
+}
+
+/* Utility classes */
+.text-muted {
+  color: var(--front-color2);
+}
+
+.btn {
+  display: inline-flex;
+  align-items: center;
+  gap: 6px;
+  padding: 8px 16px;
+  border: none;
+  border-radius: 6px;
+  cursor: pointer;
+  font-size: 14px;
+  transition: opacity 0.15s;
+}
+
+.btn:hover {
+  opacity: 0.85;
+}
+
+.btn-primary {
+  background-color: var(--btn-primary-bg);
+  color: var(--btn-primary-color);
+}
+
+.btn-danger {
+  background-color: var(--btn-danger-bg);
+  color: var(--btn-danger-color);
+}
+
+.card {
+  background-color: var(--bg-color2);
+  border: 1px solid var(--border-color);
+  border-radius: 8px;
+  padding: 16px;
+  margin-bottom: 12px;
+}
+
+input,
+select,
+textarea {
+  background-color: var(--input-bg);
+  color: var(--front-color1);
+  border: 1px solid var(--input-border);
+  border-radius: 6px;
+  padding: 8px 12px;
+  font-size: 14px;
+  width: 100%;
+}
+
+input:focus,
+select:focus,
+textarea:focus {
+  outline: 2px solid var(--btn-primary-bg);
+  outline-offset: -1px;
+}
diff --git a/src/styles/variables.css b/src/styles/variables.css
new file mode 100644
index 0000000..5aa7f26
--- /dev/null
+++ b/src/styles/variables.css
@@ -0,0 +1,76 @@
+:root {
+  /* FONTS */
+  --font-stack: 100%, Helvetica, sans-serif;
+  --h1-size: 32px;
+
+  /* COLORS — Light theme (default) */
+  --bg-color1: #ffffff;
+  --bg-color2: #f5f5f5;
+  --front-color1: #1a1a1a;
+  --front-color2: #555555;
+  --navbar-bg-color: #e0e0e0;
+  --navbar-front-color: #1a1a1a;
+  --navbar-hover-bg-color: #b0b0b0;
+  --navbar-hover-front-color: #ffffff;
+  --actionbar-bg-color: #1a1a1a;
+  --actionbar-font-color: #ffffff;
+  --border-color: #ddd;
+  --input-bg: #ffffff;
+  --input-border: #ccc;
+  --btn-primary-bg: #2563eb;
+  --btn-primary-color: #ffffff;
+  --btn-danger-bg: #dc2626;
+  --btn-danger-color: #ffffff;
+  --success-color: #16a34a;
+  --warning-color: #d97706;
+
+  /* SIZES */
+  --navbar-width: 190px;
+  --actionbar-height: 50px;
+}
+
+/* TrainUs theme — logo colours (#1E7FC0 blue, #12A892 teal) */
+[data-theme='trainus'] {
+  --bg-color1: #f0f8ff;
+  --bg-color2: #dceefb;
+  --front-color1: #0d1b2a;
+  --front-color2: #2c4a63;
+  --navbar-bg-color: #1e7fc0;
+  --navbar-front-color: #ffffff;
+  --navbar-hover-bg-color: #12a892;
+  --navbar-hover-front-color: #ffffff;
+  --actionbar-bg-color: #12a892;
+  --actionbar-font-color: #ffffff;
+  --border-color: #a8d5f0;
+  --input-bg: #ffffff;
+  --input-border: #1e7fc0;
+  --btn-primary-bg: #1e7fc0;
+  --btn-primary-color: #ffffff;
+  --btn-danger-bg: #dc2626;
+  --btn-danger-color: #ffffff;
+  --success-color: #12a892;
+  --warning-color: #d97706;
+}
+
+/* Dark theme */
+[data-theme='dark'] {
+  --bg-color1: #1a1a1a;
+  --bg-color2: #2a2a2a;
+  --front-color1: #e0e0e0;
+  --front-color2: #aaaaaa;
+  --navbar-bg-color: #111111;
+  --navbar-front-color: #e0e0e0;
+  --navbar-hover-bg-color: #333333;
+  --navbar-hover-front-color: #ffffff;
+  --actionbar-bg-color: #111111;
+  --actionbar-font-color: #e0e0e0;
+  --border-color: #444;
+  --input-bg: #2a2a2a;
+  --input-border: #555;
+  --btn-primary-bg: #3b82f6;
+  --btn-primary-color: #ffffff;
+  --btn-danger-bg: #ef4444;
+  --btn-danger-color: #ffffff;
+  --success-color: #22c55e;
+  --warning-color: #f59e0b;
+}
diff --git a/src/utils/backupFilename.js b/src/utils/backupFilename.js
new file mode 100644
index 0000000..7fe9df3
--- /dev/null
+++ b/src/utils/backupFilename.js
@@ -0,0 +1,10 @@
+export function formatBackupFilename(version, date = new Date()) {
+  const pad = (n) => String(n).padStart(2, '0')
+  const y = date.getFullYear()
+  const mo = pad(date.getMonth() + 1)
+  const d = pad(date.getDate())
+  const h = pad(date.getHours())
+  const mi = pad(date.getMinutes())
+  const s = pad(date.getSeconds())
+  return `trainus-${version}-backup-${y}${mo}${d}-${h}h${mi}m${s}s.sqlite3`
+}
diff --git a/src/utils/dateFormatter.js b/src/utils/dateFormatter.js
new file mode 100644
index 0000000..de99a9e
--- /dev/null
+++ b/src/utils/dateFormatter.js
@@ -0,0 +1,62 @@
+import i18next from 'i18next'
+
+export function formatDate(date, lang) {
+  if (!date) return ''
+  const d = date instanceof Date ? date : new Date(date)
+  if (isNaN(d.getTime())) return ''
+
+  lang = lang || i18next.language || 'en'
+  const pad = (n) => String(n).padStart(2, '0')
+  const dd = pad(d.getDate())
+  const mm = pad(d.getMonth() + 1)
+  const yyyy = d.getFullYear()
+
+  if (lang === 'fr') {
+    return `${dd}/${mm}/${yyyy}`
+  }
+  return `${mm}/${dd}/${yyyy}`
+}
+
+export function formatItemDuration(ms) {
+  if (!ms || ms <= 0) return null
+  const totalSecs = Math.round(ms / 1000)
+  if (totalSecs <= 0) return null
+  const mins = Math.floor(totalSecs / 60)
+  const secs = totalSecs % 60
+  if (mins === 0) return `${secs}s`
+  if (secs === 0) return `${mins}min`
+  return `${mins}min${secs}s`
+}
+
+export function formatDuration(start, end) {
+  if (!start || !end) return null
+  const s = start instanceof Date ? start : new Date(start)
+  const e = end instanceof Date ? end : new Date(end)
+  if (isNaN(s.getTime()) || isNaN(e.getTime())) return null
+  const mins = Math.round((e - s) / 60000)
+  if (mins <= 0) return null
+  if (mins < 60) return `${mins} min`
+  const h = Math.floor(mins / 60)
+  const m = mins % 60
+  return m === 0 ? `${h}h` : `${h}h ${m}min`
+}
+
+export function formatDateTime(date, lang) {
+  if (!date) return ''
+  const d = date instanceof Date ? date : new Date(date)
+  if (isNaN(d.getTime())) return ''
+
+  lang = lang || i18next.language || 'en'
+  const pad = (n) => String(n).padStart(2, '0')
+  const dd = pad(d.getDate())
+  const mm = pad(d.getMonth() + 1)
+  const yyyy = d.getFullYear()
+  const HH = pad(d.getHours())
+  const min = pad(d.getMinutes())
+  const ss = pad(d.getSeconds())
+
+  if (lang === 'fr') {
+    return `${dd}/${mm}/${yyyy}, ${HH}:${min}:${ss}`
+  }
+  return d.toLocaleString()
+}
diff --git a/src/utils/escapeLike.js b/src/utils/escapeLike.js
new file mode 100644
index 0000000..ae45488
--- /dev/null
+++ b/src/utils/escapeLike.js
@@ -0,0 +1,7 @@
+/**
+ * Escape backslash, % and _ so they are treated as literals in a LIKE pattern.
+ * Use with LIKE ? ESCAPE '\' in SQL.
+ */
+export function escapeLike(s) {
+  return s.replace(/\\/g, '\\\\').replace(/%/g, '\\%').replace(/_/g, '\\_')
+}
diff --git a/src/utils/jsonEnvelope.js b/src/utils/jsonEnvelope.js
new file mode 100644
index 0000000..ca441b8
--- /dev/null
+++ b/src/utils/jsonEnvelope.js
@@ -0,0 +1,113 @@
+import { SCHEMA_VERSION } from '../db/schema.js'
+import { useSaveFilePrompt } from '../composables/useSaveFilePrompt.js'
+
+/**
+ * Builds a JSON export envelope wrapping entity data.
+ * @param {object} data — e.g. { exercises: [...] }
+ * @param {{ name: string, uuid: string }} exportedBy — current user info
+ * @returns {object} The complete envelope
+ */
+export function buildEnvelope(data, exportedBy) {
+  return {
+    metadata: {
+      appName: __APP_NAME__,
+      appVersion: __APP_VERSION__,
+      schemaVersion: SCHEMA_VERSION,
+      exportDate: new Date().toISOString(),
+      exportedBy: {
+        name: exportedBy.name,
+        uuid: exportedBy.uuid,
+      },
+    },
+    data,
+  }
+}
+
+/**
+ * Parses and validates a JSON envelope string.
+ * Returns { valid, envelope, error } where error is an i18n key.
+ */
+export function parseEnvelope(jsonString) {
+  let parsed
+  try {
+    parsed = JSON.parse(jsonString)
+  } catch {
+    return { valid: false, envelope: null, error: 'import.errors.invalidJson' }
+  }
+
+  if (!parsed || typeof parsed !== 'object') {
+    return { valid: false, envelope: null, error: 'import.errors.invalidFormat' }
+  }
+
+  const { metadata, data } = parsed
+
+  if (!metadata || typeof metadata !== 'object') {
+    return { valid: false, envelope: null, error: 'import.errors.missingMetadata' }
+  }
+
+  if (metadata.appName !== __APP_NAME__) {
+    return { valid: false, envelope: null, error: 'import.errors.wrongApp' }
+  }
+
+  if (typeof metadata.schemaVersion !== 'number') {
+    return { valid: false, envelope: null, error: 'import.errors.missingSchema' }
+  }
+
+  if (metadata.schemaVersion > SCHEMA_VERSION) {
+    return { valid: false, envelope: null, error: 'import.errors.newerSchema' }
+  }
+
+  if (!data || typeof data !== 'object') {
+    return { valid: false, envelope: null, error: 'import.errors.missingData' }
+  }
+
+  if (!metadata.exportedBy || !metadata.exportedBy.uuid || !metadata.exportedBy.name) {
+    return { valid: false, envelope: null, error: 'import.errors.missingExporter' }
+  }
+
+  return { valid: true, envelope: parsed, error: null }
+}
+
+/**
+ * Prompts for a filename (prefilled with `defaultFilename`), then triggers a
+ * browser file download. No-op if the user cancels.
+ * @param {string} defaultFilename
+ * @param {string} jsonString
+ */
+export async function downloadJson(defaultFilename, jsonString) {
+  const { promptFilename } = useSaveFilePrompt()
+  const filename = await promptFilename(defaultFilename)
+  if (!filename) return
+
+  const blob = new Blob([jsonString], { type: 'application/json' })
+  const url = URL.createObjectURL(blob)
+  const a = document.createElement('a')
+  a.href = url
+  a.download = filename
+  a.click()
+  URL.revokeObjectURL(url)
+}
+
+/**
+ * Opens a file picker and returns file contents as string.
+ * Returns null if user cancels.
+ */
+export function pickJsonFile() {
+  return new Promise((resolve) => {
+    const input = document.createElement('input')
+    input.type = 'file'
+    input.accept = '.json'
+    input.onchange = async (e) => {
+      const file = e.target.files[0]
+      if (!file) {
+        resolve(null)
+        return
+      }
+      const text = await file.text()
+      resolve(text)
+    }
+    // Handle cancel (focus returns without change)
+    input.addEventListener('cancel', () => resolve(null))
+    input.click()
+  })
+}
diff --git a/src/utils/markdown.js b/src/utils/markdown.js
new file mode 100644
index 0000000..d053dc5
--- /dev/null
+++ b/src/utils/markdown.js
@@ -0,0 +1,7 @@
+import { marked } from 'marked'
+import DOMPurify from 'dompurify'
+
+export function renderMarkdown(text) {
+  if (!text) return ''
+  return DOMPurify.sanitize(marked.parse(text))
+}
diff --git a/src/utils/validation.js b/src/utils/validation.js
new file mode 100644
index 0000000..73b7892
--- /dev/null
+++ b/src/utils/validation.js
@@ -0,0 +1,50 @@
+/**
+ * Reusable validation helpers for form fields.
+ * Each function returns an error i18n key string if invalid, or '' if valid.
+ */
+
+/**
+ * Validates that a string is non-empty after trimming.
+ * @param {string} value
+ * @returns {string} error key or ''
+ */
+export function validateRequired(value) {
+  if (!value || !value.trim()) {
+    return 'validation.required'
+  }
+  return ''
+}
+
+/**
+ * Validates that a number is >= min.
+ * @param {number|string} value
+ * @param {number} min
+ * @returns {{ key: string, params: object } | ''} error descriptor or ''
+ */
+export function validateMin(value, min = 0) {
+  const num = Number(value)
+  if (isNaN(num) || num < min) {
+    return { key: 'validation.minValue', params: { min } }
+  }
+  return ''
+}
+
+/**
+ * Validates a URL format. Empty strings are considered valid (optional field).
+ * @param {string} value
+ * @returns {string} error key or ''
+ */
+export function validateUrl(value) {
+  if (!value || !value.trim()) {
+    return ''
+  }
+  try {
+    const url = new URL(value.trim())
+    if (!['http:', 'https:'].includes(url.protocol)) {
+      return 'validation.invalidUrl'
+    }
+    return ''
+  } catch {
+    return 'validation.invalidUrl'
+  }
+}
diff --git a/src/utils/youtube.js b/src/utils/youtube.js
new file mode 100644
index 0000000..244089f
--- /dev/null
+++ b/src/utils/youtube.js
@@ -0,0 +1,14 @@
+export function getYouTubeId(url) {
+  try {
+    const u = new URL(url)
+    if (u.hostname === 'youtu.be') {
+      return u.pathname.slice(1)
+    }
+    if (u.hostname.includes('youtube.com')) {
+      return u.searchParams.get('v')
+    }
+  } catch {
+    // ignore
+  }
+  return null
+}
diff --git a/src/views/CollectionDetailView.vue b/src/views/CollectionDetailView.vue
new file mode 100644
index 0000000..dfb941f
--- /dev/null
+++ b/src/views/CollectionDetailView.vue
@@ -0,0 +1,184 @@
+<script setup>
+import { ref, computed, onMounted } from 'vue'
+import { useTranslation } from 'i18next-vue'
+import { useRouter, useRoute } from 'vue-router'
+import { useCollections } from '../composables/useCollections.js'
+import { useJsonExport } from '../composables/useJsonExport.js'
+import { useKeyboardShortcut } from '../composables/useKeyboardShortcut.js'
+
+const { t } = useTranslation()
+const router = useRouter()
+const route = useRoute()
+const { getById, remove } = useCollections()
+const { exportCollection } = useJsonExport()
+
+const collection = ref(null)
+const loading = ref(true)
+
+const collectionId = computed(() => route.params.id)
+
+onMounted(async () => {
+  const data = await getById(collectionId.value)
+  if (!data) {
+    router.replace({ name: 'collections' })
+    return
+  }
+  collection.value = data
+  loading.value = false
+})
+
+function goToEdit() {
+  router.push({ name: 'collection-edit', params: { id: collectionId.value } })
+}
+
+useKeyboardShortcut('e', goToEdit)
+useKeyboardShortcut('escape', goBack, false)
+
+function goBack() {
+  router.push({ name: 'collections' })
+}
+
+function goToSession(sessionId) {
+  router.push({ name: 'session-detail', params: { id: sessionId } })
+}
+
+async function onDelete() {
+  if (!collection.value) return
+  const confirmed = window.confirm(
+    t('collections.deleteConfirm', { label: collection.value.label }),
+  )
+  if (!confirmed) return
+  await remove(collectionId.value)
+  router.push({ name: 'collections' })
+}
+
+async function onExport() {
+  await exportCollection(collectionId.value)
+}
+</script>
+
+<template>
+  <Teleport to="#actionbar-actions" defer>
+    <button
+      data-testid="collection-back-btn"
+      :title="$t('collections.title') + ' ' + $t('shortcuts.back')"
+      :aria-label="$t('collections.title')"
+      @click="goBack"
+    >
+      <i class="bi bi-arrow-left"></i>
+    </button>
+    <button
+      data-testid="collection-export-single-btn"
+      :title="$t('export.collection')"
+      :aria-label="$t('export.collection')"
+      @click="onExport"
+    >
+      <i class="bi bi-download"></i>
+    </button>
+    <button
+      data-testid="collection-edit-btn"
+      :title="$t('collections.edit') + ' ' + $t('shortcuts.edit')"
+      :aria-label="$t('collections.edit')"
+      @click="goToEdit"
+    >
+      <i class="bi bi-pencil"></i>
+    </button>
+    <button
+      data-testid="collection-delete-btn"
+      :title="$t('collections.delete')"
+      :aria-label="$t('collections.delete')"
+      @click="onDelete"
+    >
+      <i class="bi bi-trash"></i>
+    </button>
+  </Teleport>
+
+  <div class="collection-detail-view">
+    <p v-if="loading" class="text-muted">{{ $t('app.loading') }}</p>
+
+    <template v-else-if="collection">
+      <h2 data-testid="collection-detail-title">{{ collection.label }}</h2>
+
+      <div v-if="collection.sessions && collection.sessions.length" class="sessions-section">
+        <h3>{{ $t('collections.form.sessions') }}</h3>
+        <ol class="collection-session-list">
+          <li
+            v-for="(session, index) in collection.sessions"
+            :key="'session-' + index"
+            class="collection-session-item"
+            :data-testid="'collection-detail-session-' + index"
+          >
+            <span class="collection-session-number">{{ index + 1 }}</span>
+            <a
+              class="collection-session-title"
+              :data-testid="'collection-detail-session-link-' + index"
+              @click="goToSession(session.session_id)"
+            >
+              {{ session.title }}
+            </a>
+          </li>
+        </ol>
+      </div>
+    </template>
+  </div>
+</template>
+
+<style scoped>
+.collection-detail-view {
+  max-width: 800px;
+}
+
+.collection-detail-view h2 {
+  font-size: 22px;
+  margin-bottom: 8px;
+}
+
+.sessions-section {
+  margin-bottom: 20px;
+}
+
+.sessions-section h3 {
+  font-size: 16px;
+  font-weight: 600;
+  margin-bottom: 10px;
+}
+
+.collection-session-list {
+  list-style: none;
+  padding: 0;
+  margin: 0;
+}
+
+.collection-session-item {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+  padding: 8px 4px;
+  border-bottom: 1px solid var(--border-color);
+}
+
+.collection-session-number {
+  width: 24px;
+  height: 24px;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  border-radius: 50%;
+  background-color: var(--btn-primary-bg);
+  color: var(--btn-primary-color);
+  font-size: 12px;
+  font-weight: 600;
+  flex-shrink: 0;
+}
+
+.collection-session-title {
+  font-size: 14px;
+  color: var(--btn-primary-bg);
+  cursor: pointer;
+  text-decoration: none;
+}
+
+.collection-session-title:hover {
+  text-decoration: underline;
+}
+</style>
diff --git a/src/views/CollectionFormView.vue b/src/views/CollectionFormView.vue
new file mode 100644
index 0000000..ccc8dae
--- /dev/null
+++ b/src/views/CollectionFormView.vue
@@ -0,0 +1,428 @@
+<script setup>
+import { ref, computed, onMounted } from 'vue'
+import { useRouter, useRoute } from 'vue-router'
+import { useCollections } from '../composables/useCollections.js'
+import { useSessions } from '../composables/useSessions.js'
+import { useSettings } from '../composables/useSettings.js'
+import { validateRequired } from '../utils/validation.js'
+import { collectionRepository } from '../db/repositories/collectionRepository.js'
+import { useKeyboardShortcut } from '../composables/useKeyboardShortcut.js'
+
+const router = useRouter()
+const route = useRoute()
+const { create, update, getById } = useCollections()
+const { sessions: allSessions, fetchAll: fetchSessions } = useSessions()
+const { get: getSetting } = useSettings()
+
+const isEdit = computed(() => route.name === 'collection-edit')
+const collectionId = computed(() => route.params.id)
+
+const label = ref('')
+const selectedSessions = ref([])
+
+const errors = ref({})
+const saving = ref(false)
+
+const newSessionId = ref('')
+
+onMounted(async () => {
+  await fetchSessions()
+
+  if (isEdit.value && collectionId.value) {
+    const collection = await getById(collectionId.value)
+    if (!collection) {
+      router.replace({ name: 'collections' })
+      return
+    }
+    label.value = collection.label
+    selectedSessions.value = (collection.sessions || []).map((s) => s.session_id)
+  }
+})
+
+function validate() {
+  const e = {}
+  const labelErr = validateRequired(label.value)
+  if (labelErr) e.label = labelErr
+  errors.value = e
+  return Object.keys(e).length === 0
+}
+
+function addSession() {
+  if (!newSessionId.value) return
+  if (selectedSessions.value.includes(newSessionId.value)) return
+  selectedSessions.value.push(newSessionId.value)
+  newSessionId.value = ''
+}
+
+function removeSession(index) {
+  selectedSessions.value.splice(index, 1)
+}
+
+function moveSessionUp(index) {
+  if (index === 0) return
+  const arr = selectedSessions.value
+  ;[arr[index - 1], arr[index]] = [arr[index], arr[index - 1]]
+}
+
+function moveSessionDown(index) {
+  if (index === selectedSessions.value.length - 1) return
+  const arr = selectedSessions.value
+  ;[arr[index], arr[index + 1]] = [arr[index + 1], arr[index]]
+}
+
+function getSessionTitle(sessionId) {
+  const session = allSessions.value.find((s) => s.id === sessionId)
+  return session ? session.title : sessionId
+}
+
+async function onSave() {
+  if (!validate()) return
+
+  saving.value = true
+  try {
+    const userUuid = await getSetting('user_uuid')
+    const data = {
+      label: label.value.trim(),
+      created_by: userUuid,
+    }
+
+    let id
+    if (isEdit.value) {
+      await update(collectionId.value, data)
+      id = collectionId.value
+    } else {
+      id = await create(data)
+    }
+
+    await collectionRepository.setSessions(id, selectedSessions.value)
+
+    router.push({ name: 'collection-detail', params: { id } })
+  } catch (e) {
+    if (e.message && e.message.includes('UNIQUE')) {
+      errors.value = { ...errors.value, label: 'validation.collectionLabelTaken' }
+    } else {
+      errors.value = { ...errors.value, save: e.message }
+    }
+  } finally {
+    saving.value = false
+  }
+}
+
+useKeyboardShortcut('enter', onSave, { ctrl: true, ignoreInputs: false })
+useKeyboardShortcut('escape', onCancel, { ignoreInputs: false })
+
+function onCancel() {
+  if (isEdit.value) {
+    router.push({ name: 'collection-detail', params: { id: collectionId.value } })
+  } else {
+    router.push({ name: 'collections' })
+  }
+}
+</script>
+
+<template>
+  <Teleport to="#actionbar-actions" defer>
+    <button
+      data-testid="collection-form-cancel"
+      :title="$t('collections.form.cancel')"
+      :aria-label="$t('collections.form.cancel')"
+      @click="onCancel"
+    >
+      <i class="bi bi-x-lg"></i>
+    </button>
+  </Teleport>
+
+  <div class="collection-form-view">
+    <h2 data-testid="collection-form-heading">
+      {{ isEdit ? $t('collections.edit') : $t('collections.new') }}
+    </h2>
+
+    <form novalidate @submit.prevent="onSave">
+      <div class="form-group">
+        <label for="collection-label">{{ $t('collections.form.label') }} *</label>
+        <input
+          id="collection-label"
+          v-model="label"
+          data-testid="collection-label"
+          type="text"
+          :placeholder="$t('collections.form.labelPlaceholder')"
+          :class="{ 'input-error': errors.label }"
+          required
+          aria-required="true"
+          :aria-describedby="errors.label ? 'collection-label-error' : undefined"
+        />
+        <p
+          v-if="errors.label"
+          id="collection-label-error"
+          role="alert"
+          class="field-error"
+          data-testid="collection-label-error"
+        >
+          {{ $t(errors.label) }}
+        </p>
+      </div>
+
+      <div class="form-group">
+        <label>{{ $t('collections.form.sessions') }}</label>
+
+        <ol v-if="selectedSessions.length" class="session-order-list">
+          <li
+            v-for="(sessionId, index) in selectedSessions"
+            :key="'session-' + index"
+            class="session-order-item"
+            :data-testid="'collection-session-' + index"
+          >
+            <span class="session-order-number">{{ index + 1 }}</span>
+            <span class="session-order-title">{{ getSessionTitle(sessionId) }}</span>
+            <div class="session-order-actions">
+              <button
+                type="button"
+                class="btn-move"
+                :data-testid="'collection-session-move-up-' + index"
+                :disabled="index === 0"
+                @click="moveSessionUp(index)"
+              >
+                <i class="bi bi-chevron-up"></i>
+              </button>
+              <button
+                type="button"
+                class="btn-move"
+                :data-testid="'collection-session-move-down-' + index"
+                :disabled="index === selectedSessions.length - 1"
+                @click="moveSessionDown(index)"
+              >
+                <i class="bi bi-chevron-down"></i>
+              </button>
+              <button
+                type="button"
+                class="btn-remove"
+                :data-testid="'collection-session-remove-' + index"
+                @click="removeSession(index)"
+              >
+                <i class="bi bi-trash"></i>
+              </button>
+            </div>
+          </li>
+        </ol>
+
+        <div class="session-add">
+          <select
+            v-model="newSessionId"
+            data-testid="collection-session-select"
+            :disabled="allSessions.length === 0"
+          >
+            <option value="" disabled>
+              {{
+                allSessions.length === 0
+                  ? $t('collections.form.noSessions')
+                  : $t('collections.form.selectSession')
+              }}
+            </option>
+            <option v-for="session in allSessions" :key="session.id" :value="session.id">
+              {{ session.title }}
+            </option>
+          </select>
+          <button
+            type="button"
+            class="btn btn-primary btn-sm"
+            data-testid="collection-session-add"
+            :disabled="!newSessionId"
+            @click="addSession"
+          >
+            <i class="bi bi-plus"></i> {{ $t('collections.form.addSession') }}
+          </button>
+        </div>
+      </div>
+
+      <p v-if="errors.save" class="field-error" data-testid="collection-save-error">
+        {{ errors.save }}
+      </p>
+
+      <div class="form-actions">
+        <button
+          type="submit"
+          class="btn btn-primary"
+          data-testid="collection-save"
+          :disabled="saving"
+          :title="$t('collections.form.save') + ' ' + $t('shortcuts.save')"
+        >
+          <i class="bi bi-check-lg"></i>
+          {{ $t('collections.form.save') }}
+        </button>
+        <button
+          type="button"
+          class="btn"
+          data-testid="collection-form-cancel-btn"
+          @click="onCancel"
+        >
+          {{ $t('collections.form.cancel') }}
+        </button>
+      </div>
+    </form>
+  </div>
+</template>
+
+<style scoped>
+.collection-form-view {
+  max-width: 600px;
+}
+
+.collection-form-view h2 {
+  margin-bottom: 16px;
+  font-size: 20px;
+}
+
+.form-group {
+  margin-bottom: 16px;
+}
+
+.form-group label {
+  display: block;
+  font-weight: 600;
+  font-size: 14px;
+  margin-bottom: 4px;
+}
+
+.input-error {
+  border-color: var(--btn-danger-bg) !important;
+}
+
+.field-error {
+  color: var(--btn-danger-bg);
+  font-size: 13px;
+  margin: 4px 0 0;
+}
+
+select {
+  width: 100%;
+  padding: 8px 12px;
+  border: 1px solid var(--border-color);
+  border-radius: 4px;
+  background-color: var(--color-background);
+  color: var(--color-text);
+  font-size: 14px;
+}
+
+.session-order-list {
+  list-style: none;
+  padding: 0;
+  margin: 0 0 8px;
+}
+
+.session-order-item {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+  padding: 8px 4px;
+  border-bottom: 1px solid var(--border-color);
+}
+
+.session-order-number {
+  width: 24px;
+  height: 24px;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  border-radius: 50%;
+  background-color: var(--btn-primary-bg);
+  color: var(--btn-primary-color);
+  font-size: 12px;
+  font-weight: 600;
+  flex-shrink: 0;
+}
+
+.session-order-title {
+  flex: 1;
+  font-size: 14px;
+  min-width: 0;
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+}
+
+.session-order-actions {
+  display: flex;
+  gap: 4px;
+  flex-shrink: 0;
+}
+
+.btn-move {
+  background: none;
+  border: none;
+  color: var(--color-text);
+  cursor: pointer;
+  padding: 4px;
+  font-size: 14px;
+  display: flex;
+  align-items: center;
+}
+
+.btn-move:disabled {
+  opacity: 0.3;
+  cursor: not-allowed;
+}
+
+.btn-move:hover:not(:disabled) {
+  color: var(--btn-primary-bg);
+}
+
+.btn-remove {
+  background: none;
+  border: none;
+  color: var(--btn-danger-bg);
+  cursor: pointer;
+  padding: 4px;
+  font-size: 14px;
+  display: flex;
+  align-items: center;
+}
+
+.btn-remove:hover {
+  opacity: 0.7;
+}
+
+.session-add {
+  display: flex;
+  gap: 8px;
+  align-items: flex-start;
+}
+
+.session-add select {
+  flex: 1;
+}
+
+.btn-sm {
+  padding: 6px 12px;
+  font-size: 13px;
+  white-space: nowrap;
+}
+
+.form-actions {
+  display: flex;
+  gap: 8px;
+  margin-top: 24px;
+}
+
+@media screen and (max-width: 400px) {
+  .session-order-item {
+    flex-wrap: wrap;
+  }
+
+  .session-order-number {
+    display: none;
+  }
+
+  .session-order-actions {
+    order: 2;
+  }
+
+  .form-actions {
+    flex-wrap: wrap;
+  }
+
+  .form-actions .btn {
+    flex: 1 1 auto;
+    justify-content: center;
+  }
+}
+</style>
diff --git a/src/views/CollectionsView.vue b/src/views/CollectionsView.vue
new file mode 100644
index 0000000..0515694
--- /dev/null
+++ b/src/views/CollectionsView.vue
@@ -0,0 +1,309 @@
+<script setup>
+import { ref, nextTick, onMounted, watch, computed } from 'vue'
+import { useTranslation } from 'i18next-vue'
+import { useRouter } from 'vue-router'
+import { useCollections } from '../composables/useCollections.js'
+import { useJsonExport } from '../composables/useJsonExport.js'
+import { useJsonImport } from '../composables/useJsonImport.js'
+import { useSettings } from '../composables/useSettings.js'
+import { useKeyboardShortcut } from '../composables/useKeyboardShortcut.js'
+import { useListNavigation } from '../composables/useListNavigation.js'
+import ImportDialog from '../components/ImportDialog.vue'
+
+const { t } = useTranslation()
+const router = useRouter()
+const { collections, loading, fetchAll, search } = useCollections()
+const { exportAllCollections } = useJsonExport()
+const { loadFile } = useJsonImport()
+const { settings, fetchAll: fetchSettings } = useSettings()
+const localUuid = ref('')
+
+// Import dialog state
+const showImportDialog = ref(false)
+const importEnvelope = ref(null)
+const importAsMine = ref(false)
+
+const searchQuery = ref('')
+const searching = ref(false)
+const searchInput = ref(null)
+
+onMounted(async () => {
+  fetchAll()
+  await fetchSettings()
+  localUuid.value = settings.value.user_uuid || ''
+})
+
+let searchTimeout = null
+watch(searchQuery, (query) => {
+  clearTimeout(searchTimeout)
+  const trimmed = query.trim()
+  if (!trimmed) {
+    fetchAll()
+    return
+  }
+  searchTimeout = setTimeout(() => {
+    search(trimmed)
+  }, 250)
+})
+
+function goToNew() {
+  router.push({ name: 'collection-new' })
+}
+
+useKeyboardShortcut('n', goToNew)
+
+const collectionCount = computed(() => collections.value.length)
+const { focusedIndex: focusedCollectionIndex } = useListNavigation(collectionCount, (index) => {
+  goToDetail(collections.value[index].id)
+})
+
+function goToDetail(id) {
+  router.push({ name: 'collection-detail', params: { id } })
+}
+
+function toggleSearch() {
+  searching.value = !searching.value
+  if (searching.value) {
+    nextTick(() => {
+      searchInput.value?.focus()
+    })
+  } else {
+    searchQuery.value = ''
+    fetchAll()
+  }
+}
+
+function onSearchBlur() {
+  if (!searchQuery.value.trim()) {
+    searching.value = false
+  }
+}
+
+function clearSearch() {
+  searchQuery.value = ''
+  searchInput.value?.focus()
+}
+
+async function onExport() {
+  await exportAllCollections(searchQuery.value.trim())
+}
+
+async function onImport(asMine = false) {
+  const result = await loadFile()
+  if (result.cancelled) return
+  if (result.error) {
+    window.alert(t(result.error))
+    return
+  }
+  importEnvelope.value = result.envelope
+  importAsMine.value = asMine
+  showImportDialog.value = true
+}
+
+function onImportDone() {
+  showImportDialog.value = false
+  importEnvelope.value = null
+  importAsMine.value = false
+  fetchAll()
+}
+
+function onImportClose() {
+  showImportDialog.value = false
+  importEnvelope.value = null
+  importAsMine.value = false
+}
+</script>
+
+<template>
+  <Teleport to="#actionbar-actions" defer>
+    <button
+      data-testid="collection-search-toggle"
+      :title="$t('collections.searchPlaceholder')"
+      :aria-label="$t('collections.searchPlaceholder')"
+      @click="toggleSearch"
+    >
+      <i class="bi bi-search"></i>
+    </button>
+    <button
+      data-testid="collection-export-btn"
+      :title="$t('export.collections')"
+      :aria-label="$t('export.collections')"
+      @click="onExport"
+    >
+      <i class="bi bi-download"></i>
+    </button>
+    <button
+      data-testid="collection-import-btn"
+      :title="$t('import.exercises')"
+      :aria-label="$t('import.exercises')"
+      @click="onImport(false)"
+    >
+      <i class="bi bi-upload"></i>
+    </button>
+    <button
+      data-testid="collection-import-as-mine-btn"
+      :title="$t('import.importAsMine')"
+      :aria-label="$t('import.importAsMine')"
+      @click="onImport(true)"
+    >
+      <i class="bi bi-person-check"></i>
+    </button>
+    <button
+      data-testid="collection-new-btn"
+      :title="$t('collections.new') + ' ' + $t('shortcuts.new')"
+      :aria-label="$t('collections.new')"
+      @click="goToNew"
+    >
+      <i class="bi bi-plus-lg"></i>
+    </button>
+  </Teleport>
+
+  <div class="collection-list-view">
+    <div v-if="searching" class="search-bar" data-testid="collection-search-bar">
+      <input
+        ref="searchInput"
+        v-model="searchQuery"
+        type="text"
+        :placeholder="$t('collections.searchPlaceholder')"
+        data-testid="collection-search-input"
+        @blur="onSearchBlur"
+      />
+      <button
+        v-if="searchQuery"
+        type="button"
+        class="search-clear-btn"
+        data-testid="collection-search-clear"
+        :title="$t('common.clearSearch')"
+        :aria-label="$t('common.clearSearch')"
+        @mousedown.prevent="clearSearch"
+      >
+        <i class="bi bi-x-lg"></i>
+      </button>
+    </div>
+
+    <p v-if="loading" class="text-muted">{{ $t('app.loading') }}</p>
+
+    <p
+      v-else-if="collections.length === 0 && !searchQuery.trim()"
+      class="text-muted"
+      data-testid="collection-empty"
+    >
+      {{ $t('collections.empty') }}
+    </p>
+
+    <p
+      v-else-if="collections.length === 0 && searchQuery.trim()"
+      class="text-muted"
+      data-testid="collection-no-results"
+    >
+      {{ $t('collections.noResults') }}
+    </p>
+
+    <div
+      v-for="(collection, index) in collections"
+      :key="collection.id"
+      class="card collection-card"
+      :class="{ 'card-focused': focusedCollectionIndex === index }"
+      :data-testid="'collection-card-' + collection.id"
+      :data-list-index="index"
+      tabindex="0"
+      @click="goToDetail(collection.id)"
+    >
+      <div class="collection-card-header">
+        <h3 data-testid="collection-card-title">{{ collection.label }}</h3>
+        <span
+          v-if="collection.sessionCount"
+          class="badge badge-info"
+          data-testid="collection-card-session-count"
+        >
+          {{ collection.sessionCount }} {{ $t('collections.sessions') }}
+        </span>
+      </div>
+    </div>
+  </div>
+
+  <ImportDialog
+    v-if="showImportDialog && importEnvelope"
+    :envelope="importEnvelope"
+    :local-uuid="localUuid"
+    :as-mine="importAsMine"
+    @done="onImportDone"
+    @close="onImportClose"
+  />
+</template>
+
+<style scoped>
+.collection-list-view {
+  max-width: 800px;
+}
+
+.search-bar {
+  position: relative;
+  margin-bottom: 16px;
+}
+
+.search-bar input {
+  padding-right: 36px;
+}
+
+.search-clear-btn {
+  position: absolute;
+  top: 50%;
+  right: 8px;
+  transform: translateY(-50%);
+  background: none;
+  border: none;
+  padding: 4px;
+  line-height: 1;
+  color: var(--front-color2);
+  cursor: pointer;
+}
+
+.collection-card {
+  cursor: pointer;
+  transition: border-color 0.15s;
+}
+
+.collection-card:hover {
+  border-color: var(--btn-primary-bg);
+}
+
+.collection-card:focus-visible {
+  border-color: var(--btn-primary-bg);
+  box-shadow: 0 0 0 2px var(--btn-primary-bg);
+  outline: none;
+}
+
+.collection-card.card-focused {
+  border-color: var(--btn-primary-bg);
+  box-shadow: 0 0 0 2px var(--btn-primary-bg);
+}
+
+.collection-card-header {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+}
+
+.collection-card-header h3 {
+  flex: 1;
+  font-size: 16px;
+  font-weight: 600;
+}
+
+.badge {
+  display: inline-flex;
+  align-items: center;
+  gap: 4px;
+  padding: 2px 8px;
+  border-radius: 12px;
+  font-size: 12px;
+  background-color: var(--btn-primary-bg);
+  color: var(--btn-primary-color);
+  white-space: nowrap;
+}
+
+.badge-info {
+  background-color: var(--front-color2);
+}
+</style>
diff --git a/src/views/ComboDetailView.vue b/src/views/ComboDetailView.vue
new file mode 100644
index 0000000..45b2fd4
--- /dev/null
+++ b/src/views/ComboDetailView.vue
@@ -0,0 +1,341 @@
+<script setup>
+import { ref, computed, onMounted } from 'vue'
+import { useTranslation } from 'i18next-vue'
+import { useRouter, useRoute } from 'vue-router'
+import { useCombos } from '../composables/useCombos.js'
+import { useJsonExport } from '../composables/useJsonExport.js'
+import { useKeyboardShortcut } from '../composables/useKeyboardShortcut.js'
+import { renderMarkdown } from '../utils/markdown.js'
+
+const { t } = useTranslation()
+const router = useRouter()
+const route = useRoute()
+const { getById, remove } = useCombos()
+const { exportCombo } = useJsonExport()
+
+const combo = ref(null)
+const loading = ref(true)
+
+const comboId = computed(() => route.params.id)
+
+onMounted(async () => {
+  const data = await getById(comboId.value)
+  if (!data) {
+    router.replace({ name: 'combos' })
+    return
+  }
+  combo.value = data
+  loading.value = false
+})
+
+function goToEdit() {
+  router.push({ name: 'combo-edit', params: { id: comboId.value } })
+}
+
+useKeyboardShortcut('e', goToEdit)
+useKeyboardShortcut('escape', goBack, false)
+
+function goBack() {
+  router.push({ name: 'combos' })
+}
+
+function goToExercise(exerciseId) {
+  router.push({ name: 'exercise-detail', params: { id: exerciseId } })
+}
+
+async function onDelete() {
+  if (!combo.value) return
+  const confirmed = window.confirm(t('combos.deleteConfirm', { title: combo.value.title }))
+  if (!confirmed) return
+  await remove(comboId.value)
+  router.push({ name: 'combos' })
+}
+
+async function onExport() {
+  await exportCombo(comboId.value)
+}
+</script>
+
+<template>
+  <Teleport to="#actionbar-actions" defer>
+    <button
+      data-testid="combo-back-btn"
+      :title="$t('combos.title') + ' ' + $t('shortcuts.back')"
+      :aria-label="$t('combos.title')"
+      @click="goBack"
+    >
+      <i class="bi bi-arrow-left"></i>
+    </button>
+    <button
+      data-testid="combo-export-single-btn"
+      :title="$t('export.combo')"
+      :aria-label="$t('export.combo')"
+      @click="onExport"
+    >
+      <i class="bi bi-download"></i>
+    </button>
+    <button
+      data-testid="combo-edit-btn"
+      :title="$t('combos.edit') + ' ' + $t('shortcuts.edit')"
+      :aria-label="$t('combos.edit')"
+      @click="goToEdit"
+    >
+      <i class="bi bi-pencil"></i>
+    </button>
+    <button
+      data-testid="combo-delete-btn"
+      :title="$t('combos.delete')"
+      :aria-label="$t('combos.delete')"
+      @click="onDelete"
+    >
+      <i class="bi bi-trash"></i>
+    </button>
+  </Teleport>
+
+  <div class="combo-detail-view">
+    <p v-if="loading" class="text-muted">{{ $t('app.loading') }}</p>
+
+    <template v-else-if="combo">
+      <!-- Title -->
+      <h2 data-testid="combo-detail-title">{{ combo.title }}</h2>
+
+      <!-- Description -->
+      <div
+        v-if="combo.description"
+        class="combo-description"
+        data-testid="combo-detail-description"
+        v-html="renderMarkdown(combo.description)"
+      />
+
+      <!-- Meta -->
+      <div class="combo-meta">
+        <span class="badge badge-type" data-testid="combo-detail-type">
+          {{ $t(`combos.types.${combo.type.toLowerCase()}`) }}
+        </span>
+      </div>
+
+      <!-- Timer config -->
+      <div
+        v-if="combo.type !== 'NONE' && combo.timer_config && Object.keys(combo.timer_config).length"
+        class="timer-config-section"
+      >
+        <h3>{{ $t('combos.timerConfig') }}</h3>
+        <dl class="timer-config-list">
+          <template v-if="combo.type === 'EMOM'">
+            <dt>{{ $t('combos.timer.emomDuration') }}</dt>
+            <dd data-testid="combo-detail-emom-duration">
+              {{ combo.timer_config.duration || '—' }} {{ $t('combos.timer.minutes') }}
+            </dd>
+          </template>
+          <template v-else-if="combo.type === 'AMRAP'">
+            <dt>{{ $t('combos.timer.amrapDuration') }}</dt>
+            <dd data-testid="combo-detail-amrap-duration">
+              {{ combo.timer_config.duration || '—' }} {{ $t('combos.timer.minutes') }}
+            </dd>
+          </template>
+          <template v-else-if="combo.type === 'TABATA'">
+            <dt>{{ $t('combos.timer.tabataRounds') }}</dt>
+            <dd data-testid="combo-detail-tabata-rounds">
+              {{ combo.timer_config.rounds || '—' }} {{ $t('combos.timer.rounds') }}
+            </dd>
+          </template>
+        </dl>
+      </div>
+
+      <!-- Exercises -->
+      <div v-if="combo.exercises && combo.exercises.length" class="exercises-section">
+        <h3>{{ $t('combos.form.exercises') }}</h3>
+        <ol class="combo-exercise-list">
+          <li
+            v-for="(ex, index) in combo.exercises"
+            :key="'ex-' + index"
+            class="combo-exercise-item"
+            :data-testid="'combo-detail-exercise-' + index"
+          >
+            <span class="combo-exercise-number">{{ index + 1 }}</span>
+            <a
+              class="combo-exercise-title"
+              :data-testid="'combo-detail-exercise-link-' + index"
+              @click="goToExercise(ex.exercise_id)"
+            >
+              {{ ex.title }}
+            </a>
+            <span
+              class="combo-exercise-details"
+              :data-testid="'combo-detail-exercise-details-' + index"
+            >
+              <span>{{ ex.default_reps }} {{ $t('exercises.reps') }}</span>
+              <span>{{ ex.default_weight }} {{ $t('exercises.weight') }}</span>
+            </span>
+          </li>
+        </ol>
+      </div>
+    </template>
+  </div>
+</template>
+
+<style scoped>
+.combo-detail-view {
+  max-width: 800px;
+}
+
+.combo-detail-view h2 {
+  font-size: 22px;
+  margin-bottom: 8px;
+}
+
+.combo-description {
+  font-size: 15px;
+  line-height: 1.5;
+  margin-bottom: 12px;
+}
+
+.combo-description :deep(p) {
+  margin: 0 0 8px;
+}
+
+.combo-description :deep(p:last-child) {
+  margin-bottom: 0;
+}
+
+.combo-description :deep(ul),
+.combo-description :deep(ol) {
+  margin: 0 0 8px;
+  padding-left: 20px;
+}
+
+.combo-description :deep(code) {
+  font-family: monospace;
+  font-size: 13px;
+  background: var(--color-surface, #f4f4f4);
+  padding: 1px 4px;
+  border-radius: 3px;
+}
+
+.combo-description :deep(pre) {
+  background: var(--color-surface, #f4f4f4);
+  padding: 8px;
+  border-radius: 4px;
+  overflow-x: auto;
+  margin-bottom: 8px;
+}
+
+.combo-description :deep(strong) {
+  font-weight: 600;
+}
+
+.combo-meta {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 8px;
+  margin-bottom: 20px;
+}
+
+.badge {
+  display: inline-flex;
+  align-items: center;
+  gap: 4px;
+  padding: 4px 10px;
+  border-radius: 12px;
+  font-size: 13px;
+  background-color: var(--btn-primary-bg);
+  color: var(--btn-primary-color);
+}
+
+.badge-type {
+  background-color: var(--front-color2);
+}
+
+.timer-config-section {
+  margin-bottom: 20px;
+}
+
+.timer-config-section h3 {
+  font-size: 16px;
+  font-weight: 600;
+  margin-bottom: 10px;
+}
+
+.timer-config-list {
+  display: grid;
+  grid-template-columns: auto 1fr;
+  gap: 4px 16px;
+  margin: 0;
+  padding: 0;
+}
+
+.timer-config-list dt {
+  font-weight: 600;
+  font-size: 14px;
+}
+
+.timer-config-list dd {
+  margin: 0;
+  font-size: 14px;
+}
+
+.exercises-section {
+  margin-bottom: 20px;
+}
+
+.exercises-section h3 {
+  font-size: 16px;
+  font-weight: 600;
+  margin-bottom: 10px;
+}
+
+.combo-exercise-list {
+  list-style: none;
+  padding: 0;
+  margin: 0;
+}
+
+.combo-exercise-item {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+  padding: 8px 4px;
+  border-bottom: 1px solid var(--border-color);
+}
+
+.combo-exercise-number {
+  width: 24px;
+  height: 24px;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  border-radius: 50%;
+  background-color: var(--btn-primary-bg);
+  color: var(--btn-primary-color);
+  font-size: 12px;
+  font-weight: 600;
+  flex-shrink: 0;
+}
+
+.combo-exercise-title {
+  font-size: 14px;
+  color: var(--btn-primary-bg);
+  cursor: pointer;
+  text-decoration: none;
+}
+
+.combo-exercise-title:hover {
+  text-decoration: underline;
+}
+
+.combo-exercise-details {
+  display: flex;
+  gap: 8px;
+  font-size: 13px;
+  color: var(--color-text-muted);
+  margin-left: auto;
+}
+
+.combo-exercise-details span {
+  white-space: nowrap;
+}
+
+.combo-exercise-title:hover {
+  text-decoration: underline;
+}
+</style>
diff --git a/src/views/ComboFormView.vue b/src/views/ComboFormView.vue
new file mode 100644
index 0000000..273a4be
--- /dev/null
+++ b/src/views/ComboFormView.vue
@@ -0,0 +1,711 @@
+<script setup>
+import { ref, computed, onMounted } from 'vue'
+import { useRouter, useRoute } from 'vue-router'
+import { useCombos } from '../composables/useCombos.js'
+import { useExercises } from '../composables/useExercises.js'
+import { useSettings } from '../composables/useSettings.js'
+import { validateRequired } from '../utils/validation.js'
+import { comboRepository } from '../db/repositories/comboRepository.js'
+import { useKeyboardShortcut } from '../composables/useKeyboardShortcut.js'
+
+const router = useRouter()
+const route = useRoute()
+const { create, update, getById } = useCombos()
+const { exercises: allExercises, fetchAll: fetchExercises } = useExercises()
+const { get: getSetting } = useSettings()
+
+const isEdit = computed(() => route.name === 'combo-edit')
+const comboId = computed(() => route.params.id)
+
+// Form fields
+const title = ref('')
+const description = ref('')
+const type = ref('NONE')
+const selectedExercises = ref([])
+const timerConfig = ref({})
+
+// Validation errors
+const errors = ref({})
+const saving = ref(false)
+
+const newExerciseId = ref('')
+
+onMounted(async () => {
+  await fetchExercises()
+
+  if (isEdit.value && comboId.value) {
+    const combo = await getById(comboId.value)
+    if (!combo) {
+      router.replace({ name: 'combos' })
+      return
+    }
+    title.value = combo.title
+    description.value = combo.description || ''
+    type.value = combo.type
+    selectedExercises.value = (combo.exercises || []).map((e) => {
+      const ex = allExercises.value.find((a) => a.id === e.exercise_id)
+      return {
+        exerciseId: e.exercise_id,
+        defaultReps: e.default_reps || 1,
+        defaultWeight: e.default_weight || 0.0,
+        asymmetric: ex?.asymmetric || false,
+      }
+    })
+    timerConfig.value = { ...combo.timer_config }
+  }
+})
+
+function validate() {
+  const e = {}
+  const titleErr = validateRequired(title.value)
+  if (titleErr) e.title = titleErr
+  errors.value = e
+  return Object.keys(e).length === 0
+}
+
+function addExercise() {
+  if (!newExerciseId.value) return
+  const ex = allExercises.value.find((e) => e.id === newExerciseId.value)
+  const asymmetric = ex?.asymmetric || false
+  let defaultReps = ex?.default_reps || 1
+  if (asymmetric && defaultReps % 2 !== 0) defaultReps++
+  selectedExercises.value.push({
+    exerciseId: newExerciseId.value,
+    defaultReps,
+    defaultWeight: 0.0,
+    asymmetric,
+  })
+  newExerciseId.value = ''
+}
+
+function enforceEvenReps(exercise) {
+  if (exercise.asymmetric && exercise.defaultReps > 0 && exercise.defaultReps % 2 !== 0) {
+    exercise.defaultReps++
+  }
+}
+
+function removeExercise(index) {
+  selectedExercises.value.splice(index, 1)
+}
+
+function moveExerciseUp(index) {
+  if (index === 0) return
+  const arr = selectedExercises.value
+  ;[arr[index - 1], arr[index]] = [arr[index], arr[index - 1]]
+}
+
+function moveExerciseDown(index) {
+  if (index === selectedExercises.value.length - 1) return
+  const arr = selectedExercises.value
+  ;[arr[index], arr[index + 1]] = [arr[index + 1], arr[index]]
+}
+
+function getExerciseTitle(exerciseId) {
+  const ex = allExercises.value.find((e) => e.id === exerciseId)
+  return ex ? ex.title : exerciseId
+}
+
+async function onSave() {
+  if (!validate()) return
+
+  saving.value = true
+  try {
+    const userUuid = await getSetting('user_uuid')
+    const data = {
+      title: title.value.trim(),
+      description: description.value.trim(),
+      type: type.value,
+      timer_config: timerConfig.value,
+      created_by: userUuid,
+    }
+
+    let id
+    if (isEdit.value) {
+      await update(comboId.value, data)
+      id = comboId.value
+    } else {
+      id = await create(data)
+    }
+
+    // Save exercises
+    await comboRepository.setExercises(id, selectedExercises.value)
+
+    router.push({ name: 'combo-detail', params: { id } })
+  } catch (e) {
+    if (e.message && e.message.includes('UNIQUE')) {
+      errors.value = { ...errors.value, title: 'validation.comboTitleTaken' }
+    } else {
+      errors.value = { ...errors.value, save: e.message }
+    }
+  } finally {
+    saving.value = false
+  }
+}
+
+useKeyboardShortcut('enter', onSave, { ctrl: true, ignoreInputs: false })
+useKeyboardShortcut('escape', onCancel, { ignoreInputs: false })
+
+function onCancel() {
+  if (isEdit.value) {
+    router.push({ name: 'combo-detail', params: { id: comboId.value } })
+  } else {
+    router.push({ name: 'combos' })
+  }
+}
+</script>
+
+<template>
+  <Teleport to="#actionbar-actions" defer>
+    <button
+      data-testid="combo-form-cancel"
+      :title="$t('combos.form.cancel')"
+      :aria-label="$t('combos.form.cancel')"
+      @click="onCancel"
+    >
+      <i class="bi bi-x-lg"></i>
+    </button>
+  </Teleport>
+
+  <div class="combo-form-view">
+    <h2 data-testid="combo-form-heading">
+      {{ isEdit ? $t('combos.edit') : $t('combos.new') }}
+    </h2>
+
+    <form novalidate @submit.prevent="onSave">
+      <!-- Title -->
+      <div class="form-group">
+        <label for="combo-title">{{ $t('combos.form.title') }} *</label>
+        <input
+          id="combo-title"
+          v-model="title"
+          data-testid="combo-title"
+          type="text"
+          :placeholder="$t('combos.form.titlePlaceholder')"
+          :class="{ 'input-error': errors.title }"
+          required
+          aria-required="true"
+          :aria-describedby="errors.title ? 'combo-title-error' : undefined"
+        />
+        <p
+          v-if="errors.title"
+          id="combo-title-error"
+          role="alert"
+          class="field-error"
+          data-testid="combo-title-error"
+        >
+          {{ $t(errors.title) }}
+        </p>
+      </div>
+
+      <!-- Description -->
+      <div class="form-group">
+        <label for="combo-description">
+          {{ $t('combos.form.description') }}
+          <span class="field-hint">{{ $t('common.markdownHint') }}</span>
+        </label>
+        <textarea
+          id="combo-description"
+          v-model="description"
+          data-testid="combo-description"
+          :placeholder="$t('combos.form.descriptionPlaceholder')"
+          rows="3"
+        ></textarea>
+      </div>
+
+      <!-- Type -->
+      <div class="form-group">
+        <label for="combo-type">{{ $t('combos.form.type') }}</label>
+        <select id="combo-type" v-model="type" data-testid="combo-type">
+          <option value="NONE">{{ $t('combos.types.none') }}</option>
+          <option value="EMOM">{{ $t('combos.types.emom') }}</option>
+          <option value="AMRAP">{{ $t('combos.types.amrap') }}</option>
+          <option value="TABATA">{{ $t('combos.types.tabata') }}</option>
+        </select>
+      </div>
+
+      <!-- Timer config for EMOM -->
+      <div v-if="type === 'EMOM'" class="form-group form-sub-group">
+        <label for="combo-emom-duration">{{ $t('combos.timer.emomDuration') }}</label>
+        <input
+          id="combo-emom-duration"
+          v-model.number="timerConfig.duration"
+          data-testid="combo-emom-duration"
+          type="number"
+          min="1"
+          :placeholder="$t('combos.timer.minutes')"
+        />
+      </div>
+
+      <!-- Timer config for AMRAP -->
+      <div v-if="type === 'AMRAP'" class="form-group form-sub-group">
+        <label for="combo-amrap-duration">{{ $t('combos.timer.amrapDuration') }}</label>
+        <input
+          id="combo-amrap-duration"
+          v-model.number="timerConfig.duration"
+          data-testid="combo-amrap-duration"
+          type="number"
+          min="1"
+          :placeholder="$t('combos.timer.minutes')"
+        />
+      </div>
+
+      <!-- Timer config for TABATA -->
+      <div v-if="type === 'TABATA'" class="form-group form-sub-group">
+        <label for="combo-tabata-work-time">{{ $t('combos.timer.tabataWorkTime') }}</label>
+        <input
+          id="combo-tabata-work-time"
+          v-model.number="timerConfig.workTime"
+          data-testid="combo-tabata-work-time"
+          type="number"
+          min="1"
+          :placeholder="$t('combos.timer.tabataSeconds')"
+        />
+      </div>
+      <div v-if="type === 'TABATA'" class="form-group form-sub-group">
+        <label for="combo-tabata-rest-time">{{ $t('combos.timer.tabataRestTime') }}</label>
+        <input
+          id="combo-tabata-rest-time"
+          v-model.number="timerConfig.restTime"
+          data-testid="combo-tabata-rest-time"
+          type="number"
+          min="0"
+          :placeholder="$t('combos.timer.tabataSeconds')"
+        />
+      </div>
+
+      <!-- Exercise selector -->
+      <div class="form-group">
+        <label>{{ $t('combos.form.exercises') }}</label>
+
+        <!-- Selected exercises list -->
+        <ol v-if="selectedExercises.length" class="exercise-order-list">
+          <li
+            v-for="(exercise, index) in selectedExercises"
+            :key="'ex-' + index"
+            class="exercise-order-item"
+            :data-testid="'combo-exercise-item-' + index"
+          >
+            <span class="exercise-order-number">{{ index + 1 }}</span>
+            <span class="exercise-order-title">{{ getExerciseTitle(exercise.exerciseId) }}</span>
+            <div class="exercise-order-fields">
+              <div class="exercise-field">
+                <label :for="'combo-exercise-reps-' + index">{{ $t('combos.form.reps') }}</label>
+                <div class="stepper">
+                  <button
+                    type="button"
+                    class="stepper-btn btn-primary"
+                    @click="
+                      exercise.defaultReps = Math.max(
+                        exercise.asymmetric ? 2 : 1,
+                        exercise.defaultReps - (exercise.asymmetric ? 2 : 1),
+                      )
+                    "
+                  >
+                    <i class="bi bi-dash-circle-fill"></i>
+                  </button>
+                  <input
+                    :id="'combo-exercise-reps-' + index"
+                    v-model.number="exercise.defaultReps"
+                    :data-testid="'combo-exercise-reps-' + index"
+                    type="number"
+                    :min="exercise.asymmetric ? 2 : 1"
+                    :step="exercise.asymmetric ? 2 : 1"
+                    class="step-input"
+                    @change="enforceEvenReps(exercise)"
+                  />
+                  <button
+                    type="button"
+                    class="stepper-btn btn-primary"
+                    @click="exercise.defaultReps += exercise.asymmetric ? 2 : 1"
+                  >
+                    <i class="bi bi-plus-circle-fill"></i>
+                  </button>
+                  <button
+                    type="button"
+                    class="stepper-btn stepper-btn-fast"
+                    @click="exercise.defaultReps += exercise.asymmetric ? 10 : 5"
+                  >
+                    <i class="bi bi-forward-fill"></i>
+                  </button>
+                </div>
+              </div>
+              <div class="exercise-field">
+                <label :for="'combo-exercise-weight-' + index">{{
+                  $t('combos.form.weight')
+                }}</label>
+                <div class="stepper">
+                  <button
+                    type="button"
+                    class="stepper-btn btn-primary"
+                    @click="
+                      exercise.defaultWeight = Math.max(
+                        0,
+                        +(exercise.defaultWeight - 0.5).toFixed(1),
+                      )
+                    "
+                  >
+                    <i class="bi bi-dash-circle-fill"></i>
+                  </button>
+                  <input
+                    :id="'combo-exercise-weight-' + index"
+                    v-model.number="exercise.defaultWeight"
+                    :data-testid="'combo-exercise-weight-' + index"
+                    type="number"
+                    min="0"
+                    step="0.5"
+                    class="step-input"
+                  />
+                  <button
+                    type="button"
+                    class="stepper-btn btn-primary"
+                    @click="exercise.defaultWeight = +(exercise.defaultWeight + 0.5).toFixed(1)"
+                  >
+                    <i class="bi bi-plus-circle-fill"></i>
+                  </button>
+                  <button
+                    type="button"
+                    class="stepper-btn stepper-btn-fast"
+                    @click="exercise.defaultWeight = +(exercise.defaultWeight + 1).toFixed(1)"
+                  >
+                    <i class="bi bi-forward-fill"></i>
+                  </button>
+                </div>
+              </div>
+            </div>
+            <div class="exercise-order-actions">
+              <button
+                type="button"
+                class="btn-move"
+                :data-testid="'combo-exercise-move-up-' + index"
+                :disabled="index === 0"
+                @click="moveExerciseUp(index)"
+              >
+                <i class="bi bi-chevron-up"></i>
+              </button>
+              <button
+                type="button"
+                class="btn-move"
+                :data-testid="'combo-exercise-move-down-' + index"
+                :disabled="index === selectedExercises.length - 1"
+                @click="moveExerciseDown(index)"
+              >
+                <i class="bi bi-chevron-down"></i>
+              </button>
+              <button
+                type="button"
+                class="btn-remove"
+                :data-testid="'combo-exercise-remove-' + index"
+                @click="removeExercise(index)"
+              >
+                <i class="bi bi-trash"></i>
+              </button>
+            </div>
+          </li>
+        </ol>
+        <p v-if="selectedExercises.some((e) => e.asymmetric)" class="field-hint">
+          {{ $t('exercises.evenRepsHint') }}
+        </p>
+
+        <!-- Add exercise -->
+        <div class="exercise-add">
+          <select
+            v-model="newExerciseId"
+            data-testid="combo-exercise-select"
+            :disabled="allExercises.length === 0"
+          >
+            <option value="" disabled>
+              {{
+                allExercises.length === 0
+                  ? $t('combos.form.noExercises')
+                  : $t('combos.form.selectExercise')
+              }}
+            </option>
+            <option v-for="ex in allExercises" :key="ex.id" :value="ex.id">
+              {{ ex.title }}
+            </option>
+          </select>
+          <button
+            type="button"
+            class="btn btn-primary btn-sm"
+            data-testid="combo-exercise-add"
+            :disabled="!newExerciseId"
+            @click="addExercise"
+          >
+            <i class="bi bi-plus"></i> {{ $t('combos.form.addExercise') }}
+          </button>
+        </div>
+      </div>
+
+      <!-- Save error -->
+      <p v-if="errors.save" class="field-error" data-testid="combo-save-error">
+        {{ errors.save }}
+      </p>
+
+      <!-- Actions -->
+      <div class="form-actions">
+        <button
+          type="submit"
+          class="btn btn-primary"
+          data-testid="combo-save"
+          :disabled="saving"
+          :title="$t('combos.form.save') + ' ' + $t('shortcuts.save')"
+        >
+          <i class="bi bi-check-lg"></i>
+          {{ $t('combos.form.save') }}
+        </button>
+        <button type="button" class="btn" data-testid="combo-cancel" @click="onCancel">
+          {{ $t('combos.form.cancel') }}
+        </button>
+      </div>
+    </form>
+  </div>
+</template>
+
+<style scoped>
+.combo-form-view {
+  max-width: 600px;
+}
+
+.combo-form-view h2 {
+  margin-bottom: 16px;
+  font-size: 20px;
+}
+
+.form-group {
+  margin-bottom: 16px;
+}
+
+.form-group label {
+  display: flex;
+  align-items: baseline;
+  gap: 6px;
+  font-weight: 600;
+  font-size: 14px;
+  margin-bottom: 4px;
+}
+
+.field-hint {
+  font-weight: 400;
+  font-size: 11px;
+  opacity: 0.55;
+}
+
+.form-sub-group {
+  padding-left: 24px;
+}
+
+.input-error {
+  border-color: var(--btn-danger-bg) !important;
+}
+
+.field-error {
+  color: var(--btn-danger-bg);
+  font-size: 13px;
+  margin: 4px 0 0;
+}
+
+.field-hint {
+  color: var(--color-text-muted);
+  font-size: 12px;
+  margin: 4px 0 0;
+}
+
+select {
+  width: 100%;
+  padding: 8px 12px;
+  border: 1px solid var(--border-color);
+  border-radius: 4px;
+  background-color: var(--color-background);
+  color: var(--color-text);
+  font-size: 14px;
+}
+
+.exercise-order-list {
+  list-style: none;
+  padding: 0;
+  margin: 0 0 8px;
+}
+
+.exercise-order-item {
+  display: flex;
+  align-items: center;
+  flex-wrap: wrap;
+  gap: 8px;
+  padding: 8px 4px;
+  border-bottom: 1px solid var(--border-color);
+}
+
+.exercise-order-number {
+  width: 24px;
+  height: 24px;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  border-radius: 50%;
+  background-color: var(--btn-primary-bg);
+  color: var(--btn-primary-color);
+  font-size: 12px;
+  font-weight: 600;
+  flex-shrink: 0;
+}
+
+.exercise-order-title {
+  flex: 1;
+  font-size: 14px;
+}
+
+.exercise-order-fields {
+  order: 3;
+  width: 100%;
+  display: flex;
+  flex-direction: column;
+  gap: 8px;
+}
+
+.exercise-field {
+  display: flex;
+  flex-direction: row;
+  align-items: center;
+  gap: 8px;
+}
+
+.exercise-field label {
+  font-size: 12px;
+  font-weight: 600;
+  color: var(--color-text-muted);
+  width: 90px;
+  flex-shrink: 0;
+  white-space: nowrap;
+}
+
+.stepper {
+  display: flex;
+  align-items: center;
+  gap: 4px;
+}
+
+.stepper-btn {
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  width: 36px;
+  height: 36px;
+  border: none;
+  border-radius: 6px;
+  cursor: pointer;
+  font-size: 18px;
+  flex-shrink: 0;
+  transition: opacity 0.15s;
+}
+
+.stepper-btn:hover {
+  opacity: 0.8;
+}
+
+.stepper-btn:active {
+  opacity: 0.6;
+}
+
+.stepper-btn-fast {
+  background: var(--btn-primary-bg);
+  color: var(--btn-primary-color);
+}
+
+.step-input {
+  width: 56px;
+  padding: 4px 2px;
+  border: 1px solid var(--border-color);
+  border-radius: 6px;
+  background: var(--color-background);
+  color: var(--color-text);
+  font-size: 15px;
+  font-weight: 600;
+  text-align: center;
+}
+
+.exercise-order-actions {
+  display: flex;
+  gap: 4px;
+  flex-shrink: 0;
+}
+
+.btn-move {
+  background: none;
+  border: none;
+  color: var(--color-text);
+  cursor: pointer;
+  padding: 4px;
+  font-size: 14px;
+  display: flex;
+  align-items: center;
+}
+
+.btn-move:disabled {
+  opacity: 0.3;
+  cursor: not-allowed;
+}
+
+.btn-move:hover:not(:disabled) {
+  color: var(--btn-primary-bg);
+}
+
+.btn-remove {
+  background: none;
+  border: none;
+  color: var(--btn-danger-bg);
+  cursor: pointer;
+  padding: 4px;
+  font-size: 14px;
+  display: flex;
+  align-items: center;
+}
+
+.btn-remove:hover {
+  opacity: 0.7;
+}
+
+.exercise-add {
+  display: flex;
+  gap: 8px;
+  align-items: flex-start;
+}
+
+.exercise-add select {
+  flex: 1;
+}
+
+.btn-sm {
+  padding: 6px 12px;
+  font-size: 13px;
+  white-space: nowrap;
+}
+
+.form-actions {
+  display: flex;
+  gap: 8px;
+  margin-top: 24px;
+}
+
+@media screen and (max-width: 400px) {
+  .exercise-order-number {
+    display: none;
+  }
+
+  .exercise-order-title {
+    flex: 1 1 auto;
+  }
+
+  .exercise-order-actions {
+    order: 2;
+  }
+
+  .form-actions {
+    flex-wrap: wrap;
+  }
+
+  .form-actions .btn {
+    flex: 1 1 auto;
+    justify-content: center;
+  }
+}
+</style>
diff --git a/src/views/ComboListView.vue b/src/views/ComboListView.vue
new file mode 100644
index 0000000..44d0ce6
--- /dev/null
+++ b/src/views/ComboListView.vue
@@ -0,0 +1,329 @@
+<script setup>
+import { ref, nextTick, onMounted, watch, computed } from 'vue'
+import { useTranslation } from 'i18next-vue'
+import { useRouter } from 'vue-router'
+import { useCombos } from '../composables/useCombos.js'
+import { useJsonExport } from '../composables/useJsonExport.js'
+import { useJsonImport } from '../composables/useJsonImport.js'
+import { useSettings } from '../composables/useSettings.js'
+import { useKeyboardShortcut } from '../composables/useKeyboardShortcut.js'
+import { useListNavigation } from '../composables/useListNavigation.js'
+import ImportDialog from '../components/ImportDialog.vue'
+
+const { t } = useTranslation()
+const router = useRouter()
+const { combos, loading, fetchAll, search } = useCombos()
+const { exportAllCombos } = useJsonExport()
+const { loadFile } = useJsonImport()
+const { settings, fetchAll: fetchSettings } = useSettings()
+const localUuid = ref('')
+
+// Import dialog state
+const showImportDialog = ref(false)
+const importEnvelope = ref(null)
+const importAsMine = ref(false)
+
+const searchQuery = ref('')
+const searching = ref(false)
+const searchInput = ref(null)
+
+onMounted(async () => {
+  fetchAll()
+  await fetchSettings()
+  localUuid.value = settings.value.user_uuid || ''
+})
+
+let searchTimeout = null
+watch(searchQuery, (query) => {
+  clearTimeout(searchTimeout)
+  const trimmed = query.trim()
+  if (!trimmed) {
+    fetchAll()
+    return
+  }
+  searchTimeout = setTimeout(() => {
+    search(trimmed)
+  }, 250)
+})
+
+function goToNew() {
+  router.push({ name: 'combo-new' })
+}
+
+useKeyboardShortcut('n', goToNew)
+
+const comboCount = computed(() => combos.value.length)
+const { focusedIndex: focusedComboIndex } = useListNavigation(comboCount, (index) => {
+  goToDetail(combos.value[index].id)
+})
+
+function goToDetail(id) {
+  router.push({ name: 'combo-detail', params: { id } })
+}
+
+function toggleSearch() {
+  searching.value = !searching.value
+  if (searching.value) {
+    nextTick(() => {
+      searchInput.value?.focus()
+    })
+  } else {
+    searchQuery.value = ''
+    fetchAll()
+  }
+}
+
+function onSearchBlur() {
+  if (!searchQuery.value.trim()) {
+    searching.value = false
+  }
+}
+
+function clearSearch() {
+  searchQuery.value = ''
+  searchInput.value?.focus()
+}
+
+async function onExport() {
+  await exportAllCombos(searchQuery.value.trim())
+}
+
+async function onImport(asMine = false) {
+  const result = await loadFile()
+  if (result.cancelled) return
+  if (result.error) {
+    window.alert(t(result.error))
+    return
+  }
+  importEnvelope.value = result.envelope
+  importAsMine.value = asMine
+  showImportDialog.value = true
+}
+
+function onImportDone() {
+  showImportDialog.value = false
+  importEnvelope.value = null
+  importAsMine.value = false
+  fetchAll()
+}
+
+function onImportClose() {
+  showImportDialog.value = false
+  importEnvelope.value = null
+  importAsMine.value = false
+}
+</script>
+
+<template>
+  <Teleport to="#actionbar-actions" defer>
+    <button
+      data-testid="combo-search-toggle"
+      :title="$t('combos.searchPlaceholder')"
+      :aria-label="$t('combos.searchPlaceholder')"
+      @click="toggleSearch"
+    >
+      <i class="bi bi-search"></i>
+    </button>
+    <button
+      data-testid="combo-export-btn"
+      :title="$t('export.combos')"
+      :aria-label="$t('export.combos')"
+      @click="onExport"
+    >
+      <i class="bi bi-download"></i>
+    </button>
+    <button
+      data-testid="combo-import-btn"
+      :title="$t('import.exercises')"
+      :aria-label="$t('import.exercises')"
+      @click="onImport(false)"
+    >
+      <i class="bi bi-upload"></i>
+    </button>
+    <button
+      data-testid="combo-import-as-mine-btn"
+      :title="$t('import.importAsMine')"
+      :aria-label="$t('import.importAsMine')"
+      @click="onImport(true)"
+    >
+      <i class="bi bi-person-check"></i>
+    </button>
+    <button
+      data-testid="combo-new-btn"
+      :title="$t('combos.new') + ' ' + $t('shortcuts.new')"
+      :aria-label="$t('combos.new')"
+      @click="goToNew"
+    >
+      <i class="bi bi-plus-lg"></i>
+    </button>
+  </Teleport>
+
+  <div class="combo-list-view">
+    <!-- Search bar -->
+    <div v-if="searching" class="search-bar" data-testid="combo-search-bar">
+      <input
+        ref="searchInput"
+        v-model="searchQuery"
+        type="text"
+        :placeholder="$t('combos.searchPlaceholder')"
+        data-testid="combo-search-input"
+        @blur="onSearchBlur"
+      />
+      <button
+        v-if="searchQuery"
+        type="button"
+        class="search-clear-btn"
+        data-testid="combo-search-clear"
+        :title="$t('common.clearSearch')"
+        :aria-label="$t('common.clearSearch')"
+        @mousedown.prevent="clearSearch"
+      >
+        <i class="bi bi-x-lg"></i>
+      </button>
+    </div>
+
+    <!-- Loading state -->
+    <p v-if="loading" class="text-muted">{{ $t('app.loading') }}</p>
+
+    <!-- Empty state -->
+    <p
+      v-else-if="combos.length === 0 && !searchQuery.trim()"
+      class="text-muted"
+      data-testid="combo-empty"
+    >
+      {{ $t('combos.empty') }}
+    </p>
+
+    <!-- No search results -->
+    <p
+      v-else-if="combos.length === 0 && searchQuery.trim()"
+      class="text-muted"
+      data-testid="combo-no-results"
+    >
+      {{ $t('combos.noResults') }}
+    </p>
+
+    <!-- Combo cards -->
+    <div
+      v-for="(combo, index) in combos"
+      :key="combo.id"
+      class="card combo-card"
+      :class="{ 'card-focused': focusedComboIndex === index }"
+      :data-testid="'combo-card-' + combo.id"
+      :data-list-index="index"
+      tabindex="0"
+      @click="goToDetail(combo.id)"
+    >
+      <div class="combo-card-header">
+        <h3 data-testid="combo-card-title">{{ combo.title }}</h3>
+        <div class="combo-card-badges">
+          <span class="badge badge-type" data-testid="combo-card-type">
+            {{ $t(`combos.types.${combo.type.toLowerCase()}`) }}
+          </span>
+          <span
+            v-if="combo.exercises && combo.exercises.length"
+            class="badge badge-info"
+            data-testid="combo-card-exercise-count"
+          >
+            {{ combo.exercises.length }} {{ $t('combos.exercises') }}
+          </span>
+        </div>
+      </div>
+    </div>
+  </div>
+
+  <ImportDialog
+    v-if="showImportDialog && importEnvelope"
+    :envelope="importEnvelope"
+    :local-uuid="localUuid"
+    :as-mine="importAsMine"
+    @done="onImportDone"
+    @close="onImportClose"
+  />
+</template>
+
+<style scoped>
+.combo-list-view {
+  max-width: 800px;
+}
+
+.search-bar {
+  position: relative;
+  margin-bottom: 16px;
+}
+
+.search-bar input {
+  padding-right: 36px;
+}
+
+.search-clear-btn {
+  position: absolute;
+  top: 50%;
+  right: 8px;
+  transform: translateY(-50%);
+  background: none;
+  border: none;
+  padding: 4px;
+  line-height: 1;
+  color: var(--front-color2);
+  cursor: pointer;
+}
+
+.combo-card {
+  cursor: pointer;
+  transition: border-color 0.15s;
+}
+
+.combo-card:hover {
+  border-color: var(--btn-primary-bg);
+}
+
+.combo-card:focus-visible {
+  border-color: var(--btn-primary-bg);
+  box-shadow: 0 0 0 2px var(--btn-primary-bg);
+  outline: none;
+}
+
+.combo-card.card-focused {
+  border-color: var(--btn-primary-bg);
+  box-shadow: 0 0 0 2px var(--btn-primary-bg);
+}
+
+.combo-card-header {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+}
+
+.combo-card-header h3 {
+  flex: 1;
+  font-size: 16px;
+  font-weight: 600;
+}
+
+.combo-card-badges {
+  display: flex;
+  gap: 6px;
+  flex-shrink: 0;
+}
+
+.badge {
+  display: inline-flex;
+  align-items: center;
+  gap: 4px;
+  padding: 2px 8px;
+  border-radius: 12px;
+  font-size: 12px;
+  background-color: var(--btn-primary-bg);
+  color: var(--btn-primary-color);
+  white-space: nowrap;
+}
+
+.badge-type {
+  background-color: var(--front-color2);
+}
+
+.badge-info {
+  background-color: var(--front-color2);
+}
+</style>
diff --git a/src/views/CombosView.vue b/src/views/CombosView.vue
new file mode 100644
index 0000000..bac8c6c
--- /dev/null
+++ b/src/views/CombosView.vue
@@ -0,0 +1,6 @@
+<template>
+  <div class="placeholder-view">
+    <h2>{{ $t('combos.title') }}</h2>
+    <p class="text-muted">{{ $t('combos.empty') }}</p>
+  </div>
+</template>
diff --git a/src/views/ExerciseDetailView.vue b/src/views/ExerciseDetailView.vue
new file mode 100644
index 0000000..9edcd14
--- /dev/null
+++ b/src/views/ExerciseDetailView.vue
@@ -0,0 +1,350 @@
+<script setup>
+import { ref, computed, onMounted } from 'vue'
+import { useTranslation } from 'i18next-vue'
+import { useRouter, useRoute } from 'vue-router'
+import { useExercises } from '../composables/useExercises.js'
+import { useJsonExport } from '../composables/useJsonExport.js'
+import { useKeyboardShortcut } from '../composables/useKeyboardShortcut.js'
+import { useOnlineStatus } from '../composables/useOnlineStatus.js'
+import { renderMarkdown } from '../utils/markdown.js'
+import { getYouTubeId } from '../utils/youtube.js'
+import { executionLogRepository } from '../db/repositories/executionLogRepository.js'
+
+const { t } = useTranslation()
+const router = useRouter()
+const route = useRoute()
+const { getById, remove } = useExercises()
+const { exportExercise } = useJsonExport()
+const { isOnline } = useOnlineStatus()
+
+const exercise = ref(null)
+const loading = ref(true)
+
+const exerciseId = computed(() => route.params.id)
+
+onMounted(async () => {
+  const data = await getById(exerciseId.value)
+  if (!data) {
+    router.replace({ name: 'exercises' })
+    return
+  }
+  exercise.value = data
+  loading.value = false
+})
+
+function goToEdit() {
+  router.push({ name: 'exercise-edit', params: { id: exerciseId.value } })
+}
+
+useKeyboardShortcut('e', goToEdit)
+useKeyboardShortcut('escape', goBack, false)
+
+function goBack() {
+  router.push({ name: 'exercises' })
+}
+
+async function onDelete() {
+  if (!exercise.value) return
+  const count = await executionLogRepository.countItemsByExercise(exerciseId.value)
+  const msg =
+    count > 0
+      ? t('exercises.deleteConfirmWithHistory', { title: exercise.value.title, count })
+      : t('exercises.deleteConfirm', { title: exercise.value.title })
+  const confirmed = window.confirm(msg)
+  if (!confirmed) return
+  await remove(exerciseId.value)
+  router.push({ name: 'exercises' })
+}
+
+async function onExport() {
+  await exportExercise(exerciseId.value)
+}
+</script>
+
+<template>
+  <Teleport to="#actionbar-actions" defer>
+    <button
+      data-testid="exercise-back-btn"
+      :title="$t('exercises.title') + ' ' + $t('shortcuts.back')"
+      :aria-label="$t('exercises.title')"
+      @click="goBack"
+    >
+      <i class="bi bi-arrow-left"></i>
+    </button>
+    <button
+      data-testid="exercise-export-single-btn"
+      :title="$t('export.exercise')"
+      :aria-label="$t('export.exercise')"
+      @click="onExport"
+    >
+      <i class="bi bi-download"></i>
+    </button>
+    <button
+      data-testid="exercise-edit-btn"
+      :title="$t('exercises.edit') + ' ' + $t('shortcuts.edit')"
+      :aria-label="$t('exercises.edit')"
+      @click="goToEdit"
+    >
+      <i class="bi bi-pencil"></i>
+    </button>
+    <button
+      data-testid="exercise-delete-btn"
+      :title="$t('exercises.delete')"
+      :aria-label="$t('exercises.delete')"
+      @click="onDelete"
+    >
+      <i class="bi bi-trash"></i>
+    </button>
+  </Teleport>
+
+  <div class="exercise-detail-view">
+    <p v-if="loading" class="text-muted">{{ $t('app.loading') }}</p>
+
+    <template v-else-if="exercise">
+      <!-- Title -->
+      <h2 data-testid="exercise-detail-title">{{ exercise.title }}</h2>
+
+      <!-- Description -->
+      <div
+        v-if="exercise.description"
+        class="exercise-description"
+        data-testid="exercise-detail-description"
+        v-html="renderMarkdown(exercise.description)"
+      />
+
+      <!-- Badges -->
+      <div class="exercise-meta">
+        <span v-if="exercise.default_reps" class="badge" data-testid="exercise-detail-reps">
+          {{ exercise.default_reps }} {{ $t('exercises.reps') }}
+        </span>
+        <span v-if="exercise.default_weight" class="badge" data-testid="exercise-detail-weight">
+          {{ exercise.default_weight }} {{ $t('exercises.weight') }}
+        </span>
+        <span
+          v-if="exercise.asymmetric"
+          class="badge badge-info"
+          data-testid="exercise-detail-asymmetric"
+        >
+          <i class="bi bi-arrow-left-right"></i> {{ $t('exercises.asymmetricLabel') }}
+        </span>
+        <span
+          v-if="exercise.asymmetric"
+          class="badge badge-info"
+          data-testid="exercise-detail-alternate"
+        >
+          {{ exercise.alternate ? $t('exercises.alternateLabel') : '' }}
+        </span>
+      </div>
+
+      <!-- Images -->
+      <div v-if="exercise.image_urls && exercise.image_urls.length" class="media-section">
+        <h3>Images</h3>
+        <hr />
+        <div class="image-gallery">
+          <div v-for="(url, i) in exercise.image_urls" :key="'img-' + i" class="image-item">
+            <img
+              :src="url"
+              :alt="exercise.title + ' image ' + (i + 1)"
+              :data-testid="'exercise-detail-image-' + i"
+              loading="lazy"
+              @error="($event) => ($event.target.style.display = 'none')"
+            />
+          </div>
+        </div>
+      </div>
+
+      <!-- Videos -->
+      <div v-if="exercise.video_urls && exercise.video_urls.length" class="media-section">
+        <h3>Videos</h3>
+        <hr />
+        <p v-if="!isOnline" class="video-offline">
+          <i class="bi bi-wifi-off"></i> {{ $t('exercises.videoOffline') }}
+        </p>
+        <div v-else class="video-gallery">
+          <div v-for="(url, i) in exercise.video_urls" :key="'vid-' + i" class="video-item">
+            <!-- YouTube thumbnail link -->
+            <a
+              v-if="getYouTubeId(url)"
+              :href="url"
+              target="_blank"
+              rel="noopener noreferrer"
+              :data-testid="'exercise-detail-video-' + i"
+              class="youtube-thumb"
+            >
+              <img
+                :src="'https://img.youtube.com/vi/' + getYouTubeId(url) + '/mqdefault.jpg'"
+                :alt="exercise.title + ' video ' + (i + 1)"
+                loading="lazy"
+              />
+              <span class="youtube-play"><i class="bi bi-play-circle-fill"></i></span>
+            </a>
+            <!-- Generic link fallback -->
+            <a
+              v-else
+              :href="url"
+              target="_blank"
+              rel="noopener noreferrer"
+              :data-testid="'exercise-detail-video-' + i"
+              class="video-link"
+            >
+              <i class="bi bi-play-circle"></i> {{ url }}
+            </a>
+          </div>
+        </div>
+      </div>
+    </template>
+  </div>
+</template>
+
+<style scoped>
+.exercise-detail-view {
+  max-width: 800px;
+}
+
+.exercise-detail-view h2 {
+  font-size: 22px;
+  margin-bottom: 8px;
+}
+
+.exercise-description {
+  font-size: 15px;
+  line-height: 1.5;
+  margin-bottom: 12px;
+}
+
+.exercise-description :deep(p) {
+  margin: 0 0 8px;
+}
+
+.exercise-description :deep(p:last-child) {
+  margin-bottom: 0;
+}
+
+.exercise-description :deep(ul),
+.exercise-description :deep(ol) {
+  margin: 0 0 8px;
+  padding-left: 20px;
+}
+
+.exercise-description :deep(code) {
+  font-family: monospace;
+  font-size: 13px;
+  background: var(--color-surface, #f4f4f4);
+  padding: 1px 4px;
+  border-radius: 3px;
+}
+
+.exercise-description :deep(pre) {
+  background: var(--color-surface, #f4f4f4);
+  padding: 8px;
+  border-radius: 4px;
+  overflow-x: auto;
+  margin-bottom: 8px;
+}
+
+.exercise-description :deep(strong) {
+  font-weight: 600;
+}
+
+.exercise-meta {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 8px;
+  margin-bottom: 20px;
+}
+
+.badge {
+  display: inline-flex;
+  align-items: center;
+  gap: 4px;
+  padding: 4px 10px;
+  border-radius: 12px;
+  font-size: 13px;
+  background-color: var(--btn-primary-bg);
+  color: var(--btn-primary-color);
+}
+
+.badge-info {
+  background-color: var(--front-color2);
+}
+
+.media-section {
+  margin-bottom: 20px;
+}
+
+.media-section h3 {
+  font-size: 16px;
+  font-weight: 600;
+  margin-bottom: 10px;
+}
+
+.image-gallery {
+  display: grid;
+  grid-template-columns: repeat(auto-fill, minmax(200px, 1fr));
+  gap: 12px;
+}
+
+.image-item img {
+  width: 100%;
+  border-radius: 8px;
+  border: 1px solid var(--border-color);
+}
+
+.video-gallery {
+  display: flex;
+  flex-direction: column;
+  gap: 12px;
+}
+
+.youtube-thumb {
+  position: relative;
+  display: inline-block;
+  border-radius: 8px;
+  overflow: hidden;
+  border: 1px solid var(--border-color);
+}
+
+.youtube-thumb img {
+  display: block;
+  width: 320px;
+  max-width: 100%;
+}
+
+.youtube-play {
+  position: absolute;
+  inset: 0;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  font-size: 48px;
+  color: white;
+  background: rgba(0, 0, 0, 0.3);
+  opacity: 0;
+  transition: opacity 0.15s;
+}
+
+.youtube-thumb:hover .youtube-play {
+  opacity: 1;
+}
+
+.video-link {
+  display: inline-flex;
+  align-items: center;
+  gap: 6px;
+  padding: 8px 12px;
+  border: 1px solid var(--border-color);
+  border-radius: 8px;
+  font-size: 14px;
+}
+
+.video-offline {
+  display: inline-flex;
+  align-items: center;
+  gap: 6px;
+  padding: 8px 12px;
+  border: 1px solid var(--border-color);
+  border-radius: 8px;
+  font-size: 14px;
+  color: var(--text-muted, #888);
+}
+</style>
diff --git a/src/views/ExerciseFormView.vue b/src/views/ExerciseFormView.vue
new file mode 100644
index 0000000..d67d796
--- /dev/null
+++ b/src/views/ExerciseFormView.vue
@@ -0,0 +1,678 @@
+<script setup>
+import { ref, computed, onMounted, watch } from 'vue'
+import { useTranslation } from 'i18next-vue'
+import { useRouter, useRoute } from 'vue-router'
+import { useExercises } from '../composables/useExercises.js'
+import { useSettings } from '../composables/useSettings.js'
+import { validateRequired, validateMin, validateUrl } from '../utils/validation.js'
+import { useKeyboardShortcut } from '../composables/useKeyboardShortcut.js'
+
+const { t } = useTranslation()
+
+function te(err) {
+  if (!err) return ''
+  if (typeof err === 'object') return t(err.key, err.params)
+  return t(err)
+}
+const router = useRouter()
+const route = useRoute()
+const { create, update, getById } = useExercises()
+const { get: getSetting } = useSettings()
+
+const isEdit = computed(() => route.name === 'exercise-edit')
+const exerciseId = computed(() => route.params.id)
+
+// Form fields
+const title = ref('')
+const description = ref('')
+const asymmetric = ref(false)
+const alternate = ref(false)
+const imageUrls = ref([])
+const videoUrls = ref([])
+const defaultReps = ref(0)
+const defaultWeight = ref(0)
+
+// Validation errors
+const errors = ref({})
+const saving = ref(false)
+
+// New URL inputs
+const newImageUrl = ref('')
+const newVideoUrl = ref('')
+
+onMounted(async () => {
+  if (isEdit.value && exerciseId.value) {
+    const exercise = await getById(exerciseId.value)
+    if (!exercise) {
+      router.replace({ name: 'exercises' })
+      return
+    }
+    title.value = exercise.title
+    description.value = exercise.description || ''
+    asymmetric.value = exercise.asymmetric
+    alternate.value = exercise.alternate
+    imageUrls.value = [...(exercise.image_urls || [])]
+    videoUrls.value = [...(exercise.video_urls || [])]
+    defaultReps.value = exercise.default_reps || 0
+    defaultWeight.value = exercise.default_weight || 0
+  }
+})
+
+watch(asymmetric, (val) => {
+  if (val && defaultReps.value > 0 && defaultReps.value % 2 !== 0) {
+    defaultReps.value++
+  }
+})
+
+function onDefaultRepsChange() {
+  if (asymmetric.value && defaultReps.value > 0 && defaultReps.value % 2 !== 0) {
+    defaultReps.value++
+  }
+}
+
+function validate() {
+  const e = {}
+  const titleErr = validateRequired(title.value)
+  if (titleErr) e.title = titleErr
+
+  const repsErr = validateMin(defaultReps.value, 0)
+  if (repsErr) e.defaultReps = repsErr
+
+  const weightErr = validateMin(defaultWeight.value, 0)
+  if (weightErr) e.defaultWeight = weightErr
+
+  // Validate existing URLs in lists
+  for (let i = 0; i < imageUrls.value.length; i++) {
+    const urlErr = validateUrl(imageUrls.value[i])
+    if (urlErr) {
+      e[`imageUrl_${i}`] = urlErr
+    }
+  }
+  for (let i = 0; i < videoUrls.value.length; i++) {
+    const urlErr = validateUrl(videoUrls.value[i])
+    if (urlErr) {
+      e[`videoUrl_${i}`] = urlErr
+    }
+  }
+
+  errors.value = e
+  return Object.keys(e).length === 0
+}
+
+function addImageUrl() {
+  const urlErr = validateUrl(newImageUrl.value)
+  if (urlErr) {
+    errors.value = { ...errors.value, newImageUrl: urlErr }
+    return
+  }
+  if (!newImageUrl.value.trim()) return
+  imageUrls.value.push(newImageUrl.value.trim())
+  newImageUrl.value = ''
+  // Clear any previous error on this field
+  const { newImageUrl: _, ...rest } = errors.value
+  errors.value = rest
+}
+
+function removeImageUrl(index) {
+  imageUrls.value.splice(index, 1)
+}
+
+function addVideoUrl() {
+  const urlErr = validateUrl(newVideoUrl.value)
+  if (urlErr) {
+    errors.value = { ...errors.value, newVideoUrl: urlErr }
+    return
+  }
+  if (!newVideoUrl.value.trim()) return
+  videoUrls.value.push(newVideoUrl.value.trim())
+  newVideoUrl.value = ''
+  const { newVideoUrl: _, ...rest } = errors.value
+  errors.value = rest
+}
+
+function removeVideoUrl(index) {
+  videoUrls.value.splice(index, 1)
+}
+
+async function onSave() {
+  if (!validate()) return
+
+  saving.value = true
+  try {
+    const userUuid = await getSetting('user_uuid')
+    const data = {
+      title: title.value.trim(),
+      description: description.value.trim(),
+      asymmetric: asymmetric.value,
+      alternate: asymmetric.value ? alternate.value : false,
+      image_urls: imageUrls.value,
+      video_urls: videoUrls.value,
+      default_reps: Number(defaultReps.value) || 0,
+      default_weight: Number(defaultWeight.value) || 0,
+      created_by: userUuid,
+    }
+
+    if (isEdit.value) {
+      await update(exerciseId.value, data)
+      router.push({ name: 'exercise-detail', params: { id: exerciseId.value } })
+    } else {
+      const id = await create(data)
+      router.push({ name: 'exercise-detail', params: { id } })
+    }
+  } catch (e) {
+    // Handle unique constraint violation on title
+    if (e.message && e.message.includes('UNIQUE')) {
+      errors.value = { ...errors.value, title: 'validation.titleTaken' }
+    } else {
+      errors.value = { ...errors.value, save: e.message }
+    }
+  } finally {
+    saving.value = false
+  }
+}
+
+useKeyboardShortcut('enter', onSave, { ctrl: true, ignoreInputs: false })
+useKeyboardShortcut('escape', onCancel, { ignoreInputs: false })
+
+function onCancel() {
+  if (isEdit.value) {
+    router.push({ name: 'exercise-detail', params: { id: exerciseId.value } })
+  } else {
+    router.push({ name: 'exercises' })
+  }
+}
+</script>
+
+<template>
+  <Teleport to="#actionbar-actions" defer>
+    <button
+      data-testid="exercise-form-cancel"
+      :title="$t('exercises.form.cancel')"
+      :aria-label="$t('exercises.form.cancel')"
+      @click="onCancel"
+    >
+      <i class="bi bi-x-lg"></i>
+    </button>
+  </Teleport>
+
+  <div class="exercise-form-view">
+    <h2 data-testid="exercise-form-heading">
+      {{ isEdit ? $t('exercises.edit') : $t('exercises.new') }}
+    </h2>
+
+    <form novalidate @submit.prevent="onSave">
+      <!-- Title -->
+      <div class="form-group">
+        <label for="exercise-title">{{ $t('exercises.form.title') }} *</label>
+        <input
+          id="exercise-title"
+          v-model="title"
+          data-testid="exercise-title"
+          type="text"
+          :placeholder="$t('exercises.form.titlePlaceholder')"
+          :class="{ 'input-error': errors.title }"
+          required
+          aria-required="true"
+          :aria-describedby="errors.title ? 'exercise-title-error' : undefined"
+        />
+        <p
+          v-if="errors.title"
+          id="exercise-title-error"
+          role="alert"
+          class="field-error"
+          data-testid="exercise-title-error"
+        >
+          {{ $t(errors.title) }}
+        </p>
+      </div>
+
+      <!-- Description -->
+      <div class="form-group">
+        <label for="exercise-description">
+          {{ $t('exercises.form.description') }}
+          <span class="field-hint">{{ $t('common.markdownHint') }}</span>
+        </label>
+        <textarea
+          id="exercise-description"
+          v-model="description"
+          data-testid="exercise-description"
+          :placeholder="$t('exercises.form.descriptionPlaceholder')"
+          rows="3"
+        ></textarea>
+      </div>
+
+      <!-- Asymmetric -->
+      <div class="form-group">
+        <label class="checkbox-label">
+          <input v-model="asymmetric" type="checkbox" data-testid="exercise-asymmetric" />
+          {{ $t('exercises.form.asymmetric') }}
+        </label>
+      </div>
+
+      <!-- Alternate (only visible when asymmetric) -->
+      <div v-if="asymmetric" class="form-group form-sub-group">
+        <label class="radio-label">
+          <input
+            v-model="alternate"
+            type="radio"
+            name="alternate"
+            :value="true"
+            data-testid="exercise-alternate-true"
+          />
+          {{ $t('exercises.form.alternate') }}
+        </label>
+        <label class="radio-label">
+          <input
+            v-model="alternate"
+            type="radio"
+            name="alternate"
+            :value="false"
+            data-testid="exercise-alternate-false"
+          />
+          {{ $t('exercises.form.alternateFalse') }}
+        </label>
+      </div>
+
+      <!-- Default Reps -->
+      <div class="form-group">
+        <label for="exercise-reps">{{ $t('exercises.form.defaultReps') }}</label>
+        <div class="stepper">
+          <button
+            type="button"
+            class="stepper-btn btn-primary"
+            :aria-label="'-1 ' + $t('exercises.form.defaultReps')"
+            @click="defaultReps = Math.max(0, defaultReps - (asymmetric ? 2 : 1))"
+          >
+            <i class="bi bi-dash-circle-fill"></i>
+          </button>
+          <input
+            id="exercise-reps"
+            v-model.number="defaultReps"
+            data-testid="exercise-reps"
+            type="number"
+            min="0"
+            :step="asymmetric ? 2 : 1"
+            class="step-input"
+            :class="{ 'input-error': errors.defaultReps }"
+            :aria-describedby="errors.defaultReps ? 'exercise-reps-error' : undefined"
+            @change="onDefaultRepsChange"
+          />
+          <button
+            type="button"
+            class="stepper-btn btn-primary"
+            :aria-label="'+1 ' + $t('exercises.form.defaultReps')"
+            @click="defaultReps += asymmetric ? 2 : 1"
+          >
+            <i class="bi bi-plus-circle-fill"></i>
+          </button>
+          <button
+            type="button"
+            class="stepper-btn stepper-btn-fast"
+            :aria-label="'+5 ' + $t('exercises.form.defaultReps')"
+            @click="defaultReps += asymmetric ? 10 : 5"
+          >
+            <i class="bi bi-forward-fill"></i>
+          </button>
+        </div>
+        <p
+          v-if="errors.defaultReps"
+          id="exercise-reps-error"
+          role="alert"
+          class="field-error"
+          data-testid="exercise-reps-error"
+        >
+          {{ te(errors.defaultReps) }}
+        </p>
+        <p v-if="asymmetric" class="field-hint">{{ $t('exercises.evenRepsHint') }}</p>
+      </div>
+
+      <!-- Default Weight -->
+      <div class="form-group">
+        <label for="exercise-weight">{{ $t('exercises.form.defaultWeight') }}</label>
+        <div class="stepper">
+          <button
+            type="button"
+            class="stepper-btn btn-primary"
+            :aria-label="'-0.5 ' + $t('exercises.form.defaultWeight')"
+            @click="defaultWeight = Math.max(0, +(defaultWeight - 0.5).toFixed(1))"
+          >
+            <i class="bi bi-dash-circle-fill"></i>
+          </button>
+          <input
+            id="exercise-weight"
+            v-model.number="defaultWeight"
+            data-testid="exercise-weight"
+            type="number"
+            min="0"
+            step="0.5"
+            class="step-input"
+            :class="{ 'input-error': errors.defaultWeight }"
+            :aria-describedby="errors.defaultWeight ? 'exercise-weight-error' : undefined"
+          />
+          <button
+            type="button"
+            class="stepper-btn btn-primary"
+            :aria-label="'+0.5 ' + $t('exercises.form.defaultWeight')"
+            @click="defaultWeight = +(defaultWeight + 0.5).toFixed(1)"
+          >
+            <i class="bi bi-plus-circle-fill"></i>
+          </button>
+          <button
+            type="button"
+            class="stepper-btn stepper-btn-fast"
+            :aria-label="'+1 ' + $t('exercises.form.defaultWeight')"
+            @click="defaultWeight = +(defaultWeight + 1).toFixed(1)"
+          >
+            <i class="bi bi-forward-fill"></i>
+          </button>
+        </div>
+        <p
+          v-if="errors.defaultWeight"
+          id="exercise-weight-error"
+          role="alert"
+          class="field-error"
+          data-testid="exercise-weight-error"
+        >
+          {{ te(errors.defaultWeight) }}
+        </p>
+      </div>
+
+      <!-- Image URLs -->
+      <div class="form-group">
+        <label>{{ $t('exercises.form.imageUrls') }}</label>
+        <ul v-if="imageUrls.length" class="url-list">
+          <li v-for="(url, i) in imageUrls" :key="'img-' + i" class="url-item">
+            <span class="url-text">{{ url }}</span>
+            <button
+              type="button"
+              class="btn-remove"
+              :data-testid="'exercise-remove-image-' + i"
+              @click="removeImageUrl(i)"
+            >
+              <i class="bi bi-trash"></i>
+            </button>
+            <p v-if="errors['imageUrl_' + i]" class="field-error">
+              {{ $t(errors['imageUrl_' + i]) }}
+            </p>
+          </li>
+        </ul>
+        <div class="url-add">
+          <input
+            v-model="newImageUrl"
+            type="url"
+            :placeholder="$t('exercises.form.urlPlaceholder')"
+            data-testid="exercise-new-image-url"
+            :class="{ 'input-error': errors.newImageUrl }"
+            @keyup.enter.prevent="addImageUrl"
+          />
+          <button
+            type="button"
+            class="btn btn-primary btn-sm"
+            data-testid="exercise-add-image-url"
+            @click="addImageUrl"
+          >
+            <i class="bi bi-plus"></i> {{ $t('exercises.form.addUrl') }}
+          </button>
+        </div>
+        <p v-if="errors.newImageUrl" class="field-error" data-testid="exercise-image-url-error">
+          {{ $t(errors.newImageUrl) }}
+        </p>
+      </div>
+
+      <!-- Video URLs -->
+      <div class="form-group">
+        <label>{{ $t('exercises.form.videoUrls') }}</label>
+        <ul v-if="videoUrls.length" class="url-list">
+          <li v-for="(url, i) in videoUrls" :key="'vid-' + i" class="url-item">
+            <span class="url-text">{{ url }}</span>
+            <button
+              type="button"
+              class="btn-remove"
+              :data-testid="'exercise-remove-video-' + i"
+              @click="removeVideoUrl(i)"
+            >
+              <i class="bi bi-trash"></i>
+            </button>
+            <p v-if="errors['videoUrl_' + i]" class="field-error">
+              {{ $t(errors['videoUrl_' + i]) }}
+            </p>
+          </li>
+        </ul>
+        <div class="url-add">
+          <input
+            v-model="newVideoUrl"
+            type="url"
+            :placeholder="$t('exercises.form.urlPlaceholder')"
+            data-testid="exercise-new-video-url"
+            :class="{ 'input-error': errors.newVideoUrl }"
+            @keyup.enter.prevent="addVideoUrl"
+          />
+          <button
+            type="button"
+            class="btn btn-primary btn-sm"
+            data-testid="exercise-add-video-url"
+            @click="addVideoUrl"
+          >
+            <i class="bi bi-plus"></i> {{ $t('exercises.form.addUrl') }}
+          </button>
+        </div>
+        <p v-if="errors.newVideoUrl" class="field-error" data-testid="exercise-video-url-error">
+          {{ $t(errors.newVideoUrl) }}
+        </p>
+      </div>
+
+      <!-- Save error -->
+      <p v-if="errors.save" class="field-error" data-testid="exercise-save-error">
+        {{ errors.save }}
+      </p>
+
+      <!-- Actions -->
+      <div class="form-actions">
+        <button
+          type="submit"
+          class="btn btn-primary"
+          data-testid="exercise-save"
+          :disabled="saving"
+          :title="$t('exercises.form.save') + ' ' + $t('shortcuts.save')"
+        >
+          <i class="bi bi-check-lg"></i>
+          {{ $t('exercises.form.save') }}
+        </button>
+        <button type="button" class="btn" data-testid="exercise-cancel" @click="onCancel">
+          {{ $t('exercises.form.cancel') }}
+        </button>
+      </div>
+    </form>
+  </div>
+</template>
+
+<style scoped>
+.exercise-form-view {
+  max-width: 600px;
+}
+
+.exercise-form-view h2 {
+  margin-bottom: 16px;
+  font-size: 20px;
+}
+
+.form-group {
+  margin-bottom: 16px;
+}
+
+.form-group label {
+  display: flex;
+  align-items: baseline;
+  gap: 6px;
+  font-weight: 600;
+  font-size: 14px;
+  margin-bottom: 4px;
+}
+
+.field-hint {
+  font-weight: 400;
+  font-size: 11px;
+  opacity: 0.55;
+}
+
+.form-sub-group {
+  padding-left: 24px;
+  display: flex;
+  flex-direction: column;
+  gap: 6px;
+}
+
+.checkbox-label,
+.radio-label {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+  font-weight: 400;
+  cursor: pointer;
+}
+
+.checkbox-label input,
+.radio-label input {
+  width: auto;
+  margin: 0;
+}
+
+.input-error {
+  border-color: var(--btn-danger-bg) !important;
+}
+
+.stepper {
+  display: flex;
+  align-items: center;
+  gap: 4px;
+}
+
+.stepper-btn {
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  width: 44px;
+  height: 44px;
+  border: none;
+  border-radius: 8px;
+  cursor: pointer;
+  font-size: 22px;
+  flex-shrink: 0;
+  transition: opacity 0.15s;
+}
+
+.stepper-btn:hover {
+  opacity: 0.8;
+}
+
+.stepper-btn:active {
+  opacity: 0.6;
+}
+
+.stepper-btn-fast {
+  background: var(--btn-primary-bg);
+  color: var(--btn-primary-color);
+}
+
+.step-input {
+  width: 64px;
+  padding: 6px 4px;
+  border: 1px solid var(--border-color);
+  border-radius: 6px;
+  background: var(--color-background);
+  color: var(--color-text);
+  font-size: 18px;
+  font-weight: 600;
+  text-align: center;
+}
+
+.field-error {
+  color: var(--btn-danger-bg);
+  font-size: 13px;
+  margin: 4px 0 0;
+}
+
+.field-hint {
+  color: var(--color-text-muted);
+  font-size: 12px;
+  margin: 4px 0 0;
+}
+
+.url-list {
+  list-style: none;
+  padding: 0;
+  margin: 0 0 8px;
+}
+
+.url-item {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+  padding: 4px 0;
+  border-bottom: 1px solid var(--border-color);
+}
+
+.url-text {
+  flex: 1;
+  font-size: 13px;
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+}
+
+.btn-remove {
+  background: none;
+  border: none;
+  color: var(--btn-danger-bg);
+  cursor: pointer;
+  padding: 4px;
+  font-size: 14px;
+  display: flex;
+  align-items: center;
+}
+
+.btn-remove:hover {
+  opacity: 0.7;
+}
+
+.url-add {
+  display: flex;
+  gap: 8px;
+  align-items: flex-start;
+}
+
+.url-add input {
+  flex: 1;
+}
+
+.btn-sm {
+  padding: 6px 12px;
+  font-size: 13px;
+  white-space: nowrap;
+}
+
+.form-actions {
+  display: flex;
+  gap: 8px;
+  margin-top: 24px;
+}
+
+@media screen and (max-width: 400px) {
+  .url-add {
+    flex-wrap: wrap;
+  }
+
+  .url-add input {
+    flex: 1 1 100%;
+  }
+
+  .form-actions {
+    flex-wrap: wrap;
+  }
+
+  .form-actions .btn {
+    flex: 1 1 auto;
+    justify-content: center;
+  }
+}
+</style>
diff --git a/src/views/ExerciseListView.vue b/src/views/ExerciseListView.vue
new file mode 100644
index 0000000..12624e7
--- /dev/null
+++ b/src/views/ExerciseListView.vue
@@ -0,0 +1,329 @@
+<script setup>
+import { ref, nextTick, onMounted, watch, computed } from 'vue'
+import { useTranslation } from 'i18next-vue'
+import { useRouter } from 'vue-router'
+import { useExercises } from '../composables/useExercises.js'
+import { useJsonExport } from '../composables/useJsonExport.js'
+import { useJsonImport } from '../composables/useJsonImport.js'
+import { useSettings } from '../composables/useSettings.js'
+import { useKeyboardShortcut } from '../composables/useKeyboardShortcut.js'
+import { useListNavigation } from '../composables/useListNavigation.js'
+import ImportDialog from '../components/ImportDialog.vue'
+
+const { t } = useTranslation()
+const router = useRouter()
+const { exercises, loading, fetchAll, search } = useExercises()
+const { exportAllExercises } = useJsonExport()
+const { loadFile } = useJsonImport()
+const { settings, fetchAll: fetchSettings } = useSettings()
+
+const searchQuery = ref('')
+const searching = ref(false)
+const searchInput = ref(null)
+
+// Import dialog state
+const showImportDialog = ref(false)
+const importEnvelope = ref(null)
+const importAsMine = ref(false)
+const localUuid = ref('')
+
+onMounted(async () => {
+  fetchAll()
+  await fetchSettings()
+  localUuid.value = settings.value.user_uuid || ''
+})
+
+let searchTimeout = null
+watch(searchQuery, (query) => {
+  clearTimeout(searchTimeout)
+  const trimmed = query.trim()
+  if (!trimmed) {
+    fetchAll()
+    return
+  }
+  searchTimeout = setTimeout(() => {
+    search(trimmed)
+  }, 250)
+})
+
+function goToNew() {
+  router.push({ name: 'exercise-new' })
+}
+
+useKeyboardShortcut('n', goToNew)
+
+const exerciseCount = computed(() => exercises.value.length)
+const { focusedIndex: focusedExerciseIndex } = useListNavigation(exerciseCount, (index) => {
+  goToDetail(exercises.value[index].id)
+})
+
+function goToDetail(id) {
+  router.push({ name: 'exercise-detail', params: { id } })
+}
+
+function toggleSearch() {
+  searching.value = !searching.value
+  if (searching.value) {
+    nextTick(() => {
+      searchInput.value?.focus()
+    })
+  } else {
+    searchQuery.value = ''
+    fetchAll()
+  }
+}
+
+function onSearchBlur() {
+  if (!searchQuery.value.trim()) {
+    searching.value = false
+  }
+}
+
+function clearSearch() {
+  searchQuery.value = ''
+  searchInput.value?.focus()
+}
+
+async function onExport() {
+  await exportAllExercises(searchQuery.value.trim())
+}
+
+async function onImport(asMine = false) {
+  const result = await loadFile()
+  if (result.cancelled) return
+  if (result.error) {
+    window.alert(t(result.error))
+    return
+  }
+  importEnvelope.value = result.envelope
+  importAsMine.value = asMine
+  showImportDialog.value = true
+}
+
+function onImportDone() {
+  showImportDialog.value = false
+  importEnvelope.value = null
+  importAsMine.value = false
+  fetchAll()
+}
+
+function onImportClose() {
+  showImportDialog.value = false
+  importEnvelope.value = null
+  importAsMine.value = false
+}
+</script>
+
+<template>
+  <Teleport to="#actionbar-actions" defer>
+    <button
+      data-testid="exercise-search-toggle"
+      :title="$t('exercises.searchPlaceholder')"
+      :aria-label="$t('exercises.searchPlaceholder')"
+      @click="toggleSearch"
+    >
+      <i class="bi bi-search"></i>
+    </button>
+    <button
+      data-testid="exercise-export-btn"
+      :title="$t('export.exercises')"
+      :aria-label="$t('export.exercises')"
+      @click="onExport"
+    >
+      <i class="bi bi-download"></i>
+    </button>
+    <button
+      data-testid="exercise-import-btn"
+      :title="$t('import.exercises')"
+      :aria-label="$t('import.exercises')"
+      @click="onImport(false)"
+    >
+      <i class="bi bi-upload"></i>
+    </button>
+    <button
+      data-testid="exercise-import-as-mine-btn"
+      :title="$t('import.importAsMine')"
+      :aria-label="$t('import.importAsMine')"
+      @click="onImport(true)"
+    >
+      <i class="bi bi-person-check"></i>
+    </button>
+    <button
+      data-testid="exercise-new-btn"
+      :title="$t('exercises.new') + ' ' + $t('shortcuts.new')"
+      :aria-label="$t('exercises.new')"
+      @click="goToNew"
+    >
+      <i class="bi bi-plus-lg"></i>
+    </button>
+  </Teleport>
+
+  <div class="exercise-list-view">
+    <!-- Search bar -->
+    <div v-if="searching" class="search-bar" data-testid="exercise-search-bar">
+      <input
+        ref="searchInput"
+        v-model="searchQuery"
+        type="text"
+        :placeholder="$t('exercises.searchPlaceholder')"
+        data-testid="exercise-search-input"
+        @blur="onSearchBlur"
+      />
+      <button
+        v-if="searchQuery"
+        type="button"
+        class="search-clear-btn"
+        data-testid="exercise-search-clear"
+        :title="$t('common.clearSearch')"
+        :aria-label="$t('common.clearSearch')"
+        @mousedown.prevent="clearSearch"
+      >
+        <i class="bi bi-x-lg"></i>
+      </button>
+    </div>
+
+    <!-- Loading state -->
+    <p v-if="loading" class="text-muted">{{ $t('app.loading') }}</p>
+
+    <!-- Empty state -->
+    <p
+      v-else-if="exercises.length === 0 && !searchQuery.trim()"
+      class="text-muted"
+      data-testid="exercise-empty"
+    >
+      {{ $t('exercises.empty') }}
+    </p>
+
+    <!-- No search results -->
+    <p
+      v-else-if="exercises.length === 0 && searchQuery.trim()"
+      class="text-muted"
+      data-testid="exercise-no-results"
+    >
+      {{ $t('exercises.noResults') }}
+    </p>
+
+    <!-- Exercise cards -->
+    <div
+      v-for="(exercise, index) in exercises"
+      :key="exercise.id"
+      class="card exercise-card"
+      :class="{ 'card-focused': focusedExerciseIndex === index }"
+      :data-testid="'exercise-card-' + exercise.id"
+      :data-list-index="index"
+      tabindex="0"
+      @click="goToDetail(exercise.id)"
+    >
+      <div class="exercise-card-header">
+        <h3 data-testid="exercise-card-title">{{ exercise.title }}</h3>
+        <div class="exercise-card-badges">
+          <span v-if="exercise.default_reps" class="badge" data-testid="exercise-card-reps">
+            {{ exercise.default_reps }} {{ $t('exercises.reps') }}
+          </span>
+          <span v-if="exercise.default_weight" class="badge" data-testid="exercise-card-weight">
+            {{ exercise.default_weight }} {{ $t('exercises.weight') }}
+          </span>
+          <span
+            v-if="exercise.asymmetric"
+            class="badge badge-info"
+            data-testid="exercise-card-asymmetric"
+          >
+            <i class="bi bi-arrow-left-right"></i>
+          </span>
+        </div>
+      </div>
+    </div>
+
+    <!-- Import dialog -->
+    <ImportDialog
+      v-if="showImportDialog && importEnvelope"
+      :envelope="importEnvelope"
+      :local-uuid="localUuid"
+      :as-mine="importAsMine"
+      @done="onImportDone"
+      @close="onImportClose"
+    />
+  </div>
+</template>
+
+<style scoped>
+.exercise-list-view {
+  max-width: 800px;
+}
+
+.search-bar {
+  position: relative;
+  margin-bottom: 16px;
+}
+
+.search-bar input {
+  padding-right: 36px;
+}
+
+.search-clear-btn {
+  position: absolute;
+  top: 50%;
+  right: 8px;
+  transform: translateY(-50%);
+  background: none;
+  border: none;
+  padding: 4px;
+  line-height: 1;
+  color: var(--front-color2);
+  cursor: pointer;
+}
+
+.exercise-card {
+  cursor: pointer;
+  transition: border-color 0.15s;
+}
+
+.exercise-card:hover {
+  border-color: var(--btn-primary-bg);
+}
+
+.exercise-card:focus-visible {
+  border-color: var(--btn-primary-bg);
+  box-shadow: 0 0 0 2px var(--btn-primary-bg);
+  outline: none;
+}
+
+.exercise-card.card-focused {
+  border-color: var(--btn-primary-bg);
+  box-shadow: 0 0 0 2px var(--btn-primary-bg);
+}
+
+.exercise-card-header {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+}
+
+.exercise-card-header h3 {
+  flex: 1;
+  font-size: 16px;
+  font-weight: 600;
+}
+
+.exercise-card-badges {
+  display: flex;
+  gap: 6px;
+  flex-shrink: 0;
+}
+
+.badge {
+  display: inline-flex;
+  align-items: center;
+  gap: 4px;
+  padding: 2px 8px;
+  border-radius: 12px;
+  font-size: 12px;
+  background-color: var(--btn-primary-bg);
+  color: var(--btn-primary-color);
+  white-space: nowrap;
+}
+
+.badge-info {
+  background-color: var(--front-color2);
+}
+</style>
diff --git a/src/views/HomeView.vue b/src/views/HomeView.vue
new file mode 100644
index 0000000..9a2a7ef
--- /dev/null
+++ b/src/views/HomeView.vue
@@ -0,0 +1,527 @@
+<script setup>
+import { ref, computed, onMounted } from 'vue'
+import { useRouter } from 'vue-router'
+import { executionLogRepository } from '../db/repositories/executionLogRepository.js'
+import { formatDate, formatDuration, formatItemDuration } from '../utils/dateFormatter.js'
+import { useHtmlExport } from '../composables/useHtmlExport.js'
+import i18next from 'i18next'
+
+const router = useRouter()
+const { exportHomeAsHtml } = useHtmlExport()
+
+const recentSessions = ref([])
+const allLogs = ref([])
+const count7Days = ref(0)
+const count30Days = ref(0)
+const loading = ref(true)
+
+const today = new Date().toISOString().substring(0, 10)
+const historyFrom = ref(new Date(Date.now() - 30 * 86400000).toISOString().substring(0, 10))
+const historyTo = ref(today)
+
+onMounted(async () => {
+  try {
+    const now = new Date()
+    const date7DaysAgo = new Date(now.getTime() - 7 * 24 * 60 * 60 * 1000).toISOString()
+    const date30DaysAgo = new Date(now.getTime() - 30 * 24 * 60 * 60 * 1000).toISOString()
+
+    ;[recentSessions.value, allLogs.value, count7Days.value, count30Days.value] = await Promise.all(
+      [
+        executionLogRepository.getRecentWithItems(4),
+        executionLogRepository.getAllWithItems(),
+        executionLogRepository.getCountSince(date7DaysAgo),
+        executionLogRepository.getCountSince(date30DaysAgo),
+      ],
+    )
+  } catch (e) {
+    console.error('Failed to load home data:', e)
+  } finally {
+    loading.value = false
+  }
+})
+
+const historyByDay = computed(() => {
+  const groups = {}
+  for (const log of allLogs.value) {
+    const day = log.started_at.substring(0, 10)
+    if (day < historyFrom.value || day > historyTo.value) continue
+    if (!groups[day]) groups[day] = []
+    groups[day].push(log)
+  }
+  return Object.entries(groups)
+    .sort(([a], [b]) => b.localeCompare(a))
+    .map(([day, logs]) => ({ day, logs }))
+})
+
+// Adds duration_ms to each item using consecutive timestamp deltas
+function enrichItemsWithTiming(log) {
+  const items = log.items || []
+  return items.map((item, i) => {
+    const curr = item.timestamp ? new Date(item.timestamp).getTime() : null
+    const prev =
+      i === 0
+        ? log.started_at
+          ? new Date(log.started_at).getTime()
+          : null
+        : items[i - 1].timestamp
+          ? new Date(items[i - 1].timestamp).getTime()
+          : null
+    return { ...item, duration_ms: curr && prev ? curr - prev : null }
+  })
+}
+
+// Groups enriched items into standalone exercises and combo blocks
+function groupItems(items) {
+  if (!items || items.length === 0) return []
+  const result = []
+  const comboMap = {}
+  for (const item of items) {
+    if (!item.combo_id) {
+      result.push({ type: 'exercise', item })
+    } else {
+      if (!comboMap[item.combo_id]) {
+        comboMap[item.combo_id] = {
+          type: 'combo',
+          combo_id: item.combo_id,
+          combo_title: item.combo_title,
+          combo_type: item.combo_type,
+          exercises: [],
+        }
+        result.push(comboMap[item.combo_id])
+      }
+      comboMap[item.combo_id].exercises.push(item)
+    }
+  }
+  return result
+}
+
+// Returns combo exercises grouped by round as an array of arrays
+function comboRounds(group) {
+  const hasRounds = group.exercises.some((ex) => ex.round_number != null)
+  if (!hasRounds) return [group.exercises]
+  const map = {}
+  for (const ex of group.exercises) {
+    const rn = ex.round_number ?? 0
+    if (!map[rn]) map[rn] = []
+    map[rn].push(ex)
+  }
+  return Object.entries(map)
+    .sort(([a], [b]) => Number(a) - Number(b))
+    .map(([, exes]) => exes)
+}
+
+// Formats the (reps,weight[,timing]) parenthesis for an item
+function itemParens(item) {
+  const parts = [item.reps_done, item.weight_used]
+  const dur = formatItemDuration(item.duration_ms)
+  if (dur) parts.push(dur)
+  return `(${parts.join(',')})`
+}
+
+function getDuration(log) {
+  return formatDuration(log.started_at, log.finished_at)
+}
+
+function formatDateLocalized(dateStr) {
+  return formatDate(dateStr, i18next.language)
+}
+
+function goToSession(sessionId) {
+  router.push({ name: 'session-detail', params: { id: sessionId } })
+}
+
+function goToExecute(sessionId, event) {
+  event.stopPropagation()
+  router.push({ name: 'session-execute', params: { id: sessionId } })
+}
+
+async function onExportHtml() {
+  await exportHomeAsHtml({
+    count7Days: count7Days.value,
+    count30Days: count30Days.value,
+    recentSessions: recentSessions.value,
+    historyByDay: historyByDay.value,
+    historyFrom: historyFrom.value,
+    historyTo: historyTo.value,
+  })
+}
+</script>
+
+<template>
+  <Teleport to="#actionbar-actions" defer>
+    <button
+      v-if="!loading && allLogs.length > 0"
+      data-testid="home-export-html-btn"
+      :title="$t('home.exportHtml')"
+      :aria-label="$t('home.exportHtml')"
+      @click="onExportHtml"
+    >
+      <i class="bi bi-filetype-html"></i>
+    </button>
+  </Teleport>
+
+  <div class="home-view">
+    <p v-if="loading" class="text-muted">{{ $t('app.loading') }}</p>
+
+    <template v-else>
+      <!-- Stats cards -->
+      <div class="stats-cards">
+        <div class="stat-card" data-testid="home-stat-7days">
+          <span class="stat-value">{{ count7Days }}</span>
+          <span class="stat-label">{{ $t('home.sessionsLast7Days') }}</span>
+        </div>
+        <div class="stat-card" data-testid="home-stat-30days">
+          <span class="stat-value">{{ count30Days }}</span>
+          <span class="stat-label">{{ $t('home.sessionsLast30Days') }}</span>
+        </div>
+      </div>
+
+      <!-- Empty state -->
+      <p v-if="allLogs.length === 0" class="text-muted" data-testid="home-empty">
+        {{ $t('home.empty') }}
+      </p>
+
+      <template v-else>
+        <!-- Last 4 sessions with details -->
+        <div class="recent-section">
+          <h3>{{ $t('home.recentSessions') }}</h3>
+          <div
+            v-for="log in recentSessions"
+            :key="log.id"
+            class="card recent-session-card"
+            :data-testid="'home-recent-session-' + log.id"
+            @click="goToSession(log.session_id)"
+          >
+            <div class="session-header">
+              <h4 data-testid="home-recent-session-title">{{ log.session_title }}</h4>
+              <span class="session-meta">
+                <span class="session-date" data-testid="home-recent-session-date">
+                  {{ formatDateLocalized(log.started_at) }}
+                </span>
+                <span v-if="getDuration(log)" class="session-duration">
+                  <i class="bi bi-clock"></i> {{ getDuration(log) }}
+                </span>
+              </span>
+              <button
+                class="card-play-btn"
+                :data-testid="'home-recent-session-play-' + log.session_id"
+                :title="$t('execution.start')"
+                :aria-label="$t('execution.start')"
+                @click="goToExecute(log.session_id, $event)"
+              >
+                <i class="bi bi-play-fill"></i>
+              </button>
+            </div>
+            <div v-if="log.items && log.items.length > 0" class="session-items-inline">
+              <template
+                v-for="(group, gi) in groupItems(enrichItemsWithTiming(log))"
+                :key="group.type === 'exercise' ? group.item.id : group.combo_id"
+              >
+                <span v-if="gi > 0">, </span>
+                <span v-if="group.type === 'exercise'"
+                  >{{ group.item.exercise_title }} {{ itemParens(group.item) }}</span
+                >
+                <span v-else
+                  >{{ group.combo_title }} ×{{ comboRounds(group).length }} :
+                  <span class="combo-inline"
+                    >{{ '{'
+                    }}<template v-for="(round, ri) in comboRounds(group)" :key="ri"
+                      ><strong v-if="ri > 0"> // </strong
+                      ><template v-for="(ex, ei) in round" :key="ex.id"
+                        ><template v-if="ri > 0 || ei > 0">, </template>{{ ex.exercise_title }}
+                        {{ itemParens(ex) }}</template
+                      ></template
+                    >{{ '}' }}</span
+                  ></span
+                >
+              </template>
+            </div>
+          </div>
+        </div>
+
+        <!-- History by day -->
+        <div class="history-section">
+          <div class="history-header">
+            <h3>{{ $t('home.history') }}</h3>
+            <div class="history-filter">
+              <input v-model="historyFrom" type="date" :max="historyTo" class="input-date" />
+              <span class="history-filter-sep">–</span>
+              <input
+                v-model="historyTo"
+                type="date"
+                :min="historyFrom"
+                :max="today"
+                class="input-date"
+              />
+            </div>
+          </div>
+          <div v-for="dayGroup in historyByDay" :key="dayGroup.day" class="history-day">
+            <h4 class="history-day-label">{{ formatDateLocalized(dayGroup.day) }}</h4>
+            <div
+              v-for="log in dayGroup.logs"
+              :key="log.id"
+              class="card history-session-card"
+              :data-testid="'home-history-session-' + log.id"
+              @click="goToSession(log.session_id)"
+            >
+              <div class="session-header session-header--sm">
+                <span class="history-session-title">{{ log.session_title }}</span>
+                <span class="session-meta">
+                  <span v-if="getDuration(log)" class="session-duration">
+                    <i class="bi bi-clock"></i> {{ getDuration(log) }}
+                  </span>
+                </span>
+                <button
+                  class="card-play-btn card-play-btn-sm"
+                  :title="$t('execution.start')"
+                  :aria-label="$t('execution.start')"
+                  @click="goToExecute(log.session_id, $event)"
+                >
+                  <i class="bi bi-play-fill"></i>
+                </button>
+              </div>
+              <div
+                v-if="log.items && log.items.length > 0"
+                class="session-items-inline session-items-inline--sm"
+              >
+                <template
+                  v-for="(group, gi) in groupItems(enrichItemsWithTiming(log))"
+                  :key="group.type === 'exercise' ? group.item.id : group.combo_id"
+                >
+                  <span v-if="gi > 0">, </span>
+                  <span v-if="group.type === 'exercise'"
+                    >{{ group.item.exercise_title }} {{ itemParens(group.item) }}</span
+                  >
+                  <span v-else
+                    >{{ group.combo_title }} ×{{ comboRounds(group).length }} :
+                    <span class="combo-inline"
+                      >{{ '{'
+                      }}<template v-for="(round, ri) in comboRounds(group)" :key="ri"
+                        ><strong v-if="ri > 0"> // </strong
+                        ><template v-for="(ex, ei) in round" :key="ex.id"
+                          ><template v-if="ri > 0 || ei > 0">, </template>{{ ex.exercise_title }}
+                          {{ itemParens(ex) }}</template
+                        ></template
+                      >{{ '}' }}</span
+                    ></span
+                  >
+                </template>
+              </div>
+            </div>
+          </div>
+        </div>
+      </template>
+    </template>
+  </div>
+</template>
+
+<style scoped>
+.home-view {
+  max-width: 800px;
+}
+
+/* Stats */
+
+.stats-cards {
+  display: flex;
+  gap: 16px;
+  margin-bottom: 24px;
+}
+
+.stat-card {
+  flex: 1;
+  display: flex;
+  flex-direction: column;
+  align-items: center;
+  padding: 16px;
+  border-radius: 8px;
+  background-color: var(--color-background);
+  border: 1px solid var(--border-color);
+}
+
+.stat-value {
+  font-size: 32px;
+  font-weight: 700;
+  color: var(--btn-primary-bg);
+}
+
+.stat-label {
+  font-size: 13px;
+  color: var(--color-text-muted);
+  text-align: center;
+  margin-top: 4px;
+}
+
+/* Section headings */
+
+.recent-section {
+  margin-bottom: 28px;
+}
+
+.recent-section h3,
+.history-header h3 {
+  font-size: 16px;
+  font-weight: 600;
+  margin-bottom: 10px;
+}
+
+/* Session cards */
+
+.recent-session-card,
+.history-session-card {
+  cursor: pointer;
+  transition: border-color 0.15s;
+  margin-bottom: 8px;
+}
+
+.recent-session-card:hover,
+.history-session-card:hover {
+  border-color: var(--btn-primary-bg);
+}
+
+/* Session header row */
+
+.session-header {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+  margin-bottom: 6px;
+}
+
+.session-header h4 {
+  flex: 1;
+  font-size: 15px;
+  font-weight: 600;
+  margin: 0;
+}
+
+.session-header--sm {
+  margin-bottom: 4px;
+}
+
+.history-session-title {
+  flex: 1;
+  font-size: 14px;
+  font-weight: 600;
+}
+
+.session-meta {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+  flex-shrink: 0;
+}
+
+.session-date {
+  font-size: 13px;
+  color: var(--color-text-muted);
+  white-space: nowrap;
+}
+
+.session-duration {
+  font-size: 12px;
+  color: var(--color-text-muted);
+  white-space: nowrap;
+  display: flex;
+  align-items: center;
+  gap: 3px;
+}
+
+/* Play buttons */
+
+.card-play-btn {
+  width: 32px;
+  height: 32px;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  border-radius: 50%;
+  border: none;
+  background: var(--btn-primary-bg);
+  color: var(--btn-primary-color);
+  cursor: pointer;
+  flex-shrink: 0;
+  font-size: 14px;
+  transition: opacity 0.15s;
+}
+
+.card-play-btn:hover {
+  opacity: 0.8;
+}
+
+.card-play-btn-sm {
+  width: 26px;
+  height: 26px;
+  font-size: 12px;
+}
+
+/* History day groups */
+
+.history-section {
+  margin-bottom: 20px;
+}
+
+.history-day {
+  margin-bottom: 16px;
+}
+
+.history-day-label {
+  font-size: 13px;
+  font-weight: 600;
+  color: var(--color-text-muted);
+  margin-bottom: 6px;
+  text-transform: uppercase;
+  letter-spacing: 0.04em;
+}
+
+/* Inline item line */
+
+.session-items-inline {
+  font-size: 13px;
+  color: var(--front-color1);
+  line-height: 1.6;
+}
+
+.session-items-inline--sm {
+  font-size: 12px;
+}
+
+.combo-inline {
+  font-style: italic;
+}
+
+/* History header with date filter */
+
+.history-header {
+  display: flex;
+  align-items: center;
+  gap: 12px;
+  margin-bottom: 10px;
+  flex-wrap: wrap;
+}
+
+.history-header h3 {
+  margin-bottom: 0;
+}
+
+.history-filter {
+  display: flex;
+  align-items: center;
+  gap: 6px;
+  margin-left: auto;
+}
+
+.history-filter-sep {
+  color: var(--color-text-muted);
+  font-size: 13px;
+}
+
+.input-date {
+  font-size: 12px;
+  padding: 3px 6px;
+  border: 1px solid var(--border-color);
+  border-radius: 4px;
+  background: var(--bg-color2);
+  color: var(--front-color1);
+}
+</style>
diff --git a/src/views/SessionDetailView.vue b/src/views/SessionDetailView.vue
new file mode 100644
index 0000000..dd4d09c
--- /dev/null
+++ b/src/views/SessionDetailView.vue
@@ -0,0 +1,294 @@
+<script setup>
+import { ref, computed, onMounted } from 'vue'
+import { useTranslation } from 'i18next-vue'
+import { useRouter, useRoute } from 'vue-router'
+import { useSessions } from '../composables/useSessions.js'
+import { useJsonExport } from '../composables/useJsonExport.js'
+import { useKeyboardShortcut } from '../composables/useKeyboardShortcut.js'
+import { renderMarkdown } from '../utils/markdown.js'
+import { executionLogRepository } from '../db/repositories/executionLogRepository.js'
+
+const { t } = useTranslation()
+const router = useRouter()
+const route = useRoute()
+const { getById, remove } = useSessions()
+const { exportSession } = useJsonExport()
+
+const session = ref(null)
+const loading = ref(true)
+
+const sessionId = computed(() => route.params.id)
+
+onMounted(async () => {
+  const data = await getById(sessionId.value)
+  if (!data) {
+    router.replace({ name: 'sessions' })
+    return
+  }
+  session.value = data
+  loading.value = false
+})
+
+function goToEdit() {
+  router.push({ name: 'session-edit', params: { id: sessionId.value } })
+}
+
+useKeyboardShortcut('e', goToEdit)
+useKeyboardShortcut('escape', goBack, false)
+
+function goBack() {
+  router.push({ name: 'sessions' })
+}
+
+function goToExecute() {
+  router.push({ name: 'session-execute', params: { id: sessionId.value } })
+}
+
+function goToItem(item) {
+  if (item.item_type === 'exercise') {
+    router.push({ name: 'exercise-detail', params: { id: item.item_id } })
+  } else {
+    router.push({ name: 'combo-detail', params: { id: item.item_id } })
+  }
+}
+
+function getItemTypeLabel(itemType) {
+  return itemType === 'exercise' ? t('sessions.itemType.exercise') : t('sessions.itemType.combo')
+}
+
+async function onDelete() {
+  if (!session.value) return
+  const count = await executionLogRepository.countLogsBySession(sessionId.value)
+  const msg =
+    count > 0
+      ? t('sessions.deleteConfirmWithHistory', { title: session.value.title, count })
+      : t('sessions.deleteConfirm', { title: session.value.title })
+  const confirmed = window.confirm(msg)
+  if (!confirmed) return
+  await remove(sessionId.value)
+  router.push({ name: 'sessions' })
+}
+
+async function onExport() {
+  await exportSession(sessionId.value)
+}
+</script>
+
+<template>
+  <Teleport to="#actionbar-actions" defer>
+    <button
+      data-testid="session-back-btn"
+      :title="$t('sessions.title') + ' ' + $t('shortcuts.back')"
+      :aria-label="$t('sessions.title')"
+      @click="goBack"
+    >
+      <i class="bi bi-arrow-left"></i>
+    </button>
+    <button
+      data-testid="session-execute-btn"
+      :title="$t('execution.start')"
+      :aria-label="$t('execution.start')"
+      @click="goToExecute"
+    >
+      <i class="bi bi-play-fill"></i>
+    </button>
+    <button
+      data-testid="session-export-single-btn"
+      :title="$t('export.session')"
+      :aria-label="$t('export.session')"
+      @click="onExport"
+    >
+      <i class="bi bi-download"></i>
+    </button>
+    <button
+      data-testid="session-edit-btn"
+      :title="$t('sessions.edit') + ' ' + $t('shortcuts.edit')"
+      :aria-label="$t('sessions.edit')"
+      @click="goToEdit"
+    >
+      <i class="bi bi-pencil"></i>
+    </button>
+    <button
+      data-testid="session-delete-btn"
+      :title="$t('sessions.delete')"
+      :aria-label="$t('sessions.delete')"
+      @click="onDelete"
+    >
+      <i class="bi bi-trash"></i>
+    </button>
+  </Teleport>
+
+  <div class="session-detail-view">
+    <p v-if="loading" class="text-muted">{{ $t('app.loading') }}</p>
+
+    <template v-else-if="session">
+      <!-- Title -->
+      <h2 data-testid="session-detail-title">{{ session.title }}</h2>
+
+      <!-- Description -->
+      <div
+        v-if="session.description"
+        class="session-description"
+        data-testid="session-detail-description"
+        v-html="renderMarkdown(session.description)"
+      />
+
+      <!-- Items -->
+      <div v-if="session.items && session.items.length" class="items-section">
+        <h3>{{ $t('sessions.form.items') }}</h3>
+        <ol class="session-item-list">
+          <li
+            v-for="(item, index) in session.items"
+            :key="'item-' + index"
+            class="session-item"
+            :data-testid="'session-detail-item-' + index"
+          >
+            <span class="session-item-number">{{ index + 1 }}</span>
+            <span class="session-item-type">{{ getItemTypeLabel(item.item_type) }}</span>
+            <a
+              class="session-item-title"
+              :data-testid="'session-detail-item-link-' + index"
+              @click="goToItem(item)"
+            >
+              {{ item.title }}
+            </a>
+            <span
+              class="session-item-details"
+              :data-testid="'session-detail-item-details-' + index"
+            >
+              <span v-if="item.combo_type === 'AMRAP'">
+                {{ item.repetitions }} {{ $t('combos.timer.minutes') }}
+              </span>
+              <span v-else>{{ item.repetitions }} {{ $t('exercises.reps') }}</span>
+              <span v-if="item.item_type === 'exercise'"
+                >{{ item.weight }} {{ $t('exercises.weight') }}</span
+              >
+              <span v-else>0 {{ $t('exercises.weight') }}</span>
+            </span>
+          </li>
+        </ol>
+      </div>
+    </template>
+  </div>
+</template>
+
+<style scoped>
+.session-detail-view {
+  max-width: 800px;
+}
+
+.session-detail-view h2 {
+  font-size: 22px;
+  margin-bottom: 8px;
+}
+
+.session-description {
+  font-size: 15px;
+  line-height: 1.5;
+  margin-bottom: 12px;
+}
+
+.session-description :deep(p) {
+  margin: 0 0 8px;
+}
+
+.session-description :deep(p:last-child) {
+  margin-bottom: 0;
+}
+
+.session-description :deep(ul),
+.session-description :deep(ol) {
+  margin: 0 0 8px;
+  padding-left: 20px;
+}
+
+.session-description :deep(code) {
+  font-family: monospace;
+  font-size: 13px;
+  background: var(--color-surface, #f4f4f4);
+  padding: 1px 4px;
+  border-radius: 3px;
+}
+
+.session-description :deep(pre) {
+  background: var(--color-surface, #f4f4f4);
+  padding: 8px;
+  border-radius: 4px;
+  overflow-x: auto;
+  margin-bottom: 8px;
+}
+
+.session-description :deep(strong) {
+  font-weight: 600;
+}
+
+.items-section {
+  margin-bottom: 20px;
+}
+
+.items-section h3 {
+  font-size: 16px;
+  font-weight: 600;
+  margin-bottom: 10px;
+}
+
+.session-item-list {
+  list-style: none;
+  padding: 0;
+  margin: 0;
+}
+
+.session-item {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+  padding: 8px 4px;
+  border-bottom: 1px solid var(--border-color);
+}
+
+.session-item-number {
+  width: 24px;
+  height: 24px;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  border-radius: 50%;
+  background-color: var(--btn-primary-bg);
+  color: var(--btn-primary-color);
+  font-size: 12px;
+  font-weight: 600;
+  flex-shrink: 0;
+}
+
+.session-item-type {
+  font-size: 11px;
+  padding: 2px 6px;
+  border-radius: 4px;
+  background-color: var(--front-color2);
+  color: var(--btn-primary-color);
+  flex-shrink: 0;
+}
+
+.session-item-title {
+  font-size: 14px;
+  color: var(--btn-primary-bg);
+  cursor: pointer;
+  text-decoration: none;
+}
+
+.session-item-title:hover {
+  text-decoration: underline;
+}
+
+.session-item-details {
+  display: flex;
+  gap: 8px;
+  font-size: 13px;
+  color: var(--color-text-muted);
+  margin-left: auto;
+}
+
+.session-item-details span {
+  white-space: nowrap;
+}
+</style>
diff --git a/src/views/SessionExecuteView.vue b/src/views/SessionExecuteView.vue
new file mode 100644
index 0000000..fc7f29c
--- /dev/null
+++ b/src/views/SessionExecuteView.vue
@@ -0,0 +1,880 @@
+<script setup>
+import { ref, watch, onMounted } from 'vue'
+import { useRouter, useRoute, onBeforeRouteLeave } from 'vue-router'
+import { useTranslation } from 'i18next-vue'
+import { useSessionExecution } from '../composables/useSessionExecution.js'
+import { exerciseRepository } from '../db/repositories/exerciseRepository.js'
+import { useOnlineStatus } from '../composables/useOnlineStatus.js'
+import { renderMarkdown } from '../utils/markdown.js'
+import { getYouTubeId } from '../utils/youtube.js'
+import TimerDisplay from '../components/TimerDisplay.vue'
+
+const { t } = useTranslation()
+const route = useRoute()
+const router = useRouter()
+const sessionId = route.params.id
+const { isOnline } = useOnlineStatus()
+
+const {
+  sessionTitle,
+  currentIndex,
+  totalSteps,
+  currentStep,
+  nextStep,
+  showFinalRound,
+  sessionDone,
+  loading,
+  error,
+  currentReps,
+  currentWeight,
+  currentSide,
+  timerPhase,
+  timerRemaining,
+  timerPaused,
+  timerActive,
+  isAmrapTimeUp,
+  init,
+  markDone,
+  continueAfterCombo,
+  continueAfterAmrap,
+  addOneMoreRound,
+  togglePause,
+  exit,
+} = useSessionExecution(sessionId)
+
+const showDetail = ref(false)
+const detailExercise = ref(null)
+const detailLoading = ref(false)
+const detailPausedTimer = ref(false)
+
+watch(currentStep, () => {
+  showDetail.value = false
+  detailExercise.value = null
+  detailPausedTimer.value = false
+})
+
+async function toggleDetail() {
+  showDetail.value = !showDetail.value
+  if (showDetail.value) {
+    if (timerActive.value && !timerPaused.value) {
+      togglePause()
+      detailPausedTimer.value = true
+    }
+    if (!detailExercise.value && currentStep.value) {
+      detailLoading.value = true
+      detailExercise.value = await exerciseRepository.getById(currentStep.value.exerciseId)
+      detailLoading.value = false
+    }
+  } else {
+    if (detailPausedTimer.value) {
+      togglePause()
+      detailPausedTimer.value = false
+    }
+  }
+}
+
+onMounted(async () => {
+  await init()
+})
+
+onBeforeRouteLeave(async () => {
+  if (!sessionDone.value) {
+    const confirmed = window.confirm(t('execution.leaveConfirm'))
+    if (!confirmed) return false
+    await exit()
+  }
+})
+
+function toggleSide() {
+  currentSide.value = currentSide.value === 'left' ? 'right' : 'left'
+}
+
+async function onExit() {
+  await exit()
+  router.push({ name: 'session-detail', params: { id: sessionId } })
+}
+
+async function onDone() {
+  await markDone()
+  if (sessionDone.value) {
+    router.push({ name: 'session-detail', params: { id: sessionId } })
+  }
+}
+
+async function onContinue() {
+  await continueAfterCombo()
+  if (sessionDone.value) {
+    router.push({ name: 'session-detail', params: { id: sessionId } })
+  }
+}
+
+async function onContinueAmrap() {
+  await continueAfterAmrap()
+  if (sessionDone.value) {
+    router.push({ name: 'session-detail', params: { id: sessionId } })
+  }
+}
+</script>
+
+<template>
+  <Teleport to="#actionbar-actions" defer>
+    <button
+      data-testid="execute-exit-btn"
+      :title="$t('execution.exit')"
+      :aria-label="$t('execution.exit')"
+      @click="onExit"
+    >
+      <i class="bi bi-x-lg"></i>
+    </button>
+  </Teleport>
+
+  <div class="session-execute-view">
+    <p v-if="loading" class="text-muted">{{ $t('app.loading') }}</p>
+    <p v-else-if="error" class="text-danger">{{ error }}</p>
+
+    <template v-else>
+      <!-- Session title -->
+      <h2 data-testid="execute-session-title">{{ sessionTitle }}</h2>
+
+      <!-- Progress bar -->
+      <div class="progress-section" data-testid="execute-progress">
+        <div
+          class="progress-bar-track"
+          role="progressbar"
+          :aria-valuenow="currentIndex"
+          aria-valuemin="0"
+          :aria-valuemax="totalSteps"
+          :aria-label="currentIndex + ' / ' + totalSteps + ' ' + $t('execution.steps')"
+        >
+          <div
+            class="progress-bar-fill"
+            :style="{ width: totalSteps > 0 ? (currentIndex / totalSteps) * 100 + '%' : '0%' }"
+          ></div>
+        </div>
+        <span class="progress-label" data-testid="execute-progress-label">
+          {{ currentIndex }} / {{ totalSteps }} {{ $t('execution.steps') }}
+        </span>
+      </div>
+
+      <!-- AMRAP time-up screen -->
+      <div v-if="isAmrapTimeUp" class="final-round-card card" data-testid="execute-amrap-timeup">
+        <div class="final-round-message">
+          <i class="bi bi-stopwatch-fill"></i>
+          {{ $t('execution.timer.timeUpTitle', { title: currentStep?.comboTitle }) }}
+        </div>
+        <div class="final-round-actions">
+          <button
+            class="btn btn-primary"
+            data-testid="execute-amrap-continue-btn"
+            @click="onContinueAmrap"
+          >
+            {{ $t('execution.continue') }} →
+          </button>
+        </div>
+      </div>
+
+      <!-- TABATA rest screen -->
+      <div
+        v-else-if="timerPhase === 'rest'"
+        class="rest-card card"
+        data-testid="execute-tabata-rest"
+      >
+        <div class="rest-label">{{ $t('execution.timer.rest') }}</div>
+        <p v-if="nextStep" class="rest-next text-muted">
+          {{ $t('execution.timer.nextExercise') }} {{ nextStep.exerciseTitle }}
+        </p>
+        <TimerDisplay
+          :remaining="timerRemaining"
+          :is-paused="timerPaused"
+          :pause-label="$t('execution.timer.pause')"
+          :resume-label="$t('execution.timer.resume')"
+          @toggle-pause="togglePause"
+        />
+      </div>
+
+      <!-- Final-round screen -->
+      <div
+        v-else-if="showFinalRound"
+        class="final-round-card card"
+        data-testid="execute-final-round"
+      >
+        <div class="final-round-message">
+          <i class="bi bi-check-circle-fill"></i>
+          {{
+            $t('execution.comboComplete', {
+              title: currentStep?.comboTitle,
+              rounds: currentStep?.roundNumber,
+            })
+          }}
+        </div>
+        <div class="final-round-actions">
+          <button class="btn btn-primary" data-testid="execute-continue-btn" @click="onContinue">
+            {{ $t('execution.continue') }} →
+          </button>
+          <button
+            class="btn btn-secondary"
+            data-testid="execute-one-more-btn"
+            @click="addOneMoreRound"
+          >
+            + {{ $t('execution.oneMoreRound') }}
+          </button>
+        </div>
+      </div>
+
+      <!-- Current step -->
+      <template v-else-if="currentStep">
+        <div class="step-label">▶ {{ $t('execution.now') }}</div>
+        <div class="step-card card" data-testid="execute-current-step">
+          <h3>
+            <button
+              class="exercise-title-btn"
+              :aria-expanded="showDetail"
+              :aria-label="showDetail ? $t('execution.hideDetails') : $t('execution.showDetails')"
+              @click="toggleDetail"
+            >
+              <span data-testid="execute-exercise-title">{{ currentStep.exerciseTitle }}</span>
+              <i
+                :class="showDetail ? 'bi bi-chevron-up' : 'bi bi-chevron-down'"
+                class="detail-chevron"
+              ></i>
+            </button>
+          </h3>
+
+          <!-- Exercise detail panel -->
+          <div
+            v-if="showDetail"
+            class="exercise-detail-panel"
+            data-testid="execute-exercise-detail"
+          >
+            <p v-if="detailLoading" class="text-muted detail-loading">{{ $t('app.loading') }}</p>
+            <template v-else-if="detailExercise">
+              <div
+                v-if="detailExercise.description"
+                class="detail-description"
+                v-html="renderMarkdown(detailExercise.description)"
+              />
+              <div
+                v-if="detailExercise.image_urls && detailExercise.image_urls.length"
+                class="detail-images"
+              >
+                <img
+                  v-for="(url, i) in detailExercise.image_urls"
+                  :key="'img-' + i"
+                  :src="url"
+                  :alt="currentStep.exerciseTitle + ' image ' + (i + 1)"
+                  class="detail-image"
+                  loading="lazy"
+                  @error="($event) => ($event.target.style.display = 'none')"
+                />
+              </div>
+              <div
+                v-if="detailExercise.video_urls && detailExercise.video_urls.length"
+                class="detail-videos"
+              >
+                <p v-if="!isOnline" class="detail-offline text-muted">
+                  <i class="bi bi-wifi-off"></i> {{ $t('execution.videoOffline') }}
+                </p>
+                <template v-else>
+                  <a
+                    v-for="(url, i) in detailExercise.video_urls"
+                    :key="'vid-' + i"
+                    :href="url"
+                    target="_blank"
+                    rel="noopener noreferrer"
+                    class="detail-video-link"
+                  >
+                    <template v-if="getYouTubeId(url)">
+                      <img
+                        :src="'https://img.youtube.com/vi/' + getYouTubeId(url) + '/mqdefault.jpg'"
+                        :alt="currentStep.exerciseTitle + ' video ' + (i + 1)"
+                        class="detail-yt-thumb"
+                        loading="lazy"
+                      />
+                    </template>
+                    <template v-else> <i class="bi bi-play-circle"></i> {{ url }} </template>
+                  </a>
+                </template>
+              </div>
+            </template>
+          </div>
+
+          <!-- Combo context -->
+          <p
+            v-if="currentStep.comboId"
+            class="combo-context text-muted"
+            data-testid="execute-combo-context"
+          >
+            {{
+              $t('execution.comboContext', {
+                title: currentStep.comboTitle,
+                round: currentStep.roundNumber,
+                total: currentStep.totalRounds,
+              })
+            }}
+          </p>
+
+          <!-- Timer display (EMOM, TABATA work, AMRAP) -->
+          <TimerDisplay
+            v-if="timerActive && timerPhase !== 'rest'"
+            :remaining="timerRemaining"
+            :is-paused="timerPaused"
+            :pause-label="$t('execution.timer.pause')"
+            :resume-label="$t('execution.timer.resume')"
+            data-testid="execute-timer"
+            @toggle-pause="togglePause"
+          />
+
+          <div class="step-inputs">
+            <!-- Reps input -->
+            <div class="input-row">
+              <label class="input-label">{{ $t('execution.reps') }}</label>
+              <div class="stepper">
+                <button
+                  class="stepper-btn btn-primary"
+                  :aria-label="'-1 ' + $t('execution.reps')"
+                  @click="currentReps = Math.max(0, currentReps - 1)"
+                >
+                  <i class="bi bi-dash-circle-fill"></i>
+                </button>
+                <input
+                  type="number"
+                  class="step-input"
+                  data-testid="execute-reps-input"
+                  :value="currentReps"
+                  min="0"
+                  @input="currentReps = Number($event.target.value)"
+                />
+                <button
+                  class="stepper-btn btn-primary"
+                  :aria-label="'+1 ' + $t('execution.reps')"
+                  @click="currentReps++"
+                >
+                  <i class="bi bi-plus-circle-fill"></i>
+                </button>
+                <button
+                  class="stepper-btn stepper-btn-fast"
+                  :aria-label="'+5 ' + $t('execution.reps')"
+                  @click="currentReps += 5"
+                >
+                  <i class="bi bi-forward-fill"></i>
+                </button>
+              </div>
+            </div>
+
+            <!-- Weight input -->
+            <div class="input-row">
+              <label class="input-label">{{ $t('execution.weight') }}</label>
+              <div class="stepper">
+                <button
+                  class="stepper-btn btn-primary"
+                  :aria-label="'-0.5 ' + $t('execution.weight')"
+                  @click="currentWeight = Math.max(0, +(currentWeight - 0.5).toFixed(1))"
+                >
+                  <i class="bi bi-dash-circle-fill"></i>
+                </button>
+                <input
+                  type="number"
+                  class="step-input"
+                  data-testid="execute-weight-input"
+                  :value="currentWeight"
+                  min="0"
+                  step="0.5"
+                  @input="currentWeight = Number($event.target.value)"
+                />
+                <button
+                  class="stepper-btn btn-primary"
+                  :aria-label="'+0.5 ' + $t('execution.weight')"
+                  @click="currentWeight = +(currentWeight + 0.5).toFixed(1)"
+                >
+                  <i class="bi bi-plus-circle-fill"></i>
+                </button>
+                <button
+                  class="stepper-btn stepper-btn-fast"
+                  :aria-label="'+1 ' + $t('execution.weight')"
+                  @click="currentWeight = +(currentWeight + 1).toFixed(1)"
+                >
+                  <i class="bi bi-forward-fill"></i>
+                </button>
+              </div>
+              <span class="input-unit">kg</span>
+            </div>
+
+            <!-- Side toggle (asymmetric exercises only) -->
+            <div v-if="currentStep.asymmetric" class="input-row">
+              <label class="input-label">{{ $t('execution.side') }}</label>
+              <button
+                class="side-toggle"
+                data-testid="execute-side-toggle"
+                :aria-label="
+                  $t('execution.side') +
+                  ': ' +
+                  (currentSide === 'left' ? $t('execution.sideLeft') : $t('execution.sideRight'))
+                "
+                @click="toggleSide"
+              >
+                {{ currentSide === 'left' ? $t('execution.sideLeft') : $t('execution.sideRight') }}
+                ↔
+              </button>
+              <span class="asym-hint text-muted">
+                {{
+                  currentStep.alternate
+                    ? $t('execution.asymAlternate', {
+                        left: $t('execution.sideLeft'),
+                        right: $t('execution.sideRight'),
+                        count: Math.floor(currentReps / 2),
+                      })
+                    : $t('execution.asymSequential', {
+                        left: $t('execution.sideLeft'),
+                        right: $t('execution.sideRight'),
+                        count: Math.floor(currentReps / 2),
+                      })
+                }}
+              </span>
+            </div>
+          </div>
+
+          <button class="btn btn-primary done-btn" data-testid="execute-done-btn" @click="onDone">
+            <i class="bi bi-check-lg"></i> {{ $t('execution.done') }}
+          </button>
+        </div>
+
+        <!-- Next step preview -->
+        <template v-if="nextStep && timerPhase !== 'rest'">
+          <div class="step-label next-label">↓ {{ $t('execution.next') }}</div>
+          <div class="next-step-preview" data-testid="execute-next-step">
+            <span class="next-title">{{ nextStep.exerciseTitle }}</span>
+            <span class="next-detail text-muted">
+              — {{ nextStep.prefillReps }} {{ $t('execution.reps') }}
+              <template v-if="nextStep.comboId">
+                ({{ nextStep.comboTitle }}, {{ $t('execution.round') }} {{ nextStep.roundNumber }})
+              </template>
+            </span>
+          </div>
+        </template>
+      </template>
+
+      <!-- Session complete -->
+      <div v-else class="session-complete" data-testid="execute-complete">
+        <i class="bi bi-trophy-fill complete-icon"></i>
+        <p>{{ $t('execution.complete') }}</p>
+        <button
+          class="btn btn-primary"
+          @click="$router.push({ name: 'session-detail', params: { id: sessionId } })"
+        >
+          {{ $t('execution.backToSession') }}
+        </button>
+      </div>
+    </template>
+  </div>
+</template>
+
+<style scoped>
+.session-execute-view {
+  max-width: 600px;
+}
+
+.session-execute-view h2 {
+  font-size: 20px;
+  font-weight: 600;
+  margin-bottom: 12px;
+}
+
+/* Progress */
+.progress-section {
+  display: flex;
+  align-items: center;
+  gap: 10px;
+  margin-bottom: 20px;
+}
+
+.progress-bar-track {
+  flex: 1;
+  height: 8px;
+  background: var(--border-color);
+  border-radius: 4px;
+  overflow: hidden;
+}
+
+.progress-bar-fill {
+  height: 100%;
+  background: var(--btn-primary-bg);
+  border-radius: 4px;
+  transition: width 0.3s ease;
+}
+
+.progress-label {
+  font-size: 13px;
+  color: var(--color-text-muted);
+  white-space: nowrap;
+}
+
+/* Step labels */
+.step-label {
+  font-size: 12px;
+  font-weight: 600;
+  text-transform: uppercase;
+  letter-spacing: 0.05em;
+  color: var(--color-text-muted);
+  margin-bottom: 6px;
+}
+
+.next-label {
+  margin-top: 16px;
+}
+
+/* Current step card */
+.step-card {
+  padding: 16px;
+  margin-bottom: 0;
+}
+
+.step-card h3 {
+  font-size: 20px;
+  font-weight: 700;
+  margin-bottom: 4px;
+}
+
+.exercise-title-btn {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+  background: none;
+  border: none;
+  padding: 0;
+  cursor: pointer;
+  color: inherit;
+  font-size: inherit;
+  font-weight: inherit;
+  text-align: left;
+  width: 100%;
+}
+
+.exercise-title-btn:hover {
+  opacity: 0.8;
+}
+
+.detail-chevron {
+  font-size: 14px;
+  flex-shrink: 0;
+  color: var(--color-text-muted);
+}
+
+/* Exercise detail panel */
+.exercise-detail-panel {
+  margin: 8px 0 12px;
+  padding: 10px 12px;
+  border-radius: 8px;
+  background: var(--color-surface, var(--front-color));
+  border: 1px solid var(--border-color);
+}
+
+.detail-loading {
+  font-size: 13px;
+  margin: 0;
+}
+
+.detail-description {
+  font-size: 14px;
+  line-height: 1.5;
+  margin-bottom: 8px;
+}
+
+.detail-description :deep(p) {
+  margin: 0 0 6px;
+}
+
+.detail-description :deep(p:last-child) {
+  margin-bottom: 0;
+}
+
+.detail-description :deep(ul),
+.detail-description :deep(ol) {
+  margin: 0 0 6px;
+  padding-left: 18px;
+}
+
+.detail-description :deep(strong) {
+  font-weight: 600;
+}
+
+.detail-images {
+  display: flex;
+  gap: 8px;
+  flex-wrap: wrap;
+  margin-top: 8px;
+}
+
+.detail-image {
+  width: 120px;
+  height: 80px;
+  object-fit: cover;
+  border-radius: 6px;
+  border: 1px solid var(--border-color);
+}
+
+.detail-videos {
+  display: flex;
+  flex-direction: column;
+  gap: 8px;
+  margin-top: 8px;
+}
+
+.detail-video-link {
+  display: inline-flex;
+  align-items: center;
+  gap: 6px;
+  font-size: 13px;
+  color: var(--btn-primary-bg);
+  text-decoration: none;
+}
+
+.detail-video-link:hover {
+  opacity: 0.8;
+}
+
+.detail-yt-thumb {
+  width: 160px;
+  max-width: 100%;
+  border-radius: 6px;
+  border: 1px solid var(--border-color);
+  display: block;
+}
+
+.detail-offline {
+  font-size: 13px;
+  display: inline-flex;
+  align-items: center;
+  gap: 6px;
+  margin: 0;
+}
+
+.combo-context {
+  font-size: 13px;
+  margin-bottom: 12px;
+}
+
+/* Inputs */
+.step-inputs {
+  display: flex;
+  flex-direction: column;
+  gap: 10px;
+  margin: 14px 0;
+}
+
+.input-row {
+  display: flex;
+  align-items: center;
+  gap: 10px;
+}
+
+.input-label {
+  width: 70px;
+  font-size: 14px;
+  font-weight: 500;
+  flex-shrink: 0;
+}
+
+.stepper {
+  display: flex;
+  align-items: center;
+  gap: 4px;
+}
+
+.stepper-btn {
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  width: 44px;
+  height: 44px;
+  border: none;
+  border-radius: 8px;
+  cursor: pointer;
+  font-size: 22px;
+  flex-shrink: 0;
+  transition: opacity 0.15s;
+}
+
+.stepper-btn:hover {
+  opacity: 0.8;
+}
+
+.stepper-btn:active {
+  opacity: 0.6;
+}
+
+.stepper-btn-fast {
+  background: var(--btn-primary-bg);
+  color: var(--btn-primary-color);
+}
+
+.step-input {
+  width: 64px;
+  padding: 6px 4px;
+  border: 1px solid var(--border-color);
+  border-radius: 6px;
+  background: var(--color-background);
+  color: var(--color-text);
+  font-size: 18px;
+  font-weight: 600;
+  text-align: center;
+}
+
+/* hide native number spinners */
+.step-input::-webkit-inner-spin-button,
+.step-input::-webkit-outer-spin-button {
+  -webkit-appearance: none;
+  margin: 0;
+}
+
+.step-input[type='number'] {
+  -moz-appearance: textfield;
+}
+
+.step-input:focus {
+  outline: none;
+  border-color: var(--btn-primary-bg);
+}
+
+.input-unit {
+  font-size: 13px;
+  color: var(--color-text-muted);
+}
+
+.asym-hint {
+  font-size: 12px;
+}
+
+.side-toggle {
+  padding: 6px 14px;
+  border: 1px solid var(--btn-primary-bg);
+  border-radius: 6px;
+  background: var(--btn-primary-bg);
+  color: var(--btn-primary-color);
+  cursor: pointer;
+  font-size: 14px;
+  font-weight: 600;
+}
+
+.side-toggle:hover {
+  opacity: 0.85;
+}
+
+.done-btn {
+  width: 100%;
+  margin-top: 4px;
+  font-size: 16px;
+  padding: 10px;
+}
+
+/* Next step */
+.next-step-preview {
+  font-size: 14px;
+  padding: 10px 12px;
+  background: var(--color-surface, var(--front-color));
+  border-radius: 8px;
+  border: 1px solid var(--border-color);
+}
+
+.next-title {
+  font-weight: 600;
+}
+
+/* Final round / time-up */
+.final-round-card {
+  padding: 24px;
+  text-align: center;
+}
+
+.final-round-message {
+  font-size: 18px;
+  font-weight: 600;
+  margin-bottom: 20px;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  gap: 10px;
+  color: var(--btn-primary-bg);
+}
+
+.final-round-message i {
+  font-size: 24px;
+}
+
+.final-round-actions {
+  display: flex;
+  gap: 12px;
+  justify-content: center;
+  flex-wrap: wrap;
+}
+
+/* TABATA rest screen */
+.rest-card {
+  padding: 24px;
+  text-align: center;
+}
+
+.rest-label {
+  font-size: 28px;
+  font-weight: 800;
+  letter-spacing: 0.1em;
+  color: var(--btn-primary-bg);
+  margin-bottom: 8px;
+}
+
+.rest-next {
+  font-size: 14px;
+  margin-bottom: 0;
+}
+
+/* Complete */
+.session-complete {
+  text-align: center;
+  padding: 40px 20px;
+}
+
+.complete-icon {
+  font-size: 48px;
+  color: var(--btn-primary-bg);
+  margin-bottom: 16px;
+  display: block;
+}
+
+.session-complete p {
+  font-size: 18px;
+  font-weight: 600;
+  margin-bottom: 20px;
+}
+
+/* Shared btn styles (mirror what's in layout.css) */
+.btn {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  gap: 6px;
+  padding: 8px 18px;
+  border-radius: 8px;
+  border: none;
+  cursor: pointer;
+  font-size: 14px;
+  font-weight: 500;
+  transition: opacity 0.15s;
+}
+
+.btn:hover {
+  opacity: 0.85;
+}
+
+.btn-primary {
+  background: var(--btn-primary-bg);
+  color: var(--btn-primary-color);
+}
+
+.btn-secondary {
+  background: var(--front-color2);
+  color: var(--btn-primary-color);
+}
+
+.text-danger {
+  color: var(--color-danger, #dc3545);
+}
+</style>
diff --git a/src/views/SessionFormView.vue b/src/views/SessionFormView.vue
new file mode 100644
index 0000000..27f66c5
--- /dev/null
+++ b/src/views/SessionFormView.vue
@@ -0,0 +1,710 @@
+<script setup>
+import { ref, computed, onMounted } from 'vue'
+import { useTranslation } from 'i18next-vue'
+import { useRouter, useRoute } from 'vue-router'
+import { useSessions } from '../composables/useSessions.js'
+import { useExercises } from '../composables/useExercises.js'
+import { useCombos } from '../composables/useCombos.js'
+import { useSettings } from '../composables/useSettings.js'
+import { validateRequired } from '../utils/validation.js'
+import { sessionRepository } from '../db/repositories/sessionRepository.js'
+import { useKeyboardShortcut } from '../composables/useKeyboardShortcut.js'
+
+const { t } = useTranslation()
+const router = useRouter()
+const route = useRoute()
+const { create, update, getById } = useSessions()
+const { exercises: allExercises, fetchAll: fetchExercises } = useExercises()
+const { combos: allCombos, fetchAll: fetchCombos } = useCombos()
+const { get: getSetting } = useSettings()
+
+const isEdit = computed(() => route.name === 'session-edit')
+const sessionId = computed(() => route.params.id)
+
+// Form fields
+const title = ref('')
+const description = ref('')
+const selectedItems = ref([])
+
+// Validation errors
+const errors = ref({})
+const saving = ref(false)
+
+// Item selector
+const newItemType = ref('exercise')
+const newItemId = ref('')
+
+onMounted(async () => {
+  await fetchExercises()
+  await fetchCombos()
+
+  if (isEdit.value && sessionId.value) {
+    const session = await getById(sessionId.value)
+    if (!session) {
+      router.replace({ name: 'sessions' })
+      return
+    }
+    title.value = session.title
+    description.value = session.description || ''
+    selectedItems.value = (session.items || []).map((item) => {
+      let asymmetric = false
+      if (item.item_type === 'exercise') {
+        const ex = allExercises.value.find((e) => e.id === item.item_id)
+        asymmetric = ex?.asymmetric || false
+      }
+      return {
+        item_id: item.item_id,
+        item_type: item.item_type,
+        repetitions: item.repetitions || 1,
+        weight: item.weight || 0.0,
+        asymmetric,
+      }
+    })
+  }
+})
+
+function validate() {
+  const e = {}
+  const titleErr = validateRequired(title.value)
+  if (titleErr) e.title = titleErr
+  errors.value = e
+  return Object.keys(e).length === 0
+}
+
+function addItem() {
+  if (!newItemId.value) return
+  let repetitions = 1
+  let asymmetric = false
+  if (newItemType.value === 'exercise') {
+    const ex = allExercises.value.find((e) => e.id === newItemId.value)
+    repetitions = ex?.default_reps || 1
+    asymmetric = ex?.asymmetric || false
+    if (asymmetric && repetitions % 2 !== 0) repetitions++
+  } else if (newItemType.value === 'combo') {
+    const combo = allCombos.value.find((c) => c.id === newItemId.value)
+    if (combo?.type === 'EMOM') {
+      repetitions = combo.timer_config?.duration || 1
+    }
+  }
+  selectedItems.value.push({
+    item_id: newItemId.value,
+    item_type: newItemType.value,
+    repetitions,
+    weight: 0.0,
+    asymmetric,
+  })
+  newItemId.value = ''
+}
+
+function enforceEvenReps(item) {
+  if (item.asymmetric && item.repetitions > 0 && item.repetitions % 2 !== 0) {
+    item.repetitions++
+  }
+}
+
+function removeItem(index) {
+  selectedItems.value.splice(index, 1)
+}
+
+function moveItemUp(index) {
+  if (index === 0) return
+  const arr = selectedItems.value
+  ;[arr[index - 1], arr[index]] = [arr[index], arr[index - 1]]
+}
+
+function moveItemDown(index) {
+  if (index === selectedItems.value.length - 1) return
+  const arr = selectedItems.value
+  ;[arr[index], arr[index + 1]] = [arr[index + 1], arr[index]]
+}
+
+function getItemTitle(item) {
+  if (item.item_type === 'exercise') {
+    const ex = allExercises.value.find((e) => e.id === item.item_id)
+    return ex ? ex.title : item.item_id
+  }
+  const combo = allCombos.value.find((c) => c.id === item.item_id)
+  return combo ? combo.title : item.item_id
+}
+
+function getItemTypeLabel(itemType) {
+  return itemType === 'exercise' ? t('sessions.itemType.exercise') : t('sessions.itemType.combo')
+}
+
+function getItemComboType(item) {
+  if (item.item_type !== 'combo') return null
+  const combo = allCombos.value.find((c) => c.id === item.item_id)
+  return combo?.type || null
+}
+
+function repsLabel(item) {
+  const comboType = getItemComboType(item)
+  return comboType === 'AMRAP' || comboType === 'EMOM'
+    ? t('sessions.form.durationMin')
+    : t('sessions.form.reps')
+}
+
+async function onSave() {
+  if (!validate()) return
+
+  saving.value = true
+  try {
+    const userUuid = await getSetting('user_uuid')
+    const data = {
+      title: title.value.trim(),
+      description: description.value.trim(),
+      created_by: userUuid,
+    }
+
+    let id
+    if (isEdit.value) {
+      await update(sessionId.value, data)
+      id = sessionId.value
+    } else {
+      id = await create(data)
+    }
+
+    // Save items
+    await sessionRepository.setItems(id, selectedItems.value)
+
+    router.push({ name: 'session-detail', params: { id } })
+  } catch (e) {
+    if (e.message && e.message.includes('UNIQUE')) {
+      errors.value = { ...errors.value, title: 'validation.titleTaken' }
+    } else {
+      errors.value = { ...errors.value, save: e.message }
+    }
+  } finally {
+    saving.value = false
+  }
+}
+
+useKeyboardShortcut('enter', onSave, { ctrl: true, ignoreInputs: false })
+useKeyboardShortcut('escape', onCancel, { ignoreInputs: false })
+
+function onCancel() {
+  if (isEdit.value) {
+    router.push({ name: 'session-detail', params: { id: sessionId.value } })
+  } else {
+    router.push({ name: 'sessions' })
+  }
+}
+</script>
+
+<template>
+  <Teleport to="#actionbar-actions" defer>
+    <button
+      data-testid="session-form-cancel"
+      :title="$t('sessions.form.cancel')"
+      :aria-label="$t('sessions.form.cancel')"
+      @click="onCancel"
+    >
+      <i class="bi bi-x-lg"></i>
+    </button>
+  </Teleport>
+
+  <div class="session-form-view">
+    <h2 data-testid="session-form-heading">
+      {{ isEdit ? $t('sessions.edit') : $t('sessions.new') }}
+    </h2>
+
+    <form novalidate @submit.prevent="onSave">
+      <!-- Title -->
+      <div class="form-group">
+        <label for="session-title">{{ $t('sessions.form.title') }} *</label>
+        <input
+          id="session-title"
+          v-model="title"
+          data-testid="session-title"
+          type="text"
+          :placeholder="$t('sessions.form.titlePlaceholder')"
+          :class="{ 'input-error': errors.title }"
+          required
+          aria-required="true"
+          :aria-describedby="errors.title ? 'session-title-error' : undefined"
+        />
+        <p
+          v-if="errors.title"
+          id="session-title-error"
+          role="alert"
+          class="field-error"
+          data-testid="session-title-error"
+        >
+          {{ $t(errors.title) }}
+        </p>
+      </div>
+
+      <!-- Description -->
+      <div class="form-group">
+        <label for="session-description">
+          {{ $t('sessions.form.description') }}
+          <span class="field-hint">{{ $t('common.markdownHint') }}</span>
+        </label>
+        <textarea
+          id="session-description"
+          v-model="description"
+          data-testid="session-description"
+          :placeholder="$t('sessions.form.descriptionPlaceholder')"
+          rows="3"
+        ></textarea>
+      </div>
+
+      <!-- Item selector -->
+      <div class="form-group">
+        <label>{{ $t('sessions.form.items') }}</label>
+
+        <!-- Selected items list -->
+        <ol v-if="selectedItems.length" class="item-order-list">
+          <li
+            v-for="(item, index) in selectedItems"
+            :key="'item-' + index"
+            class="item-order-item"
+            :data-testid="'session-item-' + index"
+          >
+            <span class="item-order-number">{{ index + 1 }}</span>
+            <span class="item-order-type">{{ getItemTypeLabel(item.item_type) }}</span>
+            <span class="item-order-title">{{ getItemTitle(item) }}</span>
+            <div class="item-order-fields">
+              <div class="item-field">
+                <label :for="'session-item-reps-' + index">{{ repsLabel(item) }}</label>
+                <div class="stepper">
+                  <button
+                    type="button"
+                    class="stepper-btn btn-primary"
+                    @click="
+                      item.repetitions = Math.max(
+                        item.asymmetric ? 2 : 1,
+                        item.repetitions - (item.asymmetric ? 2 : 1),
+                      )
+                    "
+                  >
+                    <i class="bi bi-dash-circle-fill"></i>
+                  </button>
+                  <input
+                    :id="'session-item-reps-' + index"
+                    v-model.number="item.repetitions"
+                    :data-testid="'session-item-reps-' + index"
+                    type="number"
+                    :min="item.asymmetric ? 2 : 1"
+                    :step="item.asymmetric ? 2 : 1"
+                    class="step-input"
+                    @change="enforceEvenReps(item)"
+                  />
+                  <button
+                    type="button"
+                    class="stepper-btn btn-primary"
+                    @click="item.repetitions += item.asymmetric ? 2 : 1"
+                  >
+                    <i class="bi bi-plus-circle-fill"></i>
+                  </button>
+                  <button
+                    type="button"
+                    class="stepper-btn stepper-btn-fast"
+                    @click="item.repetitions += item.asymmetric ? 10 : 5"
+                  >
+                    <i class="bi bi-forward-fill"></i>
+                  </button>
+                </div>
+              </div>
+              <div v-if="item.item_type === 'exercise'" class="item-field">
+                <label :for="'session-item-weight-' + index">{{
+                  $t('sessions.form.weight')
+                }}</label>
+                <div class="stepper">
+                  <button
+                    type="button"
+                    class="stepper-btn btn-primary"
+                    @click="item.weight = Math.max(0, +(item.weight - 0.5).toFixed(1))"
+                  >
+                    <i class="bi bi-dash-circle-fill"></i>
+                  </button>
+                  <input
+                    :id="'session-item-weight-' + index"
+                    v-model.number="item.weight"
+                    :data-testid="'session-item-weight-' + index"
+                    type="number"
+                    min="0"
+                    step="0.5"
+                    class="step-input"
+                  />
+                  <button
+                    type="button"
+                    class="stepper-btn btn-primary"
+                    @click="item.weight = +(item.weight + 0.5).toFixed(1)"
+                  >
+                    <i class="bi bi-plus-circle-fill"></i>
+                  </button>
+                  <button
+                    type="button"
+                    class="stepper-btn stepper-btn-fast"
+                    @click="item.weight = +(item.weight + 1).toFixed(1)"
+                  >
+                    <i class="bi bi-forward-fill"></i>
+                  </button>
+                </div>
+              </div>
+            </div>
+            <div class="item-order-actions">
+              <button
+                type="button"
+                class="btn-move"
+                :data-testid="'session-item-move-up-' + index"
+                :disabled="index === 0"
+                @click="moveItemUp(index)"
+              >
+                <i class="bi bi-chevron-up"></i>
+              </button>
+              <button
+                type="button"
+                class="btn-move"
+                :data-testid="'session-item-move-down-' + index"
+                :disabled="index === selectedItems.length - 1"
+                @click="moveItemDown(index)"
+              >
+                <i class="bi bi-chevron-down"></i>
+              </button>
+              <button
+                type="button"
+                class="btn-remove"
+                :data-testid="'session-item-remove-' + index"
+                @click="removeItem(index)"
+              >
+                <i class="bi bi-trash"></i>
+              </button>
+            </div>
+          </li>
+        </ol>
+        <p v-if="selectedItems.some((i) => i.asymmetric)" class="field-hint">
+          {{ $t('exercises.evenRepsHint') }}
+        </p>
+
+        <!-- Add item -->
+        <div class="item-add">
+          <select v-model="newItemType" data-testid="session-item-type-select">
+            <option value="exercise">{{ $t('sessions.itemType.exercise') }}</option>
+            <option value="combo">{{ $t('sessions.itemType.combo') }}</option>
+          </select>
+          <select
+            v-model="newItemId"
+            data-testid="session-item-select"
+            :disabled="
+              (newItemType === 'exercise' && allExercises.length === 0) ||
+              (newItemType === 'combo' && allCombos.length === 0)
+            "
+          >
+            <option value="" disabled>
+              {{
+                newItemType === 'exercise'
+                  ? allExercises.length === 0
+                    ? $t('sessions.form.noExercises')
+                    : $t('sessions.form.selectExercise')
+                  : allCombos.length === 0
+                    ? $t('sessions.form.noCombos')
+                    : $t('sessions.form.selectCombo')
+              }}
+            </option>
+            <template v-if="newItemType === 'exercise'">
+              <option v-for="ex in allExercises" :key="ex.id" :value="ex.id">
+                {{ ex.title }}
+              </option>
+            </template>
+            <template v-else>
+              <option v-for="combo in allCombos" :key="combo.id" :value="combo.id">
+                {{ combo.title }}
+              </option>
+            </template>
+          </select>
+          <button
+            type="button"
+            class="btn btn-primary btn-sm"
+            data-testid="session-item-add"
+            :disabled="!newItemId"
+            @click="addItem"
+          >
+            <i class="bi bi-plus"></i> {{ $t('sessions.form.addItem') }}
+          </button>
+        </div>
+      </div>
+
+      <!-- Save error -->
+      <p v-if="errors.save" class="field-error" data-testid="session-save-error">
+        {{ errors.save }}
+      </p>
+
+      <!-- Actions -->
+      <div class="form-actions">
+        <button
+          type="submit"
+          class="btn btn-primary"
+          data-testid="session-save"
+          :disabled="saving"
+          :title="$t('sessions.form.save') + ' ' + $t('shortcuts.save')"
+        >
+          <i class="bi bi-check-lg"></i>
+          {{ $t('sessions.form.save') }}
+        </button>
+        <button type="button" class="btn" data-testid="session-cancel" @click="onCancel">
+          {{ $t('sessions.form.cancel') }}
+        </button>
+      </div>
+    </form>
+  </div>
+</template>
+
+<style scoped>
+.session-form-view {
+  max-width: 600px;
+}
+
+.session-form-view h2 {
+  margin-bottom: 16px;
+  font-size: 20px;
+}
+
+.form-group {
+  margin-bottom: 16px;
+}
+
+.form-group label {
+  display: flex;
+  align-items: baseline;
+  gap: 6px;
+  font-weight: 600;
+  font-size: 14px;
+  margin-bottom: 4px;
+}
+
+.field-hint {
+  font-weight: 400;
+  font-size: 11px;
+  opacity: 0.55;
+}
+
+.input-error {
+  border-color: var(--btn-danger-bg) !important;
+}
+
+.field-error {
+  color: var(--btn-danger-bg);
+  font-size: 13px;
+  margin: 4px 0 0;
+}
+
+.field-hint {
+  color: var(--color-text-muted);
+  font-size: 12px;
+  margin: 4px 0 0;
+}
+
+select {
+  width: 100%;
+  padding: 8px 12px;
+  border: 1px solid var(--border-color);
+  border-radius: 4px;
+  background-color: var(--color-background);
+  color: var(--color-text);
+  font-size: 14px;
+}
+
+.item-order-list {
+  list-style: none;
+  padding: 0;
+  margin: 0 0 8px;
+}
+
+.item-order-item {
+  display: flex;
+  align-items: center;
+  flex-wrap: wrap;
+  gap: 8px;
+  padding: 8px 4px;
+  border-bottom: 1px solid var(--border-color);
+}
+
+.item-order-number {
+  width: 24px;
+  height: 24px;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  border-radius: 50%;
+  background-color: var(--btn-primary-bg);
+  color: var(--btn-primary-color);
+  font-size: 12px;
+  font-weight: 600;
+  flex-shrink: 0;
+}
+
+.item-order-type {
+  font-size: 11px;
+  padding: 2px 6px;
+  border-radius: 4px;
+  background-color: var(--front-color2);
+  color: var(--btn-primary-color);
+  flex-shrink: 0;
+}
+
+.item-order-title {
+  flex: 1;
+  font-size: 14px;
+  min-width: 0;
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+}
+
+.item-order-fields {
+  order: 3;
+  width: 100%;
+  display: flex;
+  flex-direction: column;
+  gap: 8px;
+}
+
+.item-field {
+  display: flex;
+  flex-direction: row;
+  align-items: center;
+  gap: 8px;
+}
+
+.item-field label {
+  font-size: 12px;
+  font-weight: 600;
+  color: var(--color-text-muted);
+  width: 90px;
+  flex-shrink: 0;
+  white-space: nowrap;
+}
+
+.stepper {
+  display: flex;
+  align-items: center;
+  gap: 4px;
+}
+
+.stepper-btn {
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  width: 36px;
+  height: 36px;
+  border: none;
+  border-radius: 6px;
+  cursor: pointer;
+  font-size: 18px;
+  flex-shrink: 0;
+  transition: opacity 0.15s;
+}
+
+.stepper-btn:hover {
+  opacity: 0.8;
+}
+
+.stepper-btn:active {
+  opacity: 0.6;
+}
+
+.stepper-btn-fast {
+  background: var(--btn-primary-bg);
+  color: var(--btn-primary-color);
+}
+
+.step-input {
+  width: 56px;
+  padding: 4px 2px;
+  border: 1px solid var(--border-color);
+  border-radius: 6px;
+  background: var(--color-background);
+  color: var(--color-text);
+  font-size: 15px;
+  font-weight: 600;
+  text-align: center;
+}
+
+.item-order-actions {
+  display: flex;
+  gap: 4px;
+  flex-shrink: 0;
+}
+
+.btn-move {
+  background: none;
+  border: none;
+  color: var(--color-text);
+  cursor: pointer;
+  padding: 4px;
+  font-size: 14px;
+  display: flex;
+  align-items: center;
+}
+
+.btn-move:disabled {
+  opacity: 0.3;
+  cursor: not-allowed;
+}
+
+.btn-move:hover:not(:disabled) {
+  color: var(--btn-primary-bg);
+}
+
+.btn-remove {
+  background: none;
+  border: none;
+  color: var(--btn-danger-bg);
+  cursor: pointer;
+  padding: 4px;
+  font-size: 14px;
+  display: flex;
+  align-items: center;
+}
+
+.btn-remove:hover {
+  opacity: 0.7;
+}
+
+.item-add {
+  display: flex;
+  gap: 8px;
+  align-items: flex-start;
+}
+
+.item-add select {
+  flex: 1;
+}
+
+.btn-sm {
+  padding: 6px 12px;
+  font-size: 13px;
+  white-space: nowrap;
+}
+
+.form-actions {
+  display: flex;
+  gap: 8px;
+  margin-top: 24px;
+}
+
+@media screen and (max-width: 400px) {
+  .item-order-number {
+    display: none;
+  }
+
+  .item-order-title {
+    flex: 1 1 auto;
+  }
+
+  .item-order-actions {
+    order: 2;
+  }
+
+  .form-actions {
+    flex-wrap: wrap;
+  }
+
+  .form-actions .btn {
+    flex: 1 1 auto;
+    justify-content: center;
+  }
+}
+</style>
diff --git a/src/views/SessionListView.vue b/src/views/SessionListView.vue
new file mode 100644
index 0000000..08504b8
--- /dev/null
+++ b/src/views/SessionListView.vue
@@ -0,0 +1,348 @@
+<script setup>
+import { ref, nextTick, onMounted, watch, computed } from 'vue'
+import { useTranslation } from 'i18next-vue'
+import { useRouter } from 'vue-router'
+import { useSessions } from '../composables/useSessions.js'
+import { useJsonExport } from '../composables/useJsonExport.js'
+import { useJsonImport } from '../composables/useJsonImport.js'
+import { useSettings } from '../composables/useSettings.js'
+import { useKeyboardShortcut } from '../composables/useKeyboardShortcut.js'
+import { useListNavigation } from '../composables/useListNavigation.js'
+import ImportDialog from '../components/ImportDialog.vue'
+
+const { t } = useTranslation()
+const router = useRouter()
+const { sessions, loading, fetchAll, search } = useSessions()
+const { exportAllSessions } = useJsonExport()
+const { loadFile } = useJsonImport()
+const { settings, fetchAll: fetchSettings } = useSettings()
+const localUuid = ref('')
+
+// Import dialog state
+const showImportDialog = ref(false)
+const importEnvelope = ref(null)
+const importAsMine = ref(false)
+
+const searchQuery = ref('')
+const searching = ref(false)
+const searchInput = ref(null)
+
+onMounted(async () => {
+  fetchAll()
+  await fetchSettings()
+  localUuid.value = settings.value.user_uuid || ''
+})
+
+let searchTimeout = null
+watch(searchQuery, (query) => {
+  clearTimeout(searchTimeout)
+  const trimmed = query.trim()
+  if (!trimmed) {
+    fetchAll()
+    return
+  }
+  searchTimeout = setTimeout(() => {
+    search(trimmed)
+  }, 250)
+})
+
+function goToNew() {
+  router.push({ name: 'session-new' })
+}
+
+useKeyboardShortcut('n', goToNew)
+
+const sessionCount = computed(() => sessions.value.length)
+const { focusedIndex: focusedSessionIndex } = useListNavigation(sessionCount, (index) => {
+  goToDetail(sessions.value[index].id)
+})
+
+function goToDetail(id) {
+  router.push({ name: 'session-detail', params: { id } })
+}
+
+function goToExecute(id, event) {
+  event.stopPropagation()
+  router.push({ name: 'session-execute', params: { id } })
+}
+
+function toggleSearch() {
+  searching.value = !searching.value
+  if (searching.value) {
+    nextTick(() => {
+      searchInput.value?.focus()
+    })
+  } else {
+    searchQuery.value = ''
+    fetchAll()
+  }
+}
+
+function onSearchBlur() {
+  if (!searchQuery.value.trim()) {
+    searching.value = false
+  }
+}
+
+function clearSearch() {
+  searchQuery.value = ''
+  searchInput.value?.focus()
+}
+
+async function onExport() {
+  await exportAllSessions(searchQuery.value.trim())
+}
+
+async function onImport(asMine = false) {
+  const result = await loadFile()
+  if (result.cancelled) return
+  if (result.error) {
+    window.alert(t(result.error))
+    return
+  }
+  importEnvelope.value = result.envelope
+  importAsMine.value = asMine
+  showImportDialog.value = true
+}
+
+function onImportDone() {
+  showImportDialog.value = false
+  importEnvelope.value = null
+  importAsMine.value = false
+  fetchAll()
+}
+
+function onImportClose() {
+  showImportDialog.value = false
+  importEnvelope.value = null
+  importAsMine.value = false
+}
+</script>
+
+<template>
+  <Teleport to="#actionbar-actions" defer>
+    <button
+      data-testid="session-search-toggle"
+      :title="$t('sessions.searchPlaceholder')"
+      :aria-label="$t('sessions.searchPlaceholder')"
+      @click="toggleSearch"
+    >
+      <i class="bi bi-search"></i>
+    </button>
+    <button
+      data-testid="session-export-btn"
+      :title="$t('export.sessions')"
+      :aria-label="$t('export.sessions')"
+      @click="onExport"
+    >
+      <i class="bi bi-download"></i>
+    </button>
+    <button
+      data-testid="session-import-btn"
+      :title="$t('import.exercises')"
+      :aria-label="$t('import.exercises')"
+      @click="onImport(false)"
+    >
+      <i class="bi bi-upload"></i>
+    </button>
+    <button
+      data-testid="session-import-as-mine-btn"
+      :title="$t('import.importAsMine')"
+      :aria-label="$t('import.importAsMine')"
+      @click="onImport(true)"
+    >
+      <i class="bi bi-person-check"></i>
+    </button>
+    <button
+      data-testid="session-new-btn"
+      :title="$t('sessions.new') + ' ' + $t('shortcuts.new')"
+      :aria-label="$t('sessions.new')"
+      @click="goToNew"
+    >
+      <i class="bi bi-plus-lg"></i>
+    </button>
+  </Teleport>
+
+  <div class="session-list-view">
+    <!-- Search bar -->
+    <div v-if="searching" class="search-bar" data-testid="session-search-bar">
+      <input
+        ref="searchInput"
+        v-model="searchQuery"
+        type="text"
+        :placeholder="$t('sessions.searchPlaceholder')"
+        data-testid="session-search-input"
+        @blur="onSearchBlur"
+      />
+      <button
+        v-if="searchQuery"
+        type="button"
+        class="search-clear-btn"
+        data-testid="session-search-clear"
+        :title="$t('common.clearSearch')"
+        :aria-label="$t('common.clearSearch')"
+        @mousedown.prevent="clearSearch"
+      >
+        <i class="bi bi-x-lg"></i>
+      </button>
+    </div>
+
+    <!-- Loading state -->
+    <p v-if="loading" class="text-muted">{{ $t('app.loading') }}</p>
+
+    <!-- Empty state -->
+    <p
+      v-else-if="sessions.length === 0 && !searchQuery.trim()"
+      class="text-muted"
+      data-testid="session-empty"
+    >
+      {{ $t('sessions.empty') }}
+    </p>
+
+    <!-- No search results -->
+    <p
+      v-else-if="sessions.length === 0 && searchQuery.trim()"
+      class="text-muted"
+      data-testid="session-no-results"
+    >
+      {{ $t('sessions.noResults') }}
+    </p>
+
+    <!-- Session cards -->
+    <div
+      v-for="(session, index) in sessions"
+      :key="session.id"
+      class="card session-card"
+      :class="{ 'card-focused': focusedSessionIndex === index }"
+      :data-testid="'session-card-' + session.id"
+      :data-list-index="index"
+      tabindex="0"
+      @click="goToDetail(session.id)"
+    >
+      <div class="session-card-header">
+        <h3 data-testid="session-card-title">{{ session.title }}</h3>
+        <span
+          v-if="session.items && session.items.length"
+          class="badge badge-info"
+          data-testid="session-card-item-count"
+        >
+          {{ session.items.length }} {{ $t('sessions.items') }}
+        </span>
+        <button
+          class="card-play-btn"
+          :data-testid="'session-card-play-' + session.id"
+          :title="$t('execution.start')"
+          :aria-label="$t('execution.start')"
+          @click="goToExecute(session.id, $event)"
+        >
+          <i class="bi bi-play-fill"></i>
+        </button>
+      </div>
+    </div>
+  </div>
+
+  <ImportDialog
+    v-if="showImportDialog && importEnvelope"
+    :envelope="importEnvelope"
+    :local-uuid="localUuid"
+    :as-mine="importAsMine"
+    @done="onImportDone"
+    @close="onImportClose"
+  />
+</template>
+
+<style scoped>
+.session-list-view {
+  max-width: 800px;
+}
+
+.search-bar {
+  position: relative;
+  margin-bottom: 16px;
+}
+
+.search-bar input {
+  padding-right: 36px;
+}
+
+.search-clear-btn {
+  position: absolute;
+  top: 50%;
+  right: 8px;
+  transform: translateY(-50%);
+  background: none;
+  border: none;
+  padding: 4px;
+  line-height: 1;
+  color: var(--front-color2);
+  cursor: pointer;
+}
+
+.session-card {
+  cursor: pointer;
+  transition: border-color 0.15s;
+}
+
+.session-card:hover {
+  border-color: var(--btn-primary-bg);
+}
+
+.session-card:focus-visible {
+  border-color: var(--btn-primary-bg);
+  box-shadow: 0 0 0 2px var(--btn-primary-bg);
+  outline: none;
+}
+
+.session-card.card-focused {
+  border-color: var(--btn-primary-bg);
+  box-shadow: 0 0 0 2px var(--btn-primary-bg);
+}
+
+.session-card-header {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+}
+
+.session-card-header h3 {
+  flex: 1;
+  font-size: 16px;
+  font-weight: 600;
+}
+
+.card-play-btn {
+  width: 32px;
+  height: 32px;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  border-radius: 50%;
+  border: none;
+  background: var(--btn-primary-bg);
+  color: var(--btn-primary-color);
+  cursor: pointer;
+  flex-shrink: 0;
+  font-size: 14px;
+  transition: opacity 0.15s;
+}
+
+.card-play-btn:hover {
+  opacity: 0.8;
+}
+
+.badge {
+  display: inline-flex;
+  align-items: center;
+  gap: 4px;
+  padding: 2px 8px;
+  border-radius: 12px;
+  font-size: 12px;
+  background-color: var(--btn-primary-bg);
+  color: var(--btn-primary-color);
+  white-space: nowrap;
+}
+
+.badge-info {
+  background-color: var(--front-color2);
+}
+</style>
diff --git a/src/views/SessionsView.vue b/src/views/SessionsView.vue
new file mode 100644
index 0000000..b596259
--- /dev/null
+++ b/src/views/SessionsView.vue
@@ -0,0 +1,6 @@
+<template>
+  <div class="placeholder-view">
+    <h2>{{ $t('sessions.title') }}</h2>
+    <p class="text-muted">{{ $t('sessions.empty') }}</p>
+  </div>
+</template>
diff --git a/src/views/SettingsView.vue b/src/views/SettingsView.vue
new file mode 100644
index 0000000..83be2a1
--- /dev/null
+++ b/src/views/SettingsView.vue
@@ -0,0 +1,1075 @@
+<script setup>
+import { ref, onMounted, computed } from 'vue'
+import { useTranslation } from 'i18next-vue'
+import { useSettings } from '../composables/useSettings.js'
+import { useAudioCues } from '../composables/useAudioCues.js'
+import { useBackupStatus } from '../composables/useBackupStatus.js'
+import { useBackupDownload } from '../composables/useBackupDownload.js'
+import { useJsonExport } from '../composables/useJsonExport.js'
+import { useJsonImport } from '../composables/useJsonImport.js'
+import { suffixRepository } from '../db/repositories/suffixRepository.js'
+import { db } from '../db/database.js'
+import { formatDateTime } from '../utils/dateFormatter.js'
+import ModalDialog from '../components/ModalDialog.vue'
+import ExportFilterDialog from '../components/ExportFilterDialog.vue'
+import ImportDialog from '../components/ImportDialog.vue'
+import CreditsDialog from '../components/CreditsDialog.vue'
+import AboutDialog from '../components/AboutDialog.vue'
+import CleanJournalDialog from '../components/CleanJournalDialog.vue'
+
+const { t, i18next } = useTranslation()
+const { settings, fetchAll, get, set } = useSettings()
+const { playBip, playBIP } = useAudioCues()
+const { exportByFilter, exportAll } = useJsonExport()
+const { loadFile } = useJsonImport()
+const { markBackedUp, load: loadBackupStatus } = useBackupStatus()
+const { downloadBackup } = useBackupDownload()
+
+const userName = ref('')
+const userUuid = ref('')
+const language = ref('en')
+const theme = ref('light')
+const audioVolume = ref(50)
+const nameError = ref('')
+const restoring = ref(false)
+const restoreReport = ref(null)
+const showInitializeDialog = ref(false)
+const showCreditsDialog = ref(false)
+const showAboutDialog = ref(false)
+const showCleanJournalDialog = ref(false)
+const initializeConfirmed = ref(false)
+const initializing = ref(false)
+
+// Backup reminder
+const lastBackupAtRaw = ref(null)
+const backupReminderDays = ref('7')
+const backupReminderDaysError = ref('')
+
+const lastBackupDisplay = computed(() => {
+  if (!lastBackupAtRaw.value) return ''
+  return formatDateTime(lastBackupAtRaw.value, language.value)
+})
+
+// Export/Import
+const showExportFilter = ref(false)
+const showImportDialog = ref(false)
+const importEnvelope = ref(null)
+const importAsMine = ref(false)
+
+// Suffix management
+const suffixes = ref([])
+const editingSuffix = ref(null)
+const editSuffixValue = ref('')
+const editSuffixError = ref('')
+const pendingDeleteSuffix = ref(null)
+
+onMounted(async () => {
+  await fetchAll()
+  userName.value = settings.value.user_name || ''
+  userUuid.value = settings.value.user_uuid || ''
+  language.value = settings.value.language || 'en'
+  theme.value = settings.value.theme || 'light'
+  const volumeStr = await get('audio_volume')
+  const parsed = parseInt(volumeStr, 10)
+  audioVolume.value = isNaN(parsed) ? 50 : parsed
+  await loadSuffixes()
+  await loadBackupInfo()
+  await loadBackupStatus()
+})
+
+async function onLanguageChange() {
+  const lang = language.value
+  await set('language', lang)
+  i18next.changeLanguage(lang)
+}
+
+async function onNameBlur() {
+  const trimmed = userName.value.trim()
+  if (!trimmed) {
+    nameError.value = t('settings.nameRequired')
+    return
+  }
+  nameError.value = ''
+  userName.value = trimmed
+  await set('user_name', trimmed)
+}
+
+async function onThemeChange() {
+  const newTheme = theme.value
+  await set('theme', newTheme)
+  document.documentElement.setAttribute('data-theme', newTheme)
+}
+
+async function onVolumeChange() {
+  await set('audio_volume', String(audioVolume.value))
+}
+
+function onSoundTest() {
+  const vol = audioVolume.value / 100
+  playBip(vol)
+  setTimeout(() => playBIP(vol), 300)
+}
+
+async function downloadDatabase() {
+  await downloadBackup()
+  await loadBackupInfo()
+}
+
+function restoreDatabase() {
+  const input = document.createElement('input')
+  input.type = 'file'
+  input.accept = '.sqlite3,.db'
+
+  input.onchange = async (e) => {
+    const file = e.target.files[0]
+    if (!file) return
+
+    const confirmed = window.confirm(t('settings.restoreDbWarning', { version: __APP_VERSION__ }))
+    if (!confirmed) return
+
+    restoring.value = true
+    restoreReport.value = null
+
+    try {
+      const bytes = await file.arrayBuffer()
+      const report = await db.importDatabase(new Uint8Array(bytes))
+      restoreReport.value = report
+
+      if (report.success) {
+        // Re-fetch settings to reflect restored data
+        await fetchAll()
+        userName.value = settings.value.user_name || ''
+        userUuid.value = settings.value.user_uuid || ''
+        language.value = settings.value.language || 'en'
+        theme.value = settings.value.theme || 'light'
+        // Apply restored language and theme
+        i18next.changeLanguage(language.value)
+        document.documentElement.setAttribute('data-theme', theme.value)
+        // Update backup timestamp
+        await markBackedUp()
+        await loadBackupInfo()
+      }
+    } catch (err) {
+      restoreReport.value = { success: false, error: 'UNEXPECTED', message: err.message }
+    } finally {
+      restoring.value = false
+    }
+  }
+
+  input.click()
+}
+
+function dismissReport() {
+  restoreReport.value = null
+}
+
+function openInitializeDialog() {
+  showInitializeDialog.value = true
+  initializeConfirmed.value = false
+}
+
+function cancelInitialize() {
+  showInitializeDialog.value = false
+  initializeConfirmed.value = false
+}
+
+async function confirmInitialize() {
+  if (!initializeConfirmed.value) return
+  initializing.value = true
+  try {
+    await db.resetDatabase()
+    window.location.reload()
+  } catch (err) {
+    console.error('Failed to reset database:', err)
+    window.alert(t('error.dbInitFailed'))
+  } finally {
+    initializing.value = false
+  }
+}
+
+// --- Export / Import ---
+
+async function onExportAll() {
+  await exportAll()
+}
+
+function onExportData() {
+  showExportFilter.value = true
+}
+
+async function onExportConfirm(filters) {
+  showExportFilter.value = false
+  await exportByFilter(filters)
+}
+
+async function onImportData(asMine = false) {
+  const result = await loadFile()
+  if (result.cancelled) return
+  if (result.error) {
+    window.alert(t(result.error))
+    return
+  }
+  importEnvelope.value = result.envelope
+  importAsMine.value = asMine
+  showImportDialog.value = true
+}
+
+function onImportDone() {
+  showImportDialog.value = false
+  importEnvelope.value = null
+  importAsMine.value = false
+}
+
+function onImportClose() {
+  showImportDialog.value = false
+  importEnvelope.value = null
+  importAsMine.value = false
+}
+
+// --- Suffix management ---
+
+async function loadSuffixes() {
+  suffixes.value = await suffixRepository.getAll()
+}
+
+function startEditSuffix(entry) {
+  editingSuffix.value = entry.user_uuid
+  editSuffixValue.value = entry.suffix
+  editSuffixError.value = ''
+}
+
+function cancelEditSuffix() {
+  editingSuffix.value = null
+  editSuffixValue.value = ''
+  editSuffixError.value = ''
+}
+
+async function saveEditSuffix(entry) {
+  const trimmed = editSuffixValue.value.trim()
+  if (!trimmed) {
+    editSuffixError.value = t('import.suffixRequired')
+    return
+  }
+  if (trimmed === entry.suffix) {
+    cancelEditSuffix()
+    return
+  }
+
+  // Check uniqueness
+  const existing = await suffixRepository.getBySuffix(trimmed)
+  if (existing && existing.user_uuid !== entry.user_uuid) {
+    editSuffixError.value = t('import.suffixTaken')
+    return
+  }
+
+  try {
+    await suffixRepository.renameSuffix(entry.user_uuid, trimmed)
+    await loadSuffixes()
+    cancelEditSuffix()
+  } catch (e) {
+    editSuffixError.value = e.message
+  }
+}
+
+async function deleteSuffix(entry) {
+  pendingDeleteSuffix.value = entry
+}
+
+async function confirmDeleteSuffix() {
+  const entry = pendingDeleteSuffix.value
+  if (!entry) return
+  await suffixRepository.delete(entry.user_uuid)
+  pendingDeleteSuffix.value = null
+  await loadSuffixes()
+}
+
+function cancelDeleteSuffix() {
+  pendingDeleteSuffix.value = null
+}
+
+// -- backup DB
+
+async function loadBackupInfo() {
+  const lastBackupAtStr = await get('last_backup_at')
+  if (lastBackupAtStr) {
+    lastBackupAtRaw.value = new Date(lastBackupAtStr)
+  } else {
+    lastBackupAtRaw.value = null
+  }
+
+  const daysStr = await get('backup_reminder_days')
+  if (daysStr !== null && daysStr !== undefined) {
+    backupReminderDays.value = daysStr
+  } else {
+    backupReminderDays.value = '7'
+  }
+}
+
+async function onBackupReminderDaysChange() {
+  const trimmed = String(backupReminderDays.value).trim()
+  const parsed = parseInt(trimmed, 10)
+  if (isNaN(parsed) || parsed < 1 || parsed > 365) {
+    backupReminderDaysError.value = t('settings.backupReminderInvalid')
+    return
+  }
+  backupReminderDaysError.value = ''
+  backupReminderDays.value = String(parsed)
+  await set('backup_reminder_days', String(parsed))
+  await loadBackupStatus()
+}
+</script>
+
+<template>
+  <div class="settings-view">
+    <!-- Language -->
+    <div class="card setting-card">
+      <label class="setting-label" for="settings-language">
+        <i class="bi bi-translate"></i>
+        {{ $t('settings.language') }}
+      </label>
+      <select
+        id="settings-language"
+        v-model="language"
+        data-testid="settings-language"
+        @change="onLanguageChange"
+      >
+        <option value="en">English</option>
+        <option value="fr">Français</option>
+        <option value="da">Dansk</option>
+      </select>
+    </div>
+
+    <!-- User Name -->
+    <div class="card setting-card">
+      <label class="setting-label" for="settings-username">
+        <i class="bi bi-person"></i>
+        {{ $t('settings.userName') }}
+      </label>
+      <input
+        id="settings-username"
+        v-model="userName"
+        data-testid="settings-username"
+        type="text"
+        :placeholder="$t('settings.userNamePlaceholder')"
+        @blur="onNameBlur"
+        @keyup.enter="onNameBlur"
+      />
+      <p v-if="nameError" class="field-error" data-testid="settings-name-error">{{ nameError }}</p>
+    </div>
+
+    <!-- UUID -->
+    <div class="card setting-card">
+      <label class="setting-label" for="settings-uuid">
+        <i class="bi bi-fingerprint"></i>
+        {{ $t('settings.userId') }}
+      </label>
+      <input
+        id="settings-uuid"
+        data-testid="settings-uuid"
+        type="text"
+        :value="userUuid"
+        readonly
+        class="input-readonly"
+      />
+    </div>
+
+    <!-- Theme -->
+    <div class="card setting-card">
+      <label class="setting-label" for="settings-theme">
+        <i class="bi bi-palette"></i>
+        {{ $t('settings.theme') }}
+      </label>
+      <select
+        id="settings-theme"
+        v-model="theme"
+        data-testid="settings-theme"
+        @change="onThemeChange"
+      >
+        <option value="light">{{ $t('settings.themeLight') }}</option>
+        <option value="dark">{{ $t('settings.themeDark') }}</option>
+        <option value="trainus">{{ $t('settings.themeTrainus') }}</option>
+      </select>
+    </div>
+
+    <!-- Sound -->
+    <div class="card setting-card">
+      <label class="setting-label">
+        <i class="bi bi-volume-up"></i>
+        {{ $t('settings.sound') }}
+      </label>
+      <div class="sound-row">
+        <label class="sound-volume-label" for="settings-volume">{{
+          $t('settings.soundVolume')
+        }}</label>
+        <input
+          id="settings-volume"
+          v-model.number="audioVolume"
+          data-testid="settings-volume"
+          type="range"
+          min="0"
+          max="100"
+          step="1"
+          class="volume-slider"
+          @change="onVolumeChange"
+        />
+        <span class="volume-value" data-testid="settings-volume-value">{{ audioVolume }}%</span>
+        <button class="btn btn-primary" data-testid="settings-sound-test" @click="onSoundTest">
+          <i class="bi bi-play-fill"></i>
+          {{ $t('settings.soundTest') }}
+        </button>
+      </div>
+    </div>
+
+    <!-- Restore overlay (spinner) -->
+    <div v-if="restoring" class="restore-overlay" data-testid="restore-spinner">
+      <div class="restore-spinner">
+        <i class="bi bi-arrow-repeat spin"></i>
+        <p>{{ $t('settings.restoreInProgress') }}</p>
+      </div>
+    </div>
+
+    <!-- Restore report -->
+    <div v-if="restoreReport" class="card setting-card restore-report" data-testid="restore-report">
+      <div :class="['report-header', restoreReport.success ? 'report-success' : 'report-error']">
+        <i :class="restoreReport.success ? 'bi bi-check-circle' : 'bi bi-exclamation-triangle'"></i>
+        <strong>{{
+          restoreReport.success ? $t('settings.restoreSuccess') : $t('settings.restoreError')
+        }}</strong>
+      </div>
+      <div class="report-body">
+        <template v-if="restoreReport.success">
+          <p v-if="restoreReport.adapted" data-testid="restore-adapted">
+            <i class="bi bi-arrow-left-right"></i>
+            {{
+              $t('settings.restoreAdapted', {
+                from: restoreReport.importedVersion,
+                to: restoreReport.currentVersion,
+              })
+            }}
+          </p>
+          <ul class="report-tables">
+            <li v-for="row in restoreReport.tablesRestored" :key="row.table">
+              <strong>{{ row.table }}</strong
+              >: {{ row.rows }} {{ $t('settings.restoreRows') }}
+            </li>
+          </ul>
+        </template>
+        <template v-else>
+          <p data-testid="restore-error-message">
+            {{
+              $t('settings.restoreErrorCodes.' + restoreReport.error, {
+                defaultValue: restoreReport.message,
+              })
+            }}
+          </p>
+        </template>
+      </div>
+      <button class="btn btn-primary" data-testid="restore-report-dismiss" @click="dismissReport">
+        {{ $t('settings.restoreDismiss') }}
+      </button>
+    </div>
+
+    <!-- Download / Restore Database -->
+    <div id="settings-backup-section" class="card setting-card">
+      <label class="setting-label">
+        <i class="bi bi-database-down"></i>
+        {{ $t('settings.database') }}
+      </label>
+      <div class="export-import-buttons">
+        <button
+          class="btn btn-primary flex-fill"
+          data-testid="settings-download-db"
+          @click="downloadDatabase"
+        >
+          <i class="bi bi-download"></i>
+          {{ $t('settings.downloadDb') }}
+        </button>
+        <button
+          class="btn btn-danger flex-fill"
+          data-testid="settings-restore-db"
+          :disabled="restoring"
+          @click="restoreDatabase"
+        >
+          <i class="bi bi-upload"></i>
+          {{ $t('settings.restoreDb') }}
+        </button>
+      </div>
+      <div class="export-import-buttons initialize-db-row">
+        <button
+          class="btn btn-danger"
+          data-testid="settings-initialize-db"
+          :disabled="initializing"
+          @click="openInitializeDialog"
+        >
+          <i class="bi bi-arrow-counterclockwise"></i>
+          {{ $t('settings.initializeDb') }}
+        </button>
+      </div>
+      <p class="text-muted">{{ $t('settings.downloadDbHint') }}</p>
+      <div class="backup-info">
+        <p class="backup-last-backup" data-testid="backup-last-backup">
+          <i class="bi bi-clock"></i>
+          {{
+            lastBackupDisplay
+              ? $t('settings.backup.lastBackup', { when: lastBackupDisplay })
+              : $t('settings.backup.neverBackedUp')
+          }}
+        </p>
+      </div>
+      <div class="backup-reminder-setting">
+        <label for="backup-reminder-days" class="reminder-label">
+          {{ $t('settings.backup.reminderEvery') }}
+        </label>
+        <input
+          id="backup-reminder-days"
+          v-model="backupReminderDays"
+          data-testid="backup-reminder-days"
+          type="text"
+          inputmode="numeric"
+          pattern="[0-9]*"
+          class="reminder-input"
+          @blur="onBackupReminderDaysChange"
+          @keyup.enter="onBackupReminderDaysChange"
+        />
+        <span class="reminder-unit">{{ $t('settings.backup.reminderEveryUnit') }}</span>
+        <p v-if="backupReminderDaysError" class="field-error" data-testid="backup-reminder-error">
+          {{ backupReminderDaysError }}
+        </p>
+      </div>
+    </div>
+
+    <!-- Export / Import -->
+    <div class="card setting-card">
+      <label class="setting-label">
+        <i class="bi bi-box-arrow-up"></i>
+        {{ $t('settings.exportImport') }}
+      </label>
+      <div class="export-import-grid">
+        <button class="btn btn-primary" data-testid="settings-export-all" @click="onExportAll">
+          <i class="bi bi-download"></i>
+          {{ $t('settings.exportAllData') }}
+        </button>
+        <button class="btn btn-primary" data-testid="settings-export" @click="onExportData">
+          <i class="bi bi-filter"></i>
+          {{ $t('settings.exportData') }}
+        </button>
+        <button class="btn btn-primary" data-testid="settings-import" @click="onImportData(false)">
+          <i class="bi bi-upload"></i>
+          {{ $t('settings.importData') }}
+        </button>
+        <button
+          class="btn btn-primary"
+          data-testid="settings-import-as-mine"
+          @click="onImportData(true)"
+        >
+          <i class="bi bi-person-check"></i>
+          {{ $t('settings.importAsMine') }}
+        </button>
+      </div>
+    </div>
+
+    <!-- Manage Exercise Logs -->
+    <div class="card setting-card">
+      <label class="setting-label">
+        <i class="bi bi-journal-x"></i>
+        {{ $t('settings.manageJournal') }}
+      </label>
+      <p class="text-muted">{{ $t('settings.manageJournalHint') }}</p>
+      <div>
+        <button
+          class="btn btn-danger"
+          data-testid="settings-clean-journal"
+          @click="showCleanJournalDialog = true"
+        >
+          <i class="bi bi-trash"></i>
+          {{ $t('settings.cleanJournalBtn') }}
+        </button>
+      </div>
+    </div>
+
+    <!-- Suffix Management -->
+    <div v-if="suffixes.length > 0" class="card setting-card" data-testid="suffix-management">
+      <label class="setting-label">
+        <i class="bi bi-people"></i>
+        {{ $t('settings.suffixManagement') }}
+      </label>
+      <p class="text-muted">{{ $t('settings.suffixHint') }}</p>
+      <div
+        v-for="entry in suffixes"
+        :key="entry.user_uuid"
+        class="suffix-entry"
+        :data-testid="'suffix-entry-' + entry.user_uuid"
+      >
+        <div class="suffix-info">
+          <strong>{{ entry.user_name }}</strong>
+          <template v-if="editingSuffix !== entry.user_uuid">
+            <span class="suffix-badge" data-testid="suffix-value">[{{ entry.suffix }}]</span>
+          </template>
+          <template v-else>
+            <input
+              v-model="editSuffixValue"
+              type="text"
+              class="suffix-edit-input"
+              data-testid="suffix-edit-input"
+              @keyup.enter="saveEditSuffix(entry)"
+              @keyup.escape="cancelEditSuffix"
+            />
+            <p v-if="editSuffixError" class="field-error" data-testid="suffix-edit-error">
+              {{ editSuffixError }}
+            </p>
+          </template>
+        </div>
+        <div class="suffix-actions">
+          <template v-if="editingSuffix !== entry.user_uuid">
+            <button
+              class="btn btn-sm"
+              data-testid="suffix-edit-btn"
+              @click="startEditSuffix(entry)"
+            >
+              <i class="bi bi-pencil"></i>
+            </button>
+            <button
+              class="btn btn-sm btn-danger"
+              data-testid="suffix-delete-btn"
+              @click="deleteSuffix(entry)"
+            >
+              <i class="bi bi-trash"></i>
+            </button>
+          </template>
+          <template v-else>
+            <button
+              class="btn btn-sm btn-primary"
+              data-testid="suffix-save-btn"
+              @click="saveEditSuffix(entry)"
+            >
+              <i class="bi bi-check-lg"></i>
+            </button>
+            <button class="btn btn-sm" data-testid="suffix-cancel-btn" @click="cancelEditSuffix">
+              <i class="bi bi-x-lg"></i>
+            </button>
+          </template>
+        </div>
+      </div>
+    </div>
+
+    <!-- Suffix delete confirmation dialog -->
+    <ModalDialog
+      v-if="pendingDeleteSuffix"
+      :title="$t('settings.suffixDeleteTitle')"
+      @close="cancelDeleteSuffix"
+    >
+      <p>
+        {{
+          $t('settings.suffixDeleteConfirm', {
+            name: pendingDeleteSuffix.user_name,
+            suffix: pendingDeleteSuffix.suffix,
+          })
+        }}
+      </p>
+      <div class="confirm-actions">
+        <button class="btn" data-testid="suffix-delete-cancel" @click="cancelDeleteSuffix">
+          {{ $t('import.cancel') }}
+        </button>
+        <button
+          class="btn btn-danger"
+          data-testid="suffix-delete-confirm"
+          @click="confirmDeleteSuffix"
+        >
+          <i class="bi bi-trash"></i>
+          {{ $t('settings.suffixDeleteTitle') }}
+        </button>
+      </div>
+    </ModalDialog>
+
+    <!-- Initialize DB confirmation dialog -->
+    <ModalDialog
+      v-if="showInitializeDialog"
+      :title="$t('settings.initializeDbTitle')"
+      @close="cancelInitialize"
+    >
+      <p class="initialize-warning">
+        <i class="bi bi-exclamation-triangle"></i>
+        {{ $t('settings.initializeDbHint') }}
+      </p>
+      <label class="checkbox-label" data-testid="initialize-confirm-label">
+        <input
+          v-model="initializeConfirmed"
+          type="checkbox"
+          data-testid="initialize-confirm-checkbox"
+        />
+        <span>{{ $t('settings.initializeDbConfirm') }}</span>
+      </label>
+      <div class="confirm-actions">
+        <button class="btn" data-testid="initialize-cancel" @click="cancelInitialize">
+          {{ $t('import.cancel') }}
+        </button>
+        <button
+          class="btn btn-danger"
+          data-testid="initialize-confirm"
+          :disabled="!initializeConfirmed"
+          @click="confirmInitialize"
+        >
+          <i class="bi bi-arrow-counterclockwise"></i>
+          {{ $t('settings.initializeDb') }}
+        </button>
+      </div>
+    </ModalDialog>
+
+    <!-- Export filter dialog -->
+    <ExportFilterDialog
+      v-if="showExportFilter"
+      @export="onExportConfirm"
+      @close="showExportFilter = false"
+    />
+
+    <!-- Import dialog -->
+    <ImportDialog
+      v-if="showImportDialog && importEnvelope"
+      :envelope="importEnvelope"
+      :local-uuid="userUuid"
+      :as-mine="importAsMine"
+      @done="onImportDone"
+      @close="onImportClose"
+    />
+
+    <!-- Credits -->
+    <div class="card setting-card">
+      <label class="setting-label">
+        <i class="bi bi-heart"></i>
+        {{ $t('settings.credits') }}
+      </label>
+      <button class="btn" data-testid="settings-credits" @click="showCreditsDialog = true">
+        <i class="bi bi-info-circle"></i>
+        {{ $t('credits.title') }}
+      </button>
+    </div>
+
+    <CreditsDialog v-if="showCreditsDialog" @close="showCreditsDialog = false" />
+
+    <!-- About -->
+    <div class="card setting-card">
+      <label class="setting-label">
+        <i class="bi bi-info-circle"></i>
+        {{ $t('about.title') }}
+      </label>
+      <button class="btn" data-testid="settings-about" @click="showAboutDialog = true">
+        <i class="bi bi-info-circle"></i>
+        {{ $t('about.title') }}
+      </button>
+    </div>
+
+    <AboutDialog v-if="showAboutDialog" @close="showAboutDialog = false" />
+
+    <!-- Clean Journal dialog -->
+    <CleanJournalDialog
+      v-if="showCleanJournalDialog"
+      @close="showCleanJournalDialog = false"
+      @cleaned="showCleanJournalDialog = false"
+    />
+  </div>
+</template>
+
+<style scoped>
+.settings-view {
+  max-width: 600px;
+}
+
+.setting-card {
+  display: flex;
+  flex-direction: column;
+  gap: 8px;
+}
+
+.setting-label {
+  font-weight: 600;
+  font-size: 15px;
+  display: flex;
+  align-items: center;
+  gap: 8px;
+}
+
+.setting-label i {
+  font-size: 18px;
+}
+
+.field-error {
+  color: var(--btn-danger-bg);
+  font-size: 13px;
+  margin: 0;
+}
+
+.input-readonly {
+  opacity: 0.7;
+  cursor: default;
+  background-color: var(--bg-color2);
+}
+
+.export-import-buttons {
+  display: flex;
+  gap: 8px;
+}
+
+.export-import-buttons .flex-fill {
+  flex: 1;
+}
+
+.initialize-db-row {
+  margin-top: 8px;
+  justify-content: center;
+}
+
+.export-import-grid {
+  display: grid;
+  grid-template-columns: 1fr 1fr;
+  gap: 8px;
+}
+
+.export-import-buttons button:disabled {
+  opacity: 0.5;
+  cursor: not-allowed;
+}
+
+.coming-soon {
+  font-size: 13px;
+  font-style: italic;
+}
+
+/* Restore overlay */
+.restore-overlay {
+  position: fixed;
+  inset: 0;
+  background: rgba(0, 0, 0, 0.6);
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  z-index: 1000;
+}
+
+.restore-spinner {
+  text-align: center;
+  color: #fff;
+  font-size: 18px;
+}
+
+.restore-spinner .spin {
+  font-size: 48px;
+  display: inline-block;
+  animation: spin 1s linear infinite;
+}
+
+@keyframes spin {
+  from {
+    transform: rotate(0deg);
+  }
+  to {
+    transform: rotate(360deg);
+  }
+}
+
+/* Restore report */
+.restore-report {
+  border-left: 4px solid var(--front-color1);
+}
+
+.report-header {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+  font-size: 16px;
+}
+
+.report-success {
+  color: #28a745;
+  border-color: #28a745;
+}
+
+.report-success i {
+  font-size: 20px;
+}
+
+.report-error {
+  color: var(--btn-danger-bg);
+  border-color: var(--btn-danger-bg);
+}
+
+.report-error i {
+  font-size: 20px;
+}
+
+.report-body {
+  font-size: 14px;
+}
+
+.report-tables {
+  margin: 4px 0;
+  padding-left: 20px;
+}
+
+.report-tables li {
+  margin-bottom: 2px;
+}
+
+/* Suffix management */
+.suffix-entry {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  padding: 8px 0;
+  border-bottom: 1px solid var(--border-color);
+}
+
+.suffix-entry:last-child {
+  border-bottom: none;
+}
+
+.suffix-info {
+  flex: 1;
+  min-width: 0;
+  display: flex;
+  align-items: center;
+  gap: 8px;
+  flex-wrap: wrap;
+}
+
+.suffix-badge {
+  font-size: 13px;
+  padding: 2px 8px;
+  border-radius: 12px;
+  background-color: var(--btn-primary-bg);
+  color: var(--btn-primary-color);
+}
+
+.suffix-edit-input {
+  width: 120px;
+  font-size: 14px;
+  padding: 4px 8px;
+}
+
+.suffix-actions {
+  display: flex;
+  gap: 4px;
+  flex-shrink: 0;
+  margin-left: 8px;
+}
+
+.btn-sm {
+  font-size: 12px;
+  padding: 4px 10px;
+}
+
+.confirm-actions {
+  display: flex;
+  justify-content: flex-end;
+  gap: 8px;
+  margin-top: 16px;
+  padding-top: 16px;
+  border-top: 1px solid var(--border-color);
+}
+
+.confirm-actions button:disabled {
+  opacity: 0.5;
+  cursor: not-allowed;
+}
+
+.initialize-warning {
+  display: flex;
+  align-items: flex-start;
+  gap: 8px;
+  color: var(--btn-danger-bg);
+  font-size: 14px;
+}
+
+.initialize-warning i {
+  font-size: 18px;
+  flex-shrink: 0;
+  margin-top: 2px;
+}
+
+.checkbox-label {
+  display: flex;
+  align-items: flex-start;
+  gap: 8px;
+  margin-top: 16px;
+  font-size: 14px;
+  cursor: pointer;
+  word-wrap: break-word;
+  overflow-wrap: break-word;
+}
+
+.checkbox-label input[type='checkbox'] {
+  margin-top: 2px;
+  flex-shrink: 0;
+  width: 16px;
+  height: 16px;
+}
+
+.checkbox-label span {
+  flex: 1 1 0;
+  min-width: 0;
+}
+
+/* Backup section */
+.backup-info {
+  margin-top: 8px;
+}
+
+.backup-last-backup {
+  font-size: 14px;
+  color: var(--front-color2);
+  margin: 0;
+  display: flex;
+  align-items: center;
+  gap: 6px;
+}
+
+.backup-reminder-setting {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+  margin-top: 8px;
+}
+
+.reminder-label {
+  font-size: 14px;
+  color: var(--front-color2);
+}
+
+.reminder-input {
+  width: 60px;
+  font-size: 14px;
+  padding: 4px 8px;
+}
+
+.reminder-unit {
+  font-size: 14px;
+  color: var(--front-color2);
+}
+
+/* Sound section */
+.sound-row {
+  display: flex;
+  align-items: center;
+  gap: 12px;
+  flex-wrap: wrap;
+}
+
+.sound-volume-label {
+  font-size: 14px;
+  color: var(--front-color2);
+  white-space: nowrap;
+}
+
+.volume-slider {
+  flex: 1;
+  min-width: 80px;
+  accent-color: var(--btn-primary-bg);
+  outline: none;
+}
+
+.volume-value {
+  font-size: 14px;
+  color: var(--front-color2);
+  min-width: 36px;
+  text-align: right;
+}
+</style>
diff --git a/src/views/StatsView.vue b/src/views/StatsView.vue
new file mode 100644
index 0000000..0e97f74
--- /dev/null
+++ b/src/views/StatsView.vue
@@ -0,0 +1,402 @@
+<script setup>
+import { ref, computed, onMounted, onUnmounted } from 'vue'
+import { useTranslation } from 'i18next-vue'
+import { Bar, Line } from 'vue-chartjs'
+import {
+  Chart as ChartJS,
+  CategoryScale,
+  LinearScale,
+  BarElement,
+  LineElement,
+  PointElement,
+  Title,
+  Tooltip,
+  Legend,
+} from 'chart.js'
+import { useSettings } from '../composables/useSettings.js'
+import { useStats } from '../composables/useStats.js'
+import { formatDate } from '../utils/dateFormatter.js'
+
+ChartJS.register(
+  CategoryScale,
+  LinearScale,
+  BarElement,
+  LineElement,
+  PointElement,
+  Title,
+  Tooltip,
+  Legend,
+)
+
+const { t, i18next } = useTranslation()
+const { get } = useSettings()
+const {
+  dateRange,
+  frequencyGroupBy,
+  selectedExerciseId,
+  totalSessions,
+  totalExercises,
+  streak,
+  loggedExercises,
+  frequencyRaw,
+  volumeRaw,
+  progressionRaw,
+  loadAll,
+} = useStats()
+
+const dbCreatedAt = ref(null)
+const language = ref(i18next.language || 'en')
+
+const DATE_RANGES = ['7d', '30d', '3m', 'all']
+
+const formattedDate = computed(() => {
+  if (!dbCreatedAt.value) return ''
+  return formatDate(dbCreatedAt.value, language.value)
+})
+
+function shortDate(dateStr) {
+  if (!dateStr) return ''
+  const d = new Date(dateStr)
+  if (isNaN(d.getTime())) return dateStr
+  const dd = String(d.getDate()).padStart(2, '0')
+  const mm = String(d.getMonth() + 1).padStart(2, '0')
+  return language.value === 'fr' ? `${dd}/${mm}` : `${mm}/${dd}`
+}
+
+// ── Chart data ────────────────────────────────────────────────────────────────
+
+const frequencyChartData = computed(() => ({
+  labels: frequencyRaw.value.map((r) => r.period),
+  datasets: [
+    {
+      label: t('stats.charts.frequency.yLabel'),
+      data: frequencyRaw.value.map((r) => r.count),
+      backgroundColor: 'rgba(59, 130, 246, 0.75)',
+    },
+  ],
+}))
+
+const frequencyChartOptions = {
+  responsive: true,
+  maintainAspectRatio: false,
+  plugins: { legend: { display: false } },
+  scales: { y: { beginAtZero: true, ticks: { stepSize: 1 } } },
+}
+
+const volumeChartData = computed(() => ({
+  labels: volumeRaw.value.map((r) => shortDate(r.day)),
+  datasets: [
+    {
+      label: t('stats.charts.volume.yLabel'),
+      data: volumeRaw.value.map((r) => r.volume),
+      backgroundColor: 'rgba(16, 185, 129, 0.75)',
+    },
+  ],
+}))
+
+const volumeChartOptions = {
+  responsive: true,
+  maintainAspectRatio: false,
+  plugins: { legend: { display: false } },
+  scales: { y: { beginAtZero: true } },
+}
+
+const progressionChartData = computed(() => ({
+  labels: progressionRaw.value.map((r) => shortDate(r.started_at)),
+  datasets: [
+    {
+      label: t('stats.charts.progression.reps'),
+      data: progressionRaw.value.map((r) => r.total_reps),
+      borderColor: 'rgb(59, 130, 246)',
+      backgroundColor: 'rgba(59, 130, 246, 0.1)',
+      yAxisID: 'y',
+      tension: 0.3,
+    },
+    {
+      label: t('stats.charts.progression.weight'),
+      data: progressionRaw.value.map((r) => r.max_weight),
+      borderColor: 'rgb(249, 115, 22)',
+      backgroundColor: 'rgba(249, 115, 22, 0.1)',
+      yAxisID: 'y1',
+      tension: 0.3,
+    },
+  ],
+}))
+
+const progressionChartOptions = computed(() => ({
+  responsive: true,
+  maintainAspectRatio: false,
+  plugins: { legend: { display: true, position: 'top' } },
+  scales: {
+    y: {
+      type: 'linear',
+      position: 'left',
+      beginAtZero: true,
+      title: { display: true, text: t('stats.charts.progression.reps') },
+    },
+    y1: {
+      type: 'linear',
+      position: 'right',
+      beginAtZero: true,
+      grid: { drawOnChartArea: false },
+      title: { display: true, text: t('stats.charts.progression.weight') },
+    },
+  },
+}))
+
+// ── Lifecycle ────────────────────────────────────────────────────────────────
+
+function onLanguageChanged(lang) {
+  language.value = lang
+}
+
+onMounted(async () => {
+  language.value = i18next.language || 'en'
+  i18next.on('languageChanged', onLanguageChanged)
+  dbCreatedAt.value = null
+  const createdAtStr = await get('db_created_at')
+  if (createdAtStr) {
+    dbCreatedAt.value = new Date(createdAtStr)
+  }
+  await loadAll()
+})
+
+onUnmounted(() => {
+  i18next.off('languageChanged', onLanguageChanged)
+})
+</script>
+
+<template>
+  <div class="stats-view">
+    <h2>{{ $t('stats.title') }}</h2>
+
+    <p v-if="dbCreatedAt" class="text-muted using-since" data-testid="stats-using-since">
+      {{ $t('stats.usingSince', { date: formattedDate }) }}
+    </p>
+
+    <!-- Date range filter -->
+    <div class="stats-date-range" data-testid="stats-date-range">
+      <button
+        v-for="r in DATE_RANGES"
+        :key="r"
+        :class="['btn-range', { active: dateRange === r }]"
+        :data-testid="`date-range-${r}`"
+        @click="dateRange = r"
+      >
+        {{ $t(`stats.dateRange.${r}`) }}
+      </button>
+    </div>
+
+    <!-- Summary cards -->
+    <div class="stats-cards">
+      <div class="stat-card" data-testid="stats-total-sessions">
+        <span class="stat-value">{{ totalSessions }}</span>
+        <span class="stat-label">{{ $t('stats.summary.sessions') }}</span>
+      </div>
+      <div class="stat-card" data-testid="stats-total-exercises">
+        <span class="stat-value">{{ totalExercises }}</span>
+        <span class="stat-label">{{ $t('stats.summary.exercises') }}</span>
+      </div>
+      <div class="stat-card" data-testid="stats-streak">
+        <span class="stat-value">{{ streak }}</span>
+        <span class="stat-label">{{ $t('stats.summary.streak') }}</span>
+      </div>
+    </div>
+
+    <!-- Frequency chart -->
+    <div class="stats-section">
+      <div class="stats-section-header">
+        <h3>{{ $t('stats.charts.frequency.title') }}</h3>
+        <select
+          v-model="frequencyGroupBy"
+          class="stats-select"
+          data-testid="stats-frequency-groupby"
+        >
+          <option value="week">{{ $t('stats.charts.frequency.week') }}</option>
+          <option value="month">{{ $t('stats.charts.frequency.month') }}</option>
+        </select>
+      </div>
+      <div
+        v-if="frequencyRaw.length > 0"
+        class="chart-container"
+        data-testid="stats-frequency-chart"
+      >
+        <Bar :data="frequencyChartData" :options="frequencyChartOptions" />
+      </div>
+      <p v-else class="no-data" data-testid="stats-frequency-nodata">
+        {{ $t('stats.charts.frequency.noData') }}
+      </p>
+    </div>
+
+    <!-- Volume chart -->
+    <div class="stats-section">
+      <div class="stats-section-header">
+        <h3>{{ $t('stats.charts.volume.title') }}</h3>
+      </div>
+      <div v-if="volumeRaw.length > 0" class="chart-container" data-testid="stats-volume-chart">
+        <Bar :data="volumeChartData" :options="volumeChartOptions" />
+      </div>
+      <p v-else class="no-data" data-testid="stats-volume-nodata">
+        {{ $t('stats.charts.volume.noData') }}
+      </p>
+    </div>
+
+    <!-- Progression chart -->
+    <div class="stats-section">
+      <div class="stats-section-header">
+        <h3>{{ $t('stats.charts.progression.title') }}</h3>
+        <select
+          v-model="selectedExerciseId"
+          class="stats-select"
+          data-testid="stats-progression-exercise"
+          :disabled="loggedExercises.length === 0"
+        >
+          <option value="">{{ $t('stats.charts.progression.selectExercise') }}</option>
+          <option v-for="ex in loggedExercises" :key="ex.id" :value="ex.id">
+            {{ ex.title }}
+          </option>
+        </select>
+      </div>
+      <div
+        v-if="selectedExerciseId && progressionRaw.length > 0"
+        class="chart-container"
+        data-testid="stats-progression-chart"
+      >
+        <Line :data="progressionChartData" :options="progressionChartOptions" />
+      </div>
+      <p v-else class="no-data" data-testid="stats-progression-nodata">
+        {{
+          selectedExerciseId
+            ? $t('stats.charts.progression.noData')
+            : $t('stats.charts.progression.selectExercise')
+        }}
+      </p>
+    </div>
+  </div>
+</template>
+
+<style scoped>
+.stats-view {
+  padding: 1rem;
+  max-width: 900px;
+}
+
+.using-since {
+  color: var(--front-color2);
+  margin-bottom: 1rem;
+}
+
+/* Date range buttons */
+.stats-date-range {
+  display: flex;
+  gap: 0.4rem;
+  margin-bottom: 1.5rem;
+  flex-wrap: wrap;
+}
+
+.btn-range {
+  padding: 0.3rem 0.9rem;
+  border: 1px solid var(--border-color);
+  border-radius: 4px;
+  background: var(--bg-color2);
+  color: var(--front-color1);
+  cursor: pointer;
+  font-size: 0.875rem;
+  font-weight: 500;
+  transition:
+    background 0.12s,
+    color 0.12s,
+    border-color 0.12s;
+}
+
+.btn-range:hover:not(.active) {
+  border-color: var(--btn-primary-bg);
+  color: var(--btn-primary-bg);
+}
+
+.btn-range.active {
+  background: var(--btn-primary-bg);
+  color: var(--btn-primary-color);
+  border-color: var(--btn-primary-bg);
+}
+
+/* Summary cards */
+.stats-cards {
+  display: grid;
+  grid-template-columns: repeat(3, 1fr);
+  gap: 1rem;
+  margin-bottom: 2rem;
+}
+
+.stat-card {
+  display: flex;
+  flex-direction: column;
+  align-items: center;
+  padding: 1rem;
+  border: 1px solid var(--border-color);
+  border-radius: 6px;
+  background: var(--bg-color2);
+  text-align: center;
+}
+
+.stat-value {
+  font-size: 2rem;
+  font-weight: 700;
+  line-height: 1;
+  color: var(--btn-primary-bg);
+}
+
+.stat-label {
+  margin-top: 0.4rem;
+  font-size: 0.75rem;
+  color: var(--front-color2);
+  text-transform: uppercase;
+  letter-spacing: 0.04em;
+}
+
+/* Chart sections */
+.stats-section {
+  margin-bottom: 2rem;
+}
+
+.stats-section-header {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  gap: 1rem;
+  margin-bottom: 0.75rem;
+}
+
+.stats-section-header h3 {
+  margin: 0;
+  font-size: 1rem;
+  font-weight: 600;
+}
+
+.stats-select {
+  padding: 0.25rem 0.5rem;
+  border: 1px solid var(--input-border);
+  border-radius: 4px;
+  background: var(--input-bg);
+  color: var(--front-color1);
+  font-size: 0.875rem;
+}
+
+.chart-container {
+  position: relative;
+  height: 220px;
+}
+
+.no-data {
+  color: var(--front-color2);
+  font-size: 0.9rem;
+  padding: 1.5rem 0;
+  text-align: center;
+}
+
+@media (max-width: 500px) {
+  .stats-cards {
+    grid-template-columns: 1fr;
+  }
+}
+</style>
diff --git a/tests/README.md b/tests/README.md
new file mode 100644
index 0000000..1bed9f8
--- /dev/null
+++ b/tests/README.md
@@ -0,0 +1,90 @@
+# Test Suite
+
+End-to-end tests for TrainUs using **Playwright** (Python) and **pytest**.
+
+## Setup (first time)
+
+```bash
+cd tests
+python -m venv .venv
+.venv/bin/pip install -r requirements.txt
+.venv/bin/playwright install firefox chromium
+```
+
+## Running Tests
+
+The Vite dev server starts automatically on port 5199 via the `app_url` fixture in `conftest.py`. It is stopped automatically when all tests finish.
+
+### Available commands (from project root)
+
+| Command                          | Browsers           | Mode                              |
+| -------------------------------- | ------------------ | --------------------------------- |
+| `npm run test`                   | Firefox            | Sequential                        |
+| `npm run test:chromium`          | Chromium           | Sequential                        |
+| `npm run test:parallel`          | Firefox + Chromium | Parallel (all CPU cores)          |
+| `npm run test:parallel:firefox`  | Firefox            | Parallel (all CPU cores)          |
+| `npm run test:parallel:chromium` | Chromium           | Parallel (all CPU cores)          |
+| `npm run test:parallel:n`        | Firefox + Chromium | Parallel, N workers (`WORKERS=N`) |
+
+### Running directly with pytest
+
+```bash
+# All tests, Firefox only
+cd tests && .venv/bin/python -m pytest --browser firefox -v
+
+# Single file, Firefox
+cd tests && .venv/bin/python -m pytest test_step3_exercises.py --browser firefox -v
+
+# Parallel via shell script
+./tests/run_parallel.sh
+
+# Parallel, Firefox only, 4 workers
+PYTEST_WORKERS=4 PYTEST_BROWSERS="firefox" ./tests/run_parallel.sh
+
+# Single file in parallel via shell script
+./tests/run_parallel.sh test_step3_exercises.py
+```
+
+## Browser Targets
+
+- **Firefox** — primary browser; all tests must pass
+- **Chromium** — secondary browser; all tests must also pass
+
+## File Naming Convention
+
+```
+test_step<N>_<feature_name>.py
+```
+
+Each file corresponds to one implementation step. Tests within a file cover both green paths (happy flow) and red paths (bad inputs, edge cases, error states).
+
+## Test Files
+
+| File                                    | Feature                                     | Tests   |
+| --------------------------------------- | ------------------------------------------- | ------- |
+| `test_step0_scaffolding.py`             | App shell, navigation, i18n                 | 5       |
+| `test_step1_database.py`                | DB init, CRUD, persistence                  | 15      |
+| `test_step2_settings.py`                | Language, theme, name, DB export/restore    | 21      |
+| `test_step2b_schema_hardening.py`       | UNIQUE constraints, suffix table            | 10      |
+| `test_step3_exercises.py`               | Exercise CRUD, search, validation           | 17      |
+| `test_step3b_exercise_export_import.py` | JSON export/import, collisions, suffixes    | 23      |
+| `test_step3c_backup.py`                 | Backup filename, reminder, threshold        | 11      |
+| `test_step4_combos.py`                  | Combo CRUD, exercise ordering, reps/weight  | 19      |
+| `test_step5_sessions.py`                | Session CRUD, items, reps/weight            | 20      |
+| `test_step6_collections_home.py`        | Collections CRUD, home page stats           | 19      |
+| `test_step7_import_export.py`           | Full multi-entity export/import             | 14      |
+| `test_step8_execution.py`               | Execution mode, queue, partial logs         | 17      |
+| `test_step9_stats.py`                   | Statistics charts, streak, date range       | 16      |
+| `test_step10_pwa.py`                    | PWA manifest, install prompt, accessibility | 11      |
+| `test_step12_timers.py`                 | EMOM/AMRAP/TABATA timers, pause/resume      | 20      |
+| `test_step13_markdown.py`               | Markdown rendering in detail views          | 9       |
+| `test_step14_form_shortcuts.py`         | Ctrl+Enter save, Escape cancel on forms     | 10      |
+| `test_step15_audio_cues.py`             | TABATA/AMRAP audio cue timing (fake clock)  | 7       |
+| **Total**                               |                                             | **264** |
+
+## Infrastructure
+
+- **`conftest.py`**: Pytest fixtures. Starts the Vite dev server (`npm run dev -- --port 5199`) before the first test and stops it after all tests complete. Handles multiple concurrent workers safely using file locks.
+- **`pytest.ini`**: Sets `base_url = http://localhost:5199`.
+- **`run_parallel.sh`**: Shell wrapper for `pytest-xdist` parallel runs. Accepts `PYTEST_WORKERS` and `PYTEST_BROWSERS` environment variables.
+- **`requirements.txt`**: `playwright`, `pytest`, `pytest-playwright`, `pytest-xdist`.
diff --git a/tests/conftest.py b/tests/conftest.py
new file mode 100644
index 0000000..0ef0917
--- /dev/null
+++ b/tests/conftest.py
@@ -0,0 +1,156 @@
+import urllib.request
+import pytest
+import subprocess
+import time
+import signal
+import os
+import fcntl
+
+
+def _counter_add(delta: int, count_file: str, lock_file: str) -> int:
+    """Atomically add `delta` to the worker counter and return the new value."""
+    with open(lock_file, "w") as lock:
+        fcntl.flock(lock, fcntl.LOCK_EX)
+        try:
+            try:
+                with open(count_file) as f:
+                    value = int(f.read().strip() or "0")
+            except FileNotFoundError:
+                value = 0
+            value += delta
+            with open(count_file, "w") as f:
+                f.write(str(value))
+            return value
+        finally:
+            fcntl.flock(lock, fcntl.LOCK_UN)
+
+
+def _counter_read(count_file: str, lock_file: str) -> int:
+    """Read the current worker counter value without modifying it."""
+    with open(lock_file, "w") as lock:
+        fcntl.flock(lock, fcntl.LOCK_EX)
+        try:
+            try:
+                with open(count_file) as f:
+                    return int(f.read().strip() or "0")
+            except FileNotFoundError:
+                return 0
+        finally:
+            fcntl.flock(lock, fcntl.LOCK_UN)
+
+
+@pytest.fixture(scope="session")
+def app_url(tmp_path_factory, worker_id):
+    """Start the Vite dev server and return its URL.
+
+    When running under pytest-xdist, only the first worker (gw0) starts the
+    server and writes the URL to a shared temp file.  All other workers wait
+    for that file to appear and then read the URL from it.  The server is only
+    stopped once every worker has finished (tracked via a shared counter file).
+    When running without xdist (worker_id == "master") the behaviour is
+    identical to the original single-worker case.
+
+    Shared files are placed inside tmp_path_factory.getbasetemp() so that two
+    concurrent pytest invocations never collide (each invocation gets a unique
+    basetemp directory from pytest's per-run counter).
+    """
+    basetemp = tmp_path_factory.getbasetemp()
+    # In xdist each worker gets its own subdirectory; step up to the shared parent
+    if worker_id != "master":
+        basetemp = basetemp.parent
+    server_url_file = str(basetemp / "trainus_server_url")
+    worker_count_file = str(basetemp / "trainus_worker_count")
+    worker_count_lock = str(basetemp / "trainus_worker_count.lock")
+
+    url = "http://localhost:5199"
+    is_controller = worker_id in ("master", "gw0")
+
+    # Register this worker in the shared counter
+    _counter_add(1, worker_count_file, worker_count_lock)
+
+    server_error_file = str(basetemp / "trainus_server_error")
+
+    if is_controller:
+        # Remove stale files from a previous run if present
+        for stale in (server_url_file, server_error_file):
+            try:
+                os.remove(stale)
+            except FileNotFoundError:
+                pass
+
+        project_root = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
+        process = subprocess.Popen(
+            ["npm", "run", "dev", "--", "--port", "5199", "--strictPort"],
+            cwd=project_root,
+            stdout=subprocess.PIPE,
+            stderr=subprocess.STDOUT,
+            preexec_fn=os.setsid,
+        )
+
+        # Wait for the server to be ready (up to 60 s)
+        for _ in range(120):
+            try:
+                urllib.request.urlopen(url, timeout=1)
+                break
+            except Exception:
+                time.sleep(0.5)
+        else:
+            process.kill()
+            # Signal secondary workers to stop waiting
+            with open(server_error_file, "w") as f:
+                f.write("Vite dev server failed to start within 60s")
+            raise RuntimeError("Vite dev server failed to start within 60s")
+
+        # Publish the URL so other workers can pick it up
+        with open(server_url_file, "w") as f:
+            f.write(url)
+
+        yield url
+
+        # Mark the controller itself as done, then wait for all other workers
+        # to finish before killing the server.  We decrement exactly once here
+        # and then only *read* the counter so we never accidentally modify it
+        # inside the polling loop.
+        _counter_add(-1, worker_count_file, worker_count_lock)
+        for _ in range(240):
+            if _counter_read(worker_count_file, worker_count_lock) <= 0:
+                break
+            time.sleep(0.5)
+
+        # Cleanup
+        os.killpg(os.getpgid(process.pid), signal.SIGTERM)
+
+    else:
+        # Secondary workers: wait until gw0 has written the URL file (up to 90 s)
+        for _ in range(180):
+            if os.path.exists(server_url_file):
+                break
+            if os.path.exists(server_error_file):
+                with open(server_error_file) as f:
+                    msg = f.read().strip()
+                raise RuntimeError(f"gw0 failed to start the Vite dev server: {msg}")
+            time.sleep(0.5)
+        else:
+            raise RuntimeError("Timed out waiting for Vite dev server URL from gw0")
+
+        with open(server_url_file) as f:
+            server_url = f.read().strip()
+
+        yield server_url
+
+        # Signal this worker is done
+        _counter_add(-1, worker_count_file, worker_count_lock)
+
+
+@pytest.fixture(scope="session")
+def browser_type_launch_args():
+    """Configure browser launch args."""
+    return {}
+
+
+@pytest.fixture(scope="session")
+def browser_context_args():
+    """Configure browser context."""
+    return {
+        "viewport": {"width": 1280, "height": 720},
+    }
diff --git a/tests/fixtures/cross_user_full.json b/tests/fixtures/cross_user_full.json
new file mode 100644
index 0000000..7178d73
--- /dev/null
+++ b/tests/fixtures/cross_user_full.json
@@ -0,0 +1,120 @@
+{
+  "metadata": {
+    "appName": "trainus",
+    "appVersion": "1.0.0",
+    "schemaVersion": 1,
+    "exportDate": "2024-01-01T00:00:00.000Z",
+    "exportedBy": { "name": "Fixture User", "uuid": "facade00-0000-4000-a000-000000000001" }
+  },
+  "data": {
+    "exercises": [
+      {
+        "id": "facade00-0000-4000-a000-e00000000001",
+        "title": "Fixture Exercise One",
+        "description": "",
+        "asymmetric": false,
+        "alternate": false,
+        "image_urls": [],
+        "video_urls": [],
+        "default_reps": 10,
+        "default_weight": 0,
+        "created_by": "facade00-0000-4000-a000-000000000001"
+      },
+      {
+        "id": "facade00-0000-4000-a000-e00000000002",
+        "title": "Fixture Exercise Two",
+        "description": "",
+        "asymmetric": false,
+        "alternate": false,
+        "image_urls": [],
+        "video_urls": [],
+        "default_reps": 8,
+        "default_weight": 20,
+        "created_by": "facade00-0000-4000-a000-000000000001"
+      }
+    ],
+    "combos": [
+      {
+        "id": "facade00-0000-4000-a000-c00000000001",
+        "title": "Fixture Combo",
+        "description": "",
+        "type": "NONE",
+        "timer_config": {},
+        "created_by": "facade00-0000-4000-a000-000000000001",
+        "exercises": [
+          {
+            "exercise_id": "facade00-0000-4000-a000-e00000000001",
+            "position": 0,
+            "default_reps": 5,
+            "default_weight": 10
+          },
+          {
+            "exercise_id": "facade00-0000-4000-a000-e00000000002",
+            "position": 1,
+            "default_reps": 8,
+            "default_weight": 20
+          }
+        ]
+      }
+    ],
+    "sessions": [
+      {
+        "id": "facade00-0000-4000-a000-500000000001",
+        "title": "Fixture Session",
+        "description": "",
+        "created_by": "facade00-0000-4000-a000-000000000001",
+        "items": [
+          {
+            "position": 0,
+            "item_id": "facade00-0000-4000-a000-e00000000001",
+            "item_type": "exercise",
+            "repetitions": 10,
+            "weight": 0
+          },
+          {
+            "position": 1,
+            "item_id": "facade00-0000-4000-a000-c00000000001",
+            "item_type": "combo",
+            "repetitions": 3,
+            "weight": 0
+          }
+        ]
+      }
+    ],
+    "collections": [
+      {
+        "id": "facade00-0000-4000-a000-d00000000001",
+        "label": "Fixture Collection",
+        "created_by": "facade00-0000-4000-a000-000000000001",
+        "sessions": [
+          {
+            "position": 0,
+            "session_id": "facade00-0000-4000-a000-500000000001"
+          }
+        ]
+      }
+    ],
+    "executionLogs": [
+      {
+        "id": "facade00-0000-4000-a000-100000000001",
+        "session_id": "facade00-0000-4000-a000-500000000001",
+        "started_at": "2024-01-01T10:00:00.000Z",
+        "finished_at": "2024-01-01T10:30:00.000Z",
+        "items": [
+          {
+            "id": "facade00-0000-4000-a000-100000000011",
+            "log_id": "facade00-0000-4000-a000-100000000001",
+            "exercise_id": "facade00-0000-4000-a000-e00000000001",
+            "combo_id": null,
+            "round_number": 1,
+            "reps_done": 10,
+            "weight_used": 50,
+            "side": null,
+            "completed": true,
+            "timestamp": "2024-01-01T10:05:00.000Z"
+          }
+        ]
+      }
+    ]
+  }
+}
diff --git a/tests/fixtures/cross_user_id_collision.json b/tests/fixtures/cross_user_id_collision.json
new file mode 100644
index 0000000..57bd849
--- /dev/null
+++ b/tests/fixtures/cross_user_id_collision.json
@@ -0,0 +1,43 @@
+{
+  "metadata": {
+    "appName": "trainus",
+    "appVersion": "1.0.0",
+    "schemaVersion": 1,
+    "exportDate": "2024-01-01T00:00:00.000Z",
+    "exportedBy": { "name": "Other User", "uuid": "other-user-uuid-collision-999" }
+  },
+  "data": {
+    "exercises": [
+      {
+        "id": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
+        "title": "Imported Exercise",
+        "description": "",
+        "asymmetric": false,
+        "alternate": false,
+        "image_urls": [],
+        "video_urls": [],
+        "default_reps": 10,
+        "default_weight": 0,
+        "created_by": "other-user-uuid-collision-999"
+      }
+    ],
+    "combos": [
+      {
+        "id": "11111111-2222-3333-4444-555555555555",
+        "title": "Imported Combo",
+        "description": "",
+        "type": "NONE",
+        "timer_config": {},
+        "created_by": "other-user-uuid-collision-999",
+        "exercises": [
+          {
+            "exercise_id": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
+            "position": 0,
+            "default_reps": 5,
+            "default_weight": 10
+          }
+        ]
+      }
+    ]
+  }
+}
diff --git a/tests/pytest.ini b/tests/pytest.ini
new file mode 100644
index 0000000..051d1ff
--- /dev/null
+++ b/tests/pytest.ini
@@ -0,0 +1,2 @@
+[pytest]
+base_url = http://localhost:5199
diff --git a/tests/requirements.txt b/tests/requirements.txt
new file mode 100644
index 0000000..8bc264c
--- /dev/null
+++ b/tests/requirements.txt
@@ -0,0 +1,4 @@
+playwright>=1.40.0
+pytest>=7.4.0
+pytest-playwright>=0.4.0
+pytest-xdist>=3.5.0
diff --git a/tests/run_parallel.sh b/tests/run_parallel.sh
new file mode 100755
index 0000000..e763815
--- /dev/null
+++ b/tests/run_parallel.sh
@@ -0,0 +1,35 @@
+#!/usr/bin/env bash
+# Run the Playwright test suite in parallel using pytest-xdist.
+#
+# Usage:
+#   ./run_parallel.sh                          # both browsers, auto workers
+#   ./run_parallel.sh --browser firefox        # override browser selection
+#   ./run_parallel.sh test_step3_exercises.py  # single file, both browsers
+#
+# Environment variables:
+#   PYTEST_WORKERS   number of parallel workers (default: auto = one per CPU core)
+#   PYTEST_BROWSERS  space-separated list of browsers (default: "firefox chromium")
+#
+# Examples:
+#   PYTEST_WORKERS=4 ./run_parallel.sh
+#   PYTEST_WORKERS=2 PYTEST_BROWSERS="firefox" ./run_parallel.sh
+
+set -euo pipefail
+
+cd "$(dirname "$0")"
+
+WORKERS="${PYTEST_WORKERS:-auto}"
+BROWSERS="${PYTEST_BROWSERS:-firefox chromium}"
+
+# Build --browser flags from the BROWSERS variable
+BROWSER_FLAGS=()
+for b in $BROWSERS; do
+    BROWSER_FLAGS+=(--browser "$b")
+done
+
+.venv/bin/python -m pytest \
+    "${BROWSER_FLAGS[@]}" \
+    --dist loadfile \
+    -n "$WORKERS" \
+    -v \
+    "$@"
diff --git a/tests/test_about.py b/tests/test_about.py
new file mode 100644
index 0000000..3a107f4
--- /dev/null
+++ b/tests/test_about.py
@@ -0,0 +1,142 @@
+"""
+About Dialog Tests
+- test_about_button_visible: The About TrainUs button is visible on the Settings page
+- test_about_dialog_opens: Clicking the button opens the About modal
+- test_about_dialog_shows_app_version: Application version is displayed and non-empty
+- test_about_dialog_shows_db_version: Database version is displayed and non-empty
+- test_about_dialog_shows_author: Author name is displayed
+- test_about_dialog_shows_links: Repository and website links are present
+- test_about_notice_visible: Notice text is displayed inline in the About dialog
+- test_about_license_btn_opens_dialog: View License button opens the license modal on top of About
+- test_about_dialog_closes: The modal can be closed with the close button
+- test_about_dialog_labels_french: Labels are translated when language is French
+"""
+from playwright.sync_api import Page, expect
+
+
+def _wait_for_db(page: Page, app_url: str):
+    """Navigate and wait for the database to be ready."""
+    page.goto(app_url)
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-ready') === 'true'",
+        timeout=15000,
+    )
+
+
+def _go_to_settings(page: Page, app_url: str):
+    """Navigate to the settings page and wait for DB."""
+    _wait_for_db(page, app_url)
+    page.click('a[href="#/settings"]')
+    page.wait_for_selector('[data-testid="settings-language"]')
+
+
+def _open_about(page: Page, app_url: str):
+    """Navigate to settings and open the About dialog."""
+    _go_to_settings(page, app_url)
+    page.click('[data-testid="settings-about"]')
+    page.wait_for_selector('[data-testid="modal-card"]')
+
+
+def test_about_button_visible(page: Page, app_url: str):
+    """The About TrainUs button is visible on the Settings page."""
+    _go_to_settings(page, app_url)
+    expect(page.locator('[data-testid="settings-about"]')).to_be_visible()
+
+
+def test_about_dialog_opens(page: Page, app_url: str):
+    """Clicking the About button opens the modal dialog."""
+    _open_about(page, app_url)
+    expect(page.locator('[data-testid="modal-card"]')).to_be_visible()
+    expect(page.locator('[data-testid="modal-title"]')).to_be_visible()
+
+
+def test_about_dialog_shows_app_version(page: Page, app_url: str):
+    """Application version field is visible and contains a non-empty value."""
+    _open_about(page, app_url)
+    version_el = page.locator('[data-testid="about-app-version"]')
+    expect(version_el).to_be_visible()
+    version_text = version_el.inner_text().strip()
+    assert version_text, "Application version should not be empty"
+    # Version follows semver pattern (e.g. 1.0.0)
+    import re
+    assert re.match(r'^\d+\.\d+\.\d+', version_text), (
+        f"Application version '{version_text}' does not look like a semver string"
+    )
+
+
+def test_about_dialog_shows_db_version(page: Page, app_url: str):
+    """Database version field is visible and contains a non-empty numeric value."""
+    _open_about(page, app_url)
+    db_version_el = page.locator('[data-testid="about-db-version"]')
+    expect(db_version_el).to_be_visible()
+    db_version_text = db_version_el.inner_text().strip()
+    assert db_version_text, "Database version should not be empty"
+    assert db_version_text.isdigit(), (
+        f"Database version '{db_version_text}' should be a numeric value"
+    )
+
+
+def test_about_dialog_shows_author(page: Page, app_url: str):
+    """Author name 'David Florance' is displayed in the About dialog."""
+    _open_about(page, app_url)
+    expect(page.locator('[data-testid="modal-card"]')).to_contain_text("David Florance")
+
+
+def test_about_dialog_shows_links(page: Page, app_url: str):
+    """Repository and website links are present in the About dialog."""
+    _open_about(page, app_url)
+    expect(page.locator('[data-testid="about-repo-link"]')).to_be_visible()
+    expect(page.locator('[data-testid="about-website-link"]')).to_be_visible()
+
+
+def test_about_notice_visible(page: Page, app_url: str):
+    """Notice text is displayed inline in the About dialog."""
+    _open_about(page, app_url)
+    notice = page.locator('[data-testid="about-notice"]')
+    expect(notice).to_be_visible()
+    expect(notice).to_contain_text("TrainUs")
+
+
+def test_about_license_btn_opens_dialog(page: Page, app_url: str):
+    """Clicking View License opens the license modal on top of the About dialog."""
+    _open_about(page, app_url)
+    btn = page.locator('[data-testid="about-license-btn"]')
+    expect(btn).to_be_visible()
+    expect(btn).to_be_enabled()
+    btn.click()
+    expect(page.locator('[data-testid="license-dialog-content"]')).to_be_visible()
+    expect(page.locator('[data-testid="about-app-version"]')).to_be_visible()
+
+
+def test_about_dialog_closes(page: Page, app_url: str):
+    """The About modal can be dismissed with the close button."""
+    _open_about(page, app_url)
+    page.click('[data-testid="modal-close"]')
+    expect(page.locator('[data-testid="modal-card"]')).not_to_be_visible()
+
+
+def test_about_dialog_labels_french(page: Page, app_url: str):
+    """About dialog labels are translated when the language is set to French."""
+    _go_to_settings(page, app_url)
+
+    # Switch to French
+    page.select_option('[data-testid="settings-language"]', 'fr')
+    page.wait_for_function(
+        "window.__repos.settings.get('language').then(v => v === 'fr')",
+        timeout=5000,
+    )
+
+    page.click('[data-testid="settings-about"]')
+    page.wait_for_selector('[data-testid="modal-card"]')
+
+    expect(page.locator('[data-testid="modal-title"]')).to_have_text("À propos de TrainUs")
+    expect(page.locator('[data-testid="modal-card"]')).to_contain_text("Version de l'application")
+    expect(page.locator('[data-testid="modal-card"]')).to_contain_text("Version de la base de données")
+
+    # Reset to English
+    page.click('[data-testid="modal-close"]')
+    page.select_option('[data-testid="settings-language"]', 'en')
+    page.wait_for_function(
+        "window.__repos.settings.get('language').then(v => v === 'en')",
+        timeout=5000,
+    )
diff --git a/tests/test_license.py b/tests/test_license.py
new file mode 100644
index 0000000..a4fece8
--- /dev/null
+++ b/tests/test_license.py
@@ -0,0 +1,59 @@
+"""
+License Dialog Tests
+- test_license_dialog_opens_from_about: Clicking View License in About opens the license modal
+- test_license_dialog_contains_agpl_text: The modal displays the GNU AGPL v3 heading
+- test_license_dialog_closes: The license modal can be closed independently
+- test_about_remains_open_after_license_close: Closing the license dialog keeps About open
+"""
+from playwright.sync_api import Page, expect
+
+
+def _wait_for_db(page: Page, app_url: str):
+    """Navigate and wait for the database to be ready."""
+    page.goto(app_url)
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-ready') === 'true'",
+        timeout=15000,
+    )
+
+
+def _open_license(page: Page, app_url: str):
+    """Navigate to Settings, open About, then open the license dialog."""
+    _wait_for_db(page, app_url)
+    page.click('a[href="#/settings"]')
+    page.wait_for_selector('[data-testid="settings-language"]')
+    page.click('[data-testid="settings-about"]')
+    page.wait_for_selector('[data-testid="modal-card"]')
+    page.click('[data-testid="about-license-btn"]')
+    page.wait_for_selector('[data-testid="license-dialog-content"]')
+
+
+def test_license_dialog_opens_from_about(page: Page, app_url: str):
+    """Clicking View License in the About dialog opens the license modal."""
+    _open_license(page, app_url)
+    expect(page.locator('[data-testid="license-dialog-content"]')).to_be_visible()
+
+
+def test_license_dialog_contains_agpl_text(page: Page, app_url: str):
+    """The license modal displays the GNU Affero General Public License heading."""
+    _open_license(page, app_url)
+    expect(page.locator('[data-testid="license-dialog-content"]')).to_contain_text(
+        "GNU AFFERO GENERAL PUBLIC LICENSE"
+    )
+
+
+def test_license_dialog_closes(page: Page, app_url: str):
+    """The license modal can be closed with its own close button."""
+    _open_license(page, app_url)
+    modals = page.locator('[data-testid="modal-close"]')
+    modals.last.click()
+    expect(page.locator('[data-testid="license-dialog-content"]')).not_to_be_visible()
+
+
+def test_about_remains_open_after_license_close(page: Page, app_url: str):
+    """Closing the license dialog leaves the About dialog still open."""
+    _open_license(page, app_url)
+    modals = page.locator('[data-testid="modal-close"]')
+    modals.last.click()
+    expect(page.locator('[data-testid="license-dialog-content"]')).not_to_be_visible()
+    expect(page.locator('[data-testid="about-app-version"]')).to_be_visible()
diff --git a/tests/test_step0_scaffolding.py b/tests/test_step0_scaffolding.py
new file mode 100644
index 0000000..26d5dfa
--- /dev/null
+++ b/tests/test_step0_scaffolding.py
@@ -0,0 +1,94 @@
+"""
+Step 0 — Scaffolding Tests
+- test_app_loads: App loads and renders the shell
+- test_nav_routes: All navigation links route correctly
+- test_actionbar_shows_title: Action bar displays the current page title
+- test_responsive_mobile: Navbar moves to bottom on mobile viewport
+- test_i18n_keys_render: i18n keys render as English text (not raw keys)
+"""
+import re
+from playwright.sync_api import Page, expect
+
+
+def test_app_loads(page: Page, app_url: str):
+    """App loads and renders the navbar with the app name."""
+    page.goto(app_url)
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-ready') === 'true'"
+        " || document.documentElement.getAttribute('data-db-error') !== null",
+        timeout=15000,
+    )
+    expect(page.locator(".navbar-brand")).to_have_text("TrainUs")
+    expect(page.locator(".actionbar")).to_be_visible()
+
+
+def test_nav_routes(page: Page, app_url: str):
+    """Clicking each nav link navigates to the correct route."""
+    page.goto(app_url)
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-ready') === 'true'",
+        timeout=15000,
+    )
+
+    routes = {
+        "Home": "#/home",
+        "Exercises": "#/exercises",
+        "Combos": "#/combos",
+        "Sessions": "#/sessions",
+        "Statistics": "#/stats",
+        "Settings": "#/settings",
+    }
+
+    for label, expected_hash in routes.items():
+        page.locator(f".navbar a:has-text('{label}')").click()
+        page.wait_for_url(f"**/{expected_hash}")
+        expect(page).to_have_url(re.compile(re.escape(expected_hash)))
+
+
+def test_actionbar_shows_title(page: Page, app_url: str):
+    """Action bar h1 reflects the current page name."""
+    page.goto(f"{app_url}/#/exercises")
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-ready') === 'true'",
+        timeout=15000,
+    )
+    expect(page.locator(".actionbar h1")).to_have_text("Exercises")
+
+    page.goto(f"{app_url}/#/settings")
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-ready') === 'true'",
+        timeout=15000,
+    )
+    expect(page.locator(".actionbar h1")).to_have_text("Settings")
+
+
+def test_responsive_mobile(page: Page, app_url: str):
+    """On a narrow viewport, navbar should be at the bottom."""
+    page.set_viewport_size({"width": 375, "height": 667})
+    page.goto(app_url)
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-ready') === 'true'",
+        timeout=15000,
+    )
+
+    navbar = page.locator(".navbar")
+    expect(navbar).to_be_visible()
+
+    # Brand should be hidden on mobile
+    brand = page.locator(".navbar-brand")
+    expect(brand).to_be_hidden()
+
+
+def test_i18n_keys_render(page: Page, app_url: str):
+    """i18n renders actual text, not raw keys like 'nav.home'."""
+    page.goto(app_url)
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-ready') === 'true'",
+        timeout=15000,
+    )
+
+    # Check that nav links contain real words, not i18n keys
+    nav_text = page.locator(".navbar").inner_text()
+    assert "nav.home" not in nav_text, "i18n keys not resolved"
+    assert "Home" in nav_text
+    assert "Settings" in nav_text
diff --git a/tests/test_step10_pwa.py b/tests/test_step10_pwa.py
new file mode 100644
index 0000000..137bcaa
--- /dev/null
+++ b/tests/test_step10_pwa.py
@@ -0,0 +1,123 @@
+"""
+Step 10 — PWA Finalization & Polish tests.
+
+Tests manifest presence and validity, service worker registration,
+icon availability, and install prompt absence in test environment.
+"""
+
+import json
+import pytest
+
+
+def test_manifest_link_present(page, app_url):
+    """HTML page includes a <link rel=manifest> pointing to /manifest.json."""
+    page.goto(app_url)
+    handle = page.query_selector('link[rel="manifest"]')
+    assert handle is not None, "<link rel='manifest'> not found in <head>"
+    href = handle.get_attribute("href")
+    assert href == "/manifest.json", f"Unexpected manifest href: {href}"
+
+
+def test_manifest_json_valid(page, app_url):
+    """manifest.json is reachable, valid JSON, and has required PWA fields."""
+    response = page.request.get(f"{app_url}/manifest.json")
+    assert response.status == 200, f"manifest.json returned {response.status}"
+    manifest = json.loads(response.text())
+    assert manifest.get("name"), "manifest missing 'name'"
+    assert manifest.get("display") == "standalone", "manifest display should be 'standalone'"
+    icons = manifest.get("icons", [])
+    assert len(icons) >= 2, "manifest should declare at least 2 icons"
+    sizes = {icon["sizes"] for icon in icons}
+    assert "192x192" in sizes, "192x192 icon missing from manifest"
+    assert "512x512" in sizes, "512x512 icon missing from manifest"
+
+
+def test_icon_192_accessible(page, app_url):
+    """icon-192.png is served with a 200 status."""
+    response = page.request.get(f"{app_url}/icon-192.png")
+    assert response.status == 200, f"icon-192.png returned {response.status}"
+
+
+def test_icon_512_accessible(page, app_url):
+    """icon-512.png is served with a 200 status."""
+    response = page.request.get(f"{app_url}/icon-512.png")
+    assert response.status == 200, f"icon-512.png returned {response.status}"
+
+
+def test_service_worker_registered(page, app_url):
+    """Service worker is registered in the browser after page load."""
+    page.goto(app_url)
+    page.wait_for_selector('[data-testid="db-loading"]', state="detached", timeout=15000)
+    registration = page.evaluate(
+        "() => navigator.serviceWorker.getRegistration().then(r => !!r)"
+    )
+    assert registration, "No service worker registration found"
+
+
+def test_install_prompt_hidden_by_default(page, app_url):
+    """Install prompt button is not shown in the test environment (beforeinstallprompt not fired)."""
+    page.goto(app_url)
+    page.wait_for_selector('[data-testid="db-loading"]', state="detached", timeout=15000)
+    btn = page.query_selector('[data-testid="install-prompt-btn"]')
+    assert btn is None, "Install prompt button should not appear without beforeinstallprompt"
+
+
+def test_favicon_linked(page, app_url):
+    """HTML page includes a <link rel=icon> for the favicon."""
+    page.goto(app_url)
+    handle = page.query_selector('link[rel="icon"]')
+    assert handle is not None, "<link rel='icon'> not found in <head>"
+
+
+def test_apple_touch_icon_linked(page, app_url):
+    """HTML page includes a <link rel=apple-touch-icon>."""
+    page.goto(app_url)
+    handle = page.query_selector('link[rel="apple-touch-icon"]')
+    assert handle is not None, "<link rel='apple-touch-icon'> not found in <head>"
+
+
+def test_nav_has_aria_label(page, app_url):
+    """Main navigation has an aria-label for screen readers."""
+    page.goto(app_url)
+    page.wait_for_selector('[data-testid="db-loading"]', state="detached", timeout=15000)
+    nav = page.query_selector("nav.navbar")
+    assert nav is not None, "<nav class='navbar'> not found"
+    aria_label = nav.get_attribute("aria-label")
+    assert aria_label, "nav.navbar is missing aria-label"
+
+
+def test_form_required_fields_marked(page, app_url):
+    """Exercise form title input is marked as required."""
+    page.goto(f"{app_url}/#/exercises/new")
+    page.wait_for_selector('[data-testid="exercise-title"]', timeout=10000)
+    required = page.get_attribute('[data-testid="exercise-title"]', "required")
+    assert required is not None, "Exercise title input should have required attribute"
+
+
+def test_progress_bar_has_aria_role(page, app_url):
+    """Execution progress bar has role=progressbar with ARIA value attributes."""
+    from playwright.sync_api import expect
+
+    # Create an exercise and session first — skip if none exist, just verify structure
+    page.goto(f"{app_url}/#/exercises")
+    page.wait_for_selector('[data-testid="db-loading"]', state="detached", timeout=15000)
+
+    exercises = page.query_selector_all('[data-testid^="exercise-card"]')
+    sessions = []
+    if exercises:
+        page.goto(f"{app_url}/#/sessions")
+        sessions = page.query_selector_all('[data-testid^="session-card"]')
+
+    if not sessions:
+        pytest.skip("No sessions available to test execution view progress bar")
+
+    session_link = page.query_selector('[data-testid^="session-card"] a')
+    session_link.click()
+    page.wait_for_selector('[data-testid="session-execute-btn"]', timeout=5000)
+    page.click('[data-testid="session-execute-btn"]')
+    page.wait_for_selector('[data-testid="execute-progress"]', timeout=5000)
+
+    bar = page.query_selector('[role="progressbar"]')
+    assert bar is not None, "Progress bar should have role='progressbar'"
+    assert bar.get_attribute("aria-valuemin") == "0"
+    assert bar.get_attribute("aria-valuemax") is not None
diff --git a/tests/test_step12_timers.py b/tests/test_step12_timers.py
new file mode 100644
index 0000000..838c18a
--- /dev/null
+++ b/tests/test_step12_timers.py
@@ -0,0 +1,608 @@
+"""
+Step 12 — Timers & Combo Execution Tests
+
+- test_tabata_form_inputs_shown: TABATA combo form shows work/rest time inputs
+- test_tabata_form_inputs_not_shown_for_other_types: Work/rest inputs hidden for non-TABATA types
+- test_tabata_timer_config_saved: TABATA work/rest times saved to timer_config
+- test_amrap_label_in_session_form: AMRAP combo item shows "Duration (min)" label
+- test_amrap_label_in_session_detail: AMRAP combo item shows minutes in detail view
+- test_emom_timer_visible: EMOM combo steps show a timer display
+- test_emom_timer_pause_resume: Pause button toggles pause state on EMOM timer
+- test_emom_done_early_advances: Tapping Done during EMOM advances to next step immediately
+- test_emom_auto_advance: EMOM timer auto-advances to next step after 60 seconds
+- test_amrap_timer_visible: AMRAP combo steps show a timer display
+- test_amrap_manual_done_cycles: Done button manually advances through AMRAP exercises
+- test_amrap_timeup_screen: Time-up overlay appears when AMRAP timer expires
+- test_amrap_continue_advances: Continue after time-up advances past AMRAP combo
+- test_tabata_work_phase_shows_timer: TABATA shows timer on work phase
+- test_tabata_rest_screen_after_work: REST screen appears after work phase timer expires
+- test_tabata_advances_after_rest: Next exercise appears after rest phase timer expires
+- test_tabata_pause_during_work: Pause freezes TABATA work timer
+- test_tabata_pause_during_rest: Pause freezes TABATA rest timer
+- test_non_timed_combo_unchanged: NONE-type combos still show final-round screen as before
+"""
+import pytest
+from playwright.sync_api import Page, expect
+
+
+# ── helpers ───────────────────────────────────────────────────────────────────
+
+
+def _wait_for_db(page: Page, app_url: str):
+    page.goto(app_url)
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-ready') === 'true'",
+        timeout=15000,
+    )
+
+
+def _wait_for_execute(page: Page):
+    page.wait_for_selector('[data-testid="execute-session-title"]', timeout=10000)
+    page.wait_for_timeout(400)
+
+
+def _create_exercise(page: Page, title: str, default_reps=10, default_weight=0.0):
+    return page.evaluate(f"""async () => {{
+        const userId = await window.__repos.settings.get('user_uuid')
+        return window.__repos.exercises.create({{
+            title: {repr(title)}, description: '', asymmetric: false, alternate: false,
+            image_urls: '[]', video_urls: '[]',
+            default_reps: {default_reps}, default_weight: {default_weight},
+            created_by: userId
+        }})
+    }}""")
+
+
+def _create_timed_combo(page: Page, title: str, combo_type: str, exercise_ids: list,
+                         timer_config: dict = None):
+    if timer_config is None:
+        timer_config = {}
+    import json
+    tc_json = json.dumps(timer_config)
+    ex_json = str([{"exerciseId": eid, "defaultReps": 10, "defaultWeight": 0}
+                   for eid in exercise_ids]).replace("'", '"')
+    return page.evaluate(f"""async () => {{
+        const userId = await window.__repos.settings.get('user_uuid')
+        const comboId = await window.__repos.combos.create({{
+            title: {repr(title)}, description: '', type: {repr(combo_type)},
+            timer_config: {tc_json}, created_by: userId
+        }})
+        const exercises = {ex_json}
+        await window.__repos.combos.setExercises(comboId, exercises)
+        return comboId
+    }}""")
+
+
+def _create_session_with_items(page: Page, title: str, items: list):
+    import json
+    items_json = json.dumps(items)
+    return page.evaluate(f"""async () => {{
+        const userId = await window.__repos.settings.get('user_uuid')
+        const sessId = await window.__repos.sessions.create({{
+            title: {repr(title)}, description: '', created_by: userId
+        }})
+        const items = {items_json}
+        await window.__repos.sessions.setItems(sessId, items.map((it, i) => ({{
+            item_id: it.item_id, item_type: it.item_type,
+            position: i, repetitions: it.repetitions, weight: it.weight || 0
+        }})))
+        return sessId
+    }}""")
+
+
+def _clean_all(page: Page):
+    page.evaluate("""async () => {
+        const sessions = await window.__repos.sessions.getAll()
+        for (const s of sessions) await window.__repos.sessions.delete(s.id)
+        const combos = await window.__repos.combos.getAll()
+        for (const c of combos) await window.__repos.combos.delete(c.id)
+        const exercises = await window.__repos.exercises.getAll()
+        for (const e of exercises) await window.__repos.exercises.delete(e.id)
+    }""")
+
+
+def _navigate_to_execute(page: Page, app_url: str, sess_id: str):
+    page.goto(f"{app_url}#/sessions/{sess_id}/execute")
+    _wait_for_execute(page)
+
+
+# ── Combo form ────────────────────────────────────────────────────────────────
+
+
+def test_tabata_form_inputs_shown(page: Page, app_url: str, browser_name: str):
+    """TABATA combo form shows work time and rest time inputs."""
+    _wait_for_db(page, app_url)
+    page.goto(f"{app_url}#/combos/new")
+    page.wait_for_selector('[data-testid="combo-type"]', timeout=5000)
+
+    # Before selecting TABATA, inputs should not be visible
+    expect(page.locator('[data-testid="combo-tabata-work-time"]')).not_to_be_visible()
+    expect(page.locator('[data-testid="combo-tabata-rest-time"]')).not_to_be_visible()
+
+    # Select TABATA
+    page.select_option('[data-testid="combo-type"]', "TABATA")
+    expect(page.locator('[data-testid="combo-tabata-work-time"]')).to_be_visible()
+    expect(page.locator('[data-testid="combo-tabata-rest-time"]')).to_be_visible()
+
+
+def test_tabata_form_inputs_not_shown_for_other_types(page: Page, app_url: str, browser_name: str):
+    """Work/rest inputs are hidden for EMOM and AMRAP types."""
+    _wait_for_db(page, app_url)
+    page.goto(f"{app_url}#/combos/new")
+    page.wait_for_selector('[data-testid="combo-type"]', timeout=5000)
+
+    for combo_type in ["EMOM", "AMRAP", "NONE"]:
+        page.select_option('[data-testid="combo-type"]', combo_type)
+        expect(page.locator('[data-testid="combo-tabata-work-time"]')).not_to_be_visible()
+        expect(page.locator('[data-testid="combo-tabata-rest-time"]')).not_to_be_visible()
+
+
+def test_tabata_timer_config_saved(page: Page, app_url: str, browser_name: str):
+    """TABATA work/rest times are persisted in timer_config."""
+    _wait_for_db(page, app_url)
+    _clean_all(page)
+
+    page.goto(f"{app_url}#/combos/new")
+    page.wait_for_selector('[data-testid="combo-type"]', timeout=5000)
+
+    page.fill('[data-testid="combo-title"]', "My Tabata")
+    page.select_option('[data-testid="combo-type"]', "TABATA")
+    page.fill('[data-testid="combo-tabata-work-time"]', "15")
+    page.fill('[data-testid="combo-tabata-rest-time"]', "5")
+    page.click('[data-testid="combo-save"]')
+    page.wait_for_selector('[data-testid="combo-detail-title"]', timeout=8000)
+
+    combo_id = page.url.split("/")[-1]
+    timer_config = page.evaluate(f"""async () => {{
+        const c = await window.__repos.combos.getById({repr(combo_id)})
+        return c.timer_config
+    }}""")
+    assert timer_config.get("workTime") == 15
+    assert timer_config.get("restTime") == 5
+
+
+# ── Session form / detail labels for AMRAP ────────────────────────────────────
+
+
+def test_amrap_label_in_session_form(page: Page, app_url: str, browser_name: str):
+    """AMRAP combo items show 'Duration (min)' instead of 'Reps' in session form."""
+    _wait_for_db(page, app_url)
+    _clean_all(page)
+
+    ex_id = _create_exercise(page, "Jump")
+    amrap_id = _create_timed_combo(page, "AMRAP Combo", "AMRAP", [ex_id])
+    none_id = _create_timed_combo(page, "None Combo", "NONE", [ex_id])
+
+    page.goto(f"{app_url}#/sessions/new")
+    page.wait_for_selector('[data-testid="session-title"]', timeout=5000)
+
+    # Add AMRAP combo
+    page.select_option('[data-testid="session-item-type-select"]', "combo")
+    page.wait_for_timeout(300)
+    page.select_option('[data-testid="session-item-select"]', amrap_id)
+    page.click('[data-testid="session-item-add"]')
+    page.wait_for_timeout(300)
+
+    # The reps label for AMRAP item should say "Duration (min)"
+    label = page.locator('[data-testid="session-item-0"] label').first.inner_text()
+    assert "min" in label.lower() or "duration" in label.lower()
+
+    # Add NONE combo
+    page.select_option('[data-testid="session-item-type-select"]', "combo")
+    page.wait_for_timeout(300)
+    page.select_option('[data-testid="session-item-select"]', none_id)
+    page.click('[data-testid="session-item-add"]')
+    page.wait_for_timeout(300)
+
+    # The reps label for NONE combo should say "Reps" (not duration)
+    label2 = page.locator('[data-testid="session-item-1"] label').first.inner_text()
+    assert "rep" in label2.lower() or label2.lower() == "reps"
+
+
+def test_amrap_label_in_session_detail(page: Page, app_url: str, browser_name: str):
+    """AMRAP combo items show minutes unit in session detail view."""
+    _wait_for_db(page, app_url)
+    _clean_all(page)
+
+    ex_id = _create_exercise(page, "Burpee")
+    amrap_id = _create_timed_combo(page, "AMRAP Detail", "AMRAP", [ex_id])
+    sess_id = _create_session_with_items(page, "AMRAP Session", [
+        {"item_id": amrap_id, "item_type": "combo", "repetitions": 10, "weight": 0}
+    ])
+
+    page.goto(f"{app_url}#/sessions/{sess_id}")
+    page.wait_for_selector('[data-testid="session-detail-title"]', timeout=5000)
+
+    detail_text = page.locator('[data-testid="session-detail-item-details-0"]').inner_text()
+    # Should show "10 minutes" (not "10 reps")
+    assert "10" in detail_text
+    assert "min" in detail_text.lower()
+
+
+# ── EMOM timer ────────────────────────────────────────────────────────────────
+
+
+def test_emom_timer_visible(page: Page, app_url: str, browser_name: str):
+    """EMOM combo steps show a timer display."""
+    _wait_for_db(page, app_url)
+    _clean_all(page)
+
+    ex_id = _create_exercise(page, "EMOM Press")
+    combo_id = _create_timed_combo(page, "EMOM Combo", "EMOM", [ex_id])
+    sess_id = _create_session_with_items(page, "EMOM Session", [
+        {"item_id": combo_id, "item_type": "combo", "repetitions": 1, "weight": 0}
+    ])
+
+    _navigate_to_execute(page, app_url, sess_id)
+
+    timer = page.locator('[data-testid="execute-timer"]')
+    expect(timer).to_be_visible()
+    # Should show countdown format MM:SS
+    timer_text = timer.inner_text()
+    assert ":" in timer_text
+
+
+def test_emom_timer_pause_resume(page: Page, app_url: str, browser_name: str):
+    """Pause button toggles pause state — button label changes."""
+    _wait_for_db(page, app_url)
+    _clean_all(page)
+
+    ex_id = _create_exercise(page, "EMOM Press P")
+    combo_id = _create_timed_combo(page, "EMOM Pause Combo", "EMOM", [ex_id])
+    sess_id = _create_session_with_items(page, "EMOM Pause Session", [
+        {"item_id": combo_id, "item_type": "combo", "repetitions": 1, "weight": 0}
+    ])
+
+    _navigate_to_execute(page, app_url, sess_id)
+
+    timer = page.locator('[data-testid="execute-timer"]')
+    expect(timer).to_be_visible()
+
+    # Initially timer is running — button should say Pause
+    pause_btn = timer.locator('button')
+    initial_label = pause_btn.inner_text()
+    assert "pause" in initial_label.lower() or "pause" in pause_btn.get_attribute("aria-label", "").lower()
+
+    # Click pause
+    pause_btn.click()
+    page.wait_for_timeout(300)
+
+    # Button should now say Resume
+    resume_label = pause_btn.inner_text()
+    assert "resume" in resume_label.lower() or "resume" in pause_btn.get_attribute("aria-label", "").lower()
+
+    # Click again to resume
+    pause_btn.click()
+    page.wait_for_timeout(300)
+
+    after_resume = pause_btn.inner_text()
+    assert "pause" in after_resume.lower() or "pause" in pause_btn.get_attribute("aria-label", "").lower()
+
+
+def test_emom_done_early_advances(page: Page, app_url: str, browser_name: str):
+    """Tapping Done during EMOM advances to the next step immediately."""
+    _wait_for_db(page, app_url)
+    _clean_all(page)
+
+    ex1 = _create_exercise(page, "EMOM Ex1")
+    ex2 = _create_exercise(page, "EMOM Ex2")
+    combo_id = _create_timed_combo(page, "EMOM Two", "EMOM", [ex1, ex2])
+    sess_id = _create_session_with_items(page, "EMOM Two Session", [
+        {"item_id": combo_id, "item_type": "combo", "repetitions": 1, "weight": 0}
+    ])
+
+    _navigate_to_execute(page, app_url, sess_id)
+
+    # We're on step 1 (EMOM Ex1)
+    expect(page.locator('[data-testid="execute-exercise-title"]')).to_have_text("EMOM Ex1")
+
+    # Tap Done early (should advance without waiting 60 seconds)
+    page.click('[data-testid="execute-done-btn"]')
+    page.wait_for_timeout(500)
+
+    # Now we should be on step 2
+    expect(page.locator('[data-testid="execute-exercise-title"]')).to_have_text("EMOM Ex2")
+
+
+def test_emom_auto_advance(page: Page, app_url: str, browser_name: str):
+    """EMOM timer auto-advances to next step after 60 seconds."""
+    page.clock.install()
+    _wait_for_db(page, app_url)
+    _clean_all(page)
+
+    ex1 = _create_exercise(page, "EMOM Auto1")
+    ex2 = _create_exercise(page, "EMOM Auto2")
+    combo_id = _create_timed_combo(page, "EMOM Auto", "EMOM", [ex1, ex2])
+    sess_id = _create_session_with_items(page, "EMOM Auto Session", [
+        {"item_id": combo_id, "item_type": "combo", "repetitions": 1, "weight": 0}
+    ])
+
+    _navigate_to_execute(page, app_url, sess_id)
+    expect(page.locator('[data-testid="execute-exercise-title"]')).to_have_text("EMOM Auto1")
+
+    # Advance 61 seconds — timer should fire and auto-advance
+    page.clock.run_for(61000)
+    page.wait_for_timeout(500)
+
+    expect(page.locator('[data-testid="execute-exercise-title"]')).to_have_text("EMOM Auto2")
+
+
+# ── AMRAP timer ───────────────────────────────────────────────────────────────
+
+
+def test_amrap_timer_visible(page: Page, app_url: str, browser_name: str):
+    """AMRAP combo steps show a timer display."""
+    _wait_for_db(page, app_url)
+    _clean_all(page)
+
+    ex_id = _create_exercise(page, "AMRAP Ex")
+    combo_id = _create_timed_combo(page, "AMRAP Combo Vis", "AMRAP", [ex_id])
+    sess_id = _create_session_with_items(page, "AMRAP Vis Session", [
+        {"item_id": combo_id, "item_type": "combo", "repetitions": 5, "weight": 0}
+    ])
+
+    _navigate_to_execute(page, app_url, sess_id)
+
+    timer = page.locator('[data-testid="execute-timer"]')
+    expect(timer).to_be_visible()
+    # Timer should show 05:00 (5 minutes)
+    timer_text = timer.inner_text()
+    assert "05:00" in timer_text or "5:" in timer_text
+
+
+def test_amrap_manual_done_cycles(page: Page, app_url: str, browser_name: str):
+    """Done button manually cycles through AMRAP exercises (auto-adds next round)."""
+    _wait_for_db(page, app_url)
+    _clean_all(page)
+
+    ex1 = _create_exercise(page, "AMRAP Cycle1")
+    ex2 = _create_exercise(page, "AMRAP Cycle2")
+    combo_id = _create_timed_combo(page, "AMRAP Cycle", "AMRAP", [ex1, ex2])
+    sess_id = _create_session_with_items(page, "AMRAP Cycle Session", [
+        {"item_id": combo_id, "item_type": "combo", "repetitions": 3, "weight": 0}
+    ])
+
+    _navigate_to_execute(page, app_url, sess_id)
+
+    # Step 1: AMRAP Cycle1
+    expect(page.locator('[data-testid="execute-exercise-title"]')).to_have_text("AMRAP Cycle1")
+
+    # Done → advances to AMRAP Cycle2
+    page.click('[data-testid="execute-done-btn"]')
+    page.wait_for_timeout(400)
+    expect(page.locator('[data-testid="execute-exercise-title"]')).to_have_text("AMRAP Cycle2")
+
+    # Done → auto-cycles back to AMRAP Cycle1 (round 2)
+    page.click('[data-testid="execute-done-btn"]')
+    page.wait_for_timeout(400)
+    expect(page.locator('[data-testid="execute-exercise-title"]')).to_have_text("AMRAP Cycle1")
+
+
+def test_amrap_timeup_screen(page: Page, app_url: str, browser_name: str):
+    """Time-up overlay appears when AMRAP timer expires."""
+    page.clock.install()
+    _wait_for_db(page, app_url)
+    _clean_all(page)
+
+    ex_id = _create_exercise(page, "AMRAP TimeUp Ex")
+    combo_id = _create_timed_combo(page, "AMRAP TimeUp", "AMRAP", [ex_id])
+    sess_id = _create_session_with_items(page, "AMRAP TimeUp Session", [
+        {"item_id": combo_id, "item_type": "combo", "repetitions": 1, "weight": 0}
+    ])
+
+    _navigate_to_execute(page, app_url, sess_id)
+
+    # Advance 61 seconds (1 minute AMRAP)
+    page.clock.run_for(61000)
+    page.wait_for_timeout(500)
+
+    timeup = page.locator('[data-testid="execute-amrap-timeup"]')
+    expect(timeup).to_be_visible()
+
+
+def test_amrap_continue_advances(page: Page, app_url: str, browser_name: str):
+    """Continue after AMRAP time-up advances to the next session item."""
+    page.clock.install()
+    _wait_for_db(page, app_url)
+    _clean_all(page)
+
+    ex_amrap = _create_exercise(page, "AMRAP Cont Ex")
+    ex_next = _create_exercise(page, "After AMRAP")
+    combo_id = _create_timed_combo(page, "AMRAP Cont", "AMRAP", [ex_amrap])
+    sess_id = _create_session_with_items(page, "AMRAP Cont Session", [
+        {"item_id": combo_id, "item_type": "combo", "repetitions": 1, "weight": 0},
+        {"item_id": ex_next, "item_type": "exercise", "repetitions": 5, "weight": 0}
+    ])
+
+    _navigate_to_execute(page, app_url, sess_id)
+
+    # Expire the AMRAP timer
+    page.clock.run_for(61000)
+    page.wait_for_timeout(500)
+
+    expect(page.locator('[data-testid="execute-amrap-timeup"]')).to_be_visible()
+
+    # Click Continue
+    page.click('[data-testid="execute-amrap-continue-btn"]')
+    page.wait_for_timeout(400)
+
+    # Should now be on the next exercise
+    expect(page.locator('[data-testid="execute-exercise-title"]')).to_have_text("After AMRAP")
+
+
+# ── TABATA timer ──────────────────────────────────────────────────────────────
+
+
+def test_tabata_work_phase_shows_timer(page: Page, app_url: str, browser_name: str):
+    """TABATA step shows timer during work phase."""
+    _wait_for_db(page, app_url)
+    _clean_all(page)
+
+    ex_id = _create_exercise(page, "TABATA Work Ex")
+    combo_id = _create_timed_combo(page, "TABATA Work", "TABATA", [ex_id],
+                                    timer_config={"workTime": 30, "restTime": 10})
+    sess_id = _create_session_with_items(page, "TABATA Work Session", [
+        {"item_id": combo_id, "item_type": "combo", "repetitions": 1, "weight": 0}
+    ])
+
+    _navigate_to_execute(page, app_url, sess_id)
+
+    timer = page.locator('[data-testid="execute-timer"]')
+    expect(timer).to_be_visible()
+    timer_text = timer.inner_text()
+    assert ":" in timer_text
+
+
+def test_tabata_rest_screen_after_work(page: Page, app_url: str, browser_name: str):
+    """REST screen appears after TABATA work phase timer expires (using short times)."""
+    _wait_for_db(page, app_url)
+    _clean_all(page)
+
+    ex_id = _create_exercise(page, "TABATA Rest Ex")
+    combo_id = _create_timed_combo(page, "TABATA Rest", "TABATA", [ex_id],
+                                    timer_config={"workTime": 2, "restTime": 10})
+    sess_id = _create_session_with_items(page, "TABATA Rest Session", [
+        {"item_id": combo_id, "item_type": "combo", "repetitions": 1, "weight": 0}
+    ])
+
+    _navigate_to_execute(page, app_url, sess_id)
+
+    # Wait for work phase to expire (2 seconds + margin)
+    page.wait_for_timeout(3500)
+
+    rest_card = page.locator('[data-testid="execute-tabata-rest"]')
+    expect(rest_card).to_be_visible()
+
+
+def test_tabata_advances_after_rest(page: Page, app_url: str, browser_name: str):
+    """Next exercise appears after TABATA rest phase timer expires."""
+    _wait_for_db(page, app_url)
+    _clean_all(page)
+
+    ex1 = _create_exercise(page, "TABATA Adv1")
+    ex2 = _create_exercise(page, "TABATA Adv2")
+    combo_id = _create_timed_combo(page, "TABATA Adv", "TABATA", [ex1, ex2],
+                                    timer_config={"workTime": 2, "restTime": 1})
+    sess_id = _create_session_with_items(page, "TABATA Adv Session", [
+        {"item_id": combo_id, "item_type": "combo", "repetitions": 1, "weight": 0}
+    ])
+
+    _navigate_to_execute(page, app_url, sess_id)
+
+    # Step 1 is TABATA Adv1
+    expect(page.locator('[data-testid="execute-exercise-title"]')).to_have_text("TABATA Adv1")
+
+    # Wait for work (2s) + rest (1s) + margin → Playwright polls until ex2 appears
+    expect(page.locator('[data-testid="execute-exercise-title"]')).to_have_text(
+        "TABATA Adv2", timeout=8000
+    )
+
+
+def test_tabata_done_starts_rest(page: Page, app_url: str, browser_name: str):
+    """Tapping Done during TABATA work phase starts the rest phase immediately."""
+    _wait_for_db(page, app_url)
+    _clean_all(page)
+
+    ex1 = _create_exercise(page, "TABATA Done1")
+    ex2 = _create_exercise(page, "TABATA Done2")
+    combo_id = _create_timed_combo(page, "TABATA Done", "TABATA", [ex1, ex2],
+                                    timer_config={"workTime": 60, "restTime": 60})
+    sess_id = _create_session_with_items(page, "TABATA Done Session", [
+        {"item_id": combo_id, "item_type": "combo", "repetitions": 1, "weight": 0}
+    ])
+
+    _navigate_to_execute(page, app_url, sess_id)
+
+    expect(page.locator('[data-testid="execute-exercise-title"]')).to_have_text("TABATA Done1")
+
+    # Tap Done early — should start rest phase
+    page.click('[data-testid="execute-done-btn"]')
+    page.wait_for_timeout(400)
+
+    rest_card = page.locator('[data-testid="execute-tabata-rest"]')
+    expect(rest_card).to_be_visible()
+
+
+def test_tabata_pause_during_work(page: Page, app_url: str, browser_name: str):
+    """Pause freezes TABATA work timer — REST screen does not appear while paused."""
+    _wait_for_db(page, app_url)
+    _clean_all(page)
+
+    ex_id = _create_exercise(page, "TABATA Pause Ex")
+    combo_id = _create_timed_combo(page, "TABATA Pause", "TABATA", [ex_id],
+                                    timer_config={"workTime": 2, "restTime": 1})
+    sess_id = _create_session_with_items(page, "TABATA Pause Session", [
+        {"item_id": combo_id, "item_type": "combo", "repetitions": 1, "weight": 0}
+    ])
+
+    _navigate_to_execute(page, app_url, sess_id)
+
+    timer = page.locator('[data-testid="execute-timer"]')
+    expect(timer).to_be_visible()
+
+    # Pause immediately
+    timer.locator('button').click()
+    page.wait_for_timeout(3500)  # Wait longer than workTime (2s)
+
+    # Timer is paused — REST screen should NOT appear
+    expect(page.locator('[data-testid="execute-tabata-rest"]')).not_to_be_visible()
+    expect(page.locator('[data-testid="execute-current-step"]')).to_be_visible()
+
+
+def test_tabata_pause_during_rest(page: Page, app_url: str, browser_name: str):
+    """Pause freezes TABATA rest timer — next exercise does not appear while paused."""
+    _wait_for_db(page, app_url)
+    _clean_all(page)
+
+    ex1 = _create_exercise(page, "TABATA PauseR1")
+    ex2 = _create_exercise(page, "TABATA PauseR2")
+    combo_id = _create_timed_combo(page, "TABATA PauseR", "TABATA", [ex1, ex2],
+                                    timer_config={"workTime": 2, "restTime": 10})
+    sess_id = _create_session_with_items(page, "TABATA PauseR Session", [
+        {"item_id": combo_id, "item_type": "combo", "repetitions": 1, "weight": 0}
+    ])
+
+    _navigate_to_execute(page, app_url, sess_id)
+
+    # Wait for work phase to complete (2s)
+    page.wait_for_timeout(3000)
+
+    rest_card = page.locator('[data-testid="execute-tabata-rest"]')
+    expect(rest_card).to_be_visible()
+
+    # Pause during rest
+    rest_card.locator('button').click()
+    page.wait_for_timeout(3000)  # Wait well beyond rest time (paused)
+
+    # Should still be on rest screen (not advanced to ex2)
+    expect(rest_card).to_be_visible()
+    expect(page.locator('[data-testid="execute-exercise-title"]')).not_to_be_visible()
+
+
+# ── Non-timed combo unchanged ─────────────────────────────────────────────────
+
+
+def test_non_timed_combo_unchanged(page: Page, app_url: str, browser_name: str):
+    """NONE-type combos still show the final-round screen — no timer displayed."""
+    _wait_for_db(page, app_url)
+    _clean_all(page)
+
+    ex_id = _create_exercise(page, "None Combo Ex")
+    combo_id = _create_timed_combo(page, "None Combo", "NONE", [ex_id])
+    sess_id = _create_session_with_items(page, "None Session", [
+        {"item_id": combo_id, "item_type": "combo", "repetitions": 1, "weight": 0}
+    ])
+
+    _navigate_to_execute(page, app_url, sess_id)
+
+    # No timer should be shown
+    expect(page.locator('[data-testid="execute-timer"]')).not_to_be_visible()
+
+    # Tap Done
+    page.click('[data-testid="execute-done-btn"]')
+    page.wait_for_timeout(400)
+
+    # Final-round screen should appear (unchanged from Step 8 behaviour)
+    expect(page.locator('[data-testid="execute-final-round"]')).to_be_visible()
+    expect(page.locator('[data-testid="execute-continue-btn"]')).to_be_visible()
+    expect(page.locator('[data-testid="execute-one-more-btn"]')).to_be_visible()
diff --git a/tests/test_step13_markdown.py b/tests/test_step13_markdown.py
new file mode 100644
index 0000000..154c0a8
--- /dev/null
+++ b/tests/test_step13_markdown.py
@@ -0,0 +1,268 @@
+"""
+Step 13 — Markdown in Description Fields
+- test_markdown_hint_on_exercise_form: Hint text visible next to description label on exercise form
+- test_markdown_hint_on_combo_form: Hint text visible next to description label on combo form
+- test_markdown_hint_on_session_form: Hint text visible next to description label on session form
+- test_markdown_rendered_in_exercise_detail: Bold, italic and list render as HTML in exercise detail
+- test_markdown_rendered_in_combo_detail: Bold text renders as HTML in combo detail
+- test_markdown_rendered_in_session_detail: Bold text renders as HTML in session detail
+- test_description_absent_from_exercise_list: Description is not shown on exercise list cards
+- test_description_absent_from_combo_list: Description is not shown on combo list cards
+- test_description_absent_from_session_list: Description is not shown on session list cards
+"""
+from playwright.sync_api import Page, expect
+
+HINT_TEXT = "Basic Markdown supported"
+
+
+def _wait_for_db(page: Page, app_url: str):
+    """Navigate and wait for the database to be ready."""
+    page.goto(app_url)
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-ready') === 'true'",
+        timeout=15000,
+    )
+
+
+def _clean_all(page: Page):
+    """Remove all exercises, combos, and sessions via the repositories."""
+    page.evaluate(
+        """async () => {
+            for (const e of await window.__repos.exercises.getAll())
+                await window.__repos.exercises.delete(e.id);
+            for (const c of await window.__repos.combos.getAll())
+                await window.__repos.combos.delete(c.id);
+            for (const s of await window.__repos.sessions.getAll())
+                await window.__repos.sessions.delete(s.id);
+        }"""
+    )
+
+
+# ---------------------------------------------------------------------------
+# Hint tests
+# ---------------------------------------------------------------------------
+
+def test_markdown_hint_on_exercise_form(page: Page, app_url: str):
+    """Hint 'Basic Markdown supported' appears next to the description label on the exercise form."""
+    _wait_for_db(page, app_url)
+    page.click('a[href="#/exercises"]')
+    page.wait_for_timeout(500)
+    page.click('[data-testid="exercise-new-btn"]')
+    page.wait_for_selector('[data-testid="exercise-description"]')
+
+    hint = page.locator('[data-testid="exercise-description"]').locator(
+        'xpath=../label .field-hint'
+    )
+    # Locate via the form-group label
+    hint = page.locator('label[for="exercise-description"] .field-hint')
+    expect(hint).to_have_text(HINT_TEXT)
+
+
+def test_markdown_hint_on_combo_form(page: Page, app_url: str):
+    """Hint 'Basic Markdown supported' appears next to the description label on the combo form."""
+    _wait_for_db(page, app_url)
+    page.click('a[href="#/combos"]')
+    page.wait_for_timeout(500)
+    page.click('[data-testid="combo-new-btn"]')
+    page.wait_for_selector('[data-testid="combo-description"]')
+
+    hint = page.locator('label[for="combo-description"] .field-hint')
+    expect(hint).to_have_text(HINT_TEXT)
+
+
+def test_markdown_hint_on_session_form(page: Page, app_url: str):
+    """Hint 'Basic Markdown supported' appears next to the description label on the session form."""
+    _wait_for_db(page, app_url)
+    page.click('a[href="#/sessions"]')
+    page.wait_for_timeout(500)
+    page.click('[data-testid="session-new-btn"]')
+    page.wait_for_selector('[data-testid="session-description"]')
+
+    hint = page.locator('label[for="session-description"] .field-hint')
+    expect(hint).to_have_text(HINT_TEXT)
+
+
+# ---------------------------------------------------------------------------
+# Rendering tests
+# ---------------------------------------------------------------------------
+
+def test_markdown_rendered_in_exercise_detail(page: Page, app_url: str):
+    """Bold, italic, and list items in a description render as HTML elements in the exercise detail view."""
+    _wait_for_db(page, app_url)
+    _clean_all(page)
+
+    exercise_id = page.evaluate(
+        """async () => {
+            const uuid = await window.__repos.settings.get('user_uuid');
+            return window.__repos.exercises.create({
+                title: 'MD Exercise',
+                description: '**bold** and *italic*\\n- item one',
+                created_by: uuid,
+            });
+        }"""
+    )
+
+    page.goto(f"{app_url}/#/exercises/{exercise_id}")
+    page.wait_for_selector('[data-testid="exercise-detail-description"]')
+
+    desc = page.locator('[data-testid="exercise-detail-description"]')
+    expect(desc.locator('strong')).to_have_text('bold')
+    expect(desc.locator('em')).to_have_text('italic')
+    expect(desc.locator('li').first).to_have_text('item one')
+
+    _clean_all(page)
+
+
+def test_markdown_rendered_in_combo_detail(page: Page, app_url: str):
+    """Bold text in a combo description renders as a <strong> element in the detail view."""
+    _wait_for_db(page, app_url)
+    _clean_all(page)
+
+    combo_id = page.evaluate(
+        """async () => {
+            const uuid = await window.__repos.settings.get('user_uuid');
+            return window.__repos.combos.create({
+                title: 'MD Combo',
+                description: '**important**',
+                type: 'NONE',
+                exercises: [],
+                timer_config: {},
+                created_by: uuid,
+            });
+        }"""
+    )
+
+    page.goto(f"{app_url}/#/combos/{combo_id}")
+    page.wait_for_selector('[data-testid="combo-detail-description"]')
+
+    desc = page.locator('[data-testid="combo-detail-description"]')
+    expect(desc.locator('strong')).to_have_text('important')
+
+    _clean_all(page)
+
+
+def test_markdown_rendered_in_session_detail(page: Page, app_url: str):
+    """Bold text in a session description renders as a <strong> element in the detail view."""
+    _wait_for_db(page, app_url)
+    _clean_all(page)
+
+    session_id = page.evaluate(
+        """async () => {
+            const uuid = await window.__repos.settings.get('user_uuid');
+            return window.__repos.sessions.create({
+                title: 'MD Session',
+                description: '**focus**',
+                items: [],
+                created_by: uuid,
+            });
+        }"""
+    )
+
+    page.goto(f"{app_url}/#/sessions/{session_id}")
+    page.wait_for_selector('[data-testid="session-detail-description"]')
+
+    desc = page.locator('[data-testid="session-detail-description"]')
+    expect(desc.locator('strong')).to_have_text('focus')
+
+    _clean_all(page)
+
+
+# ---------------------------------------------------------------------------
+# List view — description must not appear
+# ---------------------------------------------------------------------------
+
+def test_description_absent_from_exercise_list(page: Page, app_url: str):
+    """Exercise list cards do not display the description text."""
+    _wait_for_db(page, app_url)
+    _clean_all(page)
+
+    page.evaluate(
+        """async () => {
+            const uuid = await window.__repos.settings.get('user_uuid');
+            await window.__repos.exercises.create({
+                title: 'No Desc Exercise',
+                description: 'should not be visible in list',
+                created_by: uuid,
+            });
+        }"""
+    )
+
+    page.click('a[href="#/exercises"]')
+    page.wait_for_timeout(500)
+    page.reload()
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-ready') === 'true'",
+        timeout=15000,
+    )
+    page.click('a[href="#/exercises"]')
+    page.wait_for_timeout(500)
+
+    expect(page.get_by_text('should not be visible in list')).not_to_be_visible()
+
+    _clean_all(page)
+
+
+def test_description_absent_from_combo_list(page: Page, app_url: str):
+    """Combo list cards do not display the description text."""
+    _wait_for_db(page, app_url)
+    _clean_all(page)
+
+    page.evaluate(
+        """async () => {
+            const uuid = await window.__repos.settings.get('user_uuid');
+            await window.__repos.combos.create({
+                title: 'No Desc Combo',
+                description: 'combo desc not in list',
+                type: 'NONE',
+                exercises: [],
+                timer_config: {},
+                created_by: uuid,
+            });
+        }"""
+    )
+
+    page.click('a[href="#/combos"]')
+    page.wait_for_timeout(500)
+    page.reload()
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-ready') === 'true'",
+        timeout=15000,
+    )
+    page.click('a[href="#/combos"]')
+    page.wait_for_timeout(500)
+
+    expect(page.get_by_text('combo desc not in list')).not_to_be_visible()
+
+    _clean_all(page)
+
+
+def test_description_absent_from_session_list(page: Page, app_url: str):
+    """Session list cards do not display the description text."""
+    _wait_for_db(page, app_url)
+    _clean_all(page)
+
+    page.evaluate(
+        """async () => {
+            const uuid = await window.__repos.settings.get('user_uuid');
+            await window.__repos.sessions.create({
+                title: 'No Desc Session',
+                description: 'session desc not in list',
+                items: [],
+                created_by: uuid,
+            });
+        }"""
+    )
+
+    page.click('a[href="#/sessions"]')
+    page.wait_for_timeout(500)
+    page.reload()
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-ready') === 'true'",
+        timeout=15000,
+    )
+    page.click('a[href="#/sessions"]')
+    page.wait_for_timeout(500)
+
+    expect(page.get_by_text('session desc not in list')).not_to_be_visible()
+
+    _clean_all(page)
diff --git a/tests/test_step14_form_shortcuts.py b/tests/test_step14_form_shortcuts.py
new file mode 100644
index 0000000..c7374fd
--- /dev/null
+++ b/tests/test_step14_form_shortcuts.py
@@ -0,0 +1,202 @@
+"""
+Step 14 — Form Keyboard Shortcuts Tests
+
+Tests for Ctrl+Enter (save) and Escape (cancel) shortcuts on form views.
+The exercise form is used as the representative form; one test each covers
+the session and combo forms to confirm the shortcuts are wired consistently.
+
+- test_ctrl_enter_saves_from_body: Ctrl+Enter with no input focused saves the form
+- test_ctrl_enter_saves_from_input: Ctrl+Enter while typing in a field saves the form
+- test_ctrl_enter_validates_before_saving: Ctrl+Enter with empty title shows validation error
+- test_escape_cancels_from_body: Escape with no input focused navigates back to list
+- test_escape_cancels_from_input: Escape while a field is focused navigates back to list
+- test_escape_cancel_edit_returns_to_detail: Escape on an edit form returns to detail view
+- test_save_button_tooltip_contains_shortcut: Save button title attribute shows Ctrl+Enter hint
+- test_ctrl_enter_on_session_form: Ctrl+Enter saves from the session new form
+- test_ctrl_enter_on_combo_form: Ctrl+Enter saves from the combo new form
+- test_ctrl_enter_on_collection_form: Ctrl+Enter saves from the collection new form
+"""
+from playwright.sync_api import Page, expect
+
+
+def _wait_db(page: Page, app_url: str):
+    page.goto(app_url)
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-ready') === 'true'",
+        timeout=15000,
+    )
+
+
+def _clean_exercises(page: Page):
+    page.evaluate(
+        """async () => {
+            const all = await window.__repos.exercises.getAll();
+            for (const ex of all) await window.__repos.exercises.delete(ex.id);
+        }"""
+    )
+
+
+def _clean_sessions(page: Page):
+    page.evaluate(
+        """async () => {
+            const all = await window.__repos.sessions.getAll();
+            for (const s of all) await window.__repos.sessions.delete(s.id);
+        }"""
+    )
+
+
+def _clean_combos(page: Page):
+    page.evaluate(
+        """async () => {
+            const all = await window.__repos.combos.getAll();
+            for (const c of all) await window.__repos.combos.delete(c.id);
+        }"""
+    )
+
+
+def _clean_collections(page: Page):
+    page.evaluate(
+        """async () => {
+            const all = await window.__repos.collections.getAll();
+            for (const c of all) await window.__repos.collections.delete(c.id);
+        }"""
+    )
+
+
+def _open_exercise_new_form(page: Page, app_url: str):
+    _wait_db(page, app_url)
+    _clean_exercises(page)
+    page.click('a[href="#/exercises"]')
+    page.wait_for_timeout(300)
+    page.click('[data-testid="exercise-new-btn"]')
+    page.wait_for_selector('[data-testid="exercise-title"]')
+
+
+def test_ctrl_enter_saves_from_body(page: Page, app_url: str):
+    """Ctrl+Enter with focus outside any input saves the form and navigates to detail view."""
+    _open_exercise_new_form(page, app_url)
+    page.fill('[data-testid="exercise-title"]', "Shortcut Save Test")
+    # Move focus away from the input (Escape would cancel the form, so blur instead)
+    page.evaluate("document.activeElement.blur()")
+    page.keyboard.press("Control+Enter")
+    page.wait_for_selector('[data-testid="exercise-detail-title"]', timeout=5000)
+    expect(page.locator('[data-testid="exercise-detail-title"]')).to_have_text("Shortcut Save Test")
+    _clean_exercises(page)
+
+
+def test_ctrl_enter_saves_from_input(page: Page, app_url: str):
+    """Ctrl+Enter while a text input is focused saves the form."""
+    _open_exercise_new_form(page, app_url)
+    page.fill('[data-testid="exercise-title"]', "Shortcut From Input")
+    # Keep focus inside the title input and press Ctrl+Enter
+    page.locator('[data-testid="exercise-title"]').press("Control+Enter")
+    page.wait_for_selector('[data-testid="exercise-detail-title"]', timeout=5000)
+    expect(page.locator('[data-testid="exercise-detail-title"]')).to_have_text("Shortcut From Input")
+    _clean_exercises(page)
+
+
+def test_ctrl_enter_validates_before_saving(page: Page, app_url: str):
+    """Ctrl+Enter with an empty title triggers validation rather than saving."""
+    _open_exercise_new_form(page, app_url)
+    # Do not fill the title — press Ctrl+Enter immediately
+    page.locator('[data-testid="exercise-title"]').press("Control+Enter")
+    expect(page.locator('[data-testid="exercise-title-error"]')).to_be_visible()
+    # Still on the form
+    expect(page.locator('[data-testid="exercise-title"]')).to_be_visible()
+
+
+def test_escape_cancels_from_body(page: Page, app_url: str):
+    """Escape with focus on the page body (no input focused) cancels the form and goes back to the list."""
+    _open_exercise_new_form(page, app_url)
+    page.fill('[data-testid="exercise-title"]', "Should Not Be Saved")
+    # Click outside the form to move focus away from any input
+    page.locator("h1").first.click()
+    page.keyboard.press("Escape")
+    page.wait_for_url("**#/exercises", timeout=5000)
+    expect(page.locator('[data-testid="exercise-new-btn"]')).to_be_visible()
+
+
+def test_escape_cancels_from_input(page: Page, app_url: str):
+    """Escape while a text input is focused cancels the form and goes back to the list."""
+    _open_exercise_new_form(page, app_url)
+    page.fill('[data-testid="exercise-title"]', "Should Not Be Saved Either")
+    page.locator('[data-testid="exercise-title"]').press("Escape")
+    page.wait_for_url("**#/exercises", timeout=5000)
+    expect(page.locator('[data-testid="exercise-new-btn"]')).to_be_visible()
+
+
+def test_escape_cancel_edit_returns_to_detail(page: Page, app_url: str):
+    """Escape on an edit form returns to the detail view, not the list."""
+    _wait_db(page, app_url)
+    _clean_exercises(page)
+    # Create an exercise first
+    page.click('a[href="#/exercises"]')
+    page.wait_for_timeout(300)
+    page.click('[data-testid="exercise-new-btn"]')
+    page.wait_for_selector('[data-testid="exercise-title"]')
+    page.fill('[data-testid="exercise-title"]', "Edit Escape Test")
+    page.click('[data-testid="exercise-save"]')
+    page.wait_for_selector('[data-testid="exercise-detail-title"]', timeout=5000)
+    # Open the edit form
+    page.click('[data-testid="exercise-edit-btn"]')
+    page.wait_for_selector('[data-testid="exercise-title"]')
+    # Press Escape — should go back to the detail view, not the list
+    page.keyboard.press("Escape")
+    page.wait_for_selector('[data-testid="exercise-detail-title"]', timeout=5000)
+    expect(page.locator('[data-testid="exercise-detail-title"]')).to_have_text("Edit Escape Test")
+    _clean_exercises(page)
+
+
+def test_save_button_tooltip_contains_shortcut(page: Page, app_url: str):
+    """The save button has a title attribute that includes 'Ctrl+Enter'."""
+    _open_exercise_new_form(page, app_url)
+    title_attr = page.locator('[data-testid="exercise-save"]').get_attribute("title")
+    assert title_attr is not None, "Save button should have a title attribute"
+    assert "Ctrl+Enter" in title_attr or "Ctrl+Entrée" in title_attr, (
+        f"Expected Ctrl+Enter hint in title, got: {title_attr}"
+    )
+
+
+def test_ctrl_enter_on_session_form(page: Page, app_url: str):
+    """Ctrl+Enter saves the session new form from within the title input."""
+    _wait_db(page, app_url)
+    _clean_sessions(page)
+    page.click('a[href="#/sessions"]')
+    page.wait_for_timeout(300)
+    page.click('[data-testid="session-new-btn"]')
+    page.wait_for_selector('[data-testid="session-title"]')
+    page.fill('[data-testid="session-title"]', "Session Shortcut Test")
+    page.locator('[data-testid="session-title"]').press("Control+Enter")
+    page.wait_for_selector('[data-testid="session-detail-title"]', timeout=5000)
+    expect(page.locator('[data-testid="session-detail-title"]')).to_have_text("Session Shortcut Test")
+    _clean_sessions(page)
+
+
+def test_ctrl_enter_on_combo_form(page: Page, app_url: str):
+    """Ctrl+Enter saves the combo new form from within the title input."""
+    _wait_db(page, app_url)
+    _clean_combos(page)
+    page.click('a[href="#/combos"]')
+    page.wait_for_timeout(300)
+    page.click('[data-testid="combo-new-btn"]')
+    page.wait_for_selector('[data-testid="combo-title"]')
+    page.fill('[data-testid="combo-title"]', "Combo Shortcut Test")
+    page.locator('[data-testid="combo-title"]').press("Control+Enter")
+    page.wait_for_selector('[data-testid="combo-detail-title"]', timeout=5000)
+    expect(page.locator('[data-testid="combo-detail-title"]')).to_have_text("Combo Shortcut Test")
+    _clean_combos(page)
+
+
+def test_ctrl_enter_on_collection_form(page: Page, app_url: str):
+    """Ctrl+Enter saves the collection new form from within the label input."""
+    _wait_db(page, app_url)
+    _clean_collections(page)
+    page.click('a[href="#/collections"]')
+    page.wait_for_timeout(300)
+    page.click('[data-testid="collection-new-btn"]')
+    page.wait_for_selector('[data-testid="collection-label"]')
+    page.fill('[data-testid="collection-label"]', "Collection Shortcut Test")
+    page.locator('[data-testid="collection-label"]').press("Control+Enter")
+    page.wait_for_selector('[data-testid="collection-detail-title"]', timeout=5000)
+    expect(page.locator('[data-testid="collection-detail-title"]')).to_have_text("Collection Shortcut Test")
+    _clean_collections(page)
diff --git a/tests/test_step15_audio_cues.py b/tests/test_step15_audio_cues.py
new file mode 100644
index 0000000..d937a54
--- /dev/null
+++ b/tests/test_step15_audio_cues.py
@@ -0,0 +1,315 @@
+"""
+Step 15 — Audio Cues Tests
+
+The WebAudio API is replaced by a lightweight mock on every page load so that
+each beep is recorded in window._audioLog as {freq: number}:
+  - 440 Hz  →  soft bip
+  - 880 Hz  →  loud BIP
+
+page.clock.install() controls fake time so setInterval ticks are driven
+explicitly with page.clock.run_for(ms), making timer-dependent assertions
+instant and deterministic.
+
+TABATA audio cues
+- test_tabata_bip_at_half_work_interval:      440 Hz bip fires at half of workTime
+- test_tabata_countdown_end_of_work_phase:    bip,bip,BIP at the end of the work phase
+- test_tabata_bip_at_half_rest_interval:      440 Hz bip fires at half of restTime
+- test_tabata_countdown_end_of_rest_phase:    bip,bip,BIP at the end of the rest phase
+
+AMRAP audio cues
+- test_amrap_minute_mark_plays_bip:           soft bip (not BIP) fires at each elapsed minute
+- test_amrap_half_time_plays_BIP:             loud BIP fires at exactly the halfway point
+- test_amrap_last_minute_countdown:           bip at r=2, bip at r=1, BIP at expiry
+"""
+
+import json
+import pytest
+from playwright.sync_api import Page, expect
+
+# ── Audio mock injected before every page load ────────────────────────────────
+
+_AUDIO_MOCK = """
+window._audioLog = [];
+window.AudioContext = function () {
+    return {
+        state: 'running',
+        currentTime: 0,
+        createOscillator: function () {
+            let _freq = 0;
+            return {
+                connect: function () {},
+                frequency: {
+                    get value() { return _freq; },
+                    set value(v) { _freq = v; }
+                },
+                start: function () {},
+                stop: function () { window._audioLog.push({ freq: _freq }); }
+            };
+        },
+        createGain: function () {
+            return { connect: function () {}, gain: { value: 0 } };
+        },
+        resume: function () { return Promise.resolve(); },
+        destination: {}
+    };
+};
+"""
+
+
+# ── Shared helpers ────────────────────────────────────────────────────────────
+
+
+def _setup(page: Page, app_url: str):
+    """Install fake clock and audio mock, then load the app."""
+    page.clock.install()
+    page.add_init_script(_AUDIO_MOCK)
+    page.goto(app_url)
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-ready') === 'true'",
+        timeout=15000,
+    )
+
+
+def _create_exercise(page: Page, title: str) -> str:
+    return page.evaluate(f"""async () => {{
+        const uid = await window.__repos.settings.get('user_uuid')
+        return window.__repos.exercises.create({{
+            title: {repr(title)}, description: '', asymmetric: false, alternate: false,
+            image_urls: '[]', video_urls: '[]',
+            default_reps: 10, default_weight: 0, created_by: uid
+        }})
+    }}""")
+
+
+def _create_timed_combo(page: Page, title: str, combo_type: str,
+                         exercise_ids: list, timer_config: dict = None) -> str:
+    tc = json.dumps(timer_config or {})
+    exs = json.dumps([{"exerciseId": eid, "defaultReps": 10, "defaultWeight": 0}
+                      for eid in exercise_ids])
+    return page.evaluate(f"""async () => {{
+        const uid = await window.__repos.settings.get('user_uuid')
+        const cid = await window.__repos.combos.create({{
+            title: {repr(title)}, description: '', type: {repr(combo_type)},
+            timer_config: {tc}, created_by: uid
+        }})
+        await window.__repos.combos.setExercises(cid, {exs})
+        return cid
+    }}""")
+
+
+def _create_session(page: Page, title: str, items: list) -> str:
+    items_json = json.dumps(items)
+    return page.evaluate(f"""async () => {{
+        const uid = await window.__repos.settings.get('user_uuid')
+        const sid = await window.__repos.sessions.create({{
+            title: {repr(title)}, description: '', created_by: uid
+        }})
+        const items = {items_json}
+        await window.__repos.sessions.setItems(sid, items.map((it, i) => ({{
+            item_id: it.item_id, item_type: it.item_type,
+            position: i, repetitions: it.repetitions, weight: 0
+        }})))
+        return sid
+    }}""")
+
+
+def _clean_all(page: Page):
+    page.evaluate("""async () => {
+        for (const s of await window.__repos.sessions.getAll())
+            await window.__repos.sessions.delete(s.id)
+        for (const c of await window.__repos.combos.getAll())
+            await window.__repos.combos.delete(c.id)
+        for (const e of await window.__repos.exercises.getAll())
+            await window.__repos.exercises.delete(e.id)
+    }""")
+
+
+def _navigate_to_execute(page: Page, app_url: str, sess_id: str):
+    page.goto(f"{app_url}#/sessions/{sess_id}/execute")
+    page.wait_for_selector('[data-testid="execute-session-title"]', timeout=10000)
+    page.wait_for_timeout(400)
+
+
+def _freqs(page: Page) -> list[int]:
+    """Return the list of recorded frequencies from the audio mock."""
+    return [e["freq"] for e in page.evaluate("window._audioLog")]
+
+
+# ── TABATA audio cue tests ────────────────────────────────────────────────────
+
+
+def test_tabata_bip_at_half_work_interval(page: Page, app_url: str, browser_name: str):
+    """A soft bip (440 Hz) fires at exactly the half-interval point of the work phase."""
+    _setup(page, app_url)
+    _clean_all(page)
+
+    ex_id = _create_exercise(page, "Tab HalfWork Ex")
+    # workTime=20 → half=10; restTime=60 so we stay in work phase during the test
+    combo_id = _create_timed_combo(page, "Tab HalfWork", "TABATA", [ex_id],
+                                    timer_config={"workTime": 20, "restTime": 60})
+    sess_id = _create_session(page, "Tab HalfWork Session",
+                               [{"item_id": combo_id, "item_type": "combo", "repetitions": 1}])
+
+    _navigate_to_execute(page, app_url, sess_id)
+    # Immediately after load: BIP(880) fires for work phase start
+
+    page.clock.run_for(10_000)   # advance to r=10 — exactly the half-interval
+    page.wait_for_timeout(300)
+
+    f = _freqs(page)
+    # Expected so far: BIP at t=0, bip at t=10 (half)
+    assert f.count(880) == 1, f"Expected 1 BIP (work start) so far: {f}"
+    assert f.count(440) == 1, f"Expected exactly 1 bip at half-interval: {f}"
+    assert f == [880, 440], f"Unexpected audio sequence: {f}"
+
+
+def test_tabata_countdown_end_of_work_phase(page: Page, app_url: str, browser_name: str):
+    """bip, bip, BIP fires at the last 2 seconds of the work phase (1-second spacing)."""
+    _setup(page, app_url)
+    _clean_all(page)
+
+    ex_id = _create_exercise(page, "Tab CntdwnWork Ex")
+    # workTime=10 → half=5, countdown at r=2 and r=1, BIP at rest start
+    combo_id = _create_timed_combo(page, "Tab CntdwnWork", "TABATA", [ex_id],
+                                    timer_config={"workTime": 10, "restTime": 60})
+    sess_id = _create_session(page, "Tab CntdwnWork Session",
+                               [{"item_id": combo_id, "item_type": "combo", "repetitions": 1}])
+
+    _navigate_to_execute(page, app_url, sess_id)
+
+    page.clock.run_for(10_000)   # full work phase
+    page.wait_for_timeout(300)
+
+    f = _freqs(page)
+    # BIP(work start), bip(r=5 half), bip(r=2), bip(r=1), BIP(rest start)
+    assert f == [880, 440, 440, 440, 880], f"Unexpected audio sequence: {f}"
+
+
+def test_tabata_bip_at_half_rest_interval(page: Page, app_url: str, browser_name: str):
+    """A soft bip (440 Hz) fires at the half-interval point of the rest phase."""
+    _setup(page, app_url)
+    _clean_all(page)
+
+    ex_id = _create_exercise(page, "Tab HalfRest Ex")
+    # workTime=10 (half=5), restTime=20 (half=10)
+    combo_id = _create_timed_combo(page, "Tab HalfRest", "TABATA", [ex_id],
+                                    timer_config={"workTime": 10, "restTime": 20})
+    sess_id = _create_session(page, "Tab HalfRest Session",
+                               [{"item_id": combo_id, "item_type": "combo", "repetitions": 1}])
+
+    _navigate_to_execute(page, app_url, sess_id)
+
+    # 10s work + 10s into rest (= rest half-interval)
+    page.clock.run_for(20_000)
+    page.wait_for_timeout(300)
+
+    f = _freqs(page)
+    # Work:  BIP(start) bip(r=5) bip(r=2) bip(r=1) BIP(rest start)
+    # Rest (first 10 s): bip(r=10 half)
+    assert f == [880, 440, 440, 440, 880, 440], f"Unexpected audio sequence: {f}"
+
+
+def test_tabata_countdown_end_of_rest_phase(page: Page, app_url: str, browser_name: str):
+    """bip, bip, BIP fires at the last 2 seconds of the rest phase."""
+    _setup(page, app_url)
+    _clean_all(page)
+
+    ex1 = _create_exercise(page, "Tab CntdwnRest Ex1")
+    ex2 = _create_exercise(page, "Tab CntdwnRest Ex2")
+    # workTime=10 (half=5), restTime=10 (half=5); two exercises to verify rest→work BIP
+    combo_id = _create_timed_combo(page, "Tab CntdwnRest", "TABATA", [ex1, ex2],
+                                    timer_config={"workTime": 10, "restTime": 10})
+    sess_id = _create_session(page, "Tab CntdwnRest Session",
+                               [{"item_id": combo_id, "item_type": "combo", "repetitions": 1}])
+
+    _navigate_to_execute(page, app_url, sess_id)
+
+    # 10s work + 10s rest
+    page.clock.run_for(20_000)
+    page.wait_for_timeout(300)
+
+    f = _freqs(page)
+    # Work:  BIP bip(r=5) bip(r=2) bip(r=1) BIP(rest start)
+    # Rest:  bip(r=5) bip(r=2) bip(r=1) BIP(work2 start)
+    assert f == [880, 440, 440, 440, 880, 440, 440, 440, 880], \
+        f"Unexpected audio sequence: {f}"
+
+
+# ── AMRAP audio cue tests ─────────────────────────────────────────────────────
+
+
+def test_amrap_minute_mark_plays_bip(page: Page, app_url: str, browser_name: str):
+    """Soft bip (440 Hz, not BIP) fires at each elapsed minute outside the last minute."""
+    _setup(page, app_url)
+    _clean_all(page)
+
+    ex_id = _create_exercise(page, "AMRAP Min Bip Ex")
+    # 4-min AMRAP (240 s): halfDuration=120; first minute fires at r=180 (t=60)
+    combo_id = _create_timed_combo(page, "AMRAP Min Bip", "AMRAP", [ex_id])
+    sess_id = _create_session(page, "AMRAP Min Bip Session",
+                               [{"item_id": combo_id, "item_type": "combo", "repetitions": 4}])
+
+    _navigate_to_execute(page, app_url, sess_id)
+    # AMRAP plays no BIP at start
+
+    page.clock.run_for(61_000)   # past the 1-minute mark, before half-time (120 s)
+    page.wait_for_timeout(300)
+
+    f = _freqs(page)
+    assert 880 not in f, f"BIP should not fire before half-time: {f}"
+    assert f.count(440) == 1, f"Expected exactly 1 bip at the 1-minute mark: {f}"
+
+
+def test_amrap_half_time_plays_BIP(page: Page, app_url: str, browser_name: str):
+    """Loud BIP (880 Hz) fires at the halfway point of the total AMRAP duration."""
+    _setup(page, app_url)
+    _clean_all(page)
+
+    ex_id = _create_exercise(page, "AMRAP Half BIP Ex")
+    # 4-min AMRAP (240 s): halfDuration = round(240/2) = 120 s
+    # At t=60 (r=180): bip for 1-min mark
+    # At t=120 (r=120): BIP for half-time (also coincides with 2-min mark, BIP takes priority)
+    combo_id = _create_timed_combo(page, "AMRAP Half BIP", "AMRAP", [ex_id])
+    sess_id = _create_session(page, "AMRAP Half BIP Session",
+                               [{"item_id": combo_id, "item_type": "combo", "repetitions": 4}])
+
+    _navigate_to_execute(page, app_url, sess_id)
+
+    page.clock.run_for(121_000)  # past both 1-min bip (t=60) and half-time BIP (t=120)
+    page.wait_for_timeout(300)
+
+    f = _freqs(page)
+    assert 880 in f, f"Half-time BIP should have fired: {f}"
+    assert f.count(880) == 1, f"Expected exactly 1 BIP (half-time), got {f.count(880)}: {f}"
+    # The minute bip at t=60 must precede the half-time BIP at t=120
+    assert f.index(440) < f.index(880), f"Minute bip should precede half-time BIP: {f}"
+
+
+def test_amrap_last_minute_countdown(page: Page, app_url: str, browser_name: str):
+    """bip at r=2 and r=1 lead into the final BIP when AMRAP time expires (1-second spacing)."""
+    _setup(page, app_url)
+    _clean_all(page)
+
+    ex_id = _create_exercise(page, "AMRAP LastMin Ex")
+    # 3-min AMRAP (180 s): halfDuration=90
+    # Full expected sequence:
+    #   bip at t=60  (r=120, 1-min mark)
+    #   BIP at t=90  (r=90,  half-time)
+    #   bip at t=150 (r=30,  midpoint of last minute)
+    #   bip at t=178 (r=2,   countdown)
+    #   bip at t=179 (r=1,   countdown)
+    #   BIP at t=180 (r=0,   expiry)
+    combo_id = _create_timed_combo(page, "AMRAP LastMin", "AMRAP", [ex_id])
+    sess_id = _create_session(page, "AMRAP LastMin Session",
+                               [{"item_id": combo_id, "item_type": "combo", "repetitions": 3}])
+
+    _navigate_to_execute(page, app_url, sess_id)
+
+    # Advance the full AMRAP duration in one step for deterministic results
+    page.clock.run_for(180_000)
+    page.wait_for_timeout(300)
+
+    f = _freqs(page)
+    assert f == [440, 880, 440, 440, 440, 880], f"Unexpected full AMRAP audio sequence: {f}"
+    # Verify the bip,bip,BIP countdown is the final 3 sounds
+    assert f[-3:] == [440, 440, 880], f"Last 3 sounds should be bip,bip,BIP: {f}"
diff --git a/tests/test_step16_migration.py b/tests/test_step16_migration.py
new file mode 100644
index 0000000..4c3d7e1
--- /dev/null
+++ b/tests/test_step16_migration.py
@@ -0,0 +1,199 @@
+"""
+Step 16 — Single Deployment + Startup DB Migration Tests
+
+Green paths:
+- test_fresh_install_initializes: Fresh DB gets the schema, schema_version stamped, defaults present
+- test_data_persists_across_reload: Data survives a reload (stable OPFS location)
+- test_opfs_directory_unversioned: OPFS pool directory carries no version suffix
+- test_full_migration_flow: Pending migration -> forced backup download -> Update -> app loads
+  with data intact (uses the v1 no-op migration by rewinding schema_version to 0)
+
+Red paths:
+- test_db_newer_than_app: dbVersion > SCHEMA_VERSION shows the blocking DB_NEWER_THAN_APP
+  error overlay without touching the data
+- test_migration_screen_no_bypass: Update stays disabled before a backup download, and a
+  reload lands back on the migration screen with data untouched
+
+Deferred:
+- Migration-failure rollback test: cannot be exercised realistically until a real v2
+  migration script exists (faking it would require test-only scripts in production code).
+"""
+import re
+
+from playwright.sync_api import Page, expect
+
+
+def _wait_for_db(page: Page, app_url: str):
+    """Navigate and wait for the database to be ready."""
+    page.goto(app_url)
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-ready') === 'true'", timeout=15000
+    )
+
+
+def _set_db_version(page: Page, version: int):
+    """Rewrite the schema_version table so it contains only `version`."""
+    page.evaluate(f"""
+        (async () => {{
+            await window.__db.run("DELETE FROM schema_version");
+            await window.__db.run("INSERT INTO schema_version (version) VALUES ({version})");
+        }})()
+    """)
+
+
+def _create_exercise(page: Page, title: str) -> str:
+    return page.evaluate(f"""
+        window.__repos.exercises.create({{
+            title: '{title}',
+            description: '',
+            created_by: 'test'
+        }})
+    """)
+
+
+def _download_via_button(page: Page, trigger_selector: str):
+    """Click a button that opens the save-filename dialog, accept the default name, return the Download."""
+    page.locator(trigger_selector).click()
+    page.wait_for_selector('[data-testid="save-file-confirm"]')
+    with page.expect_download() as download_info:
+        page.locator('[data-testid="save-file-confirm"]').click()
+    return download_info.value
+
+
+def test_fresh_install_initializes(page: Page, app_url: str):
+    """A fresh install creates the schema, stamps SCHEMA_VERSION, and seeds defaults."""
+    _wait_for_db(page, app_url)
+
+    versions = page.evaluate(
+        'window.__db.selectAll("SELECT version FROM schema_version ORDER BY version")'
+    )
+    assert len(versions) == 1, f"Expected a single schema_version row, got {versions}"
+    assert versions[0]["version"] == 1
+
+    uuid = page.evaluate("async () => await window.__repos.settings.get('user_uuid')")
+    assert uuid is not None, "Default settings missing after fresh install"
+
+
+def test_data_persists_across_reload(page: Page, app_url: str):
+    """Data persists across reload now that the OPFS location is version-independent."""
+    _wait_for_db(page, app_url)
+    ex_id = _create_exercise(page, "Step16 Persistent Exercise")
+
+    page.reload()
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-ready') === 'true'", timeout=15000
+    )
+
+    exercise = page.evaluate(f"window.__repos.exercises.getById('{ex_id}')")
+    assert exercise is not None, "Exercise lost after reload"
+    assert exercise["title"] == "Step16 Persistent Exercise"
+
+
+def test_opfs_directory_unversioned(page: Page, app_url: str):
+    """The OPFS pool directory is named .trainus with no app-version suffix."""
+    _wait_for_db(page, app_url)
+
+    dir_names = page.evaluate("""
+        (async () => {
+            const root = await navigator.storage.getDirectory();
+            const names = [];
+            for await (const name of root.keys()) names.push(name);
+            return names;
+        })()
+    """)
+    assert ".trainus" in dir_names, f"Expected '.trainus' OPFS directory, found: {dir_names}"
+    versioned = [n for n in dir_names if re.match(r"^\.trainus-", n)]
+    assert versioned == [], f"Found versioned OPFS directories: {versioned}"
+
+
+def test_full_migration_flow(page: Page, app_url: str):
+    """Pending migration forces a backup download before Update, then migrates and keeps data."""
+    _wait_for_db(page, app_url)
+    ex_id = _create_exercise(page, "Step16 Migration Exercise")
+    _set_db_version(page, 0)
+
+    page.reload()
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-migration') === 'pending'", timeout=15000
+    )
+    expect(page.locator('[data-testid="db-migration"]')).to_be_visible()
+
+    # Update is locked until a backup has been downloaded
+    expect(page.locator('[data-testid="migration-update"]')).to_be_disabled()
+
+    download = _download_via_button(page, '[data-testid="migration-backup"]')
+    filename = download.suggested_filename
+    assert re.match(
+        r"^trainus-\d+\.\d+\.\d+-backup-\d{8}-\d{2}h\d{2}m\d{2}s\.sqlite3$", filename
+    ), f"Unexpected backup filename: {filename}"
+
+    expect(page.locator('[data-testid="migration-update"]')).to_be_enabled()
+    page.locator('[data-testid="migration-update"]').click()
+
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-ready') === 'true'", timeout=15000
+    )
+
+    max_version = page.evaluate(
+        'window.__db.selectOne("SELECT MAX(version) AS v FROM schema_version")'
+    )
+    assert max_version["v"] == 1, f"schema_version not migrated: {max_version}"
+
+    exercise = page.evaluate(f"window.__repos.exercises.getById('{ex_id}')")
+    assert exercise is not None, "Data lost during migration"
+
+    last_backup = page.evaluate("async () => await window.__repos.settings.get('last_backup_at')")
+    assert last_backup is not None, "last_backup_at was not set by the forced backup"
+
+
+def test_db_newer_than_app(page: Page, app_url: str):
+    """A DB created by a newer app version blocks with DB_NEWER_THAN_APP and stays untouched."""
+    _wait_for_db(page, app_url)
+    ex_id = _create_exercise(page, "Step16 Newer DB Exercise")
+    page.evaluate('window.__db.run("INSERT INTO schema_version (version) VALUES (2)")')
+
+    page.reload()
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-error') !== null", timeout=15000
+    )
+    error = page.evaluate("document.documentElement.getAttribute('data-db-error')")
+    assert error == "DB_NEWER_THAN_APP", f"Unexpected error code: {error}"
+    expect(page.locator('[data-testid="db-error"]')).to_be_visible()
+
+    # Data untouched: removing the fake newer version makes the app load again
+    page.evaluate('window.__db.run("DELETE FROM schema_version WHERE version = 2")')
+    page.reload()
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-ready') === 'true'", timeout=15000
+    )
+    exercise = page.evaluate(f"window.__repos.exercises.getById('{ex_id}')")
+    assert exercise is not None, "Data lost while DB was flagged as newer than the app"
+
+
+def test_migration_screen_no_bypass(page: Page, app_url: str):
+    """The migration screen cannot be bypassed: Update stays disabled and survives reloads."""
+    _wait_for_db(page, app_url)
+    ex_id = _create_exercise(page, "Step16 NoBypass Exercise")
+    _set_db_version(page, 0)
+
+    page.reload()
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-migration') === 'pending'", timeout=15000
+    )
+    expect(page.locator('[data-testid="migration-update"]')).to_be_disabled()
+
+    # Reloading without downloading a backup lands back on the migration screen
+    page.reload()
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-migration') === 'pending'", timeout=15000
+    )
+    expect(page.locator('[data-testid="db-migration"]')).to_be_visible()
+    expect(page.locator('[data-testid="migration-update"]')).to_be_disabled()
+
+    # No data was touched while paused
+    version = page.evaluate(
+        'window.__db.selectOne("SELECT MAX(version) AS v FROM schema_version")'
+    )
+    assert version["v"] == 0, f"schema_version changed without user action: {version}"
+    exercise = page.evaluate(f"window.__repos.exercises.getById('{ex_id}')")
+    assert exercise is not None, "Data touched while migration was pending"
diff --git a/tests/test_step17_transactions.py b/tests/test_step17_transactions.py
new file mode 100644
index 0000000..41b68ab
--- /dev/null
+++ b/tests/test_step17_transactions.py
@@ -0,0 +1,323 @@
+"""
+Step 17 — Transaction Atomicity Tests (R1 + R2)
+
+R1 — Batch transactions for multi-statement repository writes:
+- test_set_items_roundtrips_correctly: setItems persists items and they can be retrieved
+- test_batch_constraint_violation_rolls_back: A mid-batch constraint error leaves DB unchanged
+- test_set_exercises_roundtrips_correctly: comboRepository.setExercises is atomic
+- test_set_sessions_roundtrips_correctly: collectionRepository.setSessions is atomic
+
+R2 — Atomic full-DB restore:
+- test_valid_restore_preserves_data: A valid backup restores all entities
+- test_corrupt_restore_preserves_original_data: A partially corrupt import leaves original data intact
+"""
+import sqlite3
+import tempfile
+import os
+
+import pytest
+from playwright.sync_api import Page, expect
+
+
+def _wait_for_db(page: Page, app_url: str):
+    page.goto(app_url)
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-ready') === 'true'",
+        timeout=15000,
+    )
+
+
+def _clean_all(page: Page):
+    page.evaluate("""async () => {
+        const exercises = await window.__repos.exercises.getAll()
+        for (const e of exercises) await window.__repos.exercises.delete(e.id)
+        const combos = await window.__repos.combos.getAll()
+        for (const c of combos) await window.__repos.combos.delete(c.id)
+        const sessions = await window.__repos.sessions.getAll()
+        for (const s of sessions) await window.__repos.sessions.delete(s.id)
+        const collections = await window.__repos.collections.getAll()
+        for (const c of collections) await window.__repos.collections.delete(c.id)
+    }""")
+
+
+def _create_exercise(page: Page, title: str) -> str:
+    return page.evaluate(
+        """async ([title]) => {
+            const userId = await window.__repos.settings.get('user_uuid')
+            return window.__repos.exercises.create({
+                title, description: '', asymmetric: false, alternate: false,
+                image_urls: '[]', video_urls: '[]', default_reps: 10, default_weight: 0,
+                created_by: userId
+            })
+        }""",
+        [title],
+    )
+
+
+def _create_session(page: Page, title: str) -> str:
+    return page.evaluate(
+        """async ([title]) => {
+            const userId = await window.__repos.settings.get('user_uuid')
+            return window.__repos.sessions.create({title, description: '', created_by: userId})
+        }""",
+        [title],
+    )
+
+
+def _create_combo(page: Page, title: str) -> str:
+    return page.evaluate(
+        """async ([title]) => {
+            const userId = await window.__repos.settings.get('user_uuid')
+            return window.__repos.combos.create({
+                title, description: '', type: 'NONE', timer_config: {}, created_by: userId
+            })
+        }""",
+        [title],
+    )
+
+
+def _create_collection(page: Page, label: str) -> str:
+    return page.evaluate(
+        """async ([label]) => {
+            const userId = await window.__repos.settings.get('user_uuid')
+            return window.__repos.collections.create({label, created_by: userId})
+        }""",
+        [label],
+    )
+
+
+# ── R1 tests ──────────────────────────────────────────────────────────────────
+
+
+def test_set_items_roundtrips_correctly(page: Page, app_url: str):
+    """setItems atomically replaces session items; the full set is retrievable."""
+    _wait_for_db(page, app_url)
+    _clean_all(page)
+
+    ex1 = _create_exercise(page, "Squat")
+    ex2 = _create_exercise(page, "Lunge")
+    sess_id = _create_session(page, "Leg Day")
+
+    items = [
+        {"item_id": ex1, "item_type": "exercise", "position": 0, "repetitions": 10, "weight": 0},
+        {"item_id": ex2, "item_type": "exercise", "position": 1, "repetitions": 12, "weight": 0},
+    ]
+    page.evaluate(
+        """async ([sessId, items]) => window.__repos.sessions.setItems(sessId, items)""",
+        [sess_id, items],
+    )
+
+    result = page.evaluate(
+        """async ([sessId]) => {
+            const s = await window.__repos.sessions.getById(sessId)
+            return s ? s.items : []
+        }""",
+        [sess_id],
+    )
+
+    assert len(result) == 2, f"Expected 2 items, got {len(result)}"
+    assert result[0]["item_id"] == ex1
+    assert result[1]["item_id"] == ex2
+
+
+def test_batch_constraint_violation_rolls_back(page: Page, app_url: str):
+    """A batch where any statement fails leaves the DB unchanged (full rollback)."""
+    _wait_for_db(page, app_url)
+    _clean_all(page)
+
+    ex_id = _create_exercise(page, "Bench Press")
+
+    # Build a batch: first a valid INSERT into exercise, then one that violates UNIQUE
+    result = page.evaluate(
+        """async ([exId]) => {
+            try {
+                await window.__db.batch([
+                    {
+                        sql: "INSERT INTO exercise (id, title, description, asymmetric, alternate, image_urls, video_urls, default_reps, default_weight, created_by) VALUES (?, ?, '', 0, 0, '[]', '[]', 5, 0, 'test')",
+                        params: ['new-ex-1', 'New Exercise 1']
+                    },
+                    {
+                        // UNIQUE violation: same title as existing exercise
+                        sql: "INSERT INTO exercise (id, title, description, asymmetric, alternate, image_urls, video_urls, default_reps, default_weight, created_by) VALUES (?, ?, '', 0, 0, '[]', '[]', 5, 0, 'test')",
+                        params: ['new-ex-2', 'Bench Press']
+                    }
+                ])
+                return { threw: false }
+            } catch (e) {
+                return { threw: true, message: e.message }
+            }
+        }""",
+        [ex_id],
+    )
+
+    assert result["threw"], f"Batch should have thrown, but got: {result}"
+
+    # Verify neither the valid nor invalid row was committed
+    count = page.evaluate(
+        """async () => {
+            const rows = await window.__db.selectAll('SELECT id FROM exercise')
+            return rows.length
+        }"""
+    )
+    assert count == 1, f"Only the original exercise should exist, got {count}"
+
+
+def test_set_exercises_roundtrips_correctly(page: Page, app_url: str):
+    """comboRepository.setExercises atomically replaces exercises on a combo."""
+    _wait_for_db(page, app_url)
+    _clean_all(page)
+
+    ex1 = _create_exercise(page, "Pull-up")
+    ex2 = _create_exercise(page, "Dip")
+    combo_id = _create_combo(page, "Upper Pull")
+
+    exercises = [
+        {"exerciseId": ex1, "defaultReps": 8, "defaultWeight": 0},
+        {"exerciseId": ex2, "defaultReps": 10, "defaultWeight": 0},
+    ]
+    page.evaluate(
+        """async ([comboId, exercises]) => window.__repos.combos.setExercises(comboId, exercises)""",
+        [combo_id, exercises],
+    )
+
+    result = page.evaluate(
+        """async ([comboId]) => {
+            const c = await window.__repos.combos.getById(comboId)
+            return c ? c.exercises : []
+        }""",
+        [combo_id],
+    )
+
+    assert len(result) == 2, f"Expected 2 exercises in combo, got {len(result)}"
+
+
+def test_set_sessions_roundtrips_correctly(page: Page, app_url: str):
+    """collectionRepository.setSessions atomically replaces sessions on a collection."""
+    _wait_for_db(page, app_url)
+    _clean_all(page)
+
+    s1 = _create_session(page, "Session Alpha")
+    s2 = _create_session(page, "Session Beta")
+    coll_id = _create_collection(page, "My Week")
+
+    page.evaluate(
+        """async ([collId, s1, s2]) => window.__repos.collections.setSessions(collId, [s1, s2])""",
+        [coll_id, s1, s2],
+    )
+
+    result = page.evaluate(
+        """async ([collId]) => {
+            const c = await window.__repos.collections.getById(collId)
+            return c ? c.sessions : []
+        }""",
+        [coll_id],
+    )
+
+    assert len(result) == 2, f"Expected 2 sessions in collection, got {len(result)}"
+
+
+# ── R2 tests ──────────────────────────────────────────────────────────────────
+
+
+def _build_corrupt_db_bytes(tmp_path: str) -> bytes:
+    """Create a SQLite DB that passes validation but has an exercise row with NULL created_by.
+
+    The live DB has `created_by TEXT NOT NULL`, so inserting this row during restore
+    will trigger a NOT NULL constraint failure mid-transaction.
+    """
+    db_path = os.path.join(tmp_path, "corrupt_import.db")
+    conn = sqlite3.connect(db_path)
+    # Required tables (REQUIRED_TABLES = ['schema_version', 'settings'])
+    conn.execute(
+        "CREATE TABLE schema_version (version INTEGER PRIMARY KEY, applied_at TEXT)"
+    )
+    conn.execute("INSERT INTO schema_version VALUES (1, datetime('now'))")
+    conn.execute("CREATE TABLE settings (key TEXT PRIMARY KEY, value TEXT)")
+    # exercise table without NOT NULL on created_by (SQLite won't enforce it here)
+    conn.execute("""CREATE TABLE exercise (
+        id TEXT PRIMARY KEY,
+        title TEXT NOT NULL UNIQUE,
+        description TEXT DEFAULT '',
+        asymmetric INTEGER DEFAULT 0,
+        alternate INTEGER DEFAULT 0,
+        image_urls TEXT DEFAULT '[]',
+        video_urls TEXT DEFAULT '[]',
+        default_reps INTEGER DEFAULT 0,
+        default_weight REAL DEFAULT 0.0,
+        created_by TEXT
+    )""")
+    # Insert a row where created_by = NULL — will fail NOT NULL in the live schema
+    conn.execute(
+        "INSERT INTO exercise VALUES ('corrupt-id', 'Corrupt Exercise', '', 0, 0, '[]', '[]', 5, 0.0, NULL)"
+    )
+    conn.commit()
+    conn.close()
+    with open(db_path, "rb") as f:
+        return f.read()
+
+
+def test_valid_restore_preserves_data(page: Page, app_url: str, tmp_path):
+    """A valid DB backup can be exported and re-imported without data loss."""
+    _wait_for_db(page, app_url)
+    _clean_all(page)
+
+    ex_id = _create_exercise(page, "Deadlift")
+
+    # Export the DB as bytes via the worker
+    db_bytes_list = page.evaluate(
+        """async () => {
+            const bytes = await window.__db.exportDatabase()
+            return Array.from(bytes)
+        }"""
+    )
+
+    # Import the exported bytes back — should succeed
+    result = page.evaluate(
+        """async (bytes) => window.__db.importDatabase(new Uint8Array(bytes))""",
+        db_bytes_list,
+    )
+
+    assert result.get("success") is True, f"Valid restore should succeed, got: {result}"
+
+    # After restore the exercise should still exist
+    exercises = page.evaluate(
+        """async () => window.__repos.exercises.getAll()"""
+    )
+    ids = [e["id"] for e in exercises]
+    assert ex_id in ids, f"Exercise {ex_id} should survive a valid restore"
+
+
+def test_corrupt_restore_preserves_original_data(page: Page, app_url: str, tmp_path):
+    """A restore that fails mid-way (constraint violation) leaves the original data intact."""
+    _wait_for_db(page, app_url)
+    _clean_all(page)
+
+    # Create a known exercise in the live DB
+    ex_id = _create_exercise(page, "Original Exercise")
+
+    # Build a corrupt DB file and pass bytes into the browser
+    corrupt_bytes = _build_corrupt_db_bytes(str(tmp_path))
+    corrupt_list = list(corrupt_bytes)
+
+    result = page.evaluate(
+        """async (bytes) => {
+            try {
+                return await window.__db.importDatabase(new Uint8Array(bytes))
+            } catch (e) {
+                return { success: false, error: 'THREW', message: e.message }
+            }
+        }""",
+        corrupt_list,
+    )
+
+    # The import should have failed
+    assert result.get("success") is False, f"Corrupt import should fail, got: {result}"
+
+    # Original exercise must still be present (transaction was rolled back)
+    exercises = page.evaluate("""async () => window.__repos.exercises.getAll()""")
+    ids = [e["id"] for e in exercises]
+    assert ex_id in ids, (
+        f"Original exercise should survive a failed restore. "
+        f"Got exercises: {exercises}, result: {result}"
+    )
+    assert len(exercises) == 1, f"Only original exercise should remain, got: {exercises}"
diff --git a/tests/test_step18_execution_abandon.py b/tests/test_step18_execution_abandon.py
new file mode 100644
index 0000000..be64c16
--- /dev/null
+++ b/tests/test_step18_execution_abandon.py
@@ -0,0 +1,227 @@
+"""
+Step 18 — Execution Abandon Tests (R4)
+
+R4 — Execution log status column + route-leave guard:
+- test_completed_session_has_completed_status: Finishing a session sets status='completed'
+- test_exit_button_sets_aborted_status: Using the exit button sets status='aborted'
+- test_leave_guard_shows_confirm_dialog: Navigating away mid-session triggers a confirm dialog
+- test_leave_guard_cancel_stays_on_page: Cancelling the confirm keeps the user on the execute view
+- test_leave_guard_confirm_sets_aborted: Confirming the leave dialog marks the log as aborted
+- test_no_null_finished_at_after_abandon: After any navigation away, no log has finished_at=NULL
+- test_stats_only_count_completed_sessions: Stats total-sessions count excludes aborted logs
+"""
+import json
+import pytest
+from playwright.sync_api import Page, expect
+
+
+def _wait_for_db(page: Page, app_url: str):
+    page.goto(app_url)
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-ready') === 'true'",
+        timeout=15000,
+    )
+
+
+def _clean_all(page: Page):
+    page.evaluate("""async () => {
+        const logs = await window.__repos.executionLogs.getAll()
+        for (const l of logs) await window.__repos.executionLogs.delete(l.id)
+        const sessions = await window.__repos.sessions.getAll()
+        for (const s of sessions) await window.__repos.sessions.delete(s.id)
+        const exercises = await window.__repos.exercises.getAll()
+        for (const e of exercises) await window.__repos.exercises.delete(e.id)
+    }""")
+
+
+def _create_exercise(page: Page, title: str) -> str:
+    return page.evaluate(
+        """async ([title]) => {
+            const userId = await window.__repos.settings.get('user_uuid')
+            return window.__repos.exercises.create({
+                title, description: '', asymmetric: false, alternate: false,
+                image_urls: '[]', video_urls: '[]', default_reps: 5, default_weight: 0,
+                created_by: userId
+            })
+        }""",
+        [title],
+    )
+
+
+def _create_session(page: Page, title: str, ex_id: str) -> str:
+    return page.evaluate(
+        """async ([title, exId]) => {
+            const userId = await window.__repos.settings.get('user_uuid')
+            const sessId = await window.__repos.sessions.create({title, description: '', created_by: userId})
+            await window.__repos.sessions.setItems(sessId, [{
+                item_id: exId, item_type: 'exercise', position: 0, repetitions: 5, weight: 0
+            }])
+            return sessId
+        }""",
+        [title, ex_id],
+    )
+
+
+def _navigate_to_execute(page: Page, app_url: str, sess_id: str):
+    """Navigate to the execute view for a given session."""
+    page.goto(f"{app_url}#/sessions/{sess_id}/execute")
+    page.wait_for_selector('[data-testid="execute-session-title"]', timeout=10000)
+    page.wait_for_timeout(300)
+
+
+@pytest.fixture
+def session_and_exercise(page: Page, app_url: str):
+    """Create a session with one exercise and return (sess_id, ex_id)."""
+    _wait_for_db(page, app_url)
+    _clean_all(page)
+    ex_id = _create_exercise(page, "Test Exercise")
+    sess_id = _create_session(page, "Test Session", ex_id)
+    return sess_id, ex_id
+
+
+def test_completed_session_has_completed_status(page: Page, app_url: str, session_and_exercise):
+    """Finishing all steps sets the execution log status to 'completed'."""
+    sess_id, _ = session_and_exercise
+    _navigate_to_execute(page, app_url, sess_id)
+
+    # Click Done to complete the single exercise step — for a one-exercise session this
+    # redirects directly to the session detail view (no final-round screen)
+    page.click('[data-testid="execute-done-btn"]')
+    page.wait_for_function(
+        f"window.location.hash.includes('/sessions/{sess_id}') && !window.location.hash.includes('/execute')",
+        timeout=5000,
+    )
+    page.wait_for_timeout(300)
+
+    logs = page.evaluate("""async () => window.__repos.executionLogs.getAll()""")
+    assert len(logs) == 1, f"Expected 1 log, got {len(logs)}"
+    assert logs[0]["status"] == "completed", f"Expected status=completed, got: {logs[0]}"
+    assert logs[0]["finished_at"] is not None, "finished_at should be set"
+
+
+def test_exit_button_sets_aborted_status(page: Page, app_url: str, session_and_exercise):
+    """Using the exit button during execution marks the log status as 'aborted'."""
+    sess_id, _ = session_and_exercise
+    _navigate_to_execute(page, app_url, sess_id)
+
+    # Click the exit button and confirm the dialog
+    page.once("dialog", lambda d: d.accept())
+    page.click('[data-testid="execute-exit-btn"]')
+    page.wait_for_timeout(500)
+
+    logs = page.evaluate("""async () => window.__repos.executionLogs.getAll()""")
+    assert len(logs) == 1, f"Expected 1 log, got {len(logs)}"
+    assert logs[0]["status"] == "aborted", f"Expected status=aborted, got: {logs[0]}"
+    assert logs[0]["finished_at"] is not None, "finished_at should be set on abort"
+
+
+def test_leave_guard_shows_confirm_dialog(page: Page, app_url: str, session_and_exercise):
+    """Navigating away via the nav bar while execution is in progress triggers a confirm dialog."""
+    sess_id, _ = session_and_exercise
+    _navigate_to_execute(page, app_url, sess_id)
+
+    # Intercept the dialog to detect it appeared, then dismiss (cancel)
+    dialog_appeared = []
+    page.once("dialog", lambda d: (dialog_appeared.append(d.message), d.dismiss()))
+    page.click('a[href="#/home"]')
+    page.wait_for_timeout(500)
+
+    assert len(dialog_appeared) > 0, "Leave guard should show a confirm dialog"
+    # Should still be on the execute view (dismiss = stay)
+    page.wait_for_selector('[data-testid="execute-session-title"]', timeout=3000)
+
+
+def test_leave_guard_cancel_stays_on_page(page: Page, app_url: str, session_and_exercise):
+    """Dismissing the leave confirm keeps the user on the execute view."""
+    sess_id, _ = session_and_exercise
+    _navigate_to_execute(page, app_url, sess_id)
+
+    page.once("dialog", lambda d: d.dismiss())
+    page.click('a[href="#/home"]')
+    page.wait_for_timeout(500)
+
+    title_el = page.locator('[data-testid="execute-session-title"]')
+    expect(title_el).to_be_visible()
+
+
+def test_leave_guard_confirm_sets_aborted(page: Page, app_url: str, session_and_exercise):
+    """Accepting the leave confirm marks the log as aborted and navigates away."""
+    sess_id, _ = session_and_exercise
+    _navigate_to_execute(page, app_url, sess_id)
+
+    # Accept the dialog → exit() is called → status='aborted'
+    page.once("dialog", lambda d: d.accept())
+    page.click('a[href="#/home"]')
+    page.wait_for_timeout(800)
+
+    # We should no longer be on the execute view
+    title_el = page.locator('[data-testid="execute-session-title"]')
+    expect(title_el).not_to_be_visible(timeout=3000)
+
+    logs = page.evaluate("""async () => window.__repos.executionLogs.getAll()""")
+    assert len(logs) == 1, f"Expected 1 log after abandon, got {len(logs)}"
+    assert logs[0]["status"] == "aborted", f"Expected aborted, got: {logs[0]['status']}"
+
+
+def test_no_null_finished_at_after_abandon(page: Page, app_url: str, session_and_exercise):
+    """After confirming the leave dialog, no execution_log row has finished_at=NULL."""
+    sess_id, _ = session_and_exercise
+    _navigate_to_execute(page, app_url, sess_id)
+
+    page.once("dialog", lambda d: d.accept())
+    page.click('a[href="#/home"]')
+    page.wait_for_timeout(800)
+
+    null_logs = page.evaluate(
+        """async () => {
+            const logs = await window.__repos.executionLogs.getAll()
+            return logs.filter(l => l.finished_at === null || l.finished_at === undefined)
+        }"""
+    )
+    assert len(null_logs) == 0, f"No log should have NULL finished_at; orphans: {null_logs}"
+
+
+def test_stats_only_count_completed_sessions(page: Page, app_url: str):
+    """Stats total-sessions card counts only completed logs, not aborted ones."""
+    _wait_for_db(page, app_url)
+    _clean_all(page)
+
+    ex_id = _create_exercise(page, "Stat Exercise")
+    sess_id = _create_session(page, "Stat Session", ex_id)
+
+    now = "2026-01-15T10:00:00.000Z"
+
+    # Seed one completed log and one aborted log
+    page.evaluate(
+        """async ([sessId, exId, now]) => {
+            const completedId = await window.__repos.executionLogs.create({
+                session_id: sessId,
+                started_at: now,
+                finished_at: now,
+            })
+            await window.__repos.executionLogs.update(completedId, { status: 'completed', finished_at: now })
+
+            const abortedId = await window.__repos.executionLogs.create({
+                session_id: sessId,
+                started_at: now,
+                finished_at: now,
+            })
+            await window.__repos.executionLogs.update(abortedId, { status: 'aborted', finished_at: now })
+        }""",
+        [sess_id, ex_id, now],
+    )
+
+    # Navigate to stats (all-time range)
+    page.evaluate("() => { window.location.hash = '#/stats' }")
+    page.wait_for_selector('[data-testid="stats-total-sessions"]', timeout=5000)
+    page.wait_for_timeout(500)
+
+    # Select all-time tab (last tab)
+    date_range = page.locator('[data-testid="stats-date-range"] button')
+    count = date_range.count()
+    date_range.nth(count - 1).click()
+    page.wait_for_timeout(300)
+
+    total_text = page.locator('[data-testid="stats-total-sessions"]').text_content()
+    # The count should be 1 (only completed), not 2
+    assert "1" in total_text, f"Stats should count 1 completed session, got text: '{total_text}'"
diff --git a/tests/test_step19_db_resilience.py b/tests/test_step19_db_resilience.py
new file mode 100644
index 0000000..962860b
--- /dev/null
+++ b/tests/test_step19_db_resilience.py
@@ -0,0 +1,87 @@
+"""
+Step 19 — DB Worker Resilience Tests (R5)
+
+R5 — DB worker crash detection + ui feedback:
+- test_worker_terminate_shows_error_overlay: Terminating the worker dispatches db-connection-lost
+  and the error overlay becomes visible
+- test_worker_crash_rejects_pending_calls: After termination, new DB calls reject immediately
+  rather than hanging indefinitely
+- test_reload_button_reloads_page: The reload button on the error overlay reloads the app
+"""
+import pytest
+from playwright.sync_api import Page, expect
+
+
+def _wait_for_db(page: Page, app_url: str):
+    page.goto(app_url)
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-ready') === 'true'",
+        timeout=15000,
+    )
+
+
+def _terminate_worker(page: Page):
+    """Simulate a worker crash: terminate it and dispatch the error event that the worker
+    onerror handler would normally produce, then wait for App.vue to react."""
+    page.evaluate(
+        """() => {
+            // Mark db as broken and dispatch the event that App.vue listens to
+            window.__db._broken = true
+            window.dispatchEvent(new CustomEvent('db-connection-lost'))
+        }"""
+    )
+    page.wait_for_timeout(200)
+
+
+def test_worker_terminate_shows_error_overlay(page: Page, app_url: str):
+    """Simulating a worker crash shows the db-connection-lost overlay."""
+    _wait_for_db(page, app_url)
+
+    _terminate_worker(page)
+
+    overlay = page.locator('[data-testid="db-connection-lost"]')
+    expect(overlay).to_be_visible(timeout=3000)
+
+
+def test_worker_crash_rejects_pending_calls(page: Page, app_url: str):
+    """After the worker is terminated, new DB calls reject immediately."""
+    _wait_for_db(page, app_url)
+    _terminate_worker(page)
+
+    # Try a DB call — should reject because _broken=true
+    result = page.evaluate(
+        """async () => {
+            try {
+                await window.__db.selectAll('SELECT 1')
+                return { threw: false }
+            } catch (e) {
+                return { threw: true, message: e.message }
+            }
+        }"""
+    )
+
+    assert result["threw"], f"Broken DB should reject calls immediately, got: {result}"
+    assert "lost" in result["message"].lower() or "broken" in result["message"].lower() or "crash" in result["message"].lower(), (
+        f"Error message should indicate DB is unavailable, got: {result['message']}"
+    )
+
+
+def test_reload_button_reloads_page(page: Page, app_url: str):
+    """The 'Reload' button on the error overlay reloads the app."""
+    _wait_for_db(page, app_url)
+    _terminate_worker(page)
+
+    overlay = page.locator('[data-testid="db-connection-lost"]')
+    expect(overlay).to_be_visible(timeout=3000)
+
+    # Click the reload button and wait for the page to reinitialise
+    with page.expect_navigation():
+        page.locator('[data-testid="db-connection-lost"] .btn-primary').click()
+
+    # After reload the DB should become ready again
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-ready') === 'true'",
+        timeout=15000,
+    )
+    # The error overlay should be gone
+    expect(page.locator('[data-testid="db-connection-lost"]')).not_to_be_visible()
diff --git a/tests/test_step1_database.py b/tests/test_step1_database.py
new file mode 100644
index 0000000..3006341
--- /dev/null
+++ b/tests/test_step1_database.py
@@ -0,0 +1,372 @@
+"""
+Step 1 — Database Layer Tests
+- test_db_initializes: Database initializes without errors
+- test_uuid_generated: A UUID is generated and stored in settings
+- test_app_version_stored: App version is stored in settings
+- test_default_settings: Default settings (user_name, language, theme) are created
+- test_exercise_crud: Full CRUD cycle on exercises
+- test_exercise_search: Search exercises by title
+- test_data_survives_reload: Data persists across page reload
+- test_settings_crud: Settings can be read and written
+- test_schema_tables_exist: All expected tables exist in the schema
+- test_foreign_keys_enabled: Foreign key constraints are enforced- test_combo_none_type: Combo can be created with type NONE
+- test_session_item_repetitions: Session items support repetitions field
+- test_collection_crud: Full CRUD cycle on collections (renamed from groups)
+- test_execution_log_recent_and_count: getRecent and getCountSince work correctly"""
+from playwright.sync_api import Page, expect
+
+
+def _wait_for_db(page: Page, app_url: str):
+    """Navigate and wait for the database to be ready."""
+    page.goto(app_url)
+    page.wait_for_function("document.documentElement.getAttribute('data-db-ready') === 'true'", timeout=15000)
+
+
+def test_db_initializes(page: Page, app_url: str):
+    """Database initializes and sets the data-db-ready attribute."""
+    page.goto(app_url)
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-ready') === 'true'"
+        " || document.documentElement.getAttribute('data-db-error') !== null",
+        timeout=15000,
+    )
+    error = page.evaluate("document.documentElement.getAttribute('data-db-error')")
+    assert error is None, f"DB initialization failed: {error}"
+
+
+def test_uuid_generated(page: Page, app_url: str):
+    """A UUID is generated on first launch and stored in settings."""
+    _wait_for_db(page, app_url)
+    uuid = page.evaluate("async () => await window.__repos.settings.get('user_uuid')")
+    assert uuid is not None, "No user_uuid found in settings"
+    # UUID v4 format: 8-4-4-4-12 hex chars
+    import re
+    assert re.match(
+        r'^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$',
+        uuid
+    ), f"user_uuid is not a valid UUID: {uuid}"
+
+
+def test_app_version_stored(page: Page, app_url: str):
+    """App version from package.json is stored in settings."""
+    _wait_for_db(page, app_url)
+    version = page.evaluate("async () => await window.__repos.settings.get('app_version')")
+    assert version is not None, "No app_version found in settings"
+    assert version == "1.0.0", f"Unexpected app_version: {version}"
+
+
+def test_default_settings(page: Page, app_url: str):
+    """Default settings are created on first launch."""
+    _wait_for_db(page, app_url)
+    settings = page.evaluate("async () => await window.__repos.settings.getAll()")
+    assert settings["user_name"] == "User", f"Unexpected user_name: {settings.get('user_name')}"
+    assert settings["language"] == "en", f"Unexpected language: {settings.get('language')}"
+    assert settings["theme"] == "light", f"Unexpected theme: {settings.get('theme')}"
+    assert settings["db_created_at"] is not None, "db_created_at should be set on first launch"
+
+
+def test_db_created_at_is_valid_iso_timestamp(page: Page, app_url: str):
+    """db_created_at is stored as a valid ISO-8601 timestamp on first launch."""
+    _wait_for_db(page, app_url)
+    created_at = page.evaluate("async () => await window.__repos.settings.get('db_created_at')")
+    assert created_at is not None, "db_created_at should be set"
+    parsed = page.evaluate(f"new Date('{created_at}').getTime()")
+    assert parsed > 0, f"db_created_at is not a valid date: {created_at}"
+
+
+def test_exercise_crud(page: Page, app_url: str):
+    """Full CRUD cycle: create, read, update, delete an exercise."""
+    _wait_for_db(page, app_url)
+
+    # Create
+    ex_id = page.evaluate("""
+        window.__repos.exercises.create({
+            title: 'Push-ups',
+            description: 'Basic push-up exercise',
+            asymmetric: false,
+            alternate: false,
+            default_reps: 10,
+            default_weight: 0,
+            created_by: 'test'
+        })
+    """)
+    assert ex_id is not None, "Exercise creation returned no ID"
+
+    # Read
+    exercise = page.evaluate(f"window.__repos.exercises.getById('{ex_id}')")
+    assert exercise is not None, "Exercise not found after creation"
+    assert exercise["title"] == "Push-ups"
+    assert exercise["description"] == "Basic push-up exercise"
+    assert exercise["asymmetric"] is False
+    assert exercise["alternate"] is False
+    assert exercise["default_reps"] == 10
+
+    # Update
+    page.evaluate(f"""
+        window.__repos.exercises.update('{ex_id}', {{
+            title: 'Diamond Push-ups',
+            description: 'Advanced push-up variation',
+            asymmetric: true,
+            alternate: true,
+            default_reps: 8,
+            default_weight: 0
+        }})
+    """)
+    updated = page.evaluate(f"window.__repos.exercises.getById('{ex_id}')")
+    assert updated["title"] == "Diamond Push-ups"
+    assert updated["default_reps"] == 8
+    assert updated["asymmetric"] is True
+    assert updated["alternate"] is True
+
+    # Delete
+    page.evaluate(f"window.__repos.exercises.delete('{ex_id}')")
+    deleted = page.evaluate(f"window.__repos.exercises.getById('{ex_id}')")
+    assert deleted is None, "Exercise still exists after deletion"
+
+
+def test_exercise_search(page: Page, app_url: str):
+    """Search exercises by title."""
+    _wait_for_db(page, app_url)
+
+    # Create a few exercises
+    page.evaluate("""
+        (async () => {
+            await window.__repos.exercises.create({ title: 'Squat', description: '', created_by: 'test' });
+            await window.__repos.exercises.create({ title: 'Bench Press', description: '', created_by: 'test' });
+            await window.__repos.exercises.create({ title: 'Squat Jump', description: '', created_by: 'test' });
+        })()
+    """)
+
+    results = page.evaluate("window.__repos.exercises.search('Squat')")
+    assert len(results) >= 2, f"Expected at least 2 results for 'Squat', got {len(results)}"
+    titles = [r["title"] for r in results]
+    assert "Squat" in titles
+    assert "Squat Jump" in titles
+
+    # Cleanup
+    page.evaluate("""
+        (async () => {
+            const all = await window.__repos.exercises.getAll();
+            for (const e of all) await window.__repos.exercises.delete(e.id);
+        })()
+    """)
+
+
+def test_data_survives_reload(page: Page, app_url: str):
+    """Data persists across page reload (OPFS persistence)."""
+    _wait_for_db(page, app_url)
+
+    # Create an exercise
+    ex_id = page.evaluate("""
+        window.__repos.exercises.create({
+            title: 'Persistent Exercise',
+            description: 'Should survive reload',
+            created_by: 'test'
+        })
+    """)
+
+    # Reload the page
+    page.reload()
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-ready') === 'true'",
+        timeout=15000,
+    )
+
+    # Verify exercise still exists
+    exercise = page.evaluate(f"window.__repos.exercises.getById('{ex_id}')")
+    assert exercise is not None, "Exercise lost after reload — persistence may not be working"
+    assert exercise["title"] == "Persistent Exercise"
+
+    # Cleanup
+    page.evaluate(f"window.__repos.exercises.delete('{ex_id}')")
+
+
+def test_settings_crud(page: Page, app_url: str):
+    """Settings can be read and updated."""
+    _wait_for_db(page, app_url)
+
+    # Read existing
+    original = page.evaluate("async () => await window.__repos.settings.get('user_name')")
+    assert original == "User"
+
+    # Update
+    page.evaluate("async () => { await window.__repos.settings.set('user_name', 'TestUser') }")
+    updated = page.evaluate("async () => await window.__repos.settings.get('user_name')")
+    assert updated == "TestUser", f"Expected 'TestUser', got '{updated}'"
+
+    # Restore
+    page.evaluate("async () => { await window.__repos.settings.set('user_name', 'User') }")
+
+
+def test_schema_tables_exist(page: Page, app_url: str):
+    """All expected tables exist in the database."""
+    _wait_for_db(page, app_url)
+
+    tables = page.evaluate("""
+        window.__db.selectAll(
+            "SELECT name FROM sqlite_master WHERE type='table' ORDER BY name"
+        )
+    """)
+    table_names = [t["name"] for t in tables]
+    expected = [
+        "collection", "collection_session", "combo", "combo_exercise",
+        "execution_log", "execution_log_item", "exercise",
+        "schema_version", "session", "session_item", "settings", "suffix"
+    ]
+    for name in expected:
+        assert name in table_names, f"Table '{name}' not found. Found: {table_names}"
+
+
+def test_foreign_keys_enabled(page: Page, app_url: str):
+    """Foreign key constraints are enforced."""
+    _wait_for_db(page, app_url)
+
+    # Try to insert a session_item referencing a non-existent session
+    error = page.evaluate("""
+        (async () => {
+            try {
+                await window.__db.run(
+                    "INSERT INTO session_item (session_id, item_id, item_type, position) VALUES (?, ?, ?, ?)",
+                    ['nonexistent', 'item1', 'exercise', 0]
+                );
+                return null;
+            } catch (e) {
+                return e.message;
+            }
+        })()
+    """)
+    assert error is not None, "Foreign key constraint was not enforced"
+
+
+def test_combo_none_type(page: Page, app_url: str):
+    """Combo can be created with type NONE."""
+    _wait_for_db(page, app_url)
+
+    combo_id = page.evaluate("""
+        window.__repos.combos.create({
+            title: 'Simple Combo',
+            description: 'A combo with no special type',
+            type: 'NONE',
+            created_by: 'test'
+        })
+    """)
+    assert combo_id is not None, "Combo creation returned no ID"
+
+    combo = page.evaluate(f"window.__repos.combos.getById('{combo_id}')")
+    assert combo is not None, "Combo not found after creation"
+    assert combo["type"] == "NONE"
+
+    # Cleanup
+    page.evaluate(f"window.__repos.combos.delete('{combo_id}')")
+
+
+def test_session_item_repetitions(page: Page, app_url: str):
+    """Session items support a repetitions (series) field."""
+    _wait_for_db(page, app_url)
+
+    # Create a session and an exercise
+    session_id = page.evaluate("""
+        window.__repos.sessions.create({
+            title: 'Repetitions Test Session',
+            description: '',
+            created_by: 'test'
+        })
+    """)
+    ex_id = page.evaluate("""
+        window.__repos.exercises.create({
+            title: 'Burpees',
+            description: '',
+            created_by: 'test'
+        })
+    """)
+
+    # Set items with repetitions
+    page.evaluate(f"""
+        window.__repos.sessions.setItems('{session_id}', [
+            {{ item_id: '{ex_id}', item_type: 'exercise', repetitions: 3 }}
+        ])
+    """)
+
+    session = page.evaluate(f"window.__repos.sessions.getById('{session_id}')")
+    assert session["items"][0]["repetitions"] == 3, f"Expected repetitions=3, got {session['items'][0].get('repetitions')}"
+
+    # Default repetitions should be 1
+    page.evaluate(f"""
+        window.__repos.sessions.setItems('{session_id}', [
+            {{ item_id: '{ex_id}', item_type: 'exercise' }}
+        ])
+    """)
+    session = page.evaluate(f"window.__repos.sessions.getById('{session_id}')")
+    assert session["items"][0]["repetitions"] == 1, "Default repetitions should be 1"
+
+    # Cleanup
+    page.evaluate(f"window.__repos.sessions.delete('{session_id}')")
+    page.evaluate(f"window.__repos.exercises.delete('{ex_id}')")
+
+
+def test_collection_crud(page: Page, app_url: str):
+    """Full CRUD cycle on collections (renamed from groups)."""
+    _wait_for_db(page, app_url)
+
+    # Create
+    coll_id = page.evaluate("""
+        window.__repos.collections.create({
+            label: 'Morning Routine',
+            created_by: 'test'
+        })
+    """)
+    assert coll_id is not None, "Collection creation returned no ID"
+
+    # Read
+    coll = page.evaluate(f"window.__repos.collections.getById('{coll_id}')")
+    assert coll is not None, "Collection not found after creation"
+    assert coll["label"] == "Morning Routine"
+
+    # Update
+    page.evaluate(f"""
+        window.__repos.collections.update('{coll_id}', {{ label: 'Evening Routine' }})
+    """)
+    updated = page.evaluate(f"window.__repos.collections.getById('{coll_id}')")
+    assert updated["label"] == "Evening Routine"
+
+    # Delete
+    page.evaluate(f"window.__repos.collections.delete('{coll_id}')")
+    deleted = page.evaluate(f"window.__repos.collections.getById('{coll_id}')")
+    assert deleted is None, "Collection still exists after deletion"
+
+
+def test_execution_log_recent_and_count(page: Page, app_url: str):
+    """getRecent returns last N logs with session title; getCountSince counts logs after a date."""
+    _wait_for_db(page, app_url)
+
+    # Create a session
+    session_id = page.evaluate("""
+        window.__repos.sessions.create({
+            title: 'Stats Test Session',
+            description: '',
+            created_by: 'test'
+        })
+    """)
+
+    # Create execution logs with different dates
+    page.evaluate(f"""
+        (async () => {{
+            await window.__repos.executionLogs.create({{ session_id: '{session_id}', started_at: '2026-03-10T10:00:00Z', finished_at: '2026-03-10T11:00:00Z' }});
+            await window.__repos.executionLogs.create({{ session_id: '{session_id}', started_at: '2026-03-12T10:00:00Z', finished_at: '2026-03-12T11:00:00Z' }});
+            await window.__repos.executionLogs.create({{ session_id: '{session_id}', started_at: '2026-03-14T10:00:00Z', finished_at: '2026-03-14T11:00:00Z' }});
+        }})()
+    """)
+
+    # getRecent
+    recent = page.evaluate("window.__repos.executionLogs.getRecent(2)")
+    assert len(recent) == 2, f"Expected 2 recent logs, got {len(recent)}"
+    assert recent[0]["session_title"] == "Stats Test Session"
+    # Most recent first
+    assert recent[0]["started_at"] > recent[1]["started_at"]
+
+    # getCountSince
+    count = page.evaluate("window.__repos.executionLogs.getCountSince('2026-03-11T00:00:00Z')")
+    assert count == 2, f"Expected 2 logs since March 11, got {count}"
+
+    # Cleanup
+    page.evaluate(f"window.__repos.sessions.delete('{session_id}')")
diff --git a/tests/test_step20_search_escaping.py b/tests/test_step20_search_escaping.py
new file mode 100644
index 0000000..42d8dd4
--- /dev/null
+++ b/tests/test_step20_search_escaping.py
@@ -0,0 +1,393 @@
+"""
+Step 20 — LIKE Wildcard Escaping Tests (R10) + 404 Catch-all (R12) + Delete History (R15)
+       + Cross-user Settings (R14)
+
+R10 — LIKE wildcard escaping:
+- test_underscore_matches_only_underscore: `Push_up` is found by `Push_`, not by `PushXup`
+- test_percent_does_not_match_all: `100%` search does NOT match `100kg squat`
+- test_normal_search_still_works: Regular substring search still finds results
+- test_percent_sign_in_title_is_found: Exercise with `%` in title is found by searching `%`
+
+R12 — 404 catch-all route:
+- test_unknown_hash_redirects_to_home: Navigating to a typo'd hash URL lands on the Home view
+
+R14 — Cross-user import does not apply settings:
+- test_different_user_import_skips_settings: Importing a different-user envelope leaves local settings unchanged
+- test_same_user_import_applies_settings: Importing a same-user envelope applies settings
+
+R15 — Delete with history count:
+- test_delete_exercise_with_history_shows_count: Confirm dialog mentions journal entry count
+- test_delete_session_with_history_shows_count: Confirm dialog mentions execution log count
+"""
+import json
+import pytest
+from playwright.sync_api import Page, expect
+
+
+def _wait_for_db(page: Page, app_url: str):
+    page.goto(app_url)
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-ready') === 'true'",
+        timeout=15000,
+    )
+
+
+def _clean_all(page: Page):
+    page.evaluate("""async () => {
+        const logs = await window.__repos.executionLogs.getAll()
+        for (const l of logs) await window.__repos.executionLogs.delete(l.id)
+        const sessions = await window.__repos.sessions.getAll()
+        for (const s of sessions) await window.__repos.sessions.delete(s.id)
+        const exercises = await window.__repos.exercises.getAll()
+        for (const e of exercises) await window.__repos.exercises.delete(e.id)
+        const combos = await window.__repos.combos.getAll()
+        for (const c of combos) await window.__repos.combos.delete(c.id)
+    }""")
+
+
+def _create_exercise(page: Page, title: str) -> str:
+    return page.evaluate(
+        """async ([title]) => {
+            const userId = await window.__repos.settings.get('user_uuid')
+            return window.__repos.exercises.create({
+                title, description: '', asymmetric: false, alternate: false,
+                image_urls: '[]', video_urls: '[]', default_reps: 5, default_weight: 0,
+                created_by: userId
+            })
+        }""",
+        [title],
+    )
+
+
+def _create_session(page: Page, title: str) -> str:
+    return page.evaluate(
+        """async ([title]) => {
+            const userId = await window.__repos.settings.get('user_uuid')
+            return window.__repos.sessions.create({title, description: '', created_by: userId})
+        }""",
+        [title],
+    )
+
+
+# ── R10 tests ─────────────────────────────────────────────────────────────────
+
+
+def test_underscore_matches_only_underscore(page: Page, app_url: str):
+    """An exercise titled 'Push_up' IS found by searching 'Push_' (literal underscore)."""
+    _wait_for_db(page, app_url)
+    _clean_all(page)
+
+    _create_exercise(page, "Push_up")
+    _create_exercise(page, "Pushup")
+
+    results_underscore = page.evaluate(
+        """async () => window.__repos.exercises.search('Push_')"""
+    )
+    results_any = page.evaluate(
+        """async () => window.__repos.exercises.search('PushXup')"""
+    )
+
+    titles_underscore = [e["title"] for e in results_underscore]
+    assert "Push_up" in titles_underscore, f"'Push_' should find 'Push_up', got: {titles_underscore}"
+    assert "Pushup" not in titles_underscore, f"'Push_' should NOT match 'Pushup', got: {titles_underscore}"
+
+    assert len(results_any) == 0, f"'PushXup' should match nothing (was: {results_any})"
+
+
+def test_percent_does_not_match_all(page: Page, app_url: str):
+    """Searching '100%' does NOT match '100kg squat' (% is literal, not wildcard)."""
+    _wait_for_db(page, app_url)
+    _clean_all(page)
+
+    _create_exercise(page, "100kg squat")
+
+    results = page.evaluate(
+        """async () => window.__repos.exercises.search('100%')"""
+    )
+
+    titles = [e["title"] for e in results]
+    assert "100kg squat" not in titles, (
+        f"'100%' search should NOT match '100kg squat', got: {titles}"
+    )
+
+
+def test_normal_search_still_works(page: Page, app_url: str):
+    """Regular substring search still returns matching results after escaping fix."""
+    _wait_for_db(page, app_url)
+    _clean_all(page)
+
+    _create_exercise(page, "Deadlift")
+    _create_exercise(page, "Romanian Deadlift")
+    _create_exercise(page, "Squat")
+
+    results = page.evaluate(
+        """async () => window.__repos.exercises.search('Deadlift')"""
+    )
+
+    titles = [e["title"] for e in results]
+    assert "Deadlift" in titles, f"'Deadlift' search should find 'Deadlift'"
+    assert "Romanian Deadlift" in titles, f"'Deadlift' search should find 'Romanian Deadlift'"
+    assert "Squat" not in titles, f"'Deadlift' search should not find 'Squat'"
+
+
+def test_percent_sign_in_title_is_found(page: Page, app_url: str):
+    """An exercise with '%' in the title is found by searching for '%'."""
+    _wait_for_db(page, app_url)
+    _clean_all(page)
+
+    _create_exercise(page, "100% Effort")
+    _create_exercise(page, "Normal Exercise")
+
+    results = page.evaluate(
+        """async () => window.__repos.exercises.search('100%')"""
+    )
+
+    titles = [e["title"] for e in results]
+    assert "100% Effort" in titles, f"'100%' should find '100% Effort', got: {titles}"
+    assert "Normal Exercise" not in titles, f"Normal exercise should not appear in '%' search"
+
+
+# ── R12 tests ─────────────────────────────────────────────────────────────────
+
+
+def test_unknown_hash_redirects_to_home(page: Page, app_url: str):
+    """Navigating to an unknown hash path redirects to the Home view."""
+    _wait_for_db(page, app_url)
+
+    page.evaluate("() => { window.location.hash = '#/this-does-not-exist/at-all' }")
+    page.wait_for_timeout(500)
+
+    # Should be redirected to home
+    home_card = page.locator('[data-testid="home-stats"], [data-testid="home-recent"], h1, .home-view')
+    # Check the URL hash is now /home
+    page.wait_for_function(
+        "window.location.hash === '#/home' || window.location.hash === '#/'",
+        timeout=3000,
+    )
+
+
+# ── R14 tests ─────────────────────────────────────────────────────────────────
+
+
+def _trigger_import_with_json(page: Page, json_str: str, test_id: str = "settings-import"):
+    """Trigger the import dialog via the settings page import button."""
+    with page.expect_file_chooser() as fc_info:
+        page.locator(f'[data-testid="{test_id}"]').click()
+    file_chooser = fc_info.value
+    file_chooser.set_files(
+        [
+            {
+                "name": "test-import.json",
+                "mimeType": "application/json",
+                "buffer": json_str.encode("utf-8"),
+            }
+        ]
+    )
+
+
+def test_different_user_import_skips_settings(page: Page, app_url: str):
+    """A different-user import does not overwrite local user_name, language, or theme."""
+    _wait_for_db(page, app_url)
+    _clean_all(page)
+    page.evaluate("() => { window.location.hash = '#/exercises' }")
+    page.wait_for_timeout(300)
+
+    original_name = page.evaluate(
+        """async () => await window.__repos.settings.get('user_name')"""
+    )
+
+    # Build envelope with a different user UUID, including settings and one exercise
+    different_user_json = page.evaluate(
+        """async () => {
+            const differentUuid = 'different-user-00000000-0000-0000-0000-000000000000'
+            return JSON.stringify({
+                metadata: {
+                    appName: 'trainus', appVersion: '1.0.0', schemaVersion: 1,
+                    exportDate: new Date().toISOString(),
+                    exportedBy: { name: 'Other Person', uuid: differentUuid },
+                },
+                data: {
+                    settings: { user_name: 'Invader Name', language: 'da', theme: 'dark' },
+                    exercises: [{
+                        id: 'foreign-ex-id',
+                        title: 'Foreign Exercise',
+                        description: '',
+                        asymmetric: 0,
+                        alternate: 0,
+                        image_urls: '[]',
+                        video_urls: '[]',
+                        default_reps: 5,
+                        default_weight: 0,
+                        created_by: differentUuid,
+                    }]
+                },
+            })
+        }"""
+    )
+
+    _trigger_import_with_json(page, different_user_json, "exercise-import-btn")
+
+    # Suffix prompt appears for different user — wait for it, fill it, confirm
+    page.locator('[data-testid="import-suffix-input"]').wait_for(state="visible", timeout=5000)
+    page.locator('[data-testid="import-suffix-input"]').fill("OT")
+    page.locator('[data-testid="import-suffix-confirm"]').click()
+
+    # Wait for preview and apply
+    expect(page.locator('[data-testid="import-apply"]')).to_be_visible(timeout=10000)
+    page.locator('[data-testid="import-apply"]').click()
+    expect(page.locator('[data-testid="import-report-step"]')).to_be_visible(timeout=15000)
+    page.click('[data-testid="import-done"]')
+    page.wait_for_timeout(500)
+
+    actual_name = page.evaluate(
+        """async () => await window.__repos.settings.get('user_name')"""
+    )
+    actual_lang = page.evaluate(
+        """async () => await window.__repos.settings.get('language')"""
+    )
+
+    assert actual_name == original_name, (
+        f"user_name should not change on cross-user import: was {original_name!r}, got {actual_name!r}"
+    )
+    assert actual_lang != "da", (
+        f"language should not switch to 'da' on cross-user import, got: {actual_lang!r}"
+    )
+
+
+def test_same_user_import_applies_settings(page: Page, app_url: str):
+    """A same-user import does apply settings (language, theme)."""
+    _wait_for_db(page, app_url)
+    page.evaluate("() => { window.location.hash = '#/exercises' }")
+    page.wait_for_timeout(300)
+
+    original_lang = page.evaluate(
+        """async () => await window.__repos.settings.get('language')"""
+    )
+
+    same_user_json = page.evaluate(
+        """async () => {
+            const localUuid = await window.__repos.settings.get('user_uuid')
+            return JSON.stringify({
+                metadata: {
+                    appName: 'trainus', appVersion: '1.0.0', schemaVersion: 1,
+                    exportDate: new Date().toISOString(),
+                    exportedBy: { name: 'Me', uuid: localUuid },
+                },
+                data: {
+                    settings: { language: 'fr', theme: 'dark' },
+                    exercises: []
+                },
+            })
+        }"""
+    )
+
+    _trigger_import_with_json(page, same_user_json, "exercise-import-btn")
+    expect(page.locator('[data-testid="import-apply"]')).to_be_visible(timeout=10000)
+    page.locator('[data-testid="import-apply"]').click()
+    expect(page.locator('[data-testid="import-report-step"]')).to_be_visible(timeout=15000)
+    page.click('[data-testid="import-done"]')
+    page.wait_for_timeout(500)
+
+    actual_lang = page.evaluate(
+        """async () => await window.__repos.settings.get('language')"""
+    )
+
+    # Restore original language
+    page.evaluate(
+        """async ([lang]) => {
+            await window.__repos.settings.set('language', lang)
+            await window.__repos.settings.set('theme', 'light')
+        }""",
+        [original_lang or "en"],
+    )
+
+    assert actual_lang == "fr", f"Same-user import should apply language='fr', got: {actual_lang!r}"
+
+
+# ── R15 tests ─────────────────────────────────────────────────────────────────
+
+
+def _seed_execution_log(page: Page, sess_id: str, ex_id: str, count: int = 1):
+    """Seed `count` execution log items referencing the given exercise."""
+    page.evaluate(
+        """async ([sessId, exId, count]) => {
+            const now = new Date().toISOString()
+            for (let i = 0; i < count; i++) {
+                const logId = await window.__repos.executionLogs.create({
+                    session_id: sessId,
+                    started_at: now,
+                    finished_at: now,
+                })
+                await window.__repos.executionLogs.addItem({
+                    log_id: logId,
+                    exercise_id: exId,
+                    reps_done: 5,
+                    weight_used: 0,
+                    side: null,
+                    completed: true,
+                    timestamp: now,
+                })
+            }
+        }""",
+        [sess_id, ex_id, count],
+    )
+
+
+def test_delete_exercise_with_history_shows_count(page: Page, app_url: str):
+    """Deleting an exercise with history shows the journal entry count in the confirm dialog."""
+    _wait_for_db(page, app_url)
+    _clean_all(page)
+
+    ex_id = _create_exercise(page, "Tracked Exercise")
+    sess_id = _create_session(page, "Logged Session")
+    _seed_execution_log(page, sess_id, ex_id, count=3)
+
+    # Navigate to the exercise detail page
+    page.evaluate(
+        """([exId]) => { window.location.hash = '#/exercises/' + exId }""",
+        [ex_id],
+    )
+    page.wait_for_selector('[data-testid="exercise-delete-btn"]', timeout=5000)
+
+    # Intercept the confirm dialog to read its message
+    dialog_messages = []
+    page.once("dialog", lambda d: (dialog_messages.append(d.message), d.dismiss()))
+    page.locator('[data-testid="exercise-delete-btn"]').click()
+    page.wait_for_timeout(300)
+
+    assert len(dialog_messages) == 1, "Delete should trigger a confirm dialog"
+    msg = dialog_messages[0]
+    assert "3" in msg, f"Confirm dialog should mention 3 journal entries, got: {msg!r}"
+
+
+def test_delete_session_with_history_shows_count(page: Page, app_url: str):
+    """Deleting a session with logs shows the execution log count in the confirm dialog."""
+    _wait_for_db(page, app_url)
+    _clean_all(page)
+
+    ex_id = _create_exercise(page, "Session Exercise")
+    sess_id = _create_session(page, "Logged Session 2")
+    # Set an exercise item on the session so we can seed a log
+    page.evaluate(
+        """async ([sessId, exId]) => window.__repos.sessions.setItems(sessId, [{
+            item_id: exId, item_type: 'exercise', position: 0, repetitions: 5, weight: 0
+        }])""",
+        [sess_id, ex_id],
+    )
+    _seed_execution_log(page, sess_id, ex_id, count=2)
+
+    # Navigate to session detail
+    page.evaluate(
+        """([sessId]) => { window.location.hash = '#/sessions/' + sessId }""",
+        [sess_id],
+    )
+    page.wait_for_selector('[data-testid="session-delete-btn"]', timeout=5000)
+
+    dialog_messages = []
+    page.once("dialog", lambda d: (dialog_messages.append(d.message), d.dismiss()))
+    page.locator('[data-testid="session-delete-btn"]').click()
+    page.wait_for_timeout(300)
+
+    assert len(dialog_messages) == 1, "Delete should trigger a confirm dialog"
+    msg = dialog_messages[0]
+    assert "2" in msg, f"Confirm dialog should mention 2 execution logs, got: {msg!r}"
diff --git a/tests/test_step21_import_title_conflicts.py b/tests/test_step21_import_title_conflicts.py
new file mode 100644
index 0000000..07b6ff5
--- /dev/null
+++ b/tests/test_step21_import_title_conflicts.py
@@ -0,0 +1,461 @@
+"""
+Step 21 — JSON Import: Title-Conflict Resolution UX
+- test_same_user_title_conflict_shown_as_collision: title-only conflict (different id) surfaces
+  in the collisions screen instead of being silently dropped
+- test_same_user_title_conflict_skip: skip leaves the existing exercise untouched, no duplicate row
+- test_same_user_title_conflict_replace: replace updates the existing row in place (keeps its id)
+- test_same_user_title_conflict_dependency_redirect_skip: a combo in the same batch referencing the
+  conflicting exercise's imported id ends up pointing at the existing exercise's id after skip
+- test_same_user_title_conflict_dependency_redirect_replace: same redirect check, replace branch
+- test_cross_user_title_conflict_skip: suffixed-title conflict (re-import from same external user)
+  offers Replace/Skip instead of a forced rename; skip leaves the previous import untouched
+- test_cross_user_title_conflict_replace: same scenario, replace updates the previous import in place
+"""
+
+import json
+from playwright.sync_api import Page, expect
+
+
+def _wait_for_db(page: Page, app_url: str):
+    page.goto(app_url)
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-ready') === 'true'",
+        timeout=15000,
+    )
+
+
+def _go_to_exercises(page: Page, app_url: str):
+    _wait_for_db(page, app_url)
+    page.click('a[href="#/exercises"]')
+    page.wait_for_timeout(500)
+
+
+def _clean_all(page: Page):
+    page.evaluate(
+        """async () => {
+            const combos = await window.__repos.combos.getAll();
+            for (const c of combos) await window.__repos.combos.delete(c.id);
+            const exercises = await window.__repos.exercises.getAll();
+            for (const ex of exercises) await window.__repos.exercises.delete(ex.id);
+            const suffixes = await window.__repos.suffixes.getAll();
+            for (const s of suffixes) await window.__repos.suffixes.delete(s.user_uuid);
+        }"""
+    )
+
+
+def _get_local_uuid(page: Page):
+    return page.evaluate("async () => await window.__repos.settings.get('user_uuid')")
+
+
+def _create_exercise_directly(page: Page, title, created_by=None, exercise_id=None):
+    return page.evaluate(
+        """async ([title, createdBy, exerciseId]) => {
+            const uuid = await window.__repos.settings.get('user_uuid');
+            const cb = createdBy || uuid;
+            if (exerciseId) {
+                await window.__repos.exercises.createWithId(exerciseId, {
+                    title, description: '', asymmetric: false, alternate: false,
+                    image_urls: [], video_urls: [], default_reps: 10, default_weight: 20,
+                    created_by: cb,
+                });
+                return exerciseId;
+            }
+            return await window.__repos.exercises.create({
+                title, description: '', asymmetric: false, alternate: false,
+                image_urls: [], video_urls: [], default_reps: 10, default_weight: 20,
+                created_by: cb,
+            });
+        }""",
+        [title, created_by, exercise_id],
+    )
+
+
+def _build_export_json(data, exporter_name, exporter_uuid):
+    envelope = {
+        "metadata": {
+            "appName": "trainus",
+            "appVersion": "1.0.0",
+            "schemaVersion": 1,
+            "exportDate": "2026-06-16T12:00:00.000Z",
+            "exportedBy": {"name": exporter_name, "uuid": exporter_uuid},
+        },
+        "data": data,
+    }
+    return json.dumps(envelope)
+
+
+def _trigger_import_with_json(page: Page, json_str: str, test_id: str = "exercise-import-btn"):
+    with page.expect_file_chooser() as fc_info:
+        page.click(f'[data-testid="{test_id}"]')
+    file_chooser = fc_info.value
+    file_chooser.set_files(
+        [
+            {
+                "name": "test-import.json",
+                "mimeType": "application/json",
+                "buffer": json_str.encode("utf-8"),
+            }
+        ]
+    )
+
+
+def _exercise_count_by_title(page: Page, title: str) -> int:
+    return page.evaluate(
+        """async (title) => {
+            const all = await window.__repos.exercises.getAll();
+            return all.filter((e) => e.title === title).length;
+        }""",
+        title,
+    )
+
+
+# ============================================================
+# Same-user title conflicts (different id, same title)
+# ============================================================
+
+
+def test_same_user_title_conflict_shown_as_collision(page: Page, app_url: str):
+    """A same-user import whose title matches an existing exercise (different id) surfaces
+    in the collisions screen instead of being silently dropped or raising a raw DB error."""
+    _go_to_exercises(page, app_url)
+    _clean_all(page)
+
+    local_uuid = _get_local_uuid(page)
+    _create_exercise_directly(page, "Push-ups")
+
+    imported = {
+        "id": "11111111-1111-1111-1111-111111111111",
+        "title": "Push-ups",
+        "description": "Imported version",
+        "asymmetric": False,
+        "alternate": False,
+        "image_urls": [],
+        "video_urls": [],
+        "default_reps": 99,
+        "default_weight": 99,
+        "created_by": local_uuid,
+    }
+    json_str = _build_export_json({"exercises": [imported]}, "Local User", local_uuid)
+
+    _trigger_import_with_json(page, json_str)
+
+    expect(page.locator('[data-testid="import-collisions-step"]')).to_be_visible(timeout=5000)
+    expect(page.locator('[data-testid="collision-item-exercise-0"]')).to_contain_text("Push-ups")
+
+    page.click('[data-testid="import-cancel"]')
+    _clean_all(page)
+
+
+def test_same_user_title_conflict_skip(page: Page, app_url: str):
+    """Skip on a same-user title conflict leaves the existing exercise untouched and creates
+    no duplicate row under the imported id."""
+    _go_to_exercises(page, app_url)
+    _clean_all(page)
+
+    local_uuid = _get_local_uuid(page)
+    existing_id = _create_exercise_directly(page, "Push-ups")
+    new_id = "22222222-2222-2222-2222-222222222222"
+
+    imported = {
+        "id": new_id,
+        "title": "Push-ups",
+        "description": "Imported version",
+        "asymmetric": False,
+        "alternate": False,
+        "image_urls": [],
+        "video_urls": [],
+        "default_reps": 99,
+        "default_weight": 99,
+        "created_by": local_uuid,
+    }
+    json_str = _build_export_json({"exercises": [imported]}, "Local User", local_uuid)
+
+    _trigger_import_with_json(page, json_str)
+    expect(page.locator('[data-testid="import-collisions-step"]')).to_be_visible(timeout=5000)
+
+    # Default action is Skip
+    page.click('[data-testid="import-apply"]')
+    expect(page.locator('[data-testid="import-report-step"]')).to_be_visible(timeout=5000)
+    expect(page.locator('[data-testid="import-report-skipped"]')).to_be_visible()
+    page.click('[data-testid="import-done"]')
+
+    existing = page.evaluate(
+        f"""async () => await window.__repos.exercises.getById('{existing_id}')"""
+    )
+    assert existing["default_reps"] == 10, "Existing exercise must be unchanged"
+
+    duplicate = page.evaluate(f"""async () => await window.__repos.exercises.getById('{new_id}')""")
+    assert duplicate is None, "No new row should be created under the imported id"
+
+    assert _exercise_count_by_title(page, "Push-ups") == 1
+    _clean_all(page)
+
+
+def test_same_user_title_conflict_replace(page: Page, app_url: str):
+    """Replace on a same-user title conflict updates the existing row in place (keeps its id)."""
+    _go_to_exercises(page, app_url)
+    _clean_all(page)
+
+    local_uuid = _get_local_uuid(page)
+    existing_id = _create_exercise_directly(page, "Push-ups")
+    new_id = "33333333-3333-3333-3333-333333333333"
+
+    imported = {
+        "id": new_id,
+        "title": "Push-ups",
+        "description": "Imported version",
+        "asymmetric": False,
+        "alternate": False,
+        "image_urls": [],
+        "video_urls": [],
+        "default_reps": 99,
+        "default_weight": 99,
+        "created_by": local_uuid,
+    }
+    json_str = _build_export_json({"exercises": [imported]}, "Local User", local_uuid)
+
+    _trigger_import_with_json(page, json_str)
+    expect(page.locator('[data-testid="import-collisions-step"]')).to_be_visible(timeout=5000)
+
+    page.click('[data-testid="collision-replace-exercise-0"]')
+    page.click('[data-testid="import-apply"]')
+    expect(page.locator('[data-testid="import-report-step"]')).to_be_visible(timeout=5000)
+    expect(page.locator('[data-testid="import-report-exercises-replaced"]')).to_be_visible()
+    page.click('[data-testid="import-done"]')
+
+    existing = page.evaluate(
+        f"""async () => await window.__repos.exercises.getById('{existing_id}')"""
+    )
+    assert existing is not None, "Existing row must keep its original id"
+    assert existing["default_reps"] == 99, "Existing row must be updated with imported data"
+
+    duplicate = page.evaluate(f"""async () => await window.__repos.exercises.getById('{new_id}')""")
+    assert duplicate is None, "No new row should be created under the imported id"
+
+    assert _exercise_count_by_title(page, "Push-ups") == 1
+    _clean_all(page)
+
+
+# ============================================================
+# Same-user title conflict + same-batch dependency redirect
+# ============================================================
+
+
+def _build_conflict_with_combo_json(local_uuid, new_exercise_id, combo_id):
+    imported_exercise = {
+        "id": new_exercise_id,
+        "title": "Push-ups",
+        "description": "Imported version",
+        "asymmetric": False,
+        "alternate": False,
+        "image_urls": [],
+        "video_urls": [],
+        "default_reps": 99,
+        "default_weight": 99,
+        "created_by": local_uuid,
+    }
+    imported_combo = {
+        "id": combo_id,
+        "title": "Conflict Combo",
+        "description": "",
+        "type": "NONE",
+        "timer_config": {},
+        "created_by": local_uuid,
+        "exercises": [
+            {
+                "position": 0,
+                "exercise_id": new_exercise_id,
+                "default_reps": 5,
+                "default_weight": 10,
+                "title": "Push-ups",
+                "asymmetric": False,
+                "alternate": False,
+            }
+        ],
+    }
+    return _build_export_json(
+        {"exercises": [imported_exercise], "combos": [imported_combo]}, "Local User", local_uuid
+    )
+
+
+def test_same_user_title_conflict_dependency_redirect_skip(page: Page, app_url: str):
+    """A combo in the same import batch referencing the conflicting exercise's imported id
+    ends up pointing at the existing exercise's id once the conflict is skipped."""
+    _go_to_exercises(page, app_url)
+    _clean_all(page)
+
+    local_uuid = _get_local_uuid(page)
+    existing_id = _create_exercise_directly(page, "Push-ups")
+    new_exercise_id = "44444444-4444-4444-4444-444444444444"
+    combo_id = "55555555-5555-5555-5555-555555555555"
+
+    json_str = _build_conflict_with_combo_json(local_uuid, new_exercise_id, combo_id)
+    _trigger_import_with_json(page, json_str)
+    expect(page.locator('[data-testid="import-collisions-step"]')).to_be_visible(timeout=5000)
+
+    # Default action is Skip
+    page.click('[data-testid="import-apply"]')
+    expect(page.locator('[data-testid="import-report-step"]')).to_be_visible(timeout=10000)
+    page.click('[data-testid="import-done"]')
+
+    combo = page.evaluate(f"""async () => await window.__repos.combos.getById('{combo_id}')""")
+    assert combo is not None
+    assert len(combo["exercises"]) == 1
+    assert combo["exercises"][0]["exercise_id"] == existing_id, (
+        "Combo must reference the existing exercise's id, not the skipped imported id"
+    )
+    assert _exercise_count_by_title(page, "Push-ups") == 1
+    _clean_all(page)
+
+
+def test_same_user_title_conflict_dependency_redirect_replace(page: Page, app_url: str):
+    """Same dependency-redirect check, this time resolving the conflict with Replace."""
+    _go_to_exercises(page, app_url)
+    _clean_all(page)
+
+    local_uuid = _get_local_uuid(page)
+    existing_id = _create_exercise_directly(page, "Push-ups")
+    new_exercise_id = "66666666-6666-6666-6666-666666666666"
+    combo_id = "77777777-7777-7777-7777-777777777777"
+
+    json_str = _build_conflict_with_combo_json(local_uuid, new_exercise_id, combo_id)
+    _trigger_import_with_json(page, json_str)
+    expect(page.locator('[data-testid="import-collisions-step"]')).to_be_visible(timeout=5000)
+
+    page.click('[data-testid="collision-replace-exercise-0"]')
+    page.click('[data-testid="import-apply"]')
+    expect(page.locator('[data-testid="import-report-step"]')).to_be_visible(timeout=10000)
+    page.click('[data-testid="import-done"]')
+
+    combo = page.evaluate(f"""async () => await window.__repos.combos.getById('{combo_id}')""")
+    assert combo is not None
+    assert len(combo["exercises"]) == 1
+    assert combo["exercises"][0]["exercise_id"] == existing_id, (
+        "Combo must reference the existing exercise's id after replace too"
+    )
+
+    existing = page.evaluate(
+        f"""async () => await window.__repos.exercises.getById('{existing_id}')"""
+    )
+    assert existing["default_reps"] == 99, "Existing exercise must be updated with imported data"
+
+    assert _exercise_count_by_title(page, "Push-ups") == 1
+    _clean_all(page)
+
+
+# ============================================================
+# Cross-user title conflicts (suffixed title collides with a previous import)
+# ============================================================
+
+
+def _register_suffix(page: Page, uuid: str, name: str, suffix: str):
+    page.evaluate(
+        """async ([uuid, name, suffix]) => {
+            await window.__repos.suffixes.create({ user_uuid: uuid, user_name: name, suffix });
+        }""",
+        [uuid, name, suffix],
+    )
+
+
+def test_cross_user_title_conflict_skip(page: Page, app_url: str):
+    """Re-importing from the same external user with a different id but the same pre-suffix
+    title offers Replace/Skip (not a forced rename) against the previously-imported row;
+    Skip leaves that row untouched."""
+    _go_to_exercises(page, app_url)
+    _clean_all(page)
+
+    other_uuid = "other-user-uuid-conflict-1"
+    previous_id = "ext-prev-id-1"
+    _create_exercise_directly(page, "Squats [BS]", other_uuid, previous_id)
+    _register_suffix(page, other_uuid, "Bob Smith", "BS")
+
+    new_id = "ext-new-id-1"
+    imported = {
+        "id": new_id,
+        "title": "Squats",
+        "description": "Newer export",
+        "asymmetric": False,
+        "alternate": False,
+        "image_urls": [],
+        "video_urls": [],
+        "default_reps": 50,
+        "default_weight": 50,
+        "created_by": other_uuid,
+    }
+    json_str = _build_export_json({"exercises": [imported]}, "Bob Smith", other_uuid)
+
+    _trigger_import_with_json(page, json_str)
+
+    # Suffix already registered, so it goes straight to preview
+    expect(page.locator('[data-testid="import-preview-step"]')).to_be_visible(timeout=5000)
+    page.click('[data-testid="import-apply"]')
+
+    # The suffixed title ("Squats [BS]") collides with the previous import -> collisions screen
+    expect(page.locator('[data-testid="import-collisions-step"]')).to_be_visible(timeout=5000)
+
+    page.click('[data-testid="import-apply"]')
+    expect(page.locator('[data-testid="import-report-step"]')).to_be_visible(timeout=5000)
+    expect(page.locator('[data-testid="import-report-skipped"]')).to_be_visible()
+    page.click('[data-testid="import-done"]')
+
+    existing = page.evaluate(
+        f"""async () => await window.__repos.exercises.getById('{previous_id}')"""
+    )
+    assert existing["default_reps"] == 10, "Previously-imported row must be unchanged"
+
+    duplicate = page.evaluate(f"""async () => await window.__repos.exercises.getById('{new_id}')""")
+    assert duplicate is None, "No new row should be created under the imported id"
+
+    assert _exercise_count_by_title(page, "Squats [BS]") == 1
+    _clean_all(page)
+
+
+def test_cross_user_title_conflict_replace(page: Page, app_url: str):
+    """Same scenario, resolved with Replace: the previously-imported row is updated in place."""
+    _go_to_exercises(page, app_url)
+    _clean_all(page)
+
+    other_uuid = "other-user-uuid-conflict-2"
+    previous_id = "ext-prev-id-2"
+    _create_exercise_directly(page, "Lunges [BS]", other_uuid, previous_id)
+    _register_suffix(page, other_uuid, "Bob Smith", "BS")
+
+    new_id = "ext-new-id-2"
+    imported = {
+        "id": new_id,
+        "title": "Lunges",
+        "description": "Newer export",
+        "asymmetric": False,
+        "alternate": False,
+        "image_urls": [],
+        "video_urls": [],
+        "default_reps": 50,
+        "default_weight": 50,
+        "created_by": other_uuid,
+    }
+    json_str = _build_export_json({"exercises": [imported]}, "Bob Smith", other_uuid)
+
+    _trigger_import_with_json(page, json_str)
+    expect(page.locator('[data-testid="import-preview-step"]')).to_be_visible(timeout=5000)
+    page.click('[data-testid="import-apply"]')
+
+    expect(page.locator('[data-testid="import-collisions-step"]')).to_be_visible(timeout=5000)
+    page.click('[data-testid="collision-replace-exercise-0"]')
+    page.click('[data-testid="import-apply"]')
+
+    expect(page.locator('[data-testid="import-report-step"]')).to_be_visible(timeout=5000)
+    expect(page.locator('[data-testid="import-report-exercises-replaced"]')).to_be_visible()
+    page.click('[data-testid="import-done"]')
+
+    existing = page.evaluate(
+        f"""async () => await window.__repos.exercises.getById('{previous_id}')"""
+    )
+    assert existing is not None, "Previously-imported row must keep its id"
+    assert existing["default_reps"] == 50, "Previously-imported row must be updated with new data"
+    assert existing["title"] == "Lunges [BS]"
+
+    duplicate = page.evaluate(f"""async () => await window.__repos.exercises.getById('{new_id}')""")
+    assert duplicate is None, "No new row should be created under the imported id"
+
+    assert _exercise_count_by_title(page, "Lunges [BS]") == 1
+    _clean_all(page)
diff --git a/tests/test_step22_save_filename_prompt.py b/tests/test_step22_save_filename_prompt.py
new file mode 100644
index 0000000..62db0bc
--- /dev/null
+++ b/tests/test_step22_save_filename_prompt.py
@@ -0,0 +1,162 @@
+"""
+Step 22 — Save Filename Prompt Tests
+
+Green paths:
+- test_dialog_prefilled_with_default_name: Dialog opens with stem prefilled and extension shown
+- test_custom_filename_is_used: Editing the stem changes the downloaded file's name
+- test_enter_confirms_with_default: Pressing Enter accepts the prefilled default name
+- test_empty_stem_falls_back_to_default: Clearing the stem and saving falls back to the default name
+
+Red paths:
+- test_cancel_aborts_download: Cancelling the dialog produces no download
+- test_close_button_aborts_download: Closing the dialog (X button) produces no download
+- test_backup_cancel_does_not_update_last_backup_at: Cancelling a backup save leaves last_backup_at untouched
+- test_migration_cancel_keeps_update_disabled: Cancelling the forced migration backup leaves Update disabled
+"""
+
+import re
+
+from playwright.sync_api import Page, expect
+
+
+def _wait_for_db(page: Page, app_url: str):
+    """Navigate and wait for the database to be ready."""
+    page.goto(app_url)
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-ready') === 'true'", timeout=15000
+    )
+
+
+def _go_to_exercises(page: Page, app_url: str):
+    """Navigate to the exercises list and wait for it to load."""
+    _wait_for_db(page, app_url)
+    page.click('a[href="#/exercises"]')
+    page.wait_for_timeout(500)
+
+
+def _go_to_settings(page: Page, app_url: str):
+    """Navigate to the settings page and wait for DB."""
+    _wait_for_db(page, app_url)
+    page.click('a[href="#/settings"]')
+    page.wait_for_selector('[data-testid="settings-language"]')
+
+
+def _set_db_version(page: Page, version: int):
+    """Rewrite the schema_version table so it contains only `version`."""
+    page.evaluate(f"""
+        (async () => {{
+            await window.__db.run("DELETE FROM schema_version");
+            await window.__db.run("INSERT INTO schema_version (version) VALUES ({version})");
+        }})()
+    """)
+
+
+def test_dialog_prefilled_with_default_name(page: Page, app_url: str):
+    """Save dialog opens with the input prefilled and the extension shown alongside it."""
+    _go_to_exercises(page, app_url)
+    page.locator('[data-testid="exercise-export-btn"]').click()
+
+    input_ = page.locator('[data-testid="save-file-input"]')
+    expect(input_).to_be_visible()
+    value = input_.input_value()
+    assert re.match(r"^trainus-exercises-\d{4}-\d{2}-\d{2}$", value), f"Unexpected default stem: {value}"
+    expect(page.locator('[data-testid="save-file-extension"]')).to_have_text(".json")
+
+    page.locator('[data-testid="save-file-cancel"]').click()
+
+
+def test_custom_filename_is_used(page: Page, app_url: str):
+    """Editing the stem changes the downloaded file's name, keeping the original extension."""
+    _go_to_exercises(page, app_url)
+    page.locator('[data-testid="exercise-export-btn"]').click()
+
+    page.locator('[data-testid="save-file-input"]').fill("my-custom-export")
+    with page.expect_download() as download_info:
+        page.locator('[data-testid="save-file-confirm"]').click()
+    assert download_info.value.suggested_filename == "my-custom-export.json"
+
+
+def test_enter_confirms_with_default(page: Page, app_url: str):
+    """Pressing Enter in the filename field accepts the prefilled default name."""
+    _go_to_exercises(page, app_url)
+    page.locator('[data-testid="exercise-export-btn"]').click()
+
+    input_ = page.locator('[data-testid="save-file-input"]')
+    default_stem = input_.input_value()
+    with page.expect_download() as download_info:
+        input_.press("Enter")
+    assert download_info.value.suggested_filename == f"{default_stem}.json"
+
+
+def test_empty_stem_falls_back_to_default(page: Page, app_url: str):
+    """Clearing the filename field and saving falls back to the default name."""
+    _go_to_exercises(page, app_url)
+    page.locator('[data-testid="exercise-export-btn"]').click()
+
+    input_ = page.locator('[data-testid="save-file-input"]')
+    default_stem = input_.input_value()
+    input_.fill("")
+    with page.expect_download() as download_info:
+        page.locator('[data-testid="save-file-confirm"]').click()
+    assert download_info.value.suggested_filename == f"{default_stem}.json"
+
+
+def test_cancel_aborts_download(page: Page, app_url: str):
+    """Cancelling the save dialog triggers no download."""
+    _go_to_exercises(page, app_url)
+    page.locator('[data-testid="exercise-export-btn"]').click()
+    page.wait_for_selector('[data-testid="save-file-input"]')
+
+    downloaded = []
+    page.on("download", lambda d: downloaded.append(d))
+    page.locator('[data-testid="save-file-cancel"]').click()
+    page.wait_for_timeout(500)
+    expect(page.locator('[data-testid="save-file-input"]')).not_to_be_visible()
+    assert downloaded == [], "No download should occur when the save dialog is cancelled"
+
+
+def test_close_button_aborts_download(page: Page, app_url: str):
+    """Closing the save dialog via the X button triggers no download."""
+    _go_to_exercises(page, app_url)
+    page.locator('[data-testid="exercise-export-btn"]').click()
+    page.wait_for_selector('[data-testid="save-file-input"]')
+
+    downloaded = []
+    page.on("download", lambda d: downloaded.append(d))
+    page.locator('[data-testid="modal-close"]').click()
+    page.wait_for_timeout(500)
+    expect(page.locator('[data-testid="save-file-input"]')).not_to_be_visible()
+    assert downloaded == [], "No download should occur when the save dialog is closed"
+
+
+def test_backup_cancel_does_not_update_last_backup_at(page: Page, app_url: str):
+    """Cancelling a database backup save leaves last_backup_at untouched."""
+    _go_to_settings(page, app_url)
+
+    before = page.evaluate("async () => await window.__repos.settings.get('last_backup_at')")
+
+    page.locator('[data-testid="settings-download-db"]').click()
+    page.wait_for_selector('[data-testid="save-file-cancel"]')
+    page.locator('[data-testid="save-file-cancel"]').click()
+    page.wait_for_timeout(500)
+
+    after = page.evaluate("async () => await window.__repos.settings.get('last_backup_at')")
+    assert after == before, "last_backup_at should not change when the backup save is cancelled"
+
+
+def test_migration_cancel_keeps_update_disabled(page: Page, app_url: str):
+    """Cancelling the forced migration backup leaves the Update button disabled."""
+    _wait_for_db(page, app_url)
+    _set_db_version(page, 0)
+
+    page.reload()
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-migration') === 'pending'", timeout=15000
+    )
+    expect(page.locator('[data-testid="migration-update"]')).to_be_disabled()
+
+    page.locator('[data-testid="migration-backup"]').click()
+    page.wait_for_selector('[data-testid="save-file-cancel"]')
+    page.locator('[data-testid="save-file-cancel"]').click()
+
+    expect(page.locator('[data-testid="migration-update"]')).to_be_disabled()
diff --git a/tests/test_step2_settings.py b/tests/test_step2_settings.py
new file mode 100644
index 0000000..01f5478
--- /dev/null
+++ b/tests/test_step2_settings.py
@@ -0,0 +1,659 @@
+"""
+Step 2 — Settings Tests
+- test_settings_page_loads: Settings page renders all sections
+- test_language_change_to_french: Switching language to French updates all labels reactively
+- test_language_change_persists_reload: Language preference survives page reload
+- test_username_change: Changing user name persists to database
+- test_username_persists_reload: User name survives page reload
+- test_username_empty_rejected: Empty name shows validation error
+- test_username_whitespace_only_rejected: Whitespace-only name is rejected
+- test_uuid_displayed_readonly: UUID is displayed and the field is read-only
+- test_theme_toggle_dark: Switching to dark theme applies data-theme attribute
+- test_theme_persists_reload: Theme preference survives page reload
+- test_download_db_button: Download DB button is present and triggers a download
+- test_restore_db_button: Restore DB button is visible and enabled
+- test_restore_db_cancel_dialog: Declining confirm dialog aborts the restore
+- test_restore_db_flow: Full restore round-trip with spinner and report
+- test_restore_db_invalid_file: Uploading a non-SQLite file shows error report
+- test_restore_db_incomplete_db: Uploading a DB missing required tables shows error
+- test_export_import_enabled: Export/Import buttons are present and enabled (wired in Step 3b)
+- test_initialize_db_button: Initialize DB button is present and enabled
+- test_initialize_db_dialog_requires_checkbox: Confirm button is disabled until checkbox is checked
+- test_initialize_db_dialog_cancel: Canceling the dialog does not reset the database
+- test_initialize_db_flow: Full initialize flow resets database and reloads page
+"""
+import os
+import tempfile
+from playwright.sync_api import Page, expect
+
+
+def _wait_for_db(page: Page, app_url: str):
+    """Navigate and wait for the database to be ready."""
+    page.goto(app_url)
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-ready') === 'true'",
+        timeout=15000,
+    )
+
+
+def _go_to_settings(page: Page, app_url: str):
+    """Navigate to the settings page and wait for DB."""
+    _wait_for_db(page, app_url)
+    page.click('a[href="#/settings"]')
+    page.wait_for_selector('[data-testid="settings-language"]')
+
+
+def _download_via_button(page: Page, trigger_selector: str):
+    """Click a button that opens the save-filename dialog, accept the default name, return the Download."""
+    page.locator(trigger_selector).click()
+    page.wait_for_selector('[data-testid="save-file-confirm"]')
+    with page.expect_download() as download_info:
+        page.locator('[data-testid="save-file-confirm"]').click()
+    return download_info.value
+
+
+def test_settings_page_loads(page: Page, app_url: str):
+    """Settings page renders all expected sections."""
+    _go_to_settings(page, app_url)
+
+    expect(page.locator('[data-testid="settings-language"]')).to_be_visible()
+    expect(page.locator('[data-testid="settings-username"]')).to_be_visible()
+    expect(page.locator('[data-testid="settings-uuid"]')).to_be_visible()
+    expect(page.locator('[data-testid="settings-theme"]')).to_be_visible()
+    expect(page.locator('[data-testid="settings-export"]')).to_be_visible()
+    expect(page.locator('[data-testid="settings-import"]')).to_be_visible()
+
+
+def test_language_change_to_french(page: Page, app_url: str):
+    """Switching language to French updates nav labels reactively."""
+    _go_to_settings(page, app_url)
+
+    # Change to French
+    page.select_option('[data-testid="settings-language"]', 'fr')
+    page.wait_for_function(
+        "window.__repos.settings.get('language').then(v => v === 'fr')",
+        timeout=5000,
+    )
+
+    # Nav labels should now be in French
+    expect(page.locator('a[href="#/home"] span')).to_have_text('Accueil')
+    expect(page.locator('a[href="#/exercises"] span')).to_have_text('Exercices')
+    expect(page.locator('a[href="#/settings"] span')).to_have_text('Réglages')
+
+    # Reset to English for other tests
+    page.select_option('[data-testid="settings-language"]', 'en')
+    page.wait_for_function(
+        "window.__repos.settings.get('language').then(v => v === 'en')",
+        timeout=5000,
+    )
+
+
+def test_language_change_persists_reload(page: Page, app_url: str):
+    """Language preference is persisted and restored after reload."""
+    _go_to_settings(page, app_url)
+
+    # Change to French and wait for DB confirmation
+    page.select_option('[data-testid="settings-language"]', 'fr')
+    page.wait_for_function(
+        "window.__repos.settings.get('language').then(v => v === 'fr')",
+        timeout=5000,
+    )
+
+    # Reload
+    page.reload()
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-ready') === 'true'",
+        timeout=15000,
+    )
+
+    # Nav should still be in French
+    expect(page.locator('a[href="#/home"] span')).to_have_text('Accueil')
+
+    # Navigate to settings to check the dropdown value
+    page.click('a[href="#/settings"]')
+    page.wait_for_selector('[data-testid="settings-language"]')
+    expect(page.locator('[data-testid="settings-language"]')).to_have_value('fr')
+
+    # Reset to English
+    page.select_option('[data-testid="settings-language"]', 'en')
+    page.wait_for_function(
+        "window.__repos.settings.get('language').then(v => v === 'en')",
+        timeout=5000,
+    )
+
+
+def test_username_change(page: Page, app_url: str):
+    """Changing user name persists to the database."""
+    _go_to_settings(page, app_url)
+
+    username_input = page.locator('[data-testid="settings-username"]')
+    username_input.fill('Alice')
+    username_input.blur()
+    page.wait_for_function(
+        "window.__repos.settings.get('user_name').then(v => v === 'Alice')",
+        timeout=5000,
+    )
+
+    # Verify in DB
+    stored = page.evaluate("async () => await window.__repos.settings.get('user_name')")
+    assert stored == 'Alice', f"Expected 'Alice', got '{stored}'"
+
+    # Cleanup: restore default
+    username_input.fill('User')
+    username_input.blur()
+    page.wait_for_function(
+        "window.__repos.settings.get('user_name').then(v => v === 'User')",
+        timeout=5000,
+    )
+
+
+def test_username_persists_reload(page: Page, app_url: str):
+    """User name survives page reload."""
+    _go_to_settings(page, app_url)
+
+    username_input = page.locator('[data-testid="settings-username"]')
+    username_input.fill('Bob')
+    username_input.blur()
+    page.wait_for_function(
+        "window.__repos.settings.get('user_name').then(v => v === 'Bob')",
+        timeout=5000,
+    )
+
+    # Reload and go back to settings
+    page.reload()
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-ready') === 'true'",
+        timeout=15000,
+    )
+    page.click('a[href="#/settings"]')
+    page.wait_for_selector('[data-testid="settings-username"]')
+
+    expect(page.locator('[data-testid="settings-username"]')).to_have_value('Bob')
+
+    # Cleanup
+    username_input = page.locator('[data-testid="settings-username"]')
+    username_input.fill('User')
+    username_input.blur()
+    page.wait_for_function(
+        "window.__repos.settings.get('user_name').then(v => v === 'User')",
+        timeout=5000,
+    )
+
+
+def test_username_empty_rejected(page: Page, app_url: str):
+    """Empty name shows a validation error and is not saved."""
+    _go_to_settings(page, app_url)
+
+    # Get original name
+    original = page.evaluate("async () => await window.__repos.settings.get('user_name')")
+
+    username_input = page.locator('[data-testid="settings-username"]')
+    username_input.fill('')
+    username_input.blur()
+    page.wait_for_timeout(500)
+
+    # Error should be visible
+    expect(page.locator('[data-testid="settings-name-error"]')).to_be_visible()
+
+    # DB should still have the original name
+    stored = page.evaluate("async () => await window.__repos.settings.get('user_name')")
+    assert stored == original, f"Name should not have changed, got '{stored}'"
+
+
+def test_username_whitespace_only_rejected(page: Page, app_url: str):
+    """Whitespace-only name is rejected."""
+    _go_to_settings(page, app_url)
+
+    original = page.evaluate("async () => await window.__repos.settings.get('user_name')")
+
+    username_input = page.locator('[data-testid="settings-username"]')
+    username_input.fill('   ')
+    username_input.blur()
+    page.wait_for_timeout(500)
+
+    expect(page.locator('[data-testid="settings-name-error"]')).to_be_visible()
+
+    stored = page.evaluate("async () => await window.__repos.settings.get('user_name')")
+    assert stored == original, f"Name should not have changed, got '{stored}'"
+
+
+def test_uuid_displayed_readonly(page: Page, app_url: str):
+    """UUID is displayed and the field is read-only."""
+    _go_to_settings(page, app_url)
+
+    uuid_input = page.locator('[data-testid="settings-uuid"]')
+    expect(uuid_input).to_be_visible()
+
+    # Should have readonly attribute
+    expect(uuid_input).to_have_attribute('readonly', '')
+
+    # Value should be a valid UUID
+    value = uuid_input.input_value()
+    import re
+    assert re.match(
+        r'^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$',
+        value,
+    ), f"UUID field does not contain a valid UUID: {value}"
+
+
+def test_theme_toggle_dark(page: Page, app_url: str):
+    """Switching to dark theme applies the data-theme attribute on <html>."""
+    _go_to_settings(page, app_url)
+
+    # Switch to dark
+    page.select_option('[data-testid="settings-theme"]', 'dark')
+    page.wait_for_function(
+        "window.__repos.settings.get('theme').then(v => v === 'dark')",
+        timeout=5000,
+    )
+
+    theme_attr = page.evaluate("document.documentElement.getAttribute('data-theme')")
+    assert theme_attr == 'dark', f"Expected data-theme='dark', got '{theme_attr}'"
+
+    # Verify CSS variables changed (bg should be dark)
+    bg = page.evaluate(
+        "getComputedStyle(document.documentElement).getPropertyValue('--bg-color1').trim()"
+    )
+    assert bg == '#1a1a1a', f"Expected dark bg '#1a1a1a', got '{bg}'"
+
+    # Reset to light
+    page.select_option('[data-testid="settings-theme"]', 'light')
+    page.wait_for_function(
+        "window.__repos.settings.get('theme').then(v => v === 'light')",
+        timeout=5000,
+    )
+
+
+def test_theme_persists_reload(page: Page, app_url: str):
+    """Theme preference survives page reload."""
+    _go_to_settings(page, app_url)
+
+    # Switch to dark and wait for DB confirmation
+    page.select_option('[data-testid="settings-theme"]', 'dark')
+    page.wait_for_function(
+        "window.__repos.settings.get('theme').then(v => v === 'dark')",
+        timeout=5000,
+    )
+
+    # Reload
+    page.reload()
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-ready') === 'true'",
+        timeout=15000,
+    )
+
+    # data-theme should still be dark (applied at startup)
+    theme_attr = page.evaluate("document.documentElement.getAttribute('data-theme')")
+    assert theme_attr == 'dark', f"Expected data-theme='dark' after reload, got '{theme_attr}'"
+
+    # Go to settings, dropdown should show dark
+    page.click('a[href="#/settings"]')
+    page.wait_for_selector('[data-testid="settings-theme"]')
+    expect(page.locator('[data-testid="settings-theme"]')).to_have_value('dark')
+
+    # Reset to light
+    page.select_option('[data-testid="settings-theme"]', 'light')
+    page.wait_for_function(
+        "window.__repos.settings.get('theme').then(v => v === 'light')",
+        timeout=5000,
+    )
+
+
+def test_download_db_button(page: Page, app_url: str):
+    """Download DB button is present and triggers a download."""
+    _go_to_settings(page, app_url)
+
+    download_btn = page.locator('[data-testid="settings-download-db"]')
+    expect(download_btn).to_be_visible()
+    expect(download_btn).to_be_enabled()
+
+    # Click and verify a download is initiated
+    download = _download_via_button(page, '[data-testid="settings-download-db"]')
+    assert download.suggested_filename.startswith('trainus-')
+    assert download.suggested_filename.endswith('.sqlite3')
+
+
+def test_restore_db_button(page: Page, app_url: str):
+    """Restore DB button is visible and enabled."""
+    _go_to_settings(page, app_url)
+
+    restore_btn = page.locator('[data-testid="settings-restore-db"]')
+    expect(restore_btn).to_be_visible()
+    expect(restore_btn).to_be_enabled()
+
+
+def test_restore_db_cancel_dialog(page: Page, app_url: str, tmp_path_factory):
+    """Declining the confirm dialog aborts the restore (data unchanged)."""
+    _go_to_settings(page, app_url)
+
+    # Set a known username
+    page.locator('[data-testid="settings-username"]').fill('KeepMe')
+    page.locator('[data-testid="settings-username"]').blur()
+    page.wait_for_function(
+        "window.__repos.settings.get('user_name').then(v => v === 'KeepMe')",
+        timeout=5000,
+    )
+
+    # Download DB so we have a file to upload
+    tmp_dir = tmp_path_factory.mktemp("cancel_dialog")
+    db_path = str(tmp_dir / "backup.sqlite3")
+    download = _download_via_button(page, '[data-testid="settings-download-db"]')
+    download.save_as(db_path)
+
+    # Change username after download
+    page.locator('[data-testid="settings-username"]').fill('Changed')
+    page.locator('[data-testid="settings-username"]').blur()
+    page.wait_for_function(
+        "window.__repos.settings.get('user_name').then(v => v === 'Changed')",
+        timeout=5000,
+    )
+
+    # Dismiss the confirm dialog
+    page.once('dialog', lambda dialog: dialog.dismiss())
+
+    # Open file chooser and supply the downloaded file
+    with page.expect_file_chooser() as fc_info:
+        page.locator('[data-testid="settings-restore-db"]').click()
+    file_chooser = fc_info.value
+    file_chooser.set_files(db_path)
+
+    # Give a moment for any (unwanted) action — should NOT happen
+    page.wait_for_timeout(1000)
+
+    # Username should still be the changed value
+    expect(page.locator('[data-testid="settings-username"]')).to_have_value('Changed')
+    # No report should appear
+    expect(page.locator('[data-testid="restore-report"]')).not_to_be_visible()
+
+
+def test_restore_db_flow(page: Page, app_url: str, tmp_path_factory):
+    """Full restore: download DB, change data, restore, verify report and restored data."""
+    _go_to_settings(page, app_url)
+
+    # 1. Set a known username and wait for persistence
+    page.locator('[data-testid="settings-username"]').fill('BeforeRestore')
+    page.locator('[data-testid="settings-username"]').blur()
+    page.wait_for_function(
+        "window.__repos.settings.get('user_name').then(v => v === 'BeforeRestore')",
+        timeout=5000,
+    )
+
+    # 2. Download the DB (contains 'BeforeRestore')
+    tmp_dir = tmp_path_factory.mktemp("restore_flow")
+    db_path = str(tmp_dir / "backup.sqlite3")
+    download = _download_via_button(page, '[data-testid="settings-download-db"]')
+    download.save_as(db_path)
+
+    # 3. Change username to something else
+    page.locator('[data-testid="settings-username"]').fill('AfterChange')
+    page.locator('[data-testid="settings-username"]').blur()
+    page.wait_for_function(
+        "window.__repos.settings.get('user_name').then(v => v === 'AfterChange')",
+        timeout=5000,
+    )
+
+    # 4. Accept the confirm dialog automatically
+    page.once('dialog', lambda dialog: dialog.accept())
+
+    # 5. Trigger restore with the downloaded file
+    with page.expect_file_chooser() as fc_info:
+        page.locator('[data-testid="settings-restore-db"]').click()
+    file_chooser = fc_info.value
+    file_chooser.set_files(db_path)
+
+    # 6. Report should appear with success
+    report = page.locator('[data-testid="restore-report"]')
+    expect(report).to_be_visible(timeout=15000)
+
+    # Check report indicates success (green header text)
+    report_header = report.locator('.report-success')
+    expect(report_header).to_be_visible()
+
+    # 7. Username should now reflect the restored data
+    expect(page.locator('[data-testid="settings-username"]')).to_have_value('BeforeRestore')
+
+    # 8. Dismiss the report
+    page.locator('[data-testid="restore-report-dismiss"]').click()
+    expect(report).not_to_be_visible()
+
+    # 2. Download the DB (contains 'BeforeRestore')
+    tmp_dir2 = tmp_path_factory.mktemp("restore_flow2")
+    db_path2 = str(tmp_dir2 / "backup2.sqlite3")
+    download = _download_via_button(page, '[data-testid="settings-download-db"]')
+    download.save_as(db_path2)
+
+    # 3. Change username to something else
+    page.locator('[data-testid="settings-username"]').fill('AfterChange')
+    page.locator('[data-testid="settings-username"]').blur()
+    page.wait_for_function(
+        "window.__repos.settings.get('user_name').then(v => v === 'AfterChange')",
+        timeout=5000,
+    )
+
+    # 4. Accept the confirm dialog automatically
+    page.once('dialog', lambda dialog: dialog.accept())
+
+    # 5. Trigger restore with the downloaded file
+    with page.expect_file_chooser() as fc_info:
+        page.locator('[data-testid="settings-restore-db"]').click()
+    file_chooser = fc_info.value
+    file_chooser.set_files(db_path2)
+
+    # 6. Report should appear with success
+    report = page.locator('[data-testid="restore-report"]')
+    expect(report).to_be_visible(timeout=15000)
+
+    # Debug: print report contents if error
+    report_text = report.text_content()
+    error_msg = page.locator('[data-testid="restore-error-message"]')
+    if error_msg.count() > 0:
+        assert False, f"Restore failed with error report: {report_text}"
+
+    # Check report indicates success (green header text)
+    report_header = report.locator('.report-success')
+    expect(report_header).to_be_visible()
+
+    # 7. Username should now reflect the restored data
+    expect(page.locator('[data-testid="settings-username"]')).to_have_value('BeforeRestore')
+
+    # 8. Dismiss the report
+    page.locator('[data-testid="restore-report-dismiss"]').click()
+    expect(report).not_to_be_visible()
+
+
+def test_restore_db_invalid_file(page: Page, app_url: str):
+    """Uploading a non-SQLite file shows an error report."""
+    _go_to_settings(page, app_url)
+
+    # Create a temp file with garbage content
+    tmp = tempfile.NamedTemporaryFile(suffix='.sqlite3', delete=False)
+    tmp.write(b'this is not a sqlite database at all')
+    tmp.close()
+
+    try:
+        # Accept the confirm dialog
+        page.once('dialog', lambda dialog: dialog.accept())
+
+        # Trigger restore with the invalid file
+        with page.expect_file_chooser() as fc_info:
+            page.locator('[data-testid="settings-restore-db"]').click()
+        file_chooser = fc_info.value
+        file_chooser.set_files(tmp.name)
+
+        # Report should appear with error
+        report = page.locator('[data-testid="restore-report"]')
+        expect(report).to_be_visible(timeout=10000)
+
+        # Check it's an error report
+        report_header = report.locator('.report-error')
+        expect(report_header).to_be_visible()
+
+        # Error message should be visible
+        expect(page.locator('[data-testid="restore-error-message"]')).to_be_visible()
+    finally:
+        os.unlink(tmp.name)
+
+
+def test_restore_db_incomplete_db(page: Page, app_url: str):
+    """Uploading a SQLite DB missing required tables shows an error report."""
+    _go_to_settings(page, app_url)
+
+    # Create a minimal SQLite DB with no TrainUs tables via the browser
+    # (we use page.evaluate to build bytes for a valid but empty SQLite DB)
+    db_bytes = page.evaluate("""
+        () => {
+            // SQLite header for an empty database (100 bytes minimum)
+            // We'll use a known minimal valid SQLite file
+            const header = new Uint8Array([
+                0x53, 0x51, 0x4c, 0x69, 0x74, 0x65, 0x20, 0x66,
+                0x6f, 0x72, 0x6d, 0x61, 0x74, 0x20, 0x33, 0x00
+            ]);
+            // Return as array for transfer
+            return Array.from(header);
+        }
+    """)
+
+    # Instead use a simpler approach: create a valid empty SQLite DB file
+    # by letting the browser do it
+    tmp = tempfile.NamedTemporaryFile(suffix='.sqlite3', delete=False)
+    tmp.close()
+
+    # Write a valid but empty SQLite DB using sqlite3 from Python
+    import sqlite3
+    conn = sqlite3.connect(tmp.name)
+    conn.execute('CREATE TABLE dummy (id INTEGER PRIMARY KEY)')
+    conn.commit()
+    conn.close()
+
+    try:
+        page.once('dialog', lambda dialog: dialog.accept())
+
+        with page.expect_file_chooser() as fc_info:
+            page.locator('[data-testid="settings-restore-db"]').click()
+        file_chooser = fc_info.value
+        file_chooser.set_files(tmp.name)
+
+        # Report should appear with error
+        report = page.locator('[data-testid="restore-report"]')
+        expect(report).to_be_visible(timeout=10000)
+
+        report_header = report.locator('.report-error')
+        expect(report_header).to_be_visible()
+
+        expect(page.locator('[data-testid="restore-error-message"]')).to_be_visible()
+    finally:
+        os.unlink(tmp.name)
+
+
+def test_export_import_enabled(page: Page, app_url: str):
+    """Export and Import buttons are present and enabled (wired in Step 3b)."""
+    _go_to_settings(page, app_url)
+
+    export_btn = page.locator('[data-testid="settings-export"]')
+    import_btn = page.locator('[data-testid="settings-import"]')
+
+    expect(export_btn).to_be_visible()
+    expect(import_btn).to_be_visible()
+    expect(export_btn).to_be_enabled()
+    expect(import_btn).to_be_enabled()
+
+
+def test_initialize_db_button(page: Page, app_url: str):
+    """Initialize DB button is present and enabled."""
+    _go_to_settings(page, app_url)
+
+    init_btn = page.locator('[data-testid="settings-initialize-db"]')
+    expect(init_btn).to_be_visible()
+    expect(init_btn).to_be_enabled()
+
+
+def test_initialize_db_dialog_requires_checkbox(page: Page, app_url: str):
+    """Confirm button is disabled until the confirmation checkbox is checked."""
+    _go_to_settings(page, app_url)
+
+    # Open the initialize dialog
+    page.locator('[data-testid="settings-initialize-db"]').click()
+
+    # Dialog should be visible
+    dialog = page.locator('[data-testid="initialize-confirm-label"]')
+    expect(dialog).to_be_visible()
+
+    # Confirm button should be disabled initially
+    confirm_btn = page.locator('[data-testid="initialize-confirm"]')
+    expect(confirm_btn).to_be_disabled()
+
+    # Check the checkbox
+    page.locator('[data-testid="initialize-confirm-checkbox"]').check()
+
+    # Confirm button should now be enabled
+    expect(confirm_btn).to_be_enabled()
+
+    # Cancel the dialog
+    page.locator('[data-testid="initialize-cancel"]').click()
+    expect(dialog).not_to_be_visible()
+
+
+def test_initialize_db_dialog_cancel(page: Page, app_url: str):
+    """Canceling the initialize dialog does not reset the database."""
+    _go_to_settings(page, app_url)
+
+    # Set a known username
+    page.locator('[data-testid="settings-username"]').fill('TestUser')
+    page.locator('[data-testid="settings-username"]').blur()
+    page.wait_for_function(
+        "window.__repos.settings.get('user_name').then(v => v === 'TestUser')",
+        timeout=5000,
+    )
+
+    # Open the initialize dialog
+    page.locator('[data-testid="settings-initialize-db"]').click()
+
+    # Dialog should be visible
+    expect(page.locator('[data-testid="initialize-confirm-label"]')).to_be_visible()
+
+    # Cancel the dialog
+    page.locator('[data-testid="initialize-cancel"]').click()
+
+    # Dialog should close
+    expect(page.locator('[data-testid="initialize-confirm-label"]')).not_to_be_visible()
+
+    # Username should still be present (database not reset)
+    expect(page.locator('[data-testid="settings-username"]')).to_have_value('TestUser')
+
+
+def test_initialize_db_flow(page: Page, app_url: str):
+    """Full initialize flow: check confirmation, click confirm, page reloads with fresh DB."""
+    _go_to_settings(page, app_url)
+
+    # Set a known username
+    page.locator('[data-testid="settings-username"]').fill('WillBeDeleted')
+    page.locator('[data-testid="settings-username"]').blur()
+    page.wait_for_function(
+        "window.__repos.settings.get('user_name').then(v => v === 'WillBeDeleted')",
+        timeout=5000,
+    )
+
+    # Open the initialize dialog
+    page.locator('[data-testid="settings-initialize-db"]').click()
+
+    # Dialog should be visible
+    expect(page.locator('[data-testid="initialize-confirm-label"]')).to_be_visible()
+
+    # Check the confirmation checkbox
+    page.locator('[data-testid="initialize-confirm-checkbox"]').check()
+
+    # Click confirm - this will trigger a page reload
+    page.locator('[data-testid="initialize-confirm"]').click()
+
+    # Wait for the page to reload and DB to be ready
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-ready') === 'true'",
+        timeout=15000,
+    )
+
+    # Navigate back to settings
+    page.click('a[href="#/settings"]')
+    page.wait_for_selector('[data-testid="settings-username"]')
+
+    # Username should be reset to default 'User'
+    expect(page.locator('[data-testid="settings-username"]')).to_have_value('User')
diff --git a/tests/test_step2b_schema_hardening.py b/tests/test_step2b_schema_hardening.py
new file mode 100644
index 0000000..8d8765a
--- /dev/null
+++ b/tests/test_step2b_schema_hardening.py
@@ -0,0 +1,411 @@
+"""
+Step 2b — Schema Hardening Tests
+- test_suffix_table_exists: The suffix table is created in the schema
+- test_exercise_title_unique: Duplicate exercise titles are rejected
+- test_combo_title_unique: Duplicate combo titles are rejected
+- test_session_title_unique: Duplicate session titles are rejected
+- test_collection_label_unique: Duplicate collection labels are rejected
+- test_suffix_crud: Full CRUD cycle on the suffix table
+- test_suffix_unique_constraint: Duplicate suffixes are rejected
+- test_suffix_user_uuid_primary_key: Duplicate user_uuid is rejected
+- test_unique_constraint_allows_update: Updating a record to its own title succeeds
+- test_unique_constraint_across_updates: Updating a title to an existing title fails
+"""
+from playwright.sync_api import Page, expect
+
+
+def _wait_for_db(page: Page, app_url: str):
+    """Navigate and wait for the database to be ready."""
+    page.goto(app_url)
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-ready') === 'true'", timeout=15000
+    )
+
+
+def test_suffix_table_exists(page: Page, app_url: str):
+    """The suffix table is created in the schema."""
+    _wait_for_db(page, app_url)
+
+    tables = page.evaluate(
+        """
+        window.__db.selectAll(
+            "SELECT name FROM sqlite_master WHERE type='table' ORDER BY name"
+        )
+    """
+    )
+    table_names = [t["name"] for t in tables]
+    assert "suffix" in table_names, f"Table 'suffix' not found. Found: {table_names}"
+
+    # Verify table structure
+    columns = page.evaluate(
+        """
+        window.__db.selectAll("PRAGMA table_info(suffix)")
+    """
+    )
+    col_names = [c["name"] for c in columns]
+    assert "user_uuid" in col_names, "Column 'user_uuid' not found in suffix table"
+    assert "user_name" in col_names, "Column 'user_name' not found in suffix table"
+    assert "suffix" in col_names, "Column 'suffix' not found in suffix table"
+
+
+def test_exercise_title_unique(page: Page, app_url: str):
+    """Duplicate exercise titles are rejected by the UNIQUE constraint."""
+    _wait_for_db(page, app_url)
+
+    # Create first exercise
+    ex_id = page.evaluate(
+        """
+        window.__repos.exercises.create({
+            title: 'Unique Push-ups',
+            description: '',
+            created_by: 'test'
+        })
+    """
+    )
+    assert ex_id is not None
+
+    # Try to create a duplicate
+    error = page.evaluate(
+        """
+        (async () => {
+            try {
+                await window.__repos.exercises.create({
+                    title: 'Unique Push-ups',
+                    description: 'Duplicate',
+                    created_by: 'test'
+                });
+                return null;
+            } catch (e) {
+                return e.message;
+            }
+        })()
+    """
+    )
+    assert error is not None, "Duplicate exercise title was allowed"
+    assert "UNIQUE" in error or "unique" in error.lower(), f"Unexpected error: {error}"
+
+    # Cleanup
+    page.evaluate(f"window.__repos.exercises.delete('{ex_id}')")
+
+
+def test_combo_title_unique(page: Page, app_url: str):
+    """Duplicate combo titles are rejected by the UNIQUE constraint."""
+    _wait_for_db(page, app_url)
+
+    combo_id = page.evaluate(
+        """
+        window.__repos.combos.create({
+            title: 'Unique Combo',
+            description: '',
+            type: 'NONE',
+            created_by: 'test'
+        })
+    """
+    )
+    assert combo_id is not None
+
+    error = page.evaluate(
+        """
+        (async () => {
+            try {
+                await window.__repos.combos.create({
+                    title: 'Unique Combo',
+                    description: 'Duplicate',
+                    type: 'NONE',
+                    created_by: 'test'
+                });
+                return null;
+            } catch (e) {
+                return e.message;
+            }
+        })()
+    """
+    )
+    assert error is not None, "Duplicate combo title was allowed"
+    assert "UNIQUE" in error or "unique" in error.lower(), f"Unexpected error: {error}"
+
+    # Cleanup
+    page.evaluate(f"window.__repos.combos.delete('{combo_id}')")
+
+
+def test_session_title_unique(page: Page, app_url: str):
+    """Duplicate session titles are rejected by the UNIQUE constraint."""
+    _wait_for_db(page, app_url)
+
+    session_id = page.evaluate(
+        """
+        window.__repos.sessions.create({
+            title: 'Unique Session',
+            description: '',
+            created_by: 'test'
+        })
+    """
+    )
+    assert session_id is not None
+
+    error = page.evaluate(
+        """
+        (async () => {
+            try {
+                await window.__repos.sessions.create({
+                    title: 'Unique Session',
+                    description: 'Duplicate',
+                    created_by: 'test'
+                });
+                return null;
+            } catch (e) {
+                return e.message;
+            }
+        })()
+    """
+    )
+    assert error is not None, "Duplicate session title was allowed"
+    assert "UNIQUE" in error or "unique" in error.lower(), f"Unexpected error: {error}"
+
+    # Cleanup
+    page.evaluate(f"window.__repos.sessions.delete('{session_id}')")
+
+
+def test_collection_label_unique(page: Page, app_url: str):
+    """Duplicate collection labels are rejected by the UNIQUE constraint."""
+    _wait_for_db(page, app_url)
+
+    coll_id = page.evaluate(
+        """
+        window.__repos.collections.create({
+            label: 'Unique Collection',
+            created_by: 'test'
+        })
+    """
+    )
+    assert coll_id is not None
+
+    error = page.evaluate(
+        """
+        (async () => {
+            try {
+                await window.__repos.collections.create({
+                    label: 'Unique Collection',
+                    created_by: 'test'
+                });
+                return null;
+            } catch (e) {
+                return e.message;
+            }
+        })()
+    """
+    )
+    assert error is not None, "Duplicate collection label was allowed"
+    assert "UNIQUE" in error or "unique" in error.lower(), f"Unexpected error: {error}"
+
+    # Cleanup
+    page.evaluate(f"window.__repos.collections.delete('{coll_id}')")
+
+
+def test_suffix_crud(page: Page, app_url: str):
+    """Full CRUD cycle on the suffix table."""
+    _wait_for_db(page, app_url)
+
+    # Insert
+    page.evaluate(
+        """
+        window.__db.run(
+            "INSERT INTO suffix (user_uuid, user_name, suffix) VALUES (?, ?, ?)",
+            ['uuid-001', 'Alice', 'AL']
+        )
+    """
+    )
+
+    # Read
+    row = page.evaluate(
+        """
+        window.__db.selectAll("SELECT * FROM suffix WHERE user_uuid = 'uuid-001'")
+    """
+    )
+    assert len(row) == 1, f"Expected 1 row, got {len(row)}"
+    assert row[0]["user_uuid"] == "uuid-001"
+    assert row[0]["user_name"] == "Alice"
+    assert row[0]["suffix"] == "AL"
+
+    # Update
+    page.evaluate(
+        """
+        window.__db.run(
+            "UPDATE suffix SET suffix = ?, user_name = ? WHERE user_uuid = ?",
+            ['ALC', 'Alice C.', 'uuid-001']
+        )
+    """
+    )
+    updated = page.evaluate(
+        """
+        window.__db.selectAll("SELECT * FROM suffix WHERE user_uuid = 'uuid-001'")
+    """
+    )
+    assert updated[0]["suffix"] == "ALC"
+    assert updated[0]["user_name"] == "Alice C."
+
+    # Delete
+    page.evaluate(
+        """
+        window.__db.run("DELETE FROM suffix WHERE user_uuid = 'uuid-001'")
+    """
+    )
+    deleted = page.evaluate(
+        """
+        window.__db.selectAll("SELECT * FROM suffix WHERE user_uuid = 'uuid-001'")
+    """
+    )
+    assert len(deleted) == 0, "Suffix row still exists after deletion"
+
+
+def test_suffix_unique_constraint(page: Page, app_url: str):
+    """Duplicate suffix values are rejected by the UNIQUE constraint."""
+    _wait_for_db(page, app_url)
+
+    # Insert first
+    page.evaluate(
+        """
+        window.__db.run(
+            "INSERT INTO suffix (user_uuid, user_name, suffix) VALUES (?, ?, ?)",
+            ['uuid-100', 'Bob', 'BB']
+        )
+    """
+    )
+
+    # Try duplicate suffix with different user
+    error = page.evaluate(
+        """
+        (async () => {
+            try {
+                await window.__db.run(
+                    "INSERT INTO suffix (user_uuid, user_name, suffix) VALUES (?, ?, ?)",
+                    ['uuid-200', 'Charlie', 'BB']
+                );
+                return null;
+            } catch (e) {
+                return e.message;
+            }
+        })()
+    """
+    )
+    assert error is not None, "Duplicate suffix was allowed"
+    assert "UNIQUE" in error or "unique" in error.lower(), f"Unexpected error: {error}"
+
+    # Cleanup
+    page.evaluate("""window.__db.run("DELETE FROM suffix WHERE user_uuid = 'uuid-100'")""")
+
+
+def test_suffix_user_uuid_primary_key(page: Page, app_url: str):
+    """Duplicate user_uuid (primary key) is rejected."""
+    _wait_for_db(page, app_url)
+
+    page.evaluate(
+        """
+        window.__db.run(
+            "INSERT INTO suffix (user_uuid, user_name, suffix) VALUES (?, ?, ?)",
+            ['uuid-pk-test', 'Dave', 'DV']
+        )
+    """
+    )
+
+    error = page.evaluate(
+        """
+        (async () => {
+            try {
+                await window.__db.run(
+                    "INSERT INTO suffix (user_uuid, user_name, suffix) VALUES (?, ?, ?)",
+                    ['uuid-pk-test', 'Dave Again', 'DV2']
+                );
+                return null;
+            } catch (e) {
+                return e.message;
+            }
+        })()
+    """
+    )
+    assert error is not None, "Duplicate user_uuid was allowed"
+
+    # Cleanup
+    page.evaluate("""window.__db.run("DELETE FROM suffix WHERE user_uuid = 'uuid-pk-test'")""")
+
+
+def test_unique_constraint_allows_update(page: Page, app_url: str):
+    """Updating a record to its own title succeeds (UNIQUE constraint does not block self-update)."""
+    _wait_for_db(page, app_url)
+
+    ex_id = page.evaluate(
+        """
+        window.__repos.exercises.create({
+            title: 'Self Update Test',
+            description: '',
+            created_by: 'test'
+        })
+    """
+    )
+
+    # Update to same title should work
+    error = page.evaluate(
+        f"""
+        (async () => {{
+            try {{
+                await window.__repos.exercises.update('{ex_id}', {{
+                    title: 'Self Update Test',
+                    description: 'Updated description'
+                }});
+                return null;
+            }} catch (e) {{
+                return e.message;
+            }}
+        }})()
+    """
+    )
+    assert error is None, f"Self-update was rejected: {error}"
+
+    # Cleanup
+    page.evaluate(f"window.__repos.exercises.delete('{ex_id}')")
+
+
+def test_unique_constraint_across_updates(page: Page, app_url: str):
+    """Updating a title to match another existing title fails."""
+    _wait_for_db(page, app_url)
+
+    id_a = page.evaluate(
+        """
+        window.__repos.exercises.create({
+            title: 'Exercise A',
+            description: '',
+            created_by: 'test'
+        })
+    """
+    )
+    id_b = page.evaluate(
+        """
+        window.__repos.exercises.create({
+            title: 'Exercise B',
+            description: '',
+            created_by: 'test'
+        })
+    """
+    )
+
+    # Try to update B's title to A's title
+    error = page.evaluate(
+        f"""
+        (async () => {{
+            try {{
+                await window.__repos.exercises.update('{id_b}', {{
+                    title: 'Exercise A'
+                }});
+                return null;
+            }} catch (e) {{
+                return e.message;
+            }}
+        }})()
+    """
+    )
+    assert error is not None, "Updating to a duplicate title was allowed"
+    assert "UNIQUE" in error or "unique" in error.lower(), f"Unexpected error: {error}"
+
+    # Cleanup
+    page.evaluate(f"window.__repos.exercises.delete('{id_a}')")
+    page.evaluate(f"window.__repos.exercises.delete('{id_b}')")
diff --git a/tests/test_step3_exercises.py b/tests/test_step3_exercises.py
new file mode 100644
index 0000000..b7aa6fa
--- /dev/null
+++ b/tests/test_step3_exercises.py
@@ -0,0 +1,652 @@
+"""
+Step 3 — Exercise Management Tests
+- test_exercise_list_empty: Shows empty state when no exercises exist
+- test_create_exercise_minimal: Create exercise with only required field (title)
+- test_create_exercise_full: Create exercise with all fields filled
+- test_exercise_appears_in_list: Created exercise appears in the list with badges
+- test_exercise_detail_view: Detail view shows all exercise data
+- test_edit_exercise: Edit an exercise and verify changes
+- test_delete_exercise: Delete an exercise with confirmation
+- test_delete_exercise_cancel: Cancelling delete does not remove exercise
+- test_search_exercises: Search filters exercises by title
+- test_search_no_results: Search with no matches shows empty message
+- test_search_clear_button: Clear button empties the search field and restores the full list
+- test_validation_title_required: Empty title shows validation error
+- test_validation_negative_reps: Negative reps shows validation error
+- test_validation_negative_weight: Negative weight shows validation error
+- test_validation_invalid_url: Invalid URL format is rejected
+- test_duplicate_title_rejected: Creating exercise with duplicate title shows error
+- test_asymmetric_toggle: Asymmetric toggle shows alternation options
+- test_action_bar_buttons: New and Search buttons appear in action bar
+"""
+from playwright.sync_api import Page, expect
+
+
+def _wait_for_db(page: Page, app_url: str):
+    """Navigate and wait for the database to be ready."""
+    page.goto(app_url)
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-ready') === 'true'",
+        timeout=15000,
+    )
+
+
+def _go_to_exercises(page: Page, app_url: str):
+    """Navigate to the exercises list and wait for it to load."""
+    _wait_for_db(page, app_url)
+    page.click('a[href="#/exercises"]')
+    page.wait_for_timeout(500)
+
+
+def _clean_exercises(page: Page):
+    """Remove all exercises via the repository."""
+    page.evaluate(
+        """async () => {
+            const exercises = await window.__repos.exercises.getAll();
+            for (const ex of exercises) {
+                await window.__repos.exercises.delete(ex.id);
+            }
+        }"""
+    )
+
+
+def _create_exercise_via_ui(page: Page, title, description="", reps=0, weight=0,
+                             asymmetric=False, alternate=False,
+                             image_urls=None, video_urls=None):
+    """Fill the exercise form and save via UI."""
+    # Click New button in action bar
+    page.click('[data-testid="exercise-new-btn"]')
+    page.wait_for_selector('[data-testid="exercise-title"]')
+
+    # Fill title
+    page.fill('[data-testid="exercise-title"]', title)
+
+    # Fill description
+    if description:
+        page.fill('[data-testid="exercise-description"]', description)
+
+    # Toggle asymmetric
+    if asymmetric:
+        page.click('[data-testid="exercise-asymmetric"]')
+        if alternate:
+            page.click('[data-testid="exercise-alternate-true"]')
+        else:
+            page.click('[data-testid="exercise-alternate-false"]')
+
+    # Fill reps
+    if reps:
+        page.fill('[data-testid="exercise-reps"]', str(reps))
+
+    # Fill weight
+    if weight:
+        page.fill('[data-testid="exercise-weight"]', str(weight))
+
+    # Add image URLs
+    if image_urls:
+        for url in image_urls:
+            page.fill('[data-testid="exercise-new-image-url"]', url)
+            page.click('[data-testid="exercise-add-image-url"]')
+
+    # Add video URLs
+    if video_urls:
+        for url in video_urls:
+            page.fill('[data-testid="exercise-new-video-url"]', url)
+            page.click('[data-testid="exercise-add-video-url"]')
+
+    # Save
+    page.click('[data-testid="exercise-save"]')
+    # Wait for navigation to detail view
+    page.wait_for_selector('[data-testid="exercise-detail-title"]', timeout=5000)
+
+
+def test_exercise_list_empty(page: Page, app_url: str):
+    """Empty state is shown when no exercises exist."""
+    _go_to_exercises(page, app_url)
+    _clean_exercises(page)
+    page.reload()
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-ready') === 'true'",
+        timeout=15000,
+    )
+    page.click('a[href="#/exercises"]')
+    page.wait_for_timeout(500)
+    expect(page.locator('[data-testid="exercise-empty"]')).to_be_visible()
+
+
+def test_create_exercise_minimal(page: Page, app_url: str):
+    """Create an exercise with only the required title field."""
+    _go_to_exercises(page, app_url)
+    _clean_exercises(page)
+    page.reload()
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-ready') === 'true'",
+        timeout=15000,
+    )
+    page.click('a[href="#/exercises"]')
+    page.wait_for_timeout(500)
+
+    _create_exercise_via_ui(page, "Push-ups")
+
+    # Should be on detail view
+    expect(page.locator('[data-testid="exercise-detail-title"]')).to_have_text("Push-ups")
+
+    # Clean up
+    _clean_exercises(page)
+
+
+def test_create_exercise_full(page: Page, app_url: str):
+    """Create an exercise with all fields filled."""
+    _go_to_exercises(page, app_url)
+    _clean_exercises(page)
+    page.reload()
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-ready') === 'true'",
+        timeout=15000,
+    )
+    page.click('a[href="#/exercises"]')
+    page.wait_for_timeout(500)
+
+    _create_exercise_via_ui(
+        page,
+        title="Dumbbell Curl",
+        description="Bicep curl with dumbbell",
+        reps=12,
+        weight=10,
+        asymmetric=True,
+        alternate=True,
+        image_urls=["https://example.com/curl.jpg"],
+        video_urls=["https://www.youtube.com/watch?v=dQw4w9WgXcQ"],
+    )
+
+    # Verify detail page
+    expect(page.locator('[data-testid="exercise-detail-title"]')).to_have_text("Dumbbell Curl")
+    expect(page.locator('[data-testid="exercise-detail-description"]')).to_have_text(
+        "Bicep curl with dumbbell"
+    )
+    expect(page.locator('[data-testid="exercise-detail-reps"]')).to_contain_text("12")
+    expect(page.locator('[data-testid="exercise-detail-weight"]')).to_contain_text("10")
+    expect(page.locator('[data-testid="exercise-detail-asymmetric"]')).to_be_visible()
+
+    # Clean up
+    _clean_exercises(page)
+
+
+def test_exercise_appears_in_list(page: Page, app_url: str):
+    """Created exercise appears in the list view with correct info."""
+    _go_to_exercises(page, app_url)
+    _clean_exercises(page)
+    page.reload()
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-ready') === 'true'",
+        timeout=15000,
+    )
+    page.click('a[href="#/exercises"]')
+    page.wait_for_timeout(500)
+
+    _create_exercise_via_ui(page, title="Squats", reps=15, weight=50)
+
+    # Go back to list
+    page.click('[data-testid="exercise-back-btn"]')
+    page.wait_for_timeout(500)
+
+    # Exercise card should be visible
+    card_title = page.locator('[data-testid="exercise-card-title"]')
+    expect(card_title.first).to_have_text("Squats")
+
+    # Badges
+    expect(page.locator('[data-testid="exercise-card-reps"]').first).to_contain_text("15")
+    expect(page.locator('[data-testid="exercise-card-weight"]').first).to_contain_text("50")
+
+    # Clean up
+    _clean_exercises(page)
+
+
+def test_exercise_detail_view(page: Page, app_url: str):
+    """Detail view shows all exercise data correctly."""
+    _go_to_exercises(page, app_url)
+    _clean_exercises(page)
+
+    # Create via repo
+    exercise_id = page.evaluate(
+        """async () => {
+            const uuid = await window.__repos.settings.get('user_uuid');
+            return window.__repos.exercises.create({
+                title: 'Bench Press',
+                description: 'Chest exercise with barbell',
+                asymmetric: false,
+                alternate: false,
+                image_urls: [],
+                video_urls: [],
+                default_reps: 8,
+                default_weight: 60,
+                created_by: uuid
+            });
+        }"""
+    )
+
+    # Navigate to detail
+    page.goto(f"{app_url}/#/exercises/{exercise_id}")
+    page.wait_for_selector('[data-testid="exercise-detail-title"]', timeout=5000)
+
+    expect(page.locator('[data-testid="exercise-detail-title"]')).to_have_text("Bench Press")
+    expect(page.locator('[data-testid="exercise-detail-description"]')).to_have_text(
+        "Chest exercise with barbell"
+    )
+    expect(page.locator('[data-testid="exercise-detail-reps"]')).to_contain_text("8")
+    expect(page.locator('[data-testid="exercise-detail-weight"]')).to_contain_text("60")
+
+    # Clean up
+    _clean_exercises(page)
+
+
+def test_edit_exercise(page: Page, app_url: str):
+    """Edit an exercise and verify changes are persisted."""
+    _go_to_exercises(page, app_url)
+    _clean_exercises(page)
+    page.reload()
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-ready') === 'true'",
+        timeout=15000,
+    )
+    page.click('a[href="#/exercises"]')
+    page.wait_for_timeout(500)
+
+    _create_exercise_via_ui(page, title="Plank", reps=1, weight=0)
+
+    # Click edit button
+    page.click('[data-testid="exercise-edit-btn"]')
+    page.wait_for_selector('[data-testid="exercise-title"]')
+
+    # Change title and reps
+    page.fill('[data-testid="exercise-title"]', "Side Plank")
+    page.fill('[data-testid="exercise-reps"]', "3")
+    page.fill('[data-testid="exercise-description"]', "Hold for 30 seconds each side")
+
+    # Save
+    page.click('[data-testid="exercise-save"]')
+    page.wait_for_selector('[data-testid="exercise-detail-title"]', timeout=5000)
+
+    # Verify changes
+    expect(page.locator('[data-testid="exercise-detail-title"]')).to_have_text("Side Plank")
+    expect(page.locator('[data-testid="exercise-detail-description"]')).to_have_text(
+        "Hold for 30 seconds each side"
+    )
+    expect(page.locator('[data-testid="exercise-detail-reps"]')).to_contain_text("3")
+
+    # Clean up
+    _clean_exercises(page)
+
+
+def test_delete_exercise(page: Page, app_url: str):
+    """Delete an exercise with confirmation dialog."""
+    _go_to_exercises(page, app_url)
+    _clean_exercises(page)
+    page.reload()
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-ready') === 'true'",
+        timeout=15000,
+    )
+    page.click('a[href="#/exercises"]')
+    page.wait_for_timeout(500)
+
+    _create_exercise_via_ui(page, title="To Delete")
+
+    # Accept the confirm dialog
+    page.on("dialog", lambda dialog: dialog.accept())
+
+    # Click delete button
+    page.click('[data-testid="exercise-delete-btn"]')
+    page.wait_for_timeout(500)
+
+    # Should be back on list with empty state
+    expect(page.locator('[data-testid="exercise-empty"]')).to_be_visible()
+
+
+def test_delete_exercise_cancel(page: Page, app_url: str):
+    """Cancelling the delete dialog does not remove the exercise."""
+    _go_to_exercises(page, app_url)
+    _clean_exercises(page)
+    page.reload()
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-ready') === 'true'",
+        timeout=15000,
+    )
+    page.click('a[href="#/exercises"]')
+    page.wait_for_timeout(500)
+
+    _create_exercise_via_ui(page, title="Keep Me")
+
+    # Dismiss the confirm dialog
+    page.on("dialog", lambda dialog: dialog.dismiss())
+
+    # Click delete button
+    page.click('[data-testid="exercise-delete-btn"]')
+    page.wait_for_timeout(500)
+
+    # Exercise should still be shown
+    expect(page.locator('[data-testid="exercise-detail-title"]')).to_have_text("Keep Me")
+
+    # Clean up
+    _clean_exercises(page)
+
+
+def test_search_exercises(page: Page, app_url: str):
+    """Search filters exercises by title."""
+    _go_to_exercises(page, app_url)
+    _clean_exercises(page)
+
+    # Create multiple exercises via repo
+    page.evaluate(
+        """async () => {
+            const uuid = await window.__repos.settings.get('user_uuid');
+            await window.__repos.exercises.create({
+                title: 'Push-ups', description: '', asymmetric: false, alternate: false,
+                image_urls: [], video_urls: [], default_reps: 10, default_weight: 0,
+                created_by: uuid
+            });
+            await window.__repos.exercises.create({
+                title: 'Pull-ups', description: '', asymmetric: false, alternate: false,
+                image_urls: [], video_urls: [], default_reps: 8, default_weight: 0,
+                created_by: uuid
+            });
+            await window.__repos.exercises.create({
+                title: 'Squats', description: '', asymmetric: false, alternate: false,
+                image_urls: [], video_urls: [], default_reps: 15, default_weight: 0,
+                created_by: uuid
+            });
+        }"""
+    )
+
+    # Reload exercises list
+    page.reload()
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-ready') === 'true'",
+        timeout=15000,
+    )
+    page.click('a[href="#/exercises"]')
+    page.wait_for_timeout(500)
+
+    # All 3 should be visible
+    expect(page.locator('[data-testid="exercise-card-title"]')).to_have_count(3)
+
+    # Toggle search
+    page.click('[data-testid="exercise-search-toggle"]')
+    page.wait_for_selector('[data-testid="exercise-search-input"]')
+
+    # Type search query
+    page.fill('[data-testid="exercise-search-input"]', "ups")
+    page.wait_for_timeout(500)
+
+    # Only Push-ups and Pull-ups should be visible
+    expect(page.locator('[data-testid="exercise-card-title"]')).to_have_count(2)
+
+    # Clean up
+    _clean_exercises(page)
+
+
+def test_search_no_results(page: Page, app_url: str):
+    """Search with no matches shows no-results message."""
+    _go_to_exercises(page, app_url)
+    _clean_exercises(page)
+
+    # Create one exercise
+    page.evaluate(
+        """async () => {
+            const uuid = await window.__repos.settings.get('user_uuid');
+            await window.__repos.exercises.create({
+                title: 'Push-ups', description: '', asymmetric: false, alternate: false,
+                image_urls: [], video_urls: [], default_reps: 10, default_weight: 0,
+                created_by: uuid
+            });
+        }"""
+    )
+
+    page.reload()
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-ready') === 'true'",
+        timeout=15000,
+    )
+    page.click('a[href="#/exercises"]')
+    page.wait_for_timeout(500)
+
+    # Toggle search and type non-matching query
+    page.click('[data-testid="exercise-search-toggle"]')
+    page.fill('[data-testid="exercise-search-input"]', "zzzznotfound")
+    page.wait_for_timeout(500)
+
+    expect(page.locator('[data-testid="exercise-no-results"]')).to_be_visible()
+
+    # Clean up
+    _clean_exercises(page)
+
+
+def test_search_clear_button(page: Page, app_url: str):
+    """Clear button empties the search field and restores the full list."""
+    _go_to_exercises(page, app_url)
+    _clean_exercises(page)
+
+    page.evaluate(
+        """async () => {
+            const uuid = await window.__repos.settings.get('user_uuid');
+            await window.__repos.exercises.create({
+                title: 'Push-ups', description: '', asymmetric: false, alternate: false,
+                image_urls: [], video_urls: [], default_reps: 10, default_weight: 0,
+                created_by: uuid
+            });
+            await window.__repos.exercises.create({
+                title: 'Squats', description: '', asymmetric: false, alternate: false,
+                image_urls: [], video_urls: [], default_reps: 15, default_weight: 0,
+                created_by: uuid
+            });
+        }"""
+    )
+
+    page.reload()
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-ready') === 'true'",
+        timeout=15000,
+    )
+    page.click('a[href="#/exercises"]')
+    page.wait_for_timeout(500)
+
+    page.click('[data-testid="exercise-search-toggle"]')
+
+    # Clear button is hidden until there is text in the field
+    expect(page.locator('[data-testid="exercise-search-clear"]')).not_to_be_visible()
+
+    page.fill('[data-testid="exercise-search-input"]', "Push")
+    page.wait_for_timeout(500)
+    expect(page.locator('[data-testid="exercise-card-title"]')).to_have_count(1)
+
+    # Clicking the clear button empties the field and restores the full list
+    page.click('[data-testid="exercise-search-clear"]')
+    expect(page.locator('[data-testid="exercise-search-input"]')).to_have_value("")
+    page.wait_for_timeout(500)
+    expect(page.locator('[data-testid="exercise-card-title"]')).to_have_count(2)
+
+    # Search field keeps focus after clearing
+    expect(page.locator('[data-testid="exercise-search-input"]')).to_be_focused()
+
+    # Clean up
+    _clean_exercises(page)
+
+
+def test_validation_title_required(page: Page, app_url: str):
+    """Empty title shows validation error and prevents save."""
+    _go_to_exercises(page, app_url)
+    _clean_exercises(page)
+    page.reload()
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-ready') === 'true'",
+        timeout=15000,
+    )
+    page.click('a[href="#/exercises"]')
+    page.wait_for_timeout(500)
+
+    # Click New
+    page.click('[data-testid="exercise-new-btn"]')
+    page.wait_for_selector('[data-testid="exercise-title"]')
+
+    # Leave title empty, click Save
+    page.click('[data-testid="exercise-save"]')
+
+    # Error should appear
+    expect(page.locator('[data-testid="exercise-title-error"]')).to_be_visible()
+
+    # Should still be on the form (not navigated away)
+    expect(page.locator('[data-testid="exercise-title"]')).to_be_visible()
+
+
+def test_validation_negative_reps(page: Page, app_url: str):
+    """Negative reps shows validation error."""
+    _go_to_exercises(page, app_url)
+    _clean_exercises(page)
+    page.reload()
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-ready') === 'true'",
+        timeout=15000,
+    )
+    page.click('a[href="#/exercises"]')
+    page.wait_for_timeout(500)
+
+    page.click('[data-testid="exercise-new-btn"]')
+    page.wait_for_selector('[data-testid="exercise-title"]')
+
+    page.fill('[data-testid="exercise-title"]', "Test Exercise")
+    page.fill('[data-testid="exercise-reps"]', "-5")
+    page.click('[data-testid="exercise-save"]')
+
+    expect(page.locator('[data-testid="exercise-reps-error"]')).to_be_visible()
+
+
+def test_validation_negative_weight(page: Page, app_url: str):
+    """Negative weight shows validation error."""
+    _go_to_exercises(page, app_url)
+    _clean_exercises(page)
+    page.reload()
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-ready') === 'true'",
+        timeout=15000,
+    )
+    page.click('a[href="#/exercises"]')
+    page.wait_for_timeout(500)
+
+    page.click('[data-testid="exercise-new-btn"]')
+    page.wait_for_selector('[data-testid="exercise-title"]')
+
+    page.fill('[data-testid="exercise-title"]', "Test Exercise")
+    page.fill('[data-testid="exercise-weight"]', "-10")
+    page.click('[data-testid="exercise-save"]')
+
+    expect(page.locator('[data-testid="exercise-weight-error"]')).to_be_visible()
+
+
+def test_validation_invalid_url(page: Page, app_url: str):
+    """Invalid URL format is rejected when adding an image URL."""
+    _go_to_exercises(page, app_url)
+    _clean_exercises(page)
+    page.reload()
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-ready') === 'true'",
+        timeout=15000,
+    )
+    page.click('a[href="#/exercises"]')
+    page.wait_for_timeout(500)
+
+    page.click('[data-testid="exercise-new-btn"]')
+    page.wait_for_selector('[data-testid="exercise-title"]')
+
+    # Try adding an invalid URL
+    page.fill('[data-testid="exercise-new-image-url"]', "not-a-url")
+    page.click('[data-testid="exercise-add-image-url"]')
+
+    expect(page.locator('[data-testid="exercise-image-url-error"]')).to_be_visible()
+
+
+def test_duplicate_title_rejected(page: Page, app_url: str):
+    """Creating an exercise with a duplicate title shows an error."""
+    _go_to_exercises(page, app_url)
+    _clean_exercises(page)
+    page.reload()
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-ready') === 'true'",
+        timeout=15000,
+    )
+    page.click('a[href="#/exercises"]')
+    page.wait_for_timeout(500)
+
+    # Create first exercise
+    _create_exercise_via_ui(page, title="Unique Exercise")
+
+    # Go back to list
+    page.click('[data-testid="exercise-back-btn"]')
+    page.wait_for_timeout(500)
+
+    # Try to create another with the same title
+    page.click('[data-testid="exercise-new-btn"]')
+    page.wait_for_selector('[data-testid="exercise-title"]')
+    page.fill('[data-testid="exercise-title"]', "Unique Exercise")
+    page.click('[data-testid="exercise-save"]')
+    page.wait_for_timeout(500)
+
+    # Should show error (title error or save error)
+    title_error_visible = page.locator('[data-testid="exercise-title-error"]').is_visible()
+    save_error_visible = page.locator('[data-testid="exercise-save-error"]').is_visible()
+    assert title_error_visible or save_error_visible, "Expected duplicate title error"
+
+    # Clean up
+    page.goto(app_url)
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-ready') === 'true'",
+        timeout=15000,
+    )
+    _clean_exercises(page)
+
+
+def test_asymmetric_toggle(page: Page, app_url: str):
+    """Asymmetric toggle shows/hides alternation radio buttons."""
+    _go_to_exercises(page, app_url)
+    _clean_exercises(page)
+    page.reload()
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-ready') === 'true'",
+        timeout=15000,
+    )
+    page.click('a[href="#/exercises"]')
+    page.wait_for_timeout(500)
+
+    page.click('[data-testid="exercise-new-btn"]')
+    page.wait_for_selector('[data-testid="exercise-title"]')
+
+    # Alternate options should not be visible initially
+    expect(page.locator('[data-testid="exercise-alternate-true"]')).not_to_be_visible()
+    expect(page.locator('[data-testid="exercise-alternate-false"]')).not_to_be_visible()
+
+    # Toggle asymmetric
+    page.click('[data-testid="exercise-asymmetric"]')
+
+    # Alternate options should now be visible
+    expect(page.locator('[data-testid="exercise-alternate-true"]')).to_be_visible()
+    expect(page.locator('[data-testid="exercise-alternate-false"]')).to_be_visible()
+
+    # Untoggle asymmetric
+    page.click('[data-testid="exercise-asymmetric"]')
+
+    # Alternate options should be hidden again
+    expect(page.locator('[data-testid="exercise-alternate-true"]')).not_to_be_visible()
+
+
+def test_action_bar_buttons(page: Page, app_url: str):
+    """New and Search buttons are visible in the action bar on the exercise list."""
+    _go_to_exercises(page, app_url)
+    _clean_exercises(page)
+    page.reload()
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-ready') === 'true'",
+        timeout=15000,
+    )
+    page.click('a[href="#/exercises"]')
+    page.wait_for_timeout(500)
+
+    expect(page.locator('[data-testid="exercise-new-btn"]')).to_be_visible()
+    expect(page.locator('[data-testid="exercise-search-toggle"]')).to_be_visible()
diff --git a/tests/test_step3b_exercise_export_import.py b/tests/test_step3b_exercise_export_import.py
new file mode 100644
index 0000000..48189a5
--- /dev/null
+++ b/tests/test_step3b_exercise_export_import.py
@@ -0,0 +1,1254 @@
+"""
+Step 3b — Exercise JSON Export/Import Tests
+- test_export_button_visible: Export button is visible on exercise list
+- test_export_single_button_visible: Export button is visible on exercise detail
+- test_export_import_roundtrip: Export exercises then import them back (no collision)
+- test_import_invalid_json: Import rejects non-JSON file
+- test_import_wrong_app: Import rejects file from different app
+- test_same_user_collision_skip: Same-user import with skip action
+- test_same_user_collision_replace: Same-user import with replace action
+- test_same_user_collision_batch_replace_all: Batch replace all collisions
+- test_same_user_collision_batch_skip_all: Batch skip all collisions
+- test_different_user_suffix_prompt: Different-user import shows suffix prompt
+- test_different_user_import_with_suffix: Different-user import adds suffix to titles
+- test_different_user_update_same_id: Same external user same ID treated as update
+- test_settings_export_filter_dialog: Settings export opens filter dialog
+- test_settings_import_button: Settings import button works
+- test_suffix_management_visible: Suffix section visible after import from different user
+- test_suffix_rename_cascade: Renaming suffix updates titles across exercises
+- test_suffix_delete: Suffix can be deleted from settings
+- test_import_as_mine_button_visible: Import-as-mine buttons visible on exercises and settings
+- test_import_as_mine_no_suffix_no_collision: Foreign exercises imported as own without suffix
+- test_import_as_mine_collision_replace: Import-as-mine with collision uses replace action
+- test_import_as_mine_collision_skip: Import-as-mine with collision uses skip action
+- test_import_as_mine_from_settings: Import-as-mine button works from settings page
+- test_import_as_mine_dialog_title: Import-as-mine shows correct dialog title
+"""
+import json
+from playwright.sync_api import Page, expect
+
+
+def _wait_for_db(page: Page, app_url: str):
+    """Navigate and wait for the database to be ready."""
+    page.goto(app_url)
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-ready') === 'true'",
+        timeout=15000,
+    )
+
+
+def _go_to_exercises(page: Page, app_url: str):
+    """Navigate to the exercises list and wait for it to load."""
+    _wait_for_db(page, app_url)
+    page.click('a[href="#/exercises"]')
+    page.wait_for_timeout(500)
+
+
+def _go_to_settings(page: Page, app_url: str):
+    """Navigate to the settings page."""
+    _wait_for_db(page, app_url)
+    page.click('a[href="#/settings"]')
+    page.wait_for_timeout(500)
+
+
+def _clean_all(page: Page):
+    """Remove all exercises and suffixes via the repositories."""
+    page.evaluate(
+        """async () => {
+            const exercises = await window.__repos.exercises.getAll();
+            for (const ex of exercises) {
+                await window.__repos.exercises.delete(ex.id);
+            }
+            const suffixes = await window.__repos.suffixes.getAll();
+            for (const s of suffixes) {
+                await window.__repos.suffixes.delete(s.user_uuid);
+            }
+        }"""
+    )
+
+
+def _create_exercise_directly(page: Page, title, created_by=None, exercise_id=None):
+    """Create an exercise directly via repository for test setup."""
+    return page.evaluate(
+        """async ([title, createdBy, exerciseId]) => {
+            const uuid = await window.__repos.settings.get('user_uuid');
+            const cb = createdBy || uuid;
+            if (exerciseId) {
+                await window.__repos.exercises.createWithId(exerciseId, {
+                    title: title,
+                    description: 'Test desc',
+                    asymmetric: false,
+                    alternate: false,
+                    image_urls: [],
+                    video_urls: [],
+                    default_reps: 10,
+                    default_weight: 20,
+                    created_by: cb,
+                });
+                return exerciseId;
+            } else {
+                const id = await window.__repos.exercises.create({
+                    title: title,
+                    description: 'Test desc',
+                    asymmetric: false,
+                    alternate: false,
+                    image_urls: [],
+                    video_urls: [],
+                    default_reps: 10,
+                    default_weight: 20,
+                    created_by: cb,
+                });
+                return id;
+            }
+        }""",
+        [title, created_by, exercise_id],
+    )
+
+
+def _build_export_json(exercises, exporter_name="Test User", exporter_uuid=None):
+    """Build a valid export JSON envelope for testing."""
+    envelope = {
+        "metadata": {
+            "appName": "trainus",
+            "appVersion": "1.0.0",
+            "schemaVersion": 1,
+            "exportDate": "2026-03-30T12:00:00.000Z",
+            "exportedBy": {
+                "name": exporter_name,
+                "uuid": exporter_uuid or "test-uuid-1234",
+            },
+        },
+        "data": {"exercises": exercises},
+    }
+    return json.dumps(envelope)
+
+
+def _get_local_uuid(page: Page):
+    """Get the local user UUID."""
+    return page.evaluate(
+        "async () => await window.__repos.settings.get('user_uuid')"
+    )
+
+
+def _trigger_import_with_json(page: Page, json_str: str):
+    """Trigger the import flow by injecting a file into the file picker.
+
+    This uses a file chooser event listener to intercept the file picker
+    and inject the JSON content.
+    """
+    with page.expect_file_chooser() as fc_info:
+        page.click('[data-testid="exercise-import-btn"]')
+    file_chooser = fc_info.value
+    file_chooser.set_files(
+        [
+            {
+                "name": "test-import.json",
+                "mimeType": "application/json",
+                "buffer": json_str.encode("utf-8"),
+            }
+        ]
+    )
+
+
+def _trigger_settings_import_with_json(page: Page, json_str: str):
+    """Trigger import from settings page."""
+    with page.expect_file_chooser() as fc_info:
+        page.click('[data-testid="settings-import"]')
+    file_chooser = fc_info.value
+    file_chooser.set_files(
+        [
+            {
+                "name": "test-import.json",
+                "mimeType": "application/json",
+                "buffer": json_str.encode("utf-8"),
+            }
+        ]
+    )
+
+
+def _trigger_import_as_mine_with_json(page: Page, json_str: str):
+    """Trigger the 'import as mine' flow from the exercises action bar."""
+    with page.expect_file_chooser() as fc_info:
+        page.click('[data-testid="exercise-import-as-mine-btn"]')
+    file_chooser = fc_info.value
+    file_chooser.set_files(
+        [
+            {
+                "name": "test-import.json",
+                "mimeType": "application/json",
+                "buffer": json_str.encode("utf-8"),
+            }
+        ]
+    )
+
+
+def _trigger_settings_import_as_mine_with_json(page: Page, json_str: str):
+    """Trigger 'import as mine' from settings page."""
+    with page.expect_file_chooser() as fc_info:
+        page.click('[data-testid="settings-import-as-mine"]')
+    file_chooser = fc_info.value
+    file_chooser.set_files(
+        [
+            {
+                "name": "test-import.json",
+                "mimeType": "application/json",
+                "buffer": json_str.encode("utf-8"),
+            }
+        ]
+    )
+
+
+# ============================================================
+# Tests
+# ============================================================
+
+
+def test_export_button_visible(page: Page, app_url: str):
+    """Export button is visible on the exercise list action bar."""
+    _go_to_exercises(page, app_url)
+    _clean_all(page)
+    expect(page.locator('[data-testid="exercise-export-btn"]')).to_be_visible()
+    expect(page.locator('[data-testid="exercise-import-btn"]')).to_be_visible()
+
+
+def test_export_single_button_visible(page: Page, app_url: str):
+    """Export button is visible on exercise detail view."""
+    _go_to_exercises(page, app_url)
+    _clean_all(page)
+    ex_id = _create_exercise_directly(page, "Export Test Exercise")
+    page.reload()
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-ready') === 'true'",
+        timeout=15000,
+    )
+    page.click('a[href="#/exercises"]')
+    page.wait_for_timeout(500)
+    page.click(f'[data-testid="exercise-card-{ex_id}"]')
+    page.wait_for_timeout(500)
+    expect(
+        page.locator('[data-testid="exercise-export-single-btn"]')
+    ).to_be_visible()
+    # Cleanup
+    _go_to_exercises(page, app_url)
+    _clean_all(page)
+
+
+def test_export_import_roundtrip(page: Page, app_url: str):
+    """Export exercises to JSON, clear DB, import them back, verify they exist."""
+    _go_to_exercises(page, app_url)
+    _clean_all(page)
+
+    # Create exercises
+    _create_exercise_directly(page, "Roundtrip Exercise A")
+    _create_exercise_directly(page, "Roundtrip Exercise B")
+
+    # Get the export data by building it from the repo directly
+    local_uuid = _get_local_uuid(page)
+    exercises = page.evaluate(
+        "async () => await window.__repos.exercises.getAll()"
+    )
+
+    # Clean exercises
+    _clean_all(page)
+
+    # Build import JSON with the local user UUID (same user)
+    json_str = _build_export_json(
+        exercises,
+        exporter_name="Local User",
+        exporter_uuid=local_uuid,
+    )
+
+    # Reload page so it picks up the clean state
+    page.reload()
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-ready') === 'true'",
+        timeout=15000,
+    )
+    page.click('a[href="#/exercises"]')
+    page.wait_for_timeout(500)
+
+    # Trigger import
+    _trigger_import_with_json(page, json_str)
+
+    # Should see preview step (no collisions)
+    page.wait_for_selector('[data-testid="import-preview-step"]', timeout=5000)
+    expect(page.locator('[data-testid="import-preview-step"]')).to_be_visible()
+
+    # Click import
+    page.click('[data-testid="import-apply"]')
+
+    # Should see report
+    page.wait_for_selector('[data-testid="import-report-step"]', timeout=5000)
+    expect(page.locator('[data-testid="import-report-imported"]')).to_be_visible()
+
+    # Close dialog
+    page.click('[data-testid="import-done"]')
+
+    # Verify exercises exist
+    page.wait_for_timeout(500)
+    expect(page.locator('[data-testid="exercise-card-title"]')).to_have_count(2)
+
+    # Cleanup
+    _clean_all(page)
+
+
+def test_import_invalid_json(page: Page, app_url: str):
+    """Import rejects a file with invalid JSON content."""
+    _go_to_exercises(page, app_url)
+    _clean_all(page)
+
+    # Trigger import with invalid JSON
+    page.on("dialog", lambda d: d.accept())
+
+    with page.expect_file_chooser() as fc_info:
+        page.click('[data-testid="exercise-import-btn"]')
+    file_chooser = fc_info.value
+    file_chooser.set_files(
+        [
+            {
+                "name": "bad.json",
+                "mimeType": "application/json",
+                "buffer": b"this is not json",
+            }
+        ]
+    )
+
+    # An alert dialog should appear (handled by dialog listener)
+    page.wait_for_timeout(1000)
+
+    # The import dialog should NOT be visible
+    expect(page.locator('[data-testid="modal-overlay"]')).not_to_be_visible()
+
+    # Cleanup
+    _clean_all(page)
+
+
+def test_import_wrong_app(page: Page, app_url: str):
+    """Import rejects a file from a different application."""
+    _go_to_exercises(page, app_url)
+    _clean_all(page)
+
+    bad_envelope = json.dumps(
+        {
+            "metadata": {
+                "appName": "other-app",
+                "appVersion": "1.0.0",
+                "schemaVersion": 1,
+                "exportDate": "2026-03-30T12:00:00.000Z",
+                "exportedBy": {"name": "Test", "uuid": "abc"},
+            },
+            "data": {"exercises": []},
+        }
+    )
+
+    page.on("dialog", lambda d: d.accept())
+
+    with page.expect_file_chooser() as fc_info:
+        page.click('[data-testid="exercise-import-btn"]')
+    file_chooser = fc_info.value
+    file_chooser.set_files(
+        [
+            {
+                "name": "wrong.json",
+                "mimeType": "application/json",
+                "buffer": bad_envelope.encode("utf-8"),
+            }
+        ]
+    )
+
+    page.wait_for_timeout(1000)
+    expect(page.locator('[data-testid="modal-overlay"]')).not_to_be_visible()
+
+    _clean_all(page)
+
+
+def test_same_user_collision_skip(page: Page, app_url: str):
+    """Same-user import with 'skip' action keeps the existing exercise."""
+    _go_to_exercises(page, app_url)
+    _clean_all(page)
+
+    local_uuid = _get_local_uuid(page)
+    ex_id = _create_exercise_directly(page, "Collision Exercise")
+
+    # Build import with same ID but different description
+    exercises = [
+        {
+            "id": ex_id,
+            "title": "Collision Exercise",
+            "description": "Imported version",
+            "asymmetric": False,
+            "alternate": False,
+            "image_urls": [],
+            "video_urls": [],
+            "default_reps": 99,
+            "default_weight": 99,
+            "created_by": local_uuid,
+        }
+    ]
+    json_str = _build_export_json(exercises, "Local User", local_uuid)
+
+    page.reload()
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-ready') === 'true'",
+        timeout=15000,
+    )
+    page.click('a[href="#/exercises"]')
+    page.wait_for_timeout(500)
+
+    _trigger_import_with_json(page, json_str)
+
+    # Should see collisions step
+    page.wait_for_selector(
+        '[data-testid="import-collisions-step"]', timeout=5000
+    )
+
+    # Default is skip, so just click apply
+    page.click('[data-testid="import-apply"]')
+
+    # Should see report with skipped
+    page.wait_for_selector('[data-testid="import-report-step"]', timeout=5000)
+    expect(page.locator('[data-testid="import-report-skipped"]')).to_be_visible()
+
+    page.click('[data-testid="import-done"]')
+
+    # Verify original exercise is unchanged (10 reps, not 99)
+    exercise_data = page.evaluate(
+        f"""async () => await window.__repos.exercises.getById('{ex_id}')"""
+    )
+    assert exercise_data["default_reps"] == 10
+
+    _clean_all(page)
+
+
+def test_same_user_collision_replace(page: Page, app_url: str):
+    """Same-user import with 'replace' action overwrites the existing exercise."""
+    _go_to_exercises(page, app_url)
+    _clean_all(page)
+
+    local_uuid = _get_local_uuid(page)
+    ex_id = _create_exercise_directly(page, "Replace Exercise")
+
+    exercises = [
+        {
+            "id": ex_id,
+            "title": "Replace Exercise",
+            "description": "Replaced version",
+            "asymmetric": False,
+            "alternate": False,
+            "image_urls": [],
+            "video_urls": [],
+            "default_reps": 99,
+            "default_weight": 99,
+            "created_by": local_uuid,
+        }
+    ]
+    json_str = _build_export_json(exercises, "Local User", local_uuid)
+
+    page.reload()
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-ready') === 'true'",
+        timeout=15000,
+    )
+    page.click('a[href="#/exercises"]')
+    page.wait_for_timeout(500)
+
+    _trigger_import_with_json(page, json_str)
+
+    page.wait_for_selector(
+        '[data-testid="import-collisions-step"]', timeout=5000
+    )
+
+    # Click replace on the first collision (exercise-specific testid)
+    page.click('[data-testid="collision-replace-exercise-0"]')
+
+    page.click('[data-testid="import-apply"]')
+
+    page.wait_for_selector('[data-testid="import-report-step"]', timeout=5000)
+    expect(page.locator('[data-testid="import-report-exercises-replaced"]')).to_be_visible()
+
+    page.click('[data-testid="import-done"]')
+
+    # Verify exercise was replaced (99 reps now)
+    exercise_data = page.evaluate(
+        f"""async () => await window.__repos.exercises.getById('{ex_id}')"""
+    )
+    assert exercise_data["default_reps"] == 99
+
+    _clean_all(page)
+
+
+def test_same_user_collision_batch_replace_all(page: Page, app_url: str):
+    """Batch 'Replace All' replaces all collisions at once."""
+    _go_to_exercises(page, app_url)
+    _clean_all(page)
+
+    local_uuid = _get_local_uuid(page)
+    id_a = _create_exercise_directly(page, "Batch A")
+    id_b = _create_exercise_directly(page, "Batch B")
+
+    exercises = [
+        {
+            "id": id_a,
+            "title": "Batch A",
+            "description": "Replaced A",
+            "asymmetric": False,
+            "alternate": False,
+            "image_urls": [],
+            "video_urls": [],
+            "default_reps": 77,
+            "default_weight": 77,
+            "created_by": local_uuid,
+        },
+        {
+            "id": id_b,
+            "title": "Batch B",
+            "description": "Replaced B",
+            "asymmetric": False,
+            "alternate": False,
+            "image_urls": [],
+            "video_urls": [],
+            "default_reps": 88,
+            "default_weight": 88,
+            "created_by": local_uuid,
+        },
+    ]
+    json_str = _build_export_json(exercises, "Local User", local_uuid)
+
+    page.reload()
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-ready') === 'true'",
+        timeout=15000,
+    )
+    page.click('a[href="#/exercises"]')
+    page.wait_for_timeout(500)
+
+    _trigger_import_with_json(page, json_str)
+
+    page.wait_for_selector(
+        '[data-testid="import-collisions-step"]', timeout=5000
+    )
+
+    # Click Replace All (exercise-specific testid)
+    page.click('[data-testid="exercise-replace-all"]')
+    page.click('[data-testid="import-apply"]')
+
+    page.wait_for_selector('[data-testid="import-report-step"]', timeout=5000)
+    expect(page.locator('[data-testid="import-report-exercises-replaced"]')).to_contain_text("2")
+
+    page.click('[data-testid="import-done"]')
+
+    # Verify both replaced
+    ex_a = page.evaluate(
+        f"""async () => await window.__repos.exercises.getById('{id_a}')"""
+    )
+    ex_b = page.evaluate(
+        f"""async () => await window.__repos.exercises.getById('{id_b}')"""
+    )
+    assert ex_a["default_reps"] == 77
+    assert ex_b["default_reps"] == 88
+
+    _clean_all(page)
+
+
+def test_same_user_collision_batch_skip_all(page: Page, app_url: str):
+    """Batch 'Skip All' skips all collisions."""
+    _go_to_exercises(page, app_url)
+    _clean_all(page)
+
+    local_uuid = _get_local_uuid(page)
+    id_a = _create_exercise_directly(page, "Skip A")
+    id_b = _create_exercise_directly(page, "Skip B")
+
+    exercises = [
+        {
+            "id": id_a,
+            "title": "Skip A",
+            "description": "Should not replace",
+            "asymmetric": False,
+            "alternate": False,
+            "image_urls": [],
+            "video_urls": [],
+            "default_reps": 99,
+            "default_weight": 99,
+            "created_by": local_uuid,
+        },
+        {
+            "id": id_b,
+            "title": "Skip B",
+            "description": "Should not replace",
+            "asymmetric": False,
+            "alternate": False,
+            "image_urls": [],
+            "video_urls": [],
+            "default_reps": 99,
+            "default_weight": 99,
+            "created_by": local_uuid,
+        },
+    ]
+    json_str = _build_export_json(exercises, "Local User", local_uuid)
+
+    page.reload()
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-ready') === 'true'",
+        timeout=15000,
+    )
+    page.click('a[href="#/exercises"]')
+    page.wait_for_timeout(500)
+
+    _trigger_import_with_json(page, json_str)
+
+    page.wait_for_selector(
+        '[data-testid="import-collisions-step"]', timeout=5000
+    )
+
+    # Click Skip All (exercise-specific testid)
+    page.click('[data-testid="exercise-skip-all"]')
+    page.click('[data-testid="import-apply"]')
+
+    page.wait_for_selector('[data-testid="import-report-step"]', timeout=5000)
+    expect(page.locator('[data-testid="import-report-skipped"]')).to_contain_text("2")
+
+    page.click('[data-testid="import-done"]')
+
+    # Verify originals unchanged
+    ex_a = page.evaluate(
+        f"""async () => await window.__repos.exercises.getById('{id_a}')"""
+    )
+    assert ex_a["default_reps"] == 10
+
+    _clean_all(page)
+
+
+def test_different_user_suffix_prompt(page: Page, app_url: str):
+    """Importing from a different user shows the suffix prompt."""
+    _go_to_exercises(page, app_url)
+    _clean_all(page)
+
+    other_uuid = "other-user-uuid-9999"
+    exercises = [
+        {
+            "id": "ext-exercise-id-1",
+            "title": "External Push-ups",
+            "description": "From another user",
+            "asymmetric": False,
+            "alternate": False,
+            "image_urls": [],
+            "video_urls": [],
+            "default_reps": 15,
+            "default_weight": 0,
+            "created_by": other_uuid,
+        }
+    ]
+    json_str = _build_export_json(exercises, "Jane Doe", other_uuid)
+
+    _trigger_import_with_json(page, json_str)
+
+    # Should see suffix step
+    page.wait_for_selector('[data-testid="import-suffix-step"]', timeout=5000)
+    expect(page.locator('[data-testid="import-suffix-input"]')).to_be_visible()
+
+    # Cancel
+    page.click('[data-testid="import-cancel"]')
+
+    _clean_all(page)
+
+
+def test_different_user_import_with_suffix(page: Page, app_url: str):
+    """Different-user import applies suffix to titles."""
+    _go_to_exercises(page, app_url)
+    _clean_all(page)
+
+    other_uuid = "other-user-uuid-8888"
+    exercises = [
+        {
+            "id": "ext-exercise-suffix-1",
+            "title": "Squats",
+            "description": "External exercise",
+            "asymmetric": False,
+            "alternate": False,
+            "image_urls": [],
+            "video_urls": [],
+            "default_reps": 20,
+            "default_weight": 50,
+            "created_by": other_uuid,
+        }
+    ]
+    json_str = _build_export_json(exercises, "Bob Smith", other_uuid)
+
+    _trigger_import_with_json(page, json_str)
+
+    # Suffix step
+    page.wait_for_selector('[data-testid="import-suffix-step"]', timeout=5000)
+
+    # Clear and type new suffix
+    page.fill('[data-testid="import-suffix-input"]', "BS")
+    page.click('[data-testid="import-suffix-confirm"]')
+
+    # Preview step
+    page.wait_for_selector('[data-testid="import-preview-step"]', timeout=5000)
+    page.click('[data-testid="import-apply"]')
+
+    # Report
+    page.wait_for_selector('[data-testid="import-report-step"]', timeout=5000)
+    expect(page.locator('[data-testid="import-report-imported"]')).to_be_visible()
+    page.click('[data-testid="import-done"]')
+
+    # Verify title has suffix
+    page.wait_for_timeout(500)
+    titles = page.locator('[data-testid="exercise-card-title"]')
+    expect(titles).to_have_count(1)
+    expect(titles.first).to_contain_text("Squats [BS]")
+
+    _clean_all(page)
+
+
+def test_different_user_update_same_id(page: Page, app_url: str):
+    """Same external user, same ID is treated as an update (no new ID)."""
+    _go_to_exercises(page, app_url)
+    _clean_all(page)
+
+    other_uuid = "other-user-uuid-7777"
+    ext_id = "ext-update-id-1"
+
+    # First, create the exercise as if it was previously imported
+    _create_exercise_directly(page, "Lunges [JD]", other_uuid, ext_id)
+
+    # Also register the suffix
+    page.evaluate(
+        """async ([uuid]) => {
+            await window.__repos.suffixes.create({
+                user_uuid: uuid,
+                user_name: 'John Doe',
+                suffix: 'JD',
+            });
+        }""",
+        [other_uuid],
+    )
+
+    # Import update with same external user + same ID
+    exercises = [
+        {
+            "id": ext_id,
+            "title": "Lunges",
+            "description": "Updated version",
+            "asymmetric": True,
+            "alternate": False,
+            "image_urls": [],
+            "video_urls": [],
+            "default_reps": 30,
+            "default_weight": 15,
+            "created_by": other_uuid,
+        }
+    ]
+    json_str = _build_export_json(exercises, "John Doe", other_uuid)
+
+    page.reload()
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-ready') === 'true'",
+        timeout=15000,
+    )
+    page.click('a[href="#/exercises"]')
+    page.wait_for_timeout(500)
+
+    _trigger_import_with_json(page, json_str)
+
+    # Should skip suffix prompt (already registered) and go to preview
+    page.wait_for_selector('[data-testid="import-preview-step"]', timeout=5000)
+    page.click('[data-testid="import-apply"]')
+
+    page.wait_for_selector('[data-testid="import-report-step"]', timeout=5000)
+    expect(page.locator('[data-testid="import-report-exercises-updated"]')).to_be_visible()
+    page.click('[data-testid="import-done"]')
+
+    # Verify exercise was updated (same ID, new data)
+    exercise = page.evaluate(
+        f"""async () => await window.__repos.exercises.getById('{ext_id}')"""
+    )
+    assert exercise is not None
+    assert exercise["default_reps"] == 30
+    assert exercise["title"] == "Lunges [JD]"
+
+    _clean_all(page)
+
+
+def test_settings_export_filter_dialog(page: Page, app_url: str):
+    """Settings export button opens the filter dialog."""
+    _go_to_settings(page, app_url)
+    _clean_all(page)
+
+    page.click('[data-testid="settings-export"]')
+
+    page.wait_for_selector('[data-testid="modal-card"]', timeout=5000)
+    expect(page.locator('[data-testid="export-filter-exercises"]')).to_be_visible()
+    expect(page.locator('[data-testid="export-filter-combos"]')).to_be_visible()
+    expect(page.locator('[data-testid="export-filter-sessions"]')).to_be_visible()
+    expect(page.locator('[data-testid="export-filter-collections"]')).to_be_visible()
+    expect(page.locator('[data-testid="export-filter-execution-logs"]')).to_be_visible()
+    expect(page.locator('[data-testid="export-filter-settings"]')).to_be_visible()
+
+    # Close
+    page.click('[data-testid="export-filter-cancel"]')
+    page.wait_for_timeout(300)
+    expect(page.locator('[data-testid="modal-overlay"]')).not_to_be_visible()
+
+    _clean_all(page)
+
+
+def test_settings_import_button(page: Page, app_url: str):
+    """Settings import button opens file picker and handles import."""
+    _go_to_settings(page, app_url)
+    _clean_all(page)
+
+    other_uuid = "settings-import-uuid-1111"
+    exercises = [
+        {
+            "id": "settings-import-ex-1",
+            "title": "Settings Import Exercise",
+            "description": "Via settings",
+            "asymmetric": False,
+            "alternate": False,
+            "image_urls": [],
+            "video_urls": [],
+            "default_reps": 5,
+            "default_weight": 10,
+            "created_by": other_uuid,
+        }
+    ]
+    json_str = _build_export_json(exercises, "Settings User", other_uuid)
+
+    _trigger_settings_import_with_json(page, json_str)
+
+    # Should see suffix step (different user)
+    page.wait_for_selector('[data-testid="import-suffix-step"]', timeout=5000)
+
+    # Enter suffix and continue
+    page.fill('[data-testid="import-suffix-input"]', "SU")
+    page.click('[data-testid="import-suffix-confirm"]')
+
+    # Preview
+    page.wait_for_selector('[data-testid="import-preview-step"]', timeout=5000)
+    page.click('[data-testid="import-apply"]')
+
+    # Report
+    page.wait_for_selector('[data-testid="import-report-step"]', timeout=5000)
+    page.click('[data-testid="import-done"]')
+
+    # Verify exercise created
+    exercise = page.evaluate(
+        """async () => {
+            const exercises = await window.__repos.exercises.getAll();
+            return exercises.find(e => e.title === 'Settings Import Exercise [SU]');
+        }"""
+    )
+    assert exercise is not None
+
+    _clean_all(page)
+
+
+def test_suffix_management_visible(page: Page, app_url: str):
+    """Suffix management section is visible after an import from a different user."""
+    _go_to_exercises(page, app_url)
+    _clean_all(page)
+
+    # Create a suffix entry directly
+    page.evaluate(
+        """async () => {
+            await window.__repos.suffixes.create({
+                user_uuid: 'suffix-mgmt-uuid-1',
+                user_name: 'Alice',
+                suffix: 'AL',
+            });
+        }"""
+    )
+
+    _go_to_settings(page, app_url)
+
+    expect(page.locator('[data-testid="suffix-management"]')).to_be_visible()
+    expect(page.locator('[data-testid="suffix-value"]')).to_contain_text("[AL]")
+
+    _clean_all(page)
+
+
+def test_suffix_rename_cascade(page: Page, app_url: str):
+    """Renaming a suffix updates exercise titles that contain the old suffix."""
+    _go_to_exercises(page, app_url)
+    _clean_all(page)
+
+    other_uuid = "rename-test-uuid-5555"
+
+    # Create suffix and exercise
+    page.evaluate(
+        f"""async () => {{
+            await window.__repos.suffixes.create({{
+                user_uuid: '{other_uuid}',
+                user_name: 'Charlie',
+                suffix: 'CH',
+            }});
+            await window.__repos.exercises.createWithId('rename-ex-1', {{
+                title: 'Burpees [CH]',
+                description: 'Test',
+                asymmetric: false,
+                alternate: false,
+                image_urls: [],
+                video_urls: [],
+                default_reps: 10,
+                default_weight: 0,
+                created_by: '{other_uuid}',
+            }});
+        }}"""
+    )
+
+    _go_to_settings(page, app_url)
+
+    # Start editing
+    page.click('[data-testid="suffix-edit-btn"]')
+    page.fill('[data-testid="suffix-edit-input"]', "CW")
+    page.click('[data-testid="suffix-save-btn"]')
+
+    page.wait_for_timeout(500)
+
+    # Verify suffix updated in UI
+    expect(page.locator('[data-testid="suffix-value"]')).to_contain_text("[CW]")
+
+    # Verify exercise title was updated
+    exercise = page.evaluate(
+        """async () => await window.__repos.exercises.getById('rename-ex-1')"""
+    )
+    assert exercise["title"] == "Burpees [CW]"
+
+    _clean_all(page)
+
+
+def test_suffix_delete(page: Page, app_url: str):
+    """Suffix can be deleted from settings."""
+    _go_to_exercises(page, app_url)
+    _clean_all(page)
+
+    # Create suffix
+    page.evaluate(
+        """async () => {
+            await window.__repos.suffixes.create({
+                user_uuid: 'delete-suffix-uuid',
+                user_name: 'Dave',
+                suffix: 'DV',
+            });
+        }"""
+    )
+
+    _go_to_settings(page, app_url)
+
+    expect(page.locator('[data-testid="suffix-management"]')).to_be_visible()
+
+    # Delete with confirmation via modal dialog
+    page.click('[data-testid="suffix-delete-btn"]')
+
+    # Confirm deletion in the modal
+    expect(page.locator('[data-testid="suffix-delete-confirm"]')).to_be_visible()
+    page.click('[data-testid="suffix-delete-confirm"]')
+
+    page.wait_for_timeout(500)
+
+    # Suffix section should be hidden (no suffixes left)
+    expect(page.locator('[data-testid="suffix-management"]')).not_to_be_visible()
+
+    _clean_all(page)
+
+
+# ============================================================
+# Import As Mine Tests
+# ============================================================
+
+
+def test_import_as_mine_button_visible(page: Page, app_url: str):
+    """Import-as-mine buttons are visible on exercise list and settings."""
+    _go_to_exercises(page, app_url)
+    _clean_all(page)
+    expect(
+        page.locator('[data-testid="exercise-import-as-mine-btn"]')
+    ).to_be_visible()
+
+    _go_to_settings(page, app_url)
+    expect(
+        page.locator('[data-testid="settings-import-as-mine"]')
+    ).to_be_visible()
+
+    _clean_all(page)
+
+
+def test_import_as_mine_no_suffix_no_collision(page: Page, app_url: str):
+    """Import-as-mine from a different user inserts exercises without suffix, owned by local user."""
+    _go_to_exercises(page, app_url)
+    _clean_all(page)
+
+    local_uuid = _get_local_uuid(page)
+    other_uuid = "foreign-user-uuid-aaaa"
+
+    exercises = [
+        {
+            "id": "as-mine-ex-1",
+            "title": "Foreign Push-ups",
+            "description": "From another user",
+            "asymmetric": False,
+            "alternate": False,
+            "image_urls": [],
+            "video_urls": [],
+            "default_reps": 15,
+            "default_weight": 0,
+            "created_by": other_uuid,
+        },
+        {
+            "id": "as-mine-ex-2",
+            "title": "Foreign Squats",
+            "description": "From another user",
+            "asymmetric": False,
+            "alternate": False,
+            "image_urls": [],
+            "video_urls": [],
+            "default_reps": 20,
+            "default_weight": 50,
+            "created_by": other_uuid,
+        },
+    ]
+    json_str = _build_export_json(exercises, "Foreign User", other_uuid)
+
+    _trigger_import_as_mine_with_json(page, json_str)
+
+    # Should go directly to preview (no suffix step)
+    page.wait_for_selector('[data-testid="import-preview-step"]', timeout=5000)
+    expect(page.locator('[data-testid="import-suffix-step"]')).not_to_be_visible()
+
+    page.click('[data-testid="import-apply"]')
+
+    # Report
+    page.wait_for_selector('[data-testid="import-report-step"]', timeout=5000)
+    expect(page.locator('[data-testid="import-report-imported"]')).to_contain_text(
+        "2"
+    )
+    page.click('[data-testid="import-done"]')
+
+    # Verify exercises exist with original titles (no suffix)
+    page.wait_for_timeout(500)
+    titles = page.locator('[data-testid="exercise-card-title"]')
+    expect(titles).to_have_count(2)
+    expect(titles.nth(0)).to_contain_text("Foreign")
+    expect(titles.nth(1)).to_contain_text("Foreign")
+
+    # Verify created_by is the local user, not the foreign user
+    ex1 = page.evaluate(
+        """async () => await window.__repos.exercises.getById('as-mine-ex-1')"""
+    )
+    assert ex1["created_by"] == local_uuid
+    assert ex1["title"] == "Foreign Push-ups"
+
+    ex2 = page.evaluate(
+        """async () => await window.__repos.exercises.getById('as-mine-ex-2')"""
+    )
+    assert ex2["created_by"] == local_uuid
+
+    _clean_all(page)
+
+
+def test_import_as_mine_collision_replace(page: Page, app_url: str):
+    """Import-as-mine with ID collision shows collision step; replace overwrites exercise."""
+    _go_to_exercises(page, app_url)
+    _clean_all(page)
+
+    local_uuid = _get_local_uuid(page)
+    other_uuid = "foreign-user-uuid-bbbb"
+    ex_id = "as-mine-collision-1"
+
+    # Create existing exercise with the same ID
+    _create_exercise_directly(page, "Existing Plank", None, ex_id)
+
+    exercises = [
+        {
+            "id": ex_id,
+            "title": "Existing Plank",
+            "description": "Imported version",
+            "asymmetric": True,
+            "alternate": False,
+            "image_urls": [],
+            "video_urls": [],
+            "default_reps": 60,
+            "default_weight": 0,
+            "created_by": other_uuid,
+        }
+    ]
+    json_str = _build_export_json(exercises, "Foreign User", other_uuid)
+
+    page.reload()
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-ready') === 'true'",
+        timeout=15000,
+    )
+    page.click('a[href="#/exercises"]')
+    page.wait_for_timeout(500)
+
+    _trigger_import_as_mine_with_json(page, json_str)
+
+    # Should see collisions step (same-user logic)
+    page.wait_for_selector(
+        '[data-testid="import-collisions-step"]', timeout=5000
+    )
+
+    # Choose replace (exercise-specific testid)
+    page.click('[data-testid="collision-replace-exercise-0"]')
+    page.click('[data-testid="import-apply"]')
+
+    # Report
+    page.wait_for_selector('[data-testid="import-report-step"]', timeout=5000)
+    expect(page.locator('[data-testid="import-report-exercises-replaced"]')).to_be_visible()
+    page.click('[data-testid="import-done"]')
+
+    # Verify exercise was replaced with new data, owned by local user
+    exercise = page.evaluate(
+        f"""async () => await window.__repos.exercises.getById('{ex_id}')"""
+    )
+    assert exercise["default_reps"] == 60
+    assert exercise["asymmetric"] == 1  # SQLite stores bool as int
+    assert exercise["created_by"] == local_uuid
+
+    _clean_all(page)
+
+
+def test_import_as_mine_collision_skip(page: Page, app_url: str):
+    """Import-as-mine with ID collision and skip action keeps the original exercise."""
+    _go_to_exercises(page, app_url)
+    _clean_all(page)
+
+    other_uuid = "foreign-user-uuid-cccc"
+    ex_id = "as-mine-skip-1"
+
+    _create_exercise_directly(page, "Keep This Exercise", None, ex_id)
+
+    exercises = [
+        {
+            "id": ex_id,
+            "title": "Keep This Exercise",
+            "description": "Should not replace",
+            "asymmetric": False,
+            "alternate": False,
+            "image_urls": [],
+            "video_urls": [],
+            "default_reps": 99,
+            "default_weight": 99,
+            "created_by": other_uuid,
+        }
+    ]
+    json_str = _build_export_json(exercises, "Foreign User", other_uuid)
+
+    page.reload()
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-ready') === 'true'",
+        timeout=15000,
+    )
+    page.click('a[href="#/exercises"]')
+    page.wait_for_timeout(500)
+
+    _trigger_import_as_mine_with_json(page, json_str)
+
+    # Should see collisions step
+    page.wait_for_selector(
+        '[data-testid="import-collisions-step"]', timeout=5000
+    )
+
+    # Default is skip, just apply
+    page.click('[data-testid="import-apply"]')
+
+    # Report shows skipped
+    page.wait_for_selector('[data-testid="import-report-step"]', timeout=5000)
+    expect(page.locator('[data-testid="import-report-skipped"]')).to_be_visible()
+    page.click('[data-testid="import-done"]')
+
+    # Verify original unchanged
+    exercise = page.evaluate(
+        f"""async () => await window.__repos.exercises.getById('{ex_id}')"""
+    )
+    assert exercise["default_reps"] == 10
+
+    _clean_all(page)
+
+
+def test_import_as_mine_from_settings(page: Page, app_url: str):
+    """Import-as-mine from settings page works without suffix prompt."""
+    _go_to_settings(page, app_url)
+    _clean_all(page)
+
+    local_uuid = _get_local_uuid(page)
+    other_uuid = "foreign-user-uuid-dddd"
+
+    exercises = [
+        {
+            "id": "settings-as-mine-ex-1",
+            "title": "Settings Mine Exercise",
+            "description": "Via settings as mine",
+            "asymmetric": False,
+            "alternate": False,
+            "image_urls": [],
+            "video_urls": [],
+            "default_reps": 12,
+            "default_weight": 25,
+            "created_by": other_uuid,
+        }
+    ]
+    json_str = _build_export_json(exercises, "Foreign User", other_uuid)
+
+    _trigger_settings_import_as_mine_with_json(page, json_str)
+
+    # Should go to preview directly (no suffix)
+    page.wait_for_selector('[data-testid="import-preview-step"]', timeout=5000)
+    page.click('[data-testid="import-apply"]')
+
+    # Report
+    page.wait_for_selector('[data-testid="import-report-step"]', timeout=5000)
+    expect(page.locator('[data-testid="import-report-imported"]')).to_be_visible()
+    page.click('[data-testid="import-done"]')
+
+    # Verify exercise created and owned by local user
+    exercise = page.evaluate(
+        """async () => {
+            const exercises = await window.__repos.exercises.getAll();
+            return exercises.find(e => e.title === 'Settings Mine Exercise');
+        }"""
+    )
+    assert exercise is not None
+    assert exercise["created_by"] == local_uuid
+
+    _clean_all(page)
+
+
+def test_import_as_mine_dialog_title(page: Page, app_url: str):
+    """Import-as-mine dialog shows the correct 'Import as Mine' title."""
+    _go_to_exercises(page, app_url)
+    _clean_all(page)
+
+    other_uuid = "foreign-user-uuid-eeee"
+    exercises = [
+        {
+            "id": "dialog-title-ex-1",
+            "title": "Dialog Title Test",
+            "description": "Test",
+            "asymmetric": False,
+            "alternate": False,
+            "image_urls": [],
+            "video_urls": [],
+            "default_reps": 5,
+            "default_weight": 0,
+            "created_by": other_uuid,
+        }
+    ]
+    json_str = _build_export_json(exercises, "Test User", other_uuid)
+
+    _trigger_import_as_mine_with_json(page, json_str)
+
+    # Wait for dialog
+    page.wait_for_selector('[data-testid="import-preview-step"]', timeout=5000)
+
+    # Verify the dialog title says "Import as Mine"
+    modal_title = page.locator('[data-testid="modal-title"]')
+    expect(modal_title).to_contain_text("Import as Mine")
+
+    # Cancel
+    page.click('[data-testid="import-cancel"]')
+
+    _clean_all(page)
diff --git a/tests/test_step3c_backup.py b/tests/test_step3c_backup.py
new file mode 100644
index 0000000..6752979
--- /dev/null
+++ b/tests/test_step3c_backup.py
@@ -0,0 +1,395 @@
+"""
+Step 3c — Backup Filename & Reminder Tests
+- test_download_uses_new_filename: Download uses the new backup filename pattern
+- test_download_sets_last_backup_at: After download, last_backup_at is set in DB
+- test_reminder_hidden_when_fresh: Reminder is hidden when backup is recent
+- test_reminder_visible_when_stale: Reminder appears when backup is older than threshold
+- test_reminder_visible_when_never: Reminder appears when no backup has been done and db_created_at is old
+- test_reminder_hidden_when_db_fresh_no_backup: Reminder hidden when no backup but db_created_at is recent
+- test_reminder_click_navigates_to_settings: Clicking reminder navigates to settings page
+- test_restore_updates_last_backup_at: Restore updates last_backup_at timestamp
+- test_custom_threshold_is_respected: Custom reminder days threshold is respected
+- test_invalid_threshold_rejected: Invalid threshold values are rejected
+- test_filename_is_filesystem_safe: Filename contains no colons and is zero-padded
+- test_startup_modal_appears_when_stale: Startup modal appears on load when backup is overdue
+- test_startup_modal_dismiss: Clicking Dismiss closes the startup modal
+- test_startup_modal_go_to_settings: Clicking Go to Settings navigates to settings page
+- test_startup_modal_does_not_reappear: Modal does not reappear when navigating after dismissal
+"""
+import re
+from datetime import datetime, timedelta, timezone
+from playwright.sync_api import Page, expect
+
+
+def _iso(days_ago: int) -> str:
+    """Return an ISO-8601 UTC timestamp for N days in the past."""
+    dt = datetime.now(timezone.utc) - timedelta(days=days_ago)
+    return dt.strftime("%Y-%m-%dT%H:%M:%S.000Z")
+
+
+def _wait_for_db(page: Page, app_url: str):
+    """Navigate and wait for the database to be ready."""
+    page.goto(app_url)
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-ready') === 'true'",
+        timeout=15000,
+    )
+
+
+def _go_to_settings(page: Page, app_url: str):
+    """Navigate to the settings page and wait for DB."""
+    _wait_for_db(page, app_url)
+    page.click('a[href="#/settings"]')
+    page.wait_for_selector('[data-testid="settings-language"]')
+
+
+def _download_via_button(page: Page, trigger_selector: str):
+    """Click a button that opens the save-filename dialog, accept the default name, return the Download."""
+    page.locator(trigger_selector).click()
+    page.wait_for_selector('[data-testid="save-file-confirm"]')
+    with page.expect_download() as download_info:
+        page.locator('[data-testid="save-file-confirm"]').click()
+    return download_info.value
+
+
+def test_download_uses_new_filename(page: Page, app_url: str):
+    """Download uses the new backup filename pattern with version and timestamp."""
+    _go_to_settings(page, app_url)
+
+    download = _download_via_button(page, '[data-testid="settings-download-db"]')
+    filename = download.suggested_filename
+
+    # Match pattern: trainus-{version}-backup-YYYYMMDD-HHhMMmSSs.sqlite3
+    pattern = r'^trainus-\d+\.\d+\.\d+-backup-\d{8}-\d{2}h\d{2}m\d{2}s\.sqlite3$'
+    assert re.match(pattern, filename), f"Filename '{filename}' does not match expected pattern"
+
+
+def test_download_sets_last_backup_at(page: Page, app_url: str):
+    """After download, last_backup_at is set and Settings shows the backup date."""
+    _go_to_settings(page, app_url)
+
+    # Click download
+    _download_via_button(page, '[data-testid="settings-download-db"]')
+
+    # Wait for the backup status to update
+    page.wait_for_timeout(1000)
+
+    # Check that last_backup_at is set in DB
+    last_backup = page.evaluate("async () => await window.__repos.settings.get('last_backup_at')")
+    assert last_backup is not None, "last_backup_at should be set after download"
+
+    # Settings should show the backup date
+    backup_info = page.locator('[data-testid="backup-last-backup"]')
+    expect(backup_info).to_be_visible()
+    text = backup_info.text_content()
+    assert 'Never backed up' not in text, "Should show backup date, not 'Never backed up'"
+
+
+def test_reminder_hidden_when_fresh(page: Page, app_url: str):
+    """Reminder is hidden when backup is recent (within threshold)."""
+    _go_to_settings(page, app_url)
+
+    # Do a download to create a fresh backup
+    _download_via_button(page, '[data-testid="settings-download-db"]')
+
+    page.wait_for_timeout(1000)
+
+    # Navigate away and back to check reminder visibility
+    page.click('a[href="#/home"]')
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-ready') === 'true'",
+        timeout=15000,
+    )
+
+    # Reminder should not be visible
+    reminder = page.locator('[data-testid="backup-reminder"]')
+    expect(reminder).not_to_be_visible()
+
+
+def test_reminder_visible_when_stale(page: Page, app_url: str):
+    """Reminder appears when backup is older than the threshold."""
+    _go_to_settings(page, app_url)
+
+    # Set last_backup_at to 8 days ago (default threshold is 7)
+    page.evaluate(f"window.__repos.settings.set('last_backup_at', '{_iso(8)}')")
+
+    # Go to home page to check reminder
+    page.click('a[href="#/home"]')
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-ready') === 'true'",
+        timeout=15000,
+    )
+
+    # Reminder should be visible
+    reminder = page.locator('[data-testid="backup-reminder"]')
+    expect(reminder).to_be_visible()
+
+
+def test_reminder_visible_when_never(page: Page, app_url: str):
+    """Reminder appears when no backup has been done and db_created_at is old."""
+    page.goto(app_url)
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-ready') === 'true'",
+        timeout=15000,
+    )
+
+    # Remove both last_backup_at AND set db_created_at to an old date
+    # so the fallback makes the reminder appear
+    page.evaluate("async () => { await window.__repos.settings.set('last_backup_at', null) }")
+    page.evaluate(f"async () => {{ await window.__repos.settings.set('db_created_at', '{_iso(30)}') }}")
+
+    # Reload to pick up the changed settings
+    page.reload()
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-ready') === 'true'",
+        timeout=15000,
+    )
+
+    # Reminder should be visible
+    reminder = page.locator('[data-testid="backup-reminder"]')
+    expect(reminder).to_be_visible()
+
+    # Restore db_created_at to a recent value so subsequent tests on the same
+    # browser page (same OPFS database) are not affected by the stale date.
+    page.evaluate(f"async () => {{ await window.__repos.settings.set('db_created_at', '{_iso(0)}') }}")
+    page.reload()
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-ready') === 'true'",
+        timeout=15000,
+    )
+
+
+def test_reminder_hidden_when_db_fresh_no_backup(page: Page, app_url: str):
+    """Reminder is hidden when no backup exists but db_created_at is recent."""
+    _wait_for_db(page, app_url)
+
+    # Clear only last_backup_at, leaving db_created_at intact (recent)
+    page.evaluate("async () => { await window.__repos.settings.set('last_backup_at', null) }")
+
+    # Reload to pick up the changed settings
+    page.reload()
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-ready') === 'true'",
+        timeout=15000,
+    )
+
+    # Reminder should NOT be visible (db_created_at is recent)
+    reminder = page.locator('[data-testid="backup-reminder"]')
+    expect(reminder).not_to_be_visible()
+
+
+def test_reminder_click_navigates_to_settings(page: Page, app_url: str):
+    """Clicking reminder navigates to the settings page."""
+    _go_to_settings(page, app_url)
+
+    # Set a stale backup date
+    page.evaluate(f"window.__repos.settings.set('last_backup_at', '{_iso(8)}')")
+
+    # Go to home page
+    page.click('a[href="#/home"]')
+    page.wait_for_timeout(1000)
+
+    # Click the reminder
+    page.locator('[data-testid="backup-reminder"]').click()
+
+    # Should navigate to settings
+    page.wait_for_url(re.compile(r'#/settings'), timeout=5000)
+
+    # Backup section should be visible
+    backup_section = page.locator('#settings-backup-section')
+    expect(backup_section).to_be_visible()
+
+
+def test_restore_updates_last_backup_at(page: Page, app_url: str, tmp_path_factory):
+    """Successful restore updates last_backup_at timestamp."""
+    _go_to_settings(page, app_url)
+
+    # Download DB and save to a known path (download.path() can be None under xdist)
+    tmp_dir = tmp_path_factory.mktemp("restore")
+    db_path = str(tmp_dir / "backup.sqlite3")
+    download = _download_via_button(page, '[data-testid="settings-download-db"]')
+    download.save_as(db_path)
+
+    # Wait for the download's markBackedUp() to persist, then clear last_backup_at
+    page.wait_for_timeout(500)
+    page.evaluate("async () => { await window.__repos.settings.set('last_backup_at', null) }")
+    # Verify it is actually null before proceeding
+    val = page.evaluate("async () => await window.__repos.settings.get('last_backup_at')")
+    assert val is None, f"last_backup_at should be null before restore, got: {val}"
+
+    # Restore the DB — use once() to avoid handler accumulation across tests
+    page.once('dialog', lambda dialog: dialog.accept())
+    with page.expect_file_chooser() as fc_info:
+        page.locator('[data-testid="settings-restore-db"]').click()
+    file_chooser = fc_info.value
+    file_chooser.set_files(db_path)
+
+    # Wait for the spinner to disappear — indicates the full async chain completed
+    page.wait_for_selector('[data-testid="restore-spinner"]', state="hidden", timeout=15000)
+
+    # last_backup_at should be set by markBackedUp() after successful restore
+    last_backup = page.evaluate("async () => await window.__repos.settings.get('last_backup_at')")
+    assert last_backup is not None, "last_backup_at should be set after restore"
+
+
+def test_custom_threshold_is_respected(page: Page, app_url: str):
+    """Custom reminder days threshold is respected."""
+    _go_to_settings(page, app_url)
+
+    # Set last_backup_at to 3 days ago
+    page.evaluate(f"window.__repos.settings.set('last_backup_at', '{_iso(3)}')")
+
+    # Set threshold to 2 days
+    page.locator('[data-testid="backup-reminder-days"]').fill('2')
+    page.locator('[data-testid="backup-reminder-days"]').blur()
+    page.wait_for_timeout(1000)
+
+    # Reload the page to pick up new threshold
+    page.reload()
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-ready') === 'true'",
+        timeout=15000,
+    )
+
+    # Reminder should be visible (3 days > 2 day threshold)
+    reminder = page.locator('[data-testid="backup-reminder"]')
+    expect(reminder).to_be_visible()
+
+    # The startup modal appears on reload — dismiss it before navigating
+    page.locator('[data-testid="backup-modal-dismiss"]').click()
+
+    # Go back to settings and change threshold to 30 days
+    page.click('a[href="#/settings"]')
+    page.wait_for_selector('[data-testid="settings-language"]')
+
+    page.locator('[data-testid="backup-reminder-days"]').fill('30')
+    page.locator('[data-testid="backup-reminder-days"]').blur()
+    page.wait_for_timeout(1000)
+
+    # Reload the page to pick up new threshold
+    page.reload()
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-ready') === 'true'",
+        timeout=15000,
+    )
+
+    # Reminder should be hidden (3 days < 30 day threshold)
+    expect(reminder).not_to_be_visible()
+
+
+def test_invalid_threshold_rejected(page: Page, app_url: str):
+    """Invalid threshold values (0, -1, abc, 366) are rejected."""
+    _go_to_settings(page, app_url)
+
+    # Set a known valid value first
+    page.locator('[data-testid="backup-reminder-days"]').fill('7')
+    page.locator('[data-testid="backup-reminder-days"]').blur()
+    page.wait_for_timeout(500)
+
+    # Test invalid values
+    invalid_values = ['0', '-1', 'abc', '366']
+    for value in invalid_values:
+        page.locator('[data-testid="backup-reminder-days"]').fill(value)
+        page.locator('[data-testid="backup-reminder-days"]').blur()
+        page.wait_for_timeout(500)
+
+        # Error should be visible
+        error = page.locator('[data-testid="backup-reminder-error"]')
+        expect(error).to_be_visible()
+
+    # DB should still have the last valid value (7)
+    stored = page.evaluate("async () => await window.__repos.settings.get('backup_reminder_days')")
+    assert stored == '7', f"backup_reminder_days should be '7', got '{stored}'"
+
+
+def test_filename_is_filesystem_safe(page: Page, app_url: str):
+    """Filename contains no colons and is zero-padded."""
+    _go_to_settings(page, app_url)
+
+    download = _download_via_button(page, '[data-testid="settings-download-db"]')
+    filename = download.suggested_filename
+
+    # No colons
+    assert ':' not in filename, f"Filename '{filename}' contains colons"
+
+    # Zero-padded: check the timestamp portion
+    # Extract the timestamp part: YYYYMMDD-HHhMMmSSs
+    match = re.search(r'backup-(\d{8}-\d{2}h\d{2}m\d{2}s)', filename)
+    assert match, f"Filename '{filename}' does not have zero-padded timestamp"
+
+
+def _set_stale_and_reload(page: Page, app_url: str):
+    """Set db_created_at to 30 days ago (no last_backup_at) then reload."""
+    page.goto(app_url)
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-ready') === 'true'",
+        timeout=15000,
+    )
+    page.evaluate("async () => { await window.__repos.settings.set('last_backup_at', null) }")
+    page.evaluate(f"async () => {{ await window.__repos.settings.set('db_created_at', '{_iso(30)}') }}")
+    page.reload()
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-ready') === 'true'",
+        timeout=15000,
+    )
+
+
+def _cleanup_stale(page: Page):
+    """Reset db_created_at to today so the stale state does not leak."""
+    page.evaluate(f"async () => {{ await window.__repos.settings.set('db_created_at', '{_iso(0)}') }}")
+
+
+def test_startup_modal_appears_when_stale(page: Page, app_url: str):
+    """Startup modal appears on page load when backup is overdue."""
+    _set_stale_and_reload(page, app_url)
+
+    expect(page.locator('[data-testid="backup-modal"]')).to_be_visible()
+
+    _cleanup_stale(page)
+
+
+def test_startup_modal_dismiss(page: Page, app_url: str):
+    """Clicking Dismiss closes the startup modal."""
+    _set_stale_and_reload(page, app_url)
+
+    modal = page.locator('[data-testid="backup-modal"]')
+    expect(modal).to_be_visible()
+
+    page.locator('[data-testid="backup-modal-dismiss"]').click()
+    expect(modal).not_to_be_visible()
+
+    _cleanup_stale(page)
+
+
+def test_startup_modal_go_to_settings(page: Page, app_url: str):
+    """Clicking Go to Settings in the startup modal navigates to the settings page and closes the modal."""
+    _set_stale_and_reload(page, app_url)
+
+    modal = page.locator('[data-testid="backup-modal"]')
+    expect(modal).to_be_visible()
+
+    page.locator('[data-testid="backup-modal-settings"]').click()
+
+    expect(modal).not_to_be_visible()
+    page.wait_for_url(re.compile(r'#/settings'), timeout=5000)
+
+    _cleanup_stale(page)
+
+
+def test_startup_modal_does_not_reappear(page: Page, app_url: str):
+    """After dismissal the startup modal does not reappear when navigating within the same session."""
+    _set_stale_and_reload(page, app_url)
+
+    page.locator('[data-testid="backup-modal-dismiss"]').click()
+
+    modal = page.locator('[data-testid="backup-modal"]')
+
+    # Navigate away and back — component remounts each time due to :key binding
+    page.click('a[href="#/exercises"]')
+    page.wait_for_timeout(500)
+    page.click('a[href="#/home"]')
+    page.wait_for_timeout(500)
+
+    expect(modal).not_to_be_visible()
+
+    _cleanup_stale(page)
diff --git a/tests/test_step4_combos.py b/tests/test_step4_combos.py
new file mode 100644
index 0000000..fd9507e
--- /dev/null
+++ b/tests/test_step4_combos.py
@@ -0,0 +1,762 @@
+"""
+Step 4 — Combo Management Tests
+- test_combo_list_empty: Shows empty state when no combos exist
+- test_create_combo_minimal: Create combo with only required field (title)
+- test_create_combo_full: Create combo with all fields including exercises
+- test_combo_appears_in_list: Created combo appears in the list with badges
+- test_combo_detail_view: Detail view shows all combo data
+- test_edit_combo: Edit a combo and verify changes
+- test_delete_combo: Delete a combo with confirmation
+- test_delete_combo_cancel: Cancelling delete does not remove combo
+- test_search_combos: Search filters combos by title
+- test_search_no_results: Search with no matches shows empty message
+- test_search_clear_button: Clear button empties the search field and restores the full list
+- test_validation_title_required: Empty title shows validation error
+- test_duplicate_title_rejected: Creating combo with duplicate title shows error
+- test_reorder_exercises: Reorder exercises in combo
+- test_remove_exercise: Remove an exercise from combo
+- test_type_change: Changing type shows/hides timer config fields
+- test_action_bar_buttons: New and Search buttons appear in action bar
+"""
+from playwright.sync_api import Page, expect
+
+
+def _wait_for_db(page: Page, app_url: str):
+    """Navigate and wait for the database to be ready."""
+    page.goto(app_url)
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-ready') === 'true'",
+        timeout=15000,
+    )
+
+
+def _go_to_combos(page: Page, app_url: str):
+    """Navigate to the combos list and wait for it to load."""
+    _wait_for_db(page, app_url)
+    page.click('a[href="#/combos"]')
+    page.wait_for_timeout(500)
+
+
+def _clean_combos(page: Page):
+    """Remove all combos via the repository."""
+    page.evaluate(
+        """async () => {
+            const combos = await window.__repos.combos.getAll();
+            for (const c of combos) {
+                await window.__repos.combos.delete(c.id);
+            }
+        }"""
+    )
+
+
+def _create_exercise_via_repo(page: Page, title):
+    """Create an exercise via the repository and return its ID."""
+    return page.evaluate(
+        """async (title) => {
+            const uuid = await window.__repos.settings.get('user_uuid');
+            return window.__repos.exercises.create({
+                title: title, description: '', asymmetric: false, alternate: false,
+                image_urls: [], video_urls: [], default_reps: 10, default_weight: 0,
+                created_by: uuid
+            });
+        }""",
+        title,
+    )
+
+
+def _create_combo_via_ui(page: Page, title, description="", combo_type="NONE", exercise_ids=None):
+    """Fill the combo form and save via UI."""
+    page.click('[data-testid="combo-new-btn"]')
+    page.wait_for_selector('[data-testid="combo-title"]')
+
+    page.fill('[data-testid="combo-title"]', title)
+
+    if description:
+        page.fill('[data-testid="combo-description"]', description)
+
+    if combo_type != "NONE":
+        page.select_option('[data-testid="combo-type"]', combo_type)
+
+    if exercise_ids:
+        for ex_id in exercise_ids:
+            page.select_option('[data-testid="combo-exercise-select"]', ex_id)
+            page.click('[data-testid="combo-exercise-add"]')
+
+    page.click('[data-testid="combo-save"]')
+    page.wait_for_selector('[data-testid="combo-detail-title"]', timeout=5000)
+
+
+def test_combo_list_empty(page: Page, app_url: str):
+    """Empty state is shown when no combos exist."""
+    _go_to_combos(page, app_url)
+    _clean_combos(page)
+    page.reload()
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-ready') === 'true'",
+        timeout=15000,
+    )
+    page.click('a[href="#/combos"]')
+    page.wait_for_timeout(500)
+    expect(page.locator('[data-testid="combo-empty"]')).to_be_visible()
+
+
+def test_create_combo_minimal(page: Page, app_url: str):
+    """Create a combo with only the required title field."""
+    _go_to_combos(page, app_url)
+    _clean_combos(page)
+    page.reload()
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-ready') === 'true'",
+        timeout=15000,
+    )
+    page.click('a[href="#/combos"]')
+    page.wait_for_timeout(500)
+
+    _create_combo_via_ui(page, "My First Combo")
+
+    expect(page.locator('[data-testid="combo-detail-title"]')).to_have_text("My First Combo")
+
+    _clean_combos(page)
+
+
+def test_create_combo_full(page: Page, app_url: str):
+    """Create a combo with all fields including exercises."""
+    _go_to_combos(page, app_url)
+    _clean_combos(page)
+    page.reload()
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-ready') === 'true'",
+        timeout=15000,
+    )
+    page.click('a[href="#/combos"]')
+    page.wait_for_timeout(500)
+
+    # Create exercises first
+    ex1_id = _create_exercise_via_repo(page, "Push-ups")
+    ex2_id = _create_exercise_via_repo(page, "Squats")
+
+    page.reload()
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-ready') === 'true'",
+        timeout=15000,
+    )
+    page.click('a[href="#/combos"]')
+    page.wait_for_timeout(500)
+
+    _create_combo_via_ui(
+        page,
+        title="Upper Body Blast",
+        description="Quick combo for upper body",
+        combo_type="EMOM",
+        exercise_ids=[ex1_id, ex2_id],
+    )
+
+    expect(page.locator('[data-testid="combo-detail-title"]')).to_have_text("Upper Body Blast")
+    expect(page.locator('[data-testid="combo-detail-description"]')).to_have_text(
+        "Quick combo for upper body"
+    )
+    expect(page.locator('[data-testid="combo-detail-type"]')).to_have_text("EMOM")
+    expect(page.locator('[data-testid="combo-detail-exercise-0"]')).to_contain_text("Push-ups")
+    expect(page.locator('[data-testid="combo-detail-exercise-1"]')).to_contain_text("Squats")
+
+    _clean_combos(page)
+
+
+def test_combo_appears_in_list(page: Page, app_url: str):
+    """Created combo appears in the list view with correct info."""
+    _go_to_combos(page, app_url)
+    _clean_combos(page)
+    page.reload()
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-ready') === 'true'",
+        timeout=15000,
+    )
+    page.click('a[href="#/combos"]')
+    page.wait_for_timeout(500)
+
+    _create_combo_via_ui(page, title="Test Combo", combo_type="AMRAP")
+
+    page.click('[data-testid="combo-back-btn"]')
+    page.wait_for_timeout(500)
+
+    card_title = page.locator('[data-testid="combo-card-title"]')
+    expect(card_title.first).to_have_text("Test Combo")
+    expect(page.locator('[data-testid="combo-card-type"]').first).to_have_text("AMRAP")
+
+    _clean_combos(page)
+
+
+def test_combo_detail_view(page: Page, app_url: str):
+    """Detail view shows all combo data correctly."""
+    _go_to_combos(page, app_url)
+    _clean_combos(page)
+
+    # Create exercise first
+    ex_id = _create_exercise_via_repo(page, "Burpees")
+
+    # Create combo via repo
+    combo_id = page.evaluate(
+        """async ({ exId }) => {
+            const uuid = await window.__repos.settings.get('user_uuid');
+            const id = await window.__repos.combos.create({
+                title: 'HIIT Combo',
+                description: 'High intensity interval training',
+                type: 'TABATA',
+                timer_config: { rounds: 8 },
+                created_by: uuid
+            });
+            await window.__repos.combos.setExercises(id, [exId]);
+            return id;
+        }""",
+        {"exId": ex_id},
+    )
+
+    page.goto(f"{app_url}/#/combos/{combo_id}")
+    page.wait_for_selector('[data-testid="combo-detail-title"]', timeout=5000)
+
+    expect(page.locator('[data-testid="combo-detail-title"]')).to_have_text("HIIT Combo")
+    expect(page.locator('[data-testid="combo-detail-description"]')).to_have_text(
+        "High intensity interval training"
+    )
+    expect(page.locator('[data-testid="combo-detail-type"]')).to_have_text("TABATA")
+    expect(page.locator('[data-testid="combo-detail-tabata-rounds"]')).to_contain_text("8")
+
+    _clean_combos(page)
+
+
+def test_edit_combo(page: Page, app_url: str):
+    """Edit a combo and verify changes are persisted."""
+    _go_to_combos(page, app_url)
+    _clean_combos(page)
+    page.reload()
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-ready') === 'true'",
+        timeout=15000,
+    )
+    page.click('a[href="#/combos"]')
+    page.wait_for_timeout(500)
+
+    _create_combo_via_ui(page, title="Original Combo", combo_type="NONE")
+
+    page.click('[data-testid="combo-edit-btn"]')
+    page.wait_for_selector('[data-testid="combo-title"]')
+
+    page.fill('[data-testid="combo-title"]', "Updated Combo")
+    page.select_option('[data-testid="combo-type"]', "EMOM")
+    page.fill('[data-testid="combo-emom-duration"]', "15")
+
+    page.click('[data-testid="combo-save"]')
+    page.wait_for_selector('[data-testid="combo-detail-title"]', timeout=5000)
+
+    expect(page.locator('[data-testid="combo-detail-title"]')).to_have_text("Updated Combo")
+    expect(page.locator('[data-testid="combo-detail-type"]')).to_have_text("EMOM")
+
+    _clean_combos(page)
+
+
+def test_delete_combo(page: Page, app_url: str):
+    """Delete a combo with confirmation dialog."""
+    _go_to_combos(page, app_url)
+    _clean_combos(page)
+    page.reload()
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-ready') === 'true'",
+        timeout=15000,
+    )
+    page.click('a[href="#/combos"]')
+    page.wait_for_timeout(500)
+
+    _create_combo_via_ui(page, title="To Delete")
+
+    page.on("dialog", lambda dialog: dialog.accept())
+    page.click('[data-testid="combo-delete-btn"]')
+    page.wait_for_timeout(500)
+
+    expect(page.locator('[data-testid="combo-empty"]')).to_be_visible()
+
+
+def test_delete_combo_cancel(page: Page, app_url: str):
+    """Cancelling the delete dialog does not remove the combo."""
+    _go_to_combos(page, app_url)
+    _clean_combos(page)
+    page.reload()
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-ready') === 'true'",
+        timeout=15000,
+    )
+    page.click('a[href="#/combos"]')
+    page.wait_for_timeout(500)
+
+    _create_combo_via_ui(page, title="Keep Me")
+
+    page.on("dialog", lambda dialog: dialog.dismiss())
+    page.click('[data-testid="combo-delete-btn"]')
+    page.wait_for_timeout(500)
+
+    expect(page.locator('[data-testid="combo-detail-title"]')).to_have_text("Keep Me")
+
+    _clean_combos(page)
+
+
+def test_search_combos(page: Page, app_url: str):
+    """Search filters combos by title."""
+    _go_to_combos(page, app_url)
+    _clean_combos(page)
+
+    # Create multiple combos via repo
+    page.evaluate(
+        """async () => {
+            const uuid = await window.__repos.settings.get('user_uuid');
+            await window.__repos.combos.create({
+                title: 'Upper Body', description: '', type: 'EMOM',
+                timer_config: {}, created_by: uuid
+            });
+            await window.__repos.combos.create({
+                title: 'Lower Body', description: '', type: 'AMRAP',
+                timer_config: {}, created_by: uuid
+            });
+            await window.__repos.combos.create({
+                title: 'Full Body', description: '', type: 'TABATA',
+                timer_config: {}, created_by: uuid
+            });
+        }"""
+    )
+
+    page.reload()
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-ready') === 'true'",
+        timeout=15000,
+    )
+    page.click('a[href="#/combos"]')
+    page.wait_for_timeout(500)
+
+    expect(page.locator('[data-testid="combo-card-title"]')).to_have_count(3)
+
+    page.click('[data-testid="combo-search-toggle"]')
+    page.wait_for_selector('[data-testid="combo-search-input"]')
+
+    page.fill('[data-testid="combo-search-input"]', "Body")
+    page.wait_for_timeout(500)
+
+    expect(page.locator('[data-testid="combo-card-title"]')).to_have_count(3)
+
+    page.fill('[data-testid="combo-search-input"]', "Upper")
+    page.wait_for_timeout(500)
+
+    expect(page.locator('[data-testid="combo-card-title"]')).to_have_count(1)
+    expect(page.locator('[data-testid="combo-card-title"]')).to_have_text("Upper Body")
+
+    _clean_combos(page)
+
+
+def test_search_no_results(page: Page, app_url: str):
+    """Search with no matches shows no-results message."""
+    _go_to_combos(page, app_url)
+    _clean_combos(page)
+
+    page.evaluate(
+        """async () => {
+            const uuid = await window.__repos.settings.get('user_uuid');
+            await window.__repos.combos.create({
+                title: 'Upper Body', description: '', type: 'EMOM',
+                timer_config: {}, created_by: uuid
+            });
+        }"""
+    )
+
+    page.reload()
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-ready') === 'true'",
+        timeout=15000,
+    )
+    page.click('a[href="#/combos"]')
+    page.wait_for_timeout(500)
+
+    page.click('[data-testid="combo-search-toggle"]')
+    page.fill('[data-testid="combo-search-input"]', "zzzznotfound")
+    page.wait_for_timeout(500)
+
+    expect(page.locator('[data-testid="combo-no-results"]')).to_be_visible()
+
+    _clean_combos(page)
+
+
+def test_search_clear_button(page: Page, app_url: str):
+    """Clear button empties the search field and restores the full list."""
+    _go_to_combos(page, app_url)
+    _clean_combos(page)
+
+    page.evaluate(
+        """async () => {
+            const uuid = await window.__repos.settings.get('user_uuid');
+            await window.__repos.combos.create({
+                title: 'Upper Body', description: '', type: 'EMOM',
+                timer_config: {}, created_by: uuid
+            });
+            await window.__repos.combos.create({
+                title: 'Lower Body', description: '', type: 'AMRAP',
+                timer_config: {}, created_by: uuid
+            });
+        }"""
+    )
+
+    page.reload()
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-ready') === 'true'",
+        timeout=15000,
+    )
+    page.click('a[href="#/combos"]')
+    page.wait_for_timeout(500)
+
+    page.click('[data-testid="combo-search-toggle"]')
+
+    expect(page.locator('[data-testid="combo-search-clear"]')).not_to_be_visible()
+
+    page.fill('[data-testid="combo-search-input"]', "Upper")
+    page.wait_for_timeout(500)
+    expect(page.locator('[data-testid="combo-card-title"]')).to_have_count(1)
+
+    page.click('[data-testid="combo-search-clear"]')
+    expect(page.locator('[data-testid="combo-search-input"]')).to_have_value("")
+    page.wait_for_timeout(500)
+    expect(page.locator('[data-testid="combo-card-title"]')).to_have_count(2)
+
+    expect(page.locator('[data-testid="combo-search-input"]')).to_be_focused()
+
+    _clean_combos(page)
+
+
+def test_validation_title_required(page: Page, app_url: str):
+    """Empty title shows validation error and prevents save."""
+    _go_to_combos(page, app_url)
+    _clean_combos(page)
+    page.reload()
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-ready') === 'true'",
+        timeout=15000,
+    )
+    page.click('a[href="#/combos"]')
+    page.wait_for_timeout(500)
+
+    page.click('[data-testid="combo-new-btn"]')
+    page.wait_for_selector('[data-testid="combo-title"]')
+
+    page.click('[data-testid="combo-save"]')
+
+    expect(page.locator('[data-testid="combo-title-error"]')).to_be_visible()
+    expect(page.locator('[data-testid="combo-title"]')).to_be_visible()
+
+
+def test_duplicate_title_rejected(page: Page, app_url: str):
+    """Creating a combo with a duplicate title shows an error."""
+    _go_to_combos(page, app_url)
+    _clean_combos(page)
+    page.reload()
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-ready') === 'true'",
+        timeout=15000,
+    )
+    page.click('a[href="#/combos"]')
+    page.wait_for_timeout(500)
+
+    _create_combo_via_ui(page, title="Unique Combo")
+
+    page.click('[data-testid="combo-back-btn"]')
+    page.wait_for_timeout(500)
+
+    page.click('[data-testid="combo-new-btn"]')
+    page.wait_for_selector('[data-testid="combo-title"]')
+    page.fill('[data-testid="combo-title"]', "Unique Combo")
+    page.click('[data-testid="combo-save"]')
+    page.wait_for_timeout(500)
+
+    title_error_visible = page.locator('[data-testid="combo-title-error"]').is_visible()
+    save_error_visible = page.locator('[data-testid="combo-save-error"]').is_visible()
+    assert title_error_visible or save_error_visible, "Expected duplicate title error"
+
+    _clean_combos(page)
+
+
+def test_reorder_exercises(page: Page, app_url: str):
+    """Reorder exercises in a combo."""
+    _go_to_combos(page, app_url)
+    _clean_combos(page)
+    page.reload()
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-ready') === 'true'",
+        timeout=15000,
+    )
+    page.click('a[href="#/combos"]')
+    page.wait_for_timeout(500)
+
+    # Create exercises
+    ex1_id = _create_exercise_via_repo(page, "Push-ups")
+    ex2_id = _create_exercise_via_repo(page, "Squats")
+    ex3_id = _create_exercise_via_repo(page, "Burpees")
+
+    page.reload()
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-ready') === 'true'",
+        timeout=15000,
+    )
+    page.click('a[href="#/combos"]')
+    page.wait_for_timeout(500)
+
+    # Create combo with 3 exercises
+    _create_combo_via_ui(
+        page,
+        title="Reorder Test",
+        exercise_ids=[ex1_id, ex2_id, ex3_id],
+    )
+
+    # Go to edit
+    page.click('[data-testid="combo-edit-btn"]')
+    page.wait_for_selector('[data-testid="combo-title"]')
+
+    # Move Squats (index 1) up
+    page.click('[data-testid="combo-exercise-move-up-1"]')
+
+    # Save
+    page.click('[data-testid="combo-save"]')
+    page.wait_for_selector('[data-testid="combo-detail-title"]', timeout=5000)
+
+    # Verify order: Squats, Push-ups, Burpees
+    expect(page.locator('[data-testid="combo-detail-exercise-0"]')).to_contain_text("Squats")
+    expect(page.locator('[data-testid="combo-detail-exercise-1"]')).to_contain_text("Push-ups")
+    expect(page.locator('[data-testid="combo-detail-exercise-2"]')).to_contain_text("Burpees")
+
+    _clean_combos(page)
+
+
+def test_remove_exercise(page: Page, app_url: str):
+    """Remove an exercise from a combo."""
+    _go_to_combos(page, app_url)
+    _clean_combos(page)
+    page.reload()
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-ready') === 'true'",
+        timeout=15000,
+    )
+    page.click('a[href="#/combos"]')
+    page.wait_for_timeout(500)
+
+    ex1_id = _create_exercise_via_repo(page, "Push-ups")
+    ex2_id = _create_exercise_via_repo(page, "Squats")
+
+    page.reload()
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-ready') === 'true'",
+        timeout=15000,
+    )
+    page.click('a[href="#/combos"]')
+    page.wait_for_timeout(500)
+
+    _create_combo_via_ui(
+        page,
+        title="Remove Test",
+        exercise_ids=[ex1_id, ex2_id],
+    )
+
+    page.click('[data-testid="combo-edit-btn"]')
+    page.wait_for_selector('[data-testid="combo-title"]')
+
+    # Remove first exercise
+    page.click('[data-testid="combo-exercise-remove-0"]')
+
+    page.click('[data-testid="combo-save"]')
+    page.wait_for_selector('[data-testid="combo-detail-title"]', timeout=5000)
+
+    # Only Squats should remain
+    expect(page.locator('[data-testid="combo-detail-exercise-0"]')).to_contain_text("Squats")
+    expect(page.locator('[data-testid="combo-detail-exercise-1"]')).not_to_be_attached()
+
+    _clean_combos(page)
+
+
+def test_type_change(page: Page, app_url: str):
+    """Changing type shows/hides timer config fields."""
+    _go_to_combos(page, app_url)
+    _clean_combos(page)
+    page.reload()
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-ready') === 'true'",
+        timeout=15000,
+    )
+    page.click('a[href="#/combos"]')
+    page.wait_for_timeout(500)
+
+    page.click('[data-testid="combo-new-btn"]')
+    page.wait_for_selector('[data-testid="combo-title"]')
+
+    # NONE type: no timer config fields
+    expect(page.locator('[data-testid="combo-emom-duration"]')).not_to_be_visible()
+    expect(page.locator('[data-testid="combo-amrap-duration"]')).not_to_be_visible()
+    expect(page.locator('[data-testid="combo-tabata-work-time"]')).not_to_be_visible()
+    expect(page.locator('[data-testid="combo-tabata-rest-time"]')).not_to_be_visible()
+
+    # Switch to EMOM
+    page.select_option('[data-testid="combo-type"]', "EMOM")
+    expect(page.locator('[data-testid="combo-emom-duration"]')).to_be_visible()
+    expect(page.locator('[data-testid="combo-amrap-duration"]')).not_to_be_visible()
+    expect(page.locator('[data-testid="combo-tabata-work-time"]')).not_to_be_visible()
+    expect(page.locator('[data-testid="combo-tabata-rest-time"]')).not_to_be_visible()
+
+    # Switch to TABATA
+    page.select_option('[data-testid="combo-type"]', "TABATA")
+    expect(page.locator('[data-testid="combo-emom-duration"]')).not_to_be_visible()
+    expect(page.locator('[data-testid="combo-amrap-duration"]')).not_to_be_visible()
+    expect(page.locator('[data-testid="combo-tabata-work-time"]')).to_be_visible()
+    expect(page.locator('[data-testid="combo-tabata-rest-time"]')).to_be_visible()
+
+    _clean_combos(page)
+
+
+def test_action_bar_buttons(page: Page, app_url: str):
+    """New and Search buttons are visible in the action bar on the combo list."""
+    _go_to_combos(page, app_url)
+    _clean_combos(page)
+    page.reload()
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-ready') === 'true'",
+        timeout=15000,
+    )
+    page.click('a[href="#/combos"]')
+    page.wait_for_timeout(500)
+
+    expect(page.locator('[data-testid="combo-new-btn"]')).to_be_visible()
+    expect(page.locator('[data-testid="combo-search-toggle"]')).to_be_visible()
+
+
+def test_create_combo_with_reps_and_weight(page: Page, app_url: str):
+    """Create combo with exercises and set reps/weight values."""
+    _go_to_combos(page, app_url)
+    _clean_combos(page)
+    page.reload()
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-ready') === 'true'",
+        timeout=15000,
+    )
+    page.click('a[href="#/combos"]')
+    page.wait_for_timeout(500)
+
+    # Create exercises
+    ex1_id = _create_exercise_via_repo(page, "Push-ups")
+    ex2_id = _create_exercise_via_repo(page, "Squats")
+
+    # Create combo with exercises
+    page.click('[data-testid="combo-new-btn"]')
+    page.wait_for_selector('[data-testid="combo-title"]')
+
+    page.fill('[data-testid="combo-title"]', "Reps Weight Test")
+
+    # Add first exercise
+    page.select_option('[data-testid="combo-exercise-select"]', ex1_id)
+    page.click('[data-testid="combo-exercise-add"]')
+
+    # Add second exercise
+    page.select_option('[data-testid="combo-exercise-select"]', ex2_id)
+    page.click('[data-testid="combo-exercise-add"]')
+
+    # Set reps and weight for first exercise
+    page.fill('[data-testid="combo-exercise-reps-0"]', "12")
+    page.fill('[data-testid="combo-exercise-weight-0"]', "50")
+
+    # Set reps for second exercise (weight stays default)
+    page.fill('[data-testid="combo-exercise-reps-1"]', "15")
+
+    page.click('[data-testid="combo-save"]')
+    page.wait_for_selector('[data-testid="combo-detail-title"]', timeout=5000)
+
+    # Verify detail view shows reps and weight
+    expect(page.locator('[data-testid="combo-detail-exercise-0"]')).to_contain_text("Push-ups")
+    expect(page.locator('[data-testid="combo-detail-exercise-0"]')).to_contain_text("12")
+    expect(page.locator('[data-testid="combo-detail-exercise-0"]')).to_contain_text("50")
+    expect(page.locator('[data-testid="combo-detail-exercise-1"]')).to_contain_text("Squats")
+    expect(page.locator('[data-testid="combo-detail-exercise-1"]')).to_contain_text("15")
+
+    _clean_combos(page)
+
+
+def test_edit_combo_reps_and_weight(page: Page, app_url: str):
+    """Edit combo and change reps/weight values."""
+    _go_to_combos(page, app_url)
+    _clean_combos(page)
+    page.reload()
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-ready') === 'true'",
+        timeout=15000,
+    )
+    page.click('a[href="#/combos"]')
+    page.wait_for_timeout(500)
+
+    # Create exercise
+    ex_id = _create_exercise_via_repo(page, "Deadlifts")
+
+    # Create combo
+    _create_combo_via_ui(
+        page,
+        title="Edit Reps Weight Test",
+        exercise_ids=[ex_id],
+    )
+
+    # Edit combo
+    page.click('[data-testid="combo-edit-btn"]')
+    page.wait_for_selector('[data-testid="combo-title"]')
+
+    # Change reps and weight
+    page.fill('[data-testid="combo-exercise-reps-0"]', "8")
+    page.fill('[data-testid="combo-exercise-weight-0"]', "100")
+
+    page.click('[data-testid="combo-save"]')
+    page.wait_for_selector('[data-testid="combo-detail-title"]', timeout=5000)
+
+    # Verify updated values
+    expect(page.locator('[data-testid="combo-detail-exercise-0"]')).to_contain_text("Deadlifts")
+    expect(page.locator('[data-testid="combo-detail-exercise-0"]')).to_contain_text("8")
+    expect(page.locator('[data-testid="combo-detail-exercise-0"]')).to_contain_text("100")
+
+    _clean_combos(page)
+
+
+def test_reps_weight_defaults(page: Page, app_url: str):
+    """Reps prefill from the exercise's default_reps and weight defaults to 0."""
+    _go_to_combos(page, app_url)
+    _clean_combos(page)
+    page.reload()
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-ready') === 'true'",
+        timeout=15000,
+    )
+    page.click('a[href="#/combos"]')
+    page.wait_for_timeout(500)
+
+    # Create exercise
+    ex_id = _create_exercise_via_repo(page, "Lunges")
+
+    # Create combo
+    page.click('[data-testid="combo-new-btn"]')
+    page.wait_for_selector('[data-testid="combo-title"]')
+
+    page.fill('[data-testid="combo-title"]', "Defaults Test")
+
+    # Add exercise
+    page.select_option('[data-testid="combo-exercise-select"]', ex_id)
+    page.click('[data-testid="combo-exercise-add"]')
+
+    # Verify default values in inputs (_create_exercise_via_repo sets default_reps=10)
+    reps_input = page.locator('[data-testid="combo-exercise-reps-0"]')
+    weight_input = page.locator('[data-testid="combo-exercise-weight-0"]')
+    expect(reps_input).to_have_value("10")
+    expect(weight_input).to_have_value("0")
+
+    # Save without changing
+    page.click('[data-testid="combo-save"]')
+    page.wait_for_selector('[data-testid="combo-detail-title"]', timeout=5000)
+
+    # Verify defaults are shown in detail view (always shown now)
+    exercise_item = page.locator('[data-testid="combo-detail-exercise-0"]')
+    expect(exercise_item).to_contain_text("Lunges")
+    expect(page.locator('[data-testid="combo-detail-exercise-details-0"]')).to_contain_text("10")
+    expect(page.locator('[data-testid="combo-detail-exercise-details-0"]')).to_contain_text("0")
+
+    _clean_combos(page)
diff --git a/tests/test_step5_sessions.py b/tests/test_step5_sessions.py
new file mode 100644
index 0000000..f74c393
--- /dev/null
+++ b/tests/test_step5_sessions.py
@@ -0,0 +1,908 @@
+"""
+Step 5 — Session Management Tests
+- test_session_list_empty: Shows empty state when no sessions exist
+- test_create_session_minimal: Create session with only required field (title)
+- test_create_session_full: Create session with all fields including items
+- test_session_appears_in_list: Created session appears in the list
+- test_session_detail_view: Detail view shows all session data
+- test_edit_session: Edit a session and verify changes
+- test_delete_session: Delete a session with confirmation
+- test_delete_session_cancel: Cancelling delete does not remove session
+- test_search_sessions: Search filters sessions by title
+- test_search_no_results: Search with no matches shows empty message
+- test_search_clear_button: Clear button empties the search field and restores the full list
+- test_validation_title_required: Empty title shows validation error
+- test_duplicate_title_rejected: Creating session with duplicate title shows error
+- test_reorder_items: Reorder items in session
+- test_remove_item: Remove an item from session
+- test_action_bar_buttons: New and Search buttons appear in action bar
+- test_create_session_with_exercise_and_combo: Create session mixing exercises and combos
+- test_create_session_with_reps_and_weight: Create session with reps/weight values
+- test_edit_session_reps_and_weight: Edit session and change reps/weight values
+- test_reps_weight_defaults: Reps default to 1 and weight defaults to 0
+"""
+from playwright.sync_api import Page, expect
+
+
+def _wait_for_db(page: Page, app_url: str):
+    """Navigate and wait for the database to be ready."""
+    page.goto(app_url)
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-ready') === 'true'",
+        timeout=15000,
+    )
+
+
+def _go_to_sessions(page: Page, app_url: str):
+    """Navigate to the sessions list and wait for it to load."""
+    _wait_for_db(page, app_url)
+    page.click('a[href="#/sessions"]')
+    page.wait_for_timeout(500)
+
+
+def _clean_sessions(page: Page):
+    """Remove all sessions via the repository."""
+    page.evaluate(
+        """async () => {
+            const sessions = await window.__repos.sessions.getAll();
+            for (const s of sessions) {
+                await window.__repos.sessions.delete(s.id);
+            }
+        }"""
+    )
+
+
+def _clean_exercises(page: Page):
+    """Remove all exercises via the repository."""
+    page.evaluate(
+        """async () => {
+            const exercises = await window.__repos.exercises.getAll();
+            for (const e of exercises) {
+                await window.__repos.exercises.delete(e.id);
+            }
+        }"""
+    )
+
+
+def _clean_combos(page: Page):
+    """Remove all combos via the repository."""
+    page.evaluate(
+        """async () => {
+            const combos = await window.__repos.combos.getAll();
+            for (const c of combos) {
+                await window.__repos.combos.delete(c.id);
+            }
+        }"""
+    )
+
+
+def _create_exercise_via_repo(page: Page, title):
+    """Create an exercise via the repository and return its ID."""
+    return page.evaluate(
+        """async (title) => {
+            const uuid = await window.__repos.settings.get('user_uuid');
+            return window.__repos.exercises.create({
+                title: title, description: '', asymmetric: false, alternate: false,
+                image_urls: [], video_urls: [], default_reps: 10, default_weight: 0,
+                created_by: uuid
+            });
+        }""",
+        title,
+    )
+
+
+def _create_combo_via_repo(page: Page, title):
+    """Create a combo via the repository and return its ID."""
+    return page.evaluate(
+        """async (title) => {
+            const uuid = await window.__repos.settings.get('user_uuid');
+            return window.__repos.combos.create({
+                title: title, description: '', type: 'NONE',
+                timer_config: {}, created_by: uuid
+            });
+        }""",
+        title,
+    )
+
+
+def test_session_list_empty(page: Page, app_url: str):
+    """Empty state is shown when no sessions exist."""
+    _go_to_sessions(page, app_url)
+    _clean_sessions(page)
+    page.reload()
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-ready') === 'true'",
+        timeout=15000,
+    )
+    page.click('a[href="#/sessions"]')
+    page.wait_for_timeout(500)
+    expect(page.locator('[data-testid="session-empty"]')).to_be_visible()
+
+
+def test_create_session_minimal(page: Page, app_url: str):
+    """Create a session with only the required title field."""
+    _go_to_sessions(page, app_url)
+    _clean_sessions(page)
+    page.reload()
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-ready') === 'true'",
+        timeout=15000,
+    )
+    page.click('a[href="#/sessions"]')
+    page.wait_for_timeout(500)
+
+    page.click('[data-testid="session-new-btn"]')
+    page.wait_for_selector('[data-testid="session-title"]')
+
+    page.fill('[data-testid="session-title"]', "My First Session")
+    page.click('[data-testid="session-save"]')
+    page.wait_for_selector('[data-testid="session-detail-title"]', timeout=5000)
+
+    expect(page.locator('[data-testid="session-detail-title"]')).to_have_text("My First Session")
+
+    _clean_sessions(page)
+
+
+def test_create_session_full(page: Page, app_url: str):
+    """Create a session with all fields including items."""
+    _go_to_sessions(page, app_url)
+    _clean_sessions(page)
+    _clean_exercises(page)
+    _clean_combos(page)
+    page.reload()
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-ready') === 'true'",
+        timeout=15000,
+    )
+    page.click('a[href="#/sessions"]')
+    page.wait_for_timeout(500)
+
+    # Create exercise and combo
+    ex_id = _create_exercise_via_repo(page, "Push-ups")
+    combo_id = _create_combo_via_repo(page, "Warm-up Combo")
+
+    page.reload()
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-ready') === 'true'",
+        timeout=15000,
+    )
+    page.click('a[href="#/sessions"]')
+    page.wait_for_timeout(500)
+
+    # Create session
+    page.click('[data-testid="session-new-btn"]')
+    page.wait_for_selector('[data-testid="session-title"]')
+
+    page.fill('[data-testid="session-title"]', "Upper Body Day")
+    page.fill('[data-testid="session-description"]', "Focus on chest and shoulders")
+
+    # Add exercise
+    page.select_option('[data-testid="session-item-type-select"]', "exercise")
+    page.select_option('[data-testid="session-item-select"]', ex_id)
+    page.click('[data-testid="session-item-add"]')
+
+    # Add combo
+    page.select_option('[data-testid="session-item-type-select"]', "combo")
+    page.select_option('[data-testid="session-item-select"]', combo_id)
+    page.click('[data-testid="session-item-add"]')
+
+    page.click('[data-testid="session-save"]')
+    page.wait_for_selector('[data-testid="session-detail-title"]', timeout=5000)
+
+    expect(page.locator('[data-testid="session-detail-title"]')).to_have_text("Upper Body Day")
+    expect(page.locator('[data-testid="session-detail-description"]')).to_have_text(
+        "Focus on chest and shoulders"
+    )
+    expect(page.locator('[data-testid="session-detail-item-0"]')).to_contain_text("Push-ups")
+    expect(page.locator('[data-testid="session-detail-item-1"]')).to_contain_text("Warm-up Combo")
+
+    _clean_sessions(page)
+    _clean_exercises(page)
+    _clean_combos(page)
+
+
+def test_session_appears_in_list(page: Page, app_url: str):
+    """Created session appears in the list view."""
+    _go_to_sessions(page, app_url)
+    _clean_sessions(page)
+    page.reload()
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-ready') === 'true'",
+        timeout=15000,
+    )
+    page.click('a[href="#/sessions"]')
+    page.wait_for_timeout(500)
+
+    page.click('[data-testid="session-new-btn"]')
+    page.wait_for_selector('[data-testid="session-title"]')
+    page.fill('[data-testid="session-title"]', "Test Session")
+    page.click('[data-testid="session-save"]')
+    page.wait_for_selector('[data-testid="session-detail-title"]', timeout=5000)
+
+    page.click('[data-testid="session-back-btn"]')
+    page.wait_for_timeout(500)
+
+    expect(page.locator('[data-testid="session-card-title"]')).to_have_text("Test Session")
+
+    _clean_sessions(page)
+
+
+def test_session_detail_view(page: Page, app_url: str):
+    """Detail view shows all session data correctly."""
+    _go_to_sessions(page, app_url)
+    _clean_sessions(page)
+    _clean_exercises(page)
+
+    ex_id = _create_exercise_via_repo(page, "Burpees")
+
+    # Create session via repo
+    session_id = page.evaluate(
+        """async ({ exId }) => {
+            const uuid = await window.__repos.settings.get('user_uuid');
+            const id = await window.__repos.sessions.create({
+                title: 'HIIT Session',
+                description: 'High intensity interval training',
+                created_by: uuid
+            });
+            await window.__repos.sessions.setItems(id, [
+                { item_id: exId, item_type: 'exercise', repetitions: 3, weight: 0.0 }
+            ]);
+            return id;
+        }""",
+        {"exId": ex_id},
+    )
+
+    page.goto(f"{app_url}/#/sessions/{session_id}")
+    page.wait_for_selector('[data-testid="session-detail-title"]', timeout=5000)
+
+    expect(page.locator('[data-testid="session-detail-title"]')).to_have_text("HIIT Session")
+    expect(page.locator('[data-testid="session-detail-description"]')).to_have_text(
+        "High intensity interval training"
+    )
+    expect(page.locator('[data-testid="session-detail-item-0"]')).to_contain_text("Burpees")
+
+    _clean_sessions(page)
+    _clean_exercises(page)
+
+
+def test_edit_session(page: Page, app_url: str):
+    """Edit a session and verify changes are persisted."""
+    _go_to_sessions(page, app_url)
+    _clean_sessions(page)
+    page.reload()
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-ready') === 'true'",
+        timeout=15000,
+    )
+    page.click('a[href="#/sessions"]')
+    page.wait_for_timeout(500)
+
+    page.click('[data-testid="session-new-btn"]')
+    page.wait_for_selector('[data-testid="session-title"]')
+    page.fill('[data-testid="session-title"]', "Original Session")
+    page.click('[data-testid="session-save"]')
+    page.wait_for_selector('[data-testid="session-detail-title"]', timeout=5000)
+
+    page.click('[data-testid="session-edit-btn"]')
+    page.wait_for_selector('[data-testid="session-title"]')
+
+    page.fill('[data-testid="session-title"]', "Updated Session")
+    page.fill('[data-testid="session-description"]', "Updated description")
+
+    page.click('[data-testid="session-save"]')
+    page.wait_for_selector('[data-testid="session-detail-title"]', timeout=5000)
+
+    expect(page.locator('[data-testid="session-detail-title"]')).to_have_text("Updated Session")
+    expect(page.locator('[data-testid="session-detail-description"]')).to_have_text(
+        "Updated description"
+    )
+
+    _clean_sessions(page)
+
+
+def test_delete_session(page: Page, app_url: str):
+    """Delete a session with confirmation dialog."""
+    _go_to_sessions(page, app_url)
+    _clean_sessions(page)
+    page.reload()
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-ready') === 'true'",
+        timeout=15000,
+    )
+    page.click('a[href="#/sessions"]')
+    page.wait_for_timeout(500)
+
+    page.click('[data-testid="session-new-btn"]')
+    page.wait_for_selector('[data-testid="session-title"]')
+    page.fill('[data-testid="session-title"]', "To Delete")
+    page.click('[data-testid="session-save"]')
+    page.wait_for_selector('[data-testid="session-detail-title"]', timeout=5000)
+
+    page.on("dialog", lambda dialog: dialog.accept())
+    page.click('[data-testid="session-delete-btn"]')
+    page.wait_for_timeout(500)
+
+    expect(page.locator('[data-testid="session-empty"]')).to_be_visible()
+
+
+def test_delete_session_cancel(page: Page, app_url: str):
+    """Cancelling the delete dialog does not remove the session."""
+    _go_to_sessions(page, app_url)
+    _clean_sessions(page)
+    page.reload()
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-ready') === 'true'",
+        timeout=15000,
+    )
+    page.click('a[href="#/sessions"]')
+    page.wait_for_timeout(500)
+
+    page.click('[data-testid="session-new-btn"]')
+    page.wait_for_selector('[data-testid="session-title"]')
+    page.fill('[data-testid="session-title"]', "Keep Me")
+    page.click('[data-testid="session-save"]')
+    page.wait_for_selector('[data-testid="session-detail-title"]', timeout=5000)
+
+    page.on("dialog", lambda dialog: dialog.dismiss())
+    page.click('[data-testid="session-delete-btn"]')
+    page.wait_for_timeout(500)
+
+    expect(page.locator('[data-testid="session-detail-title"]')).to_have_text("Keep Me")
+
+    _clean_sessions(page)
+
+
+def test_search_sessions(page: Page, app_url: str):
+    """Search filters sessions by title."""
+    _go_to_sessions(page, app_url)
+    _clean_sessions(page)
+
+    page.evaluate(
+        """async () => {
+            const uuid = await window.__repos.settings.get('user_uuid');
+            await window.__repos.sessions.create({
+                title: 'Upper Body', description: '', created_by: uuid
+            });
+            await window.__repos.sessions.create({
+                title: 'Lower Body', description: '', created_by: uuid
+            });
+            await window.__repos.sessions.create({
+                title: 'Full Body', description: '', created_by: uuid
+            });
+        }"""
+    )
+
+    page.reload()
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-ready') === 'true'",
+        timeout=15000,
+    )
+    page.click('a[href="#/sessions"]')
+    page.wait_for_timeout(500)
+
+    expect(page.locator('[data-testid="session-card-title"]')).to_have_count(3)
+
+    page.click('[data-testid="session-search-toggle"]')
+    page.wait_for_selector('[data-testid="session-search-input"]')
+
+    page.fill('[data-testid="session-search-input"]', "Upper")
+    page.wait_for_timeout(500)
+
+    expect(page.locator('[data-testid="session-card-title"]')).to_have_count(1)
+    expect(page.locator('[data-testid="session-card-title"]')).to_have_text("Upper Body")
+
+    _clean_sessions(page)
+
+
+def test_search_no_results(page: Page, app_url: str):
+    """Search with no matches shows no-results message."""
+    _go_to_sessions(page, app_url)
+    _clean_sessions(page)
+
+    page.evaluate(
+        """async () => {
+            const uuid = await window.__repos.settings.get('user_uuid');
+            await window.__repos.sessions.create({
+                title: 'Upper Body', description: '', created_by: uuid
+            });
+        }"""
+    )
+
+    page.reload()
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-ready') === 'true'",
+        timeout=15000,
+    )
+    page.click('a[href="#/sessions"]')
+    page.wait_for_timeout(500)
+
+    page.click('[data-testid="session-search-toggle"]')
+    page.fill('[data-testid="session-search-input"]', "zzzznotfound")
+    page.wait_for_timeout(500)
+
+    expect(page.locator('[data-testid="session-no-results"]')).to_be_visible()
+
+    _clean_sessions(page)
+
+
+def test_search_clear_button(page: Page, app_url: str):
+    """Clear button empties the search field and restores the full list."""
+    _go_to_sessions(page, app_url)
+    _clean_sessions(page)
+
+    page.evaluate(
+        """async () => {
+            const uuid = await window.__repos.settings.get('user_uuid');
+            await window.__repos.sessions.create({
+                title: 'Upper Body', description: '', created_by: uuid
+            });
+            await window.__repos.sessions.create({
+                title: 'Lower Body', description: '', created_by: uuid
+            });
+        }"""
+    )
+
+    page.reload()
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-ready') === 'true'",
+        timeout=15000,
+    )
+    page.click('a[href="#/sessions"]')
+    page.wait_for_timeout(500)
+
+    page.click('[data-testid="session-search-toggle"]')
+
+    expect(page.locator('[data-testid="session-search-clear"]')).not_to_be_visible()
+
+    page.fill('[data-testid="session-search-input"]', "Upper")
+    page.wait_for_timeout(500)
+    expect(page.locator('[data-testid="session-card-title"]')).to_have_count(1)
+
+    page.click('[data-testid="session-search-clear"]')
+    expect(page.locator('[data-testid="session-search-input"]')).to_have_value("")
+    page.wait_for_timeout(500)
+    expect(page.locator('[data-testid="session-card-title"]')).to_have_count(2)
+
+    expect(page.locator('[data-testid="session-search-input"]')).to_be_focused()
+
+    _clean_sessions(page)
+
+
+def test_validation_title_required(page: Page, app_url: str):
+    """Empty title shows validation error and prevents save."""
+    _go_to_sessions(page, app_url)
+    _clean_sessions(page)
+    page.reload()
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-ready') === 'true'",
+        timeout=15000,
+    )
+    page.click('a[href="#/sessions"]')
+    page.wait_for_timeout(500)
+
+    page.click('[data-testid="session-new-btn"]')
+    page.wait_for_selector('[data-testid="session-title"]')
+
+    page.click('[data-testid="session-save"]')
+
+    expect(page.locator('[data-testid="session-title-error"]')).to_be_visible()
+    expect(page.locator('[data-testid="session-title"]')).to_be_visible()
+
+
+def test_duplicate_title_rejected(page: Page, app_url: str):
+    """Creating a session with a duplicate title shows an error."""
+    _go_to_sessions(page, app_url)
+    _clean_sessions(page)
+    page.reload()
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-ready') === 'true'",
+        timeout=15000,
+    )
+    page.click('a[href="#/sessions"]')
+    page.wait_for_timeout(500)
+
+    page.click('[data-testid="session-new-btn"]')
+    page.wait_for_selector('[data-testid="session-title"]')
+    page.fill('[data-testid="session-title"]', "Unique Session")
+    page.click('[data-testid="session-save"]')
+    page.wait_for_selector('[data-testid="session-detail-title"]', timeout=5000)
+
+    page.click('[data-testid="session-back-btn"]')
+    page.wait_for_timeout(500)
+
+    page.click('[data-testid="session-new-btn"]')
+    page.wait_for_selector('[data-testid="session-title"]')
+    page.fill('[data-testid="session-title"]', "Unique Session")
+    page.click('[data-testid="session-save"]')
+    page.wait_for_timeout(500)
+
+    title_error_visible = page.locator('[data-testid="session-title-error"]').is_visible()
+    save_error_visible = page.locator('[data-testid="session-save-error"]').is_visible()
+    assert title_error_visible or save_error_visible, "Expected duplicate title error"
+
+    _clean_sessions(page)
+
+
+def test_reorder_items(page: Page, app_url: str):
+    """Reorder items in a session."""
+    _go_to_sessions(page, app_url)
+    _clean_sessions(page)
+    _clean_exercises(page)
+    page.reload()
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-ready') === 'true'",
+        timeout=15000,
+    )
+    page.click('a[href="#/sessions"]')
+    page.wait_for_timeout(500)
+
+    ex1_id = _create_exercise_via_repo(page, "Push-ups")
+    ex2_id = _create_exercise_via_repo(page, "Squats")
+    ex3_id = _create_exercise_via_repo(page, "Burpees")
+
+    page.reload()
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-ready') === 'true'",
+        timeout=15000,
+    )
+    page.click('a[href="#/sessions"]')
+    page.wait_for_timeout(500)
+
+    # Create session with 3 exercises
+    page.click('[data-testid="session-new-btn"]')
+    page.wait_for_selector('[data-testid="session-title"]')
+    page.fill('[data-testid="session-title"]', "Reorder Test")
+
+    for ex_id in [ex1_id, ex2_id, ex3_id]:
+        page.select_option('[data-testid="session-item-type-select"]', "exercise")
+        page.select_option('[data-testid="session-item-select"]', ex_id)
+        page.click('[data-testid="session-item-add"]')
+
+    page.click('[data-testid="session-save"]')
+    page.wait_for_selector('[data-testid="session-detail-title"]', timeout=5000)
+
+    # Go to edit
+    page.click('[data-testid="session-edit-btn"]')
+    page.wait_for_selector('[data-testid="session-title"]')
+
+    # Move Squats (index 1) up
+    page.click('[data-testid="session-item-move-up-1"]')
+
+    # Save
+    page.click('[data-testid="session-save"]')
+    page.wait_for_selector('[data-testid="session-detail-title"]', timeout=5000)
+
+    # Verify order: Squats, Push-ups, Burpees
+    expect(page.locator('[data-testid="session-detail-item-0"]')).to_contain_text("Squats")
+    expect(page.locator('[data-testid="session-detail-item-1"]')).to_contain_text("Push-ups")
+    expect(page.locator('[data-testid="session-detail-item-2"]')).to_contain_text("Burpees")
+
+    _clean_sessions(page)
+    _clean_exercises(page)
+
+
+def test_remove_item(page: Page, app_url: str):
+    """Remove an item from a session."""
+    _go_to_sessions(page, app_url)
+    _clean_sessions(page)
+    _clean_exercises(page)
+    page.reload()
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-ready') === 'true'",
+        timeout=15000,
+    )
+    page.click('a[href="#/sessions"]')
+    page.wait_for_timeout(500)
+
+    ex1_id = _create_exercise_via_repo(page, "Push-ups")
+    ex2_id = _create_exercise_via_repo(page, "Squats")
+
+    page.reload()
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-ready') === 'true'",
+        timeout=15000,
+    )
+    page.click('a[href="#/sessions"]')
+    page.wait_for_timeout(500)
+
+    # Create session with 2 exercises
+    page.click('[data-testid="session-new-btn"]')
+    page.wait_for_selector('[data-testid="session-title"]')
+    page.fill('[data-testid="session-title"]', "Remove Test")
+
+    for ex_id in [ex1_id, ex2_id]:
+        page.select_option('[data-testid="session-item-type-select"]', "exercise")
+        page.select_option('[data-testid="session-item-select"]', ex_id)
+        page.click('[data-testid="session-item-add"]')
+
+    page.click('[data-testid="session-save"]')
+    page.wait_for_selector('[data-testid="session-detail-title"]', timeout=5000)
+
+    # Go to edit
+    page.click('[data-testid="session-edit-btn"]')
+    page.wait_for_selector('[data-testid="session-title"]')
+
+    # Remove first item
+    page.click('[data-testid="session-item-remove-0"]')
+
+    page.click('[data-testid="session-save"]')
+    page.wait_for_selector('[data-testid="session-detail-title"]', timeout=5000)
+
+    # Only Squats should remain
+    expect(page.locator('[data-testid="session-detail-item-0"]')).to_contain_text("Squats")
+
+    _clean_sessions(page)
+    _clean_exercises(page)
+
+
+def test_action_bar_buttons(page: Page, app_url: str):
+    """New and Search buttons are visible in the action bar on the session list."""
+    _go_to_sessions(page, app_url)
+    _clean_sessions(page)
+    page.reload()
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-ready') === 'true'",
+        timeout=15000,
+    )
+    page.click('a[href="#/sessions"]')
+    page.wait_for_timeout(500)
+
+    expect(page.locator('[data-testid="session-new-btn"]')).to_be_visible()
+    expect(page.locator('[data-testid="session-search-toggle"]')).to_be_visible()
+
+
+def test_create_session_with_exercise_and_combo(page: Page, app_url: str):
+    """Create session mixing exercises and combos."""
+    _go_to_sessions(page, app_url)
+    _clean_sessions(page)
+    _clean_exercises(page)
+    _clean_combos(page)
+    page.reload()
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-ready') === 'true'",
+        timeout=15000,
+    )
+    page.click('a[href="#/sessions"]')
+    page.wait_for_timeout(500)
+
+    ex_id = _create_exercise_via_repo(page, "Push-ups")
+    combo_id = _create_combo_via_repo(page, "Warm-up")
+
+    page.reload()
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-ready') === 'true'",
+        timeout=15000,
+    )
+    page.click('a[href="#/sessions"]')
+    page.wait_for_timeout(500)
+
+    page.click('[data-testid="session-new-btn"]')
+    page.wait_for_selector('[data-testid="session-title"]')
+    page.fill('[data-testid="session-title"]', "Mixed Session")
+
+    # Add exercise
+    page.select_option('[data-testid="session-item-type-select"]', "exercise")
+    page.select_option('[data-testid="session-item-select"]', ex_id)
+    page.click('[data-testid="session-item-add"]')
+
+    # Add combo
+    page.select_option('[data-testid="session-item-type-select"]', "combo")
+    page.select_option('[data-testid="session-item-select"]', combo_id)
+    page.click('[data-testid="session-item-add"]')
+
+    page.click('[data-testid="session-save"]')
+    page.wait_for_selector('[data-testid="session-detail-title"]', timeout=5000)
+
+    expect(page.locator('[data-testid="session-detail-item-0"]')).to_contain_text("Push-ups")
+    expect(page.locator('[data-testid="session-detail-item-1"]')).to_contain_text("Warm-up")
+
+    _clean_sessions(page)
+    _clean_exercises(page)
+    _clean_combos(page)
+
+
+def test_create_session_with_reps_and_weight(page: Page, app_url: str):
+    """Create session with exercises and set reps/weight values."""
+    _go_to_sessions(page, app_url)
+    _clean_sessions(page)
+    _clean_exercises(page)
+    page.reload()
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-ready') === 'true'",
+        timeout=15000,
+    )
+    page.click('a[href="#/sessions"]')
+    page.wait_for_timeout(500)
+
+    ex1_id = _create_exercise_via_repo(page, "Push-ups")
+    ex2_id = _create_exercise_via_repo(page, "Squats")
+
+    page.reload()
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-ready') === 'true'",
+        timeout=15000,
+    )
+    page.click('a[href="#/sessions"]')
+    page.wait_for_timeout(500)
+
+    page.click('[data-testid="session-new-btn"]')
+    page.wait_for_selector('[data-testid="session-title"]')
+    page.fill('[data-testid="session-title"]', "Reps Weight Test")
+
+    # Add first exercise
+    page.select_option('[data-testid="session-item-type-select"]', "exercise")
+    page.select_option('[data-testid="session-item-select"]', ex1_id)
+    page.click('[data-testid="session-item-add"]')
+
+    # Add second exercise
+    page.select_option('[data-testid="session-item-type-select"]', "exercise")
+    page.select_option('[data-testid="session-item-select"]', ex2_id)
+    page.click('[data-testid="session-item-add"]')
+
+    # Set reps and weight for first exercise
+    page.fill('[data-testid="session-item-reps-0"]', "12")
+    page.fill('[data-testid="session-item-weight-0"]', "50")
+
+    # Set reps for second exercise (weight stays default)
+    page.fill('[data-testid="session-item-reps-1"]', "15")
+
+    page.click('[data-testid="session-save"]')
+    page.wait_for_selector('[data-testid="session-detail-title"]', timeout=5000)
+
+    # Verify detail view shows reps and weight
+    expect(page.locator('[data-testid="session-detail-item-0"]')).to_contain_text("Push-ups")
+    expect(page.locator('[data-testid="session-detail-item-0"]')).to_contain_text("12")
+    expect(page.locator('[data-testid="session-detail-item-0"]')).to_contain_text("50")
+    expect(page.locator('[data-testid="session-detail-item-1"]')).to_contain_text("Squats")
+    expect(page.locator('[data-testid="session-detail-item-1"]')).to_contain_text("15")
+
+    _clean_sessions(page)
+    _clean_exercises(page)
+
+
+def test_edit_session_reps_and_weight(page: Page, app_url: str):
+    """Edit session and change reps/weight values."""
+    _go_to_sessions(page, app_url)
+    _clean_sessions(page)
+    _clean_exercises(page)
+    page.reload()
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-ready') === 'true'",
+        timeout=15000,
+    )
+    page.click('a[href="#/sessions"]')
+    page.wait_for_timeout(500)
+
+    ex_id = _create_exercise_via_repo(page, "Deadlifts")
+
+    # Create session
+    page.click('[data-testid="session-new-btn"]')
+    page.wait_for_selector('[data-testid="session-title"]')
+    page.fill('[data-testid="session-title"]', "Edit Reps Weight Test")
+
+    page.select_option('[data-testid="session-item-type-select"]', "exercise")
+    page.select_option('[data-testid="session-item-select"]', ex_id)
+    page.click('[data-testid="session-item-add"]')
+
+    page.click('[data-testid="session-save"]')
+    page.wait_for_selector('[data-testid="session-detail-title"]', timeout=5000)
+
+    # Edit session
+    page.click('[data-testid="session-edit-btn"]')
+    page.wait_for_selector('[data-testid="session-title"]')
+
+    # Change reps and weight
+    page.fill('[data-testid="session-item-reps-0"]', "8")
+    page.fill('[data-testid="session-item-weight-0"]', "100")
+
+    page.click('[data-testid="session-save"]')
+    page.wait_for_selector('[data-testid="session-detail-title"]', timeout=5000)
+
+    # Verify updated values
+    expect(page.locator('[data-testid="session-detail-item-0"]')).to_contain_text("Deadlifts")
+    expect(page.locator('[data-testid="session-detail-item-0"]')).to_contain_text("8")
+    expect(page.locator('[data-testid="session-detail-item-0"]')).to_contain_text("100")
+
+    _clean_sessions(page)
+    _clean_exercises(page)
+
+
+def test_combo_item_no_weight_in_form(page: Page, app_url: str):
+    """Combo items do not show weight input in session form."""
+    _go_to_sessions(page, app_url)
+    _clean_sessions(page)
+    _clean_exercises(page)
+    _clean_combos(page)
+    page.reload()
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-ready') === 'true'",
+        timeout=15000,
+    )
+    page.click('a[href="#/sessions"]')
+    page.wait_for_timeout(500)
+
+    combo_id = _create_combo_via_repo(page, "Warm-up")
+
+    page.reload()
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-ready') === 'true'",
+        timeout=15000,
+    )
+    page.click('a[href="#/sessions"]')
+    page.wait_for_timeout(500)
+
+    page.click('[data-testid="session-new-btn"]')
+    page.wait_for_selector('[data-testid="session-title"]')
+    page.fill('[data-testid="session-title"]', "Combo Weight Test")
+
+    # Add combo
+    page.select_option('[data-testid="session-item-type-select"]', "combo")
+    page.select_option('[data-testid="session-item-select"]', combo_id)
+    page.click('[data-testid="session-item-add"]')
+
+    # Verify reps input exists but weight input does not
+    expect(page.locator('[data-testid="session-item-reps-0"]')).to_be_visible()
+    expect(page.locator('[data-testid="session-item-weight-0"]')).not_to_be_attached()
+
+    # Save and verify detail view shows 0 for weight
+    page.click('[data-testid="session-save"]')
+    page.wait_for_selector('[data-testid="session-detail-title"]', timeout=5000)
+
+    expect(page.locator('[data-testid="session-detail-item-0"]')).to_contain_text("Warm-up")
+    expect(page.locator('[data-testid="session-detail-item-details-0"]')).to_contain_text("1")
+    expect(page.locator('[data-testid="session-detail-item-details-0"]')).to_contain_text("0")
+
+    _clean_sessions(page)
+    _clean_exercises(page)
+    _clean_combos(page)
+
+
+def test_reps_weight_defaults(page: Page, app_url: str):
+    """Reps prefill from the exercise's default_reps and weight defaults to 0."""
+    _go_to_sessions(page, app_url)
+    _clean_sessions(page)
+    _clean_exercises(page)
+    page.reload()
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-ready') === 'true'",
+        timeout=15000,
+    )
+    page.click('a[href="#/sessions"]')
+    page.wait_for_timeout(500)
+
+    ex_id = _create_exercise_via_repo(page, "Lunges")
+
+    page.reload()
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-ready') === 'true'",
+        timeout=15000,
+    )
+    page.click('a[href="#/sessions"]')
+    page.wait_for_timeout(500)
+
+    page.click('[data-testid="session-new-btn"]')
+    page.wait_for_selector('[data-testid="session-title"]')
+    page.fill('[data-testid="session-title"]', "Defaults Test")
+
+    # Add exercise
+    page.select_option('[data-testid="session-item-type-select"]', "exercise")
+    page.select_option('[data-testid="session-item-select"]', ex_id)
+    page.click('[data-testid="session-item-add"]')
+
+    # Verify default values in inputs (_create_exercise_via_repo sets default_reps=10)
+    reps_input = page.locator('[data-testid="session-item-reps-0"]')
+    weight_input = page.locator('[data-testid="session-item-weight-0"]')
+    expect(reps_input).to_have_value("10")
+    expect(weight_input).to_have_value("0")
+
+    # Save without changing
+    page.click('[data-testid="session-save"]')
+    page.wait_for_selector('[data-testid="session-detail-title"]', timeout=5000)
+
+    # Verify defaults are shown in detail view (always shown now)
+    expect(page.locator('[data-testid="session-detail-item-0"]')).to_contain_text("Lunges")
+    expect(page.locator('[data-testid="session-detail-item-details-0"]')).to_contain_text("10")
+    expect(page.locator('[data-testid="session-detail-item-details-0"]')).to_contain_text("0")
+
+    _clean_sessions(page)
+    _clean_exercises(page)
diff --git a/tests/test_step6_collections_home.py b/tests/test_step6_collections_home.py
new file mode 100644
index 0000000..f9bea1a
--- /dev/null
+++ b/tests/test_step6_collections_home.py
@@ -0,0 +1,943 @@
+"""
+Step 6 — Collection Management & Home Page Tests
+- test_collection_list_empty: Shows empty state when no collections exist
+- test_create_collection_minimal: Create collection with only required field (label)
+- test_create_collection_with_sessions: Create collection with sessions
+- test_collection_appears_in_list: Created collection appears in the list
+- test_collection_detail_view: Detail view shows all collection data
+- test_edit_collection: Edit a collection and verify changes
+- test_delete_collection: Delete a collection with confirmation
+- test_delete_collection_cancel: Cancelling delete does not remove collection
+- test_search_collections: Search filters collections by label
+- test_search_no_results: Search with no matches shows empty message
+- test_search_clear_button: Clear button empties the search field and restores the full list
+- test_validation_label_required: Empty label shows validation error
+- test_duplicate_label_rejected: Creating collection with duplicate label shows error
+- test_reorder_sessions: Reorder sessions in collection
+- test_remove_session: Remove a session from collection
+- test_action_bar_buttons: New and Search buttons appear in action bar
+- test_navigate_to_session_from_collection: Click session in collection detail navigates to session
+- test_home_empty_state: Home shows empty state when no executions exist
+- test_home_recent_sessions: Home shows last 4 executed sessions with dates
+- test_home_session_counts: Home shows session counts for last 7 and 30 days
+- test_home_history_section: History section groups execution logs by calendar day
+- test_home_history_date_filter: History section hides logs outside the active date range
+- test_home_play_button_visible: Play button is visible on recent session cards
+- test_home_export_html_button: HTML export button visible when data exists, absent otherwise
+"""
+from playwright.sync_api import Page, expect
+from datetime import datetime, timedelta
+
+
+def _wait_for_db(page: Page, app_url: str):
+    """Navigate and wait for the database to be ready."""
+    page.goto(app_url)
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-ready') === 'true'",
+        timeout=15000,
+    )
+
+
+def _go_to_collections(page: Page, app_url: str):
+    """Navigate to the collections list and wait for it to load."""
+    _wait_for_db(page, app_url)
+    page.click('a[href="#/collections"]')
+    page.wait_for_timeout(500)
+
+
+def _go_to_home(page: Page, app_url: str):
+    """Navigate to the home page and wait for it to load."""
+    _wait_for_db(page, app_url)
+    page.click('a[href="#/home"]')
+    page.wait_for_timeout(500)
+
+
+def _clean_collections(page: Page):
+    """Remove all collections via the repository."""
+    page.evaluate(
+        """async () => {
+            const collections = await window.__repos.collections.getAll();
+            for (const c of collections) {
+                await window.__repos.collections.delete(c.id);
+            }
+        }"""
+    )
+
+
+def _clean_sessions(page: Page):
+    """Remove all sessions via the repository."""
+    page.evaluate(
+        """async () => {
+            const sessions = await window.__repos.sessions.getAll();
+            for (const s of sessions) {
+                await window.__repos.sessions.delete(s.id);
+            }
+        }"""
+    )
+
+
+def _clean_execution_logs(page: Page):
+    """Remove all execution logs via the repository."""
+    page.evaluate(
+        """async () => {
+            const logs = await window.__repos.executionLogs.getAll();
+            for (const log of logs) {
+                await window.__repos.executionLogs.delete(log.id);
+            }
+        }"""
+    )
+
+
+def _create_session_via_repo(page: Page, title):
+    """Create a session via the repository and return its ID."""
+    return page.evaluate(
+        """async (title) => {
+            const uuid = await window.__repos.settings.get('user_uuid');
+            return window.__repos.sessions.create({
+                title: title, description: '', created_by: uuid
+            });
+        }""",
+        title,
+    )
+
+
+def test_collection_list_empty(page: Page, app_url: str):
+    """Empty state is shown when no collections exist."""
+    _go_to_collections(page, app_url)
+    _clean_collections(page)
+    page.reload()
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-ready') === 'true'",
+        timeout=15000,
+    )
+    page.click('a[href="#/collections"]')
+    page.wait_for_timeout(500)
+    expect(page.locator('[data-testid="collection-empty"]')).to_be_visible()
+
+
+def test_create_collection_minimal(page: Page, app_url: str):
+    """Create a collection with only the required label field."""
+    _go_to_collections(page, app_url)
+    _clean_collections(page)
+    page.reload()
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-ready') === 'true'",
+        timeout=15000,
+    )
+    page.click('a[href="#/collections"]')
+    page.wait_for_timeout(500)
+
+    page.click('[data-testid="collection-new-btn"]')
+    page.wait_for_selector('[data-testid="collection-label"]')
+
+    page.fill('[data-testid="collection-label"]', "My First Collection")
+    page.click('[data-testid="collection-save"]')
+    page.wait_for_selector('[data-testid="collection-detail-title"]', timeout=5000)
+
+    expect(page.locator('[data-testid="collection-detail-title"]')).to_have_text(
+        "My First Collection"
+    )
+
+    _clean_collections(page)
+
+
+def test_create_collection_with_sessions(page: Page, app_url: str):
+    """Create a collection with sessions."""
+    _go_to_collections(page, app_url)
+    _clean_collections(page)
+    _clean_sessions(page)
+    page.reload()
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-ready') === 'true'",
+        timeout=15000,
+    )
+    page.click('a[href="#/collections"]')
+    page.wait_for_timeout(500)
+
+    # Create sessions
+    session1_id = _create_session_via_repo(page, "Morning Workout")
+    session2_id = _create_session_via_repo(page, "Evening Stretch")
+
+    page.reload()
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-ready') === 'true'",
+        timeout=15000,
+    )
+    page.click('a[href="#/collections"]')
+    page.wait_for_timeout(500)
+
+    # Create collection
+    page.click('[data-testid="collection-new-btn"]')
+    page.wait_for_selector('[data-testid="collection-label"]')
+
+    page.fill('[data-testid="collection-label"]', "Weekly Plan")
+
+    # Add sessions
+    page.select_option('[data-testid="collection-session-select"]', session1_id)
+    page.click('[data-testid="collection-session-add"]')
+
+    page.select_option('[data-testid="collection-session-select"]', session2_id)
+    page.click('[data-testid="collection-session-add"]')
+
+    page.click('[data-testid="collection-save"]')
+    page.wait_for_selector('[data-testid="collection-detail-title"]', timeout=5000)
+
+    expect(page.locator('[data-testid="collection-detail-title"]')).to_have_text("Weekly Plan")
+    expect(page.locator('[data-testid="collection-detail-session-0"]')).to_contain_text(
+        "Morning Workout"
+    )
+    expect(page.locator('[data-testid="collection-detail-session-1"]')).to_contain_text(
+        "Evening Stretch"
+    )
+
+    _clean_collections(page)
+    _clean_sessions(page)
+
+
+def test_collection_appears_in_list(page: Page, app_url: str):
+    """Created collection appears in the list view."""
+    _go_to_collections(page, app_url)
+    _clean_collections(page)
+    page.reload()
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-ready') === 'true'",
+        timeout=15000,
+    )
+    page.click('a[href="#/collections"]')
+    page.wait_for_timeout(500)
+
+    page.click('[data-testid="collection-new-btn"]')
+    page.wait_for_selector('[data-testid="collection-label"]')
+    page.fill('[data-testid="collection-label"]', "Test Collection")
+    page.click('[data-testid="collection-save"]')
+    page.wait_for_selector('[data-testid="collection-detail-title"]', timeout=5000)
+
+    page.click('[data-testid="collection-back-btn"]')
+    page.wait_for_timeout(500)
+
+    expect(page.locator('[data-testid="collection-card-title"]')).to_have_text("Test Collection")
+
+    _clean_collections(page)
+
+
+def test_collection_detail_view(page: Page, app_url: str):
+    """Detail view shows all collection data correctly."""
+    _go_to_collections(page, app_url)
+    _clean_collections(page)
+    _clean_sessions(page)
+
+    session_id = _create_session_via_repo(page, "HIIT Session")
+
+    # Create collection via repo
+    collection_id = page.evaluate(
+        """async ({ sessionId }) => {
+            const uuid = await window.__repos.settings.get('user_uuid');
+            const id = await window.__repos.collections.create({
+                label: 'Training Week', created_by: uuid
+            });
+            await window.__repos.collections.setSessions(id, [sessionId]);
+            return id;
+        }""",
+        {"sessionId": session_id},
+    )
+
+    page.goto(f"{app_url}/#/collections/{collection_id}")
+    page.wait_for_selector('[data-testid="collection-detail-title"]', timeout=5000)
+
+    expect(page.locator('[data-testid="collection-detail-title"]')).to_have_text("Training Week")
+    expect(page.locator('[data-testid="collection-detail-session-0"]')).to_contain_text(
+        "HIIT Session"
+    )
+
+    _clean_collections(page)
+    _clean_sessions(page)
+
+
+def test_edit_collection(page: Page, app_url: str):
+    """Edit a collection and verify changes are persisted."""
+    _go_to_collections(page, app_url)
+    _clean_collections(page)
+    page.reload()
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-ready') === 'true'",
+        timeout=15000,
+    )
+    page.click('a[href="#/collections"]')
+    page.wait_for_timeout(500)
+
+    page.click('[data-testid="collection-new-btn"]')
+    page.wait_for_selector('[data-testid="collection-label"]')
+    page.fill('[data-testid="collection-label"]', "Original Label")
+    page.click('[data-testid="collection-save"]')
+    page.wait_for_selector('[data-testid="collection-detail-title"]', timeout=5000)
+
+    page.click('[data-testid="collection-edit-btn"]')
+    page.wait_for_selector('[data-testid="collection-label"]')
+
+    page.fill('[data-testid="collection-label"]', "Updated Label")
+
+    page.click('[data-testid="collection-save"]')
+    page.wait_for_selector('[data-testid="collection-detail-title"]', timeout=5000)
+
+    expect(page.locator('[data-testid="collection-detail-title"]')).to_have_text("Updated Label")
+
+    _clean_collections(page)
+
+
+def test_delete_collection(page: Page, app_url: str):
+    """Delete a collection with confirmation dialog."""
+    _go_to_collections(page, app_url)
+    _clean_collections(page)
+    page.reload()
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-ready') === 'true'",
+        timeout=15000,
+    )
+    page.click('a[href="#/collections"]')
+    page.wait_for_timeout(500)
+
+    page.click('[data-testid="collection-new-btn"]')
+    page.wait_for_selector('[data-testid="collection-label"]')
+    page.fill('[data-testid="collection-label"]', "To Delete")
+    page.click('[data-testid="collection-save"]')
+    page.wait_for_selector('[data-testid="collection-detail-title"]', timeout=5000)
+
+    page.on("dialog", lambda dialog: dialog.accept())
+    page.click('[data-testid="collection-delete-btn"]')
+    page.wait_for_timeout(500)
+
+    expect(page.locator('[data-testid="collection-empty"]')).to_be_visible()
+
+
+def test_delete_collection_cancel(page: Page, app_url: str):
+    """Cancelling the delete dialog does not remove the collection."""
+    _go_to_collections(page, app_url)
+    _clean_collections(page)
+    page.reload()
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-ready') === 'true'",
+        timeout=15000,
+    )
+    page.click('a[href="#/collections"]')
+    page.wait_for_timeout(500)
+
+    page.click('[data-testid="collection-new-btn"]')
+    page.wait_for_selector('[data-testid="collection-label"]')
+    page.fill('[data-testid="collection-label"]', "Keep Me")
+    page.click('[data-testid="collection-save"]')
+    page.wait_for_selector('[data-testid="collection-detail-title"]', timeout=5000)
+
+    page.on("dialog", lambda dialog: dialog.dismiss())
+    page.click('[data-testid="collection-delete-btn"]')
+    page.wait_for_timeout(500)
+
+    expect(page.locator('[data-testid="collection-detail-title"]')).to_have_text("Keep Me")
+
+    _clean_collections(page)
+
+
+def test_search_collections(page: Page, app_url: str):
+    """Search filters collections by label."""
+    _go_to_collections(page, app_url)
+    _clean_collections(page)
+
+    page.evaluate(
+        """async () => {
+            const uuid = await window.__repos.settings.get('user_uuid');
+            await window.__repos.collections.create({
+                label: 'Upper Body Week', created_by: uuid
+            });
+            await window.__repos.collections.create({
+                label: 'Lower Body Week', created_by: uuid
+            });
+            await window.__repos.collections.create({
+                label: 'Full Body Week', created_by: uuid
+            });
+        }"""
+    )
+
+    page.reload()
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-ready') === 'true'",
+        timeout=15000,
+    )
+    page.click('a[href="#/collections"]')
+    page.wait_for_timeout(500)
+
+    expect(page.locator('[data-testid="collection-card-title"]')).to_have_count(3)
+
+    page.click('[data-testid="collection-search-toggle"]')
+    page.wait_for_selector('[data-testid="collection-search-input"]')
+
+    page.fill('[data-testid="collection-search-input"]', "Upper")
+    page.wait_for_timeout(500)
+
+    expect(page.locator('[data-testid="collection-card-title"]')).to_have_count(1)
+    expect(page.locator('[data-testid="collection-card-title"]')).to_have_text("Upper Body Week")
+
+    _clean_collections(page)
+
+
+def test_search_no_results(page: Page, app_url: str):
+    """Search with no matches shows no-results message."""
+    _go_to_collections(page, app_url)
+    _clean_collections(page)
+
+    page.evaluate(
+        """async () => {
+            const uuid = await window.__repos.settings.get('user_uuid');
+            await window.__repos.collections.create({
+                label: 'Upper Body Week', created_by: uuid
+            });
+        }"""
+    )
+
+    page.reload()
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-ready') === 'true'",
+        timeout=15000,
+    )
+    page.click('a[href="#/collections"]')
+    page.wait_for_timeout(500)
+
+    page.click('[data-testid="collection-search-toggle"]')
+    page.fill('[data-testid="collection-search-input"]', "zzzznotfound")
+    page.wait_for_timeout(500)
+
+    expect(page.locator('[data-testid="collection-no-results"]')).to_be_visible()
+
+    _clean_collections(page)
+
+
+def test_search_clear_button(page: Page, app_url: str):
+    """Clear button empties the search field and restores the full list."""
+    _go_to_collections(page, app_url)
+    _clean_collections(page)
+
+    page.evaluate(
+        """async () => {
+            const uuid = await window.__repos.settings.get('user_uuid');
+            await window.__repos.collections.create({
+                label: 'Upper Body Week', created_by: uuid
+            });
+            await window.__repos.collections.create({
+                label: 'Lower Body Week', created_by: uuid
+            });
+        }"""
+    )
+
+    page.reload()
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-ready') === 'true'",
+        timeout=15000,
+    )
+    page.click('a[href="#/collections"]')
+    page.wait_for_timeout(500)
+
+    page.click('[data-testid="collection-search-toggle"]')
+
+    expect(page.locator('[data-testid="collection-search-clear"]')).not_to_be_visible()
+
+    page.fill('[data-testid="collection-search-input"]', "Upper")
+    page.wait_for_timeout(500)
+    expect(page.locator('[data-testid="collection-card-title"]')).to_have_count(1)
+
+    page.click('[data-testid="collection-search-clear"]')
+    expect(page.locator('[data-testid="collection-search-input"]')).to_have_value("")
+    page.wait_for_timeout(500)
+    expect(page.locator('[data-testid="collection-card-title"]')).to_have_count(2)
+
+    expect(page.locator('[data-testid="collection-search-input"]')).to_be_focused()
+
+    _clean_collections(page)
+
+
+def test_validation_label_required(page: Page, app_url: str):
+    """Empty label shows validation error and prevents save."""
+    _go_to_collections(page, app_url)
+    _clean_collections(page)
+    page.reload()
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-ready') === 'true'",
+        timeout=15000,
+    )
+    page.click('a[href="#/collections"]')
+    page.wait_for_timeout(500)
+
+    page.click('[data-testid="collection-new-btn"]')
+    page.wait_for_selector('[data-testid="collection-label"]')
+
+    page.click('[data-testid="collection-save"]')
+
+    expect(page.locator('[data-testid="collection-label-error"]')).to_be_visible()
+    expect(page.locator('[data-testid="collection-label"]')).to_be_visible()
+
+
+def test_duplicate_label_rejected(page: Page, app_url: str):
+    """Creating a collection with a duplicate label shows an error."""
+    _go_to_collections(page, app_url)
+    _clean_collections(page)
+    page.reload()
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-ready') === 'true'",
+        timeout=15000,
+    )
+    page.click('a[href="#/collections"]')
+    page.wait_for_timeout(500)
+
+    page.click('[data-testid="collection-new-btn"]')
+    page.wait_for_selector('[data-testid="collection-label"]')
+    page.fill('[data-testid="collection-label"]', "Unique Collection")
+    page.click('[data-testid="collection-save"]')
+    page.wait_for_selector('[data-testid="collection-detail-title"]', timeout=5000)
+
+    page.click('[data-testid="collection-back-btn"]')
+    page.wait_for_timeout(500)
+
+    page.click('[data-testid="collection-new-btn"]')
+    page.wait_for_selector('[data-testid="collection-label"]')
+    page.fill('[data-testid="collection-label"]', "Unique Collection")
+    page.click('[data-testid="collection-save"]')
+    page.wait_for_timeout(500)
+
+    label_error_visible = page.locator('[data-testid="collection-label-error"]').is_visible()
+    save_error_visible = page.locator('[data-testid="collection-save-error"]').is_visible()
+    assert label_error_visible or save_error_visible, "Expected duplicate label error"
+
+    _clean_collections(page)
+
+
+def test_reorder_sessions(page: Page, app_url: str):
+    """Reorder sessions in a collection."""
+    _go_to_collections(page, app_url)
+    _clean_collections(page)
+    _clean_sessions(page)
+    page.reload()
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-ready') === 'true'",
+        timeout=15000,
+    )
+    page.click('a[href="#/collections"]')
+    page.wait_for_timeout(500)
+
+    s1_id = _create_session_via_repo(page, "Session A")
+    s2_id = _create_session_via_repo(page, "Session B")
+    s3_id = _create_session_via_repo(page, "Session C")
+
+    page.reload()
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-ready') === 'true'",
+        timeout=15000,
+    )
+    page.click('a[href="#/collections"]')
+    page.wait_for_timeout(500)
+
+    # Create collection with 3 sessions
+    page.click('[data-testid="collection-new-btn"]')
+    page.wait_for_selector('[data-testid="collection-label"]')
+    page.fill('[data-testid="collection-label"]', "Reorder Test")
+
+    for s_id in [s1_id, s2_id, s3_id]:
+        page.select_option('[data-testid="collection-session-select"]', s_id)
+        page.click('[data-testid="collection-session-add"]')
+
+    page.click('[data-testid="collection-save"]')
+    page.wait_for_selector('[data-testid="collection-detail-title"]', timeout=5000)
+
+    # Go to edit
+    page.click('[data-testid="collection-edit-btn"]')
+    page.wait_for_selector('[data-testid="collection-label"]')
+
+    # Move Session B (index 1) up
+    page.click('[data-testid="collection-session-move-up-1"]')
+
+    # Save
+    page.click('[data-testid="collection-save"]')
+    page.wait_for_selector('[data-testid="collection-detail-title"]', timeout=5000)
+
+    # Verify order: Session B, Session A, Session C
+    expect(page.locator('[data-testid="collection-detail-session-0"]')).to_contain_text("Session B")
+    expect(page.locator('[data-testid="collection-detail-session-1"]')).to_contain_text("Session A")
+    expect(page.locator('[data-testid="collection-detail-session-2"]')).to_contain_text("Session C")
+
+    _clean_collections(page)
+    _clean_sessions(page)
+
+
+def test_remove_session(page: Page, app_url: str):
+    """Remove a session from a collection."""
+    _go_to_collections(page, app_url)
+    _clean_collections(page)
+    _clean_sessions(page)
+    page.reload()
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-ready') === 'true'",
+        timeout=15000,
+    )
+    page.click('a[href="#/collections"]')
+    page.wait_for_timeout(500)
+
+    s1_id = _create_session_via_repo(page, "Session A")
+    s2_id = _create_session_via_repo(page, "Session B")
+
+    page.reload()
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-ready') === 'true'",
+        timeout=15000,
+    )
+    page.click('a[href="#/collections"]')
+    page.wait_for_timeout(500)
+
+    # Create collection with 2 sessions
+    page.click('[data-testid="collection-new-btn"]')
+    page.wait_for_selector('[data-testid="collection-label"]')
+    page.fill('[data-testid="collection-label"]', "Remove Test")
+
+    for s_id in [s1_id, s2_id]:
+        page.select_option('[data-testid="collection-session-select"]', s_id)
+        page.click('[data-testid="collection-session-add"]')
+
+    page.click('[data-testid="collection-save"]')
+    page.wait_for_selector('[data-testid="collection-detail-title"]', timeout=5000)
+
+    # Go to edit
+    page.click('[data-testid="collection-edit-btn"]')
+    page.wait_for_selector('[data-testid="collection-label"]')
+
+    # Remove first session
+    page.click('[data-testid="collection-session-remove-0"]')
+
+    page.click('[data-testid="collection-save"]')
+    page.wait_for_selector('[data-testid="collection-detail-title"]', timeout=5000)
+
+    # Only Session B should remain
+    expect(page.locator('[data-testid="collection-detail-session-0"]')).to_contain_text("Session B")
+
+    _clean_collections(page)
+    _clean_sessions(page)
+
+
+def test_action_bar_buttons(page: Page, app_url: str):
+    """New and Search buttons are visible in the action bar on the collection list."""
+    _go_to_collections(page, app_url)
+    _clean_collections(page)
+    page.reload()
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-ready') === 'true'",
+        timeout=15000,
+    )
+    page.click('a[href="#/collections"]')
+    page.wait_for_timeout(500)
+
+    expect(page.locator('[data-testid="collection-new-btn"]')).to_be_visible()
+    expect(page.locator('[data-testid="collection-search-toggle"]')).to_be_visible()
+
+
+def test_navigate_to_session_from_collection(page: Page, app_url: str):
+    """Clicking a session in collection detail navigates to session detail."""
+    _go_to_collections(page, app_url)
+    _clean_collections(page)
+    _clean_sessions(page)
+
+    session_id = _create_session_via_repo(page, "Target Session")
+
+    collection_id = page.evaluate(
+        """async ({ sessionId }) => {
+            const uuid = await window.__repos.settings.get('user_uuid');
+            const id = await window.__repos.collections.create({
+                label: 'Navigation Test', created_by: uuid
+            });
+            await window.__repos.collections.setSessions(id, [sessionId]);
+            return id;
+        }""",
+        {"sessionId": session_id},
+    )
+
+    page.goto(f"{app_url}/#/collections/{collection_id}")
+    page.wait_for_selector('[data-testid="collection-detail-title"]', timeout=5000)
+
+    page.click('[data-testid="collection-detail-session-link-0"]')
+    page.wait_for_selector('[data-testid="session-detail-title"]', timeout=5000)
+
+    expect(page.locator('[data-testid="session-detail-title"]')).to_have_text("Target Session")
+
+    _clean_collections(page)
+    _clean_sessions(page)
+
+
+def test_home_empty_state(page: Page, app_url: str):
+    """Home shows empty state when no executions exist."""
+    _go_to_home(page, app_url)
+    _clean_execution_logs(page)
+    page.reload()
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-ready') === 'true'",
+        timeout=15000,
+    )
+    page.click('a[href="#/home"]')
+    page.wait_for_timeout(500)
+
+    expect(page.locator('[data-testid="home-empty"]')).to_be_visible()
+
+
+def test_home_recent_sessions(page: Page, app_url: str):
+    """Home shows last 4 executed sessions with inline exercise summaries."""
+    _go_to_home(page, app_url)
+    _clean_execution_logs(page)
+    _clean_sessions(page)
+
+    # Create sessions
+    session1_id = _create_session_via_repo(page, "Session One")
+    session2_id = _create_session_via_repo(page, "Session Two")
+    session3_id = _create_session_via_repo(page, "Session Three")
+    session4_id = _create_session_via_repo(page, "Session Four")
+
+    # Create execution logs with different dates
+    page.evaluate(
+        """async ({ s1, s2, s3, s4 }) => {
+            const now = new Date();
+            const logs = [
+                { session_id: s1, started_at: new Date(now - 4 * 86400000).toISOString(), finished_at: new Date(now - 4 * 86400000 + 3600000).toISOString() },
+                { session_id: s2, started_at: new Date(now - 3 * 86400000).toISOString(), finished_at: new Date(now - 3 * 86400000 + 3600000).toISOString() },
+                { session_id: s3, started_at: new Date(now - 2 * 86400000).toISOString(), finished_at: new Date(now - 2 * 86400000 + 3600000).toISOString() },
+                { session_id: s4, started_at: new Date(now - 1 * 86400000).toISOString(), finished_at: new Date(now - 1 * 86400000 + 3600000).toISOString() },
+            ];
+            for (const log of logs) {
+                await window.__repos.executionLogs.create(log);
+            }
+        }""",
+        {"s1": session1_id, "s2": session2_id, "s3": session3_id, "s4": session4_id},
+    )
+
+    page.reload()
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-ready') === 'true'",
+        timeout=15000,
+    )
+    page.click('a[href="#/home"]')
+    page.wait_for_timeout(500)
+
+    # Should show the 4 most recent (Session Four, Three, Two, One)
+    expect(page.locator('[data-testid="home-recent-session-title"]')).to_have_count(4)
+
+    # Most recent first
+    expect(page.locator('[data-testid="home-recent-session-title"]').first).to_have_text(
+        "Session Four"
+    )
+
+    _clean_execution_logs(page)
+    _clean_sessions(page)
+
+
+def test_home_session_counts(page: Page, app_url: str):
+    """Home shows session counts for last 7 and 30 days."""
+    _go_to_home(page, app_url)
+    _clean_execution_logs(page)
+    _clean_sessions(page)
+
+    session_id = _create_session_via_repo(page, "Count Session")
+
+    # Create 2 logs within 7 days, 3 more within 30 days
+    page.evaluate(
+        """async ({ sessionId }) => {
+            const now = new Date();
+            const logs = [
+                { session_id: sessionId, started_at: new Date(now - 1 * 86400000).toISOString(), finished_at: new Date(now - 1 * 86400000 + 3600000).toISOString() },
+                { session_id: sessionId, started_at: new Date(now - 3 * 86400000).toISOString(), finished_at: new Date(now - 3 * 86400000 + 3600000).toISOString() },
+                { session_id: sessionId, started_at: new Date(now - 10 * 86400000).toISOString(), finished_at: new Date(now - 10 * 86400000 + 3600000).toISOString() },
+                { session_id: sessionId, started_at: new Date(now - 15 * 86400000).toISOString(), finished_at: new Date(now - 15 * 86400000 + 3600000).toISOString() },
+                { session_id: sessionId, started_at: new Date(now - 25 * 86400000).toISOString(), finished_at: new Date(now - 25 * 86400000 + 3600000).toISOString() },
+            ];
+            for (const log of logs) {
+                await window.__repos.executionLogs.create(log);
+            }
+        }""",
+        {"sessionId": session_id},
+    )
+
+    page.reload()
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-ready') === 'true'",
+        timeout=15000,
+    )
+    page.click('a[href="#/home"]')
+    page.wait_for_timeout(500)
+
+    # 2 within 7 days
+    expect(page.locator('[data-testid="home-stat-7days"] .stat-value')).to_have_text("2")
+    # 5 within 30 days
+    expect(page.locator('[data-testid="home-stat-30days"] .stat-value')).to_have_text("5")
+
+    _clean_execution_logs(page)
+    _clean_sessions(page)
+
+
+def test_home_history_section(page: Page, app_url: str):
+    """History section groups execution logs by calendar day."""
+    _go_to_home(page, app_url)
+    _clean_execution_logs(page)
+    _clean_sessions(page)
+
+    session_id = _create_session_via_repo(page, "History Session")
+
+    # Two logs on two different days (today and yesterday)
+    page.evaluate(
+        """async ({ sessionId }) => {
+            const now = new Date();
+            const yesterday = new Date(now - 86400000);
+            const logs = [
+                { session_id: sessionId, started_at: now.toISOString(), finished_at: new Date(now.getTime() + 3600000).toISOString() },
+                { session_id: sessionId, started_at: yesterday.toISOString(), finished_at: new Date(yesterday.getTime() + 3600000).toISOString() },
+            ];
+            for (const log of logs) {
+                await window.__repos.executionLogs.create(log);
+            }
+        }""",
+        {"sessionId": session_id},
+    )
+
+    page.reload()
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-ready') === 'true'",
+        timeout=15000,
+    )
+    page.click('a[href="#/home"]')
+    page.wait_for_timeout(500)
+
+    # History section must show 2 day groups (the .history-day-label elements)
+    expect(page.locator(".history-day-label")).to_have_count(2)
+
+    # Both logs are visible as history cards
+    history_cards = page.locator('[data-testid^="home-history-session-"]')
+    expect(history_cards).to_have_count(2)
+
+    _clean_execution_logs(page)
+    _clean_sessions(page)
+
+
+def test_home_history_date_filter(page: Page, app_url: str):
+    """History section hides execution logs that fall outside the active date range."""
+    _go_to_home(page, app_url)
+    _clean_execution_logs(page)
+    _clean_sessions(page)
+
+    session_id = _create_session_via_repo(page, "Filter Session")
+
+    # One log 5 days ago (inside default 30-day window) and one 40 days ago (outside)
+    page.evaluate(
+        """async ({ sessionId }) => {
+            const now = new Date();
+            const logs = [
+                {
+                    session_id: sessionId,
+                    started_at: new Date(now - 5 * 86400000).toISOString(),
+                    finished_at: new Date(now - 5 * 86400000 + 3600000).toISOString()
+                },
+                {
+                    session_id: sessionId,
+                    started_at: new Date(now - 40 * 86400000).toISOString(),
+                    finished_at: new Date(now - 40 * 86400000 + 3600000).toISOString()
+                },
+            ];
+            for (const log of logs) {
+                await window.__repos.executionLogs.create(log);
+            }
+        }""",
+        {"sessionId": session_id},
+    )
+
+    page.reload()
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-ready') === 'true'",
+        timeout=15000,
+    )
+    page.click('a[href="#/home"]')
+    page.wait_for_timeout(500)
+
+    # Default filter is last 30 days: only the 5-day-ago log shows in history
+    history_cards = page.locator('[data-testid^="home-history-session-"]')
+    expect(history_cards).to_have_count(1)
+
+    _clean_execution_logs(page)
+    _clean_sessions(page)
+
+
+def test_home_play_button_visible(page: Page, app_url: str):
+    """Play button is visible on each recent session card."""
+    _go_to_home(page, app_url)
+    _clean_execution_logs(page)
+    _clean_sessions(page)
+
+    session_id = _create_session_via_repo(page, "Play Button Session")
+
+    page.evaluate(
+        """async ({ sessionId }) => {
+            const now = new Date();
+            await window.__repos.executionLogs.create({
+                session_id: sessionId,
+                started_at: now.toISOString(),
+                finished_at: new Date(now.getTime() + 3600000).toISOString(),
+            });
+        }""",
+        {"sessionId": session_id},
+    )
+
+    page.reload()
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-ready') === 'true'",
+        timeout=15000,
+    )
+    page.click('a[href="#/home"]')
+    page.wait_for_timeout(500)
+
+    play_btn = page.locator(f'[data-testid="home-recent-session-play-{session_id}"]')
+    expect(play_btn).to_be_visible()
+
+    _clean_execution_logs(page)
+    _clean_sessions(page)
+
+
+def test_home_export_html_button(page: Page, app_url: str):
+    """HTML export button is visible when execution logs exist and absent on empty state."""
+    _go_to_home(page, app_url)
+    _clean_execution_logs(page)
+    _clean_sessions(page)
+
+    page.reload()
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-ready') === 'true'",
+        timeout=15000,
+    )
+    page.click('a[href="#/home"]')
+    page.wait_for_timeout(500)
+
+    # No data: export button must not be rendered
+    expect(page.locator('[data-testid="home-export-html-btn"]')).to_have_count(0)
+
+    # Create a session and an execution log
+    session_id = _create_session_via_repo(page, "Export Session")
+    page.evaluate(
+        """async ({ sessionId }) => {
+            const now = new Date();
+            await window.__repos.executionLogs.create({
+                session_id: sessionId,
+                started_at: now.toISOString(),
+                finished_at: new Date(now.getTime() + 1800000).toISOString(),
+            });
+        }""",
+        {"sessionId": session_id},
+    )
+
+    page.reload()
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-ready') === 'true'",
+        timeout=15000,
+    )
+    page.click('a[href="#/home"]')
+    page.wait_for_timeout(500)
+
+    # With data: export button must be visible
+    expect(page.locator('[data-testid="home-export-html-btn"]')).to_be_visible()
+
+    _clean_execution_logs(page)
+    _clean_sessions(page)
diff --git a/tests/test_step7_import_export.py b/tests/test_step7_import_export.py
new file mode 100644
index 0000000..e4fde0f
--- /dev/null
+++ b/tests/test_step7_import_export.py
@@ -0,0 +1,1089 @@
+"""
+Step 7 — Full Data Import/Export Tests
+- test_full_export_import_roundtrip: Export all data then import back, verify all entities
+- test_cross_entity_reference_integrity: After ID collision remapping, references stay valid
+- test_new_id_propagation_to_combo: new_id UUID is propagated to combo exercise FK on collision
+- test_per_entity_export_from_detail_views: Export single combo/session/collection from detail
+- test_different_user_suffix_applies_to_all_types: Suffix applied to exercises, combos, sessions, collections
+- test_same_user_collision_combo: Same-user combo collision with replace/skip
+- test_same_user_collision_session: Same-user session collision with replace/skip
+- test_same_user_collision_collection: Same-user collection collision with replace/skip
+- test_export_filter_all_enabled: All checkboxes enabled in export filter dialog
+- test_import_combo_list_view: Import button visible on combo list
+- test_import_session_list_view: Import button visible on session list
+- test_import_collection_list_view: Import button visible on collection list
+- test_full_export_from_settings: Full export button in settings works
+- test_import_as_mine_combo: Import-as-mine button works on combo list
+- test_import_as_mine_session: Import-as-mine button works on session list
+- test_execution_logs_same_user_roundtrip: Execution logs survive a same-user export/import cycle
+- test_execution_log_id_remapping: Log item exercise_id is remapped when the exercise gets a new_id
+- test_session_with_combo_item_remapping: Session combo item_id follows remap when combo gets new_id
+- test_collection_session_remapping: Collection session ref follows remap when session gets new_id
+- test_settings_import_roundtrip: Settings values are applied after import
+- test_single_entity_export_buttons_session_collection: Export button visible on session/collection detail
+- test_export_respects_active_search_filter: Exporting while a search filter is active only exports matching items
+- test_single_export_bundles_dependencies: Exporting a combo/session/collection bundles its dependencies
+- test_settings_export_filter_bundles_dependencies: Settings export filter bundles dependencies for a partial selection
+"""
+import json
+import os
+from playwright.sync_api import Page, expect
+
+
+def _wait_for_db(page: Page, app_url: str):
+    page.goto(app_url)
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-ready') === 'true'",
+        timeout=15000,
+    )
+
+
+def _go_to(page: Page, app_url: str, hash_path: str):
+    _wait_for_db(page, app_url)
+    page.click(f'a[href="{hash_path}"]')
+    page.wait_for_timeout(500)
+
+
+def _clean_all(page: Page):
+    page.evaluate(
+        """async () => {
+            const exercises = await window.__repos.exercises.getAll();
+            for (const ex of exercises) await window.__repos.exercises.delete(ex.id);
+            const combos = await window.__repos.combos.getAll();
+            for (const c of combos) await window.__repos.combos.delete(c.id);
+            const sessions = await window.__repos.sessions.getAll();
+            for (const s of sessions) await window.__repos.sessions.delete(s.id);
+            const collections = await window.__repos.collections.getAll();
+            for (const c of collections) await window.__repos.collections.delete(c.id);
+            const suffixes = await window.__repos.suffixes.getAll();
+            for (const s of suffixes) await window.__repos.suffixes.delete(s.user_uuid);
+        }"""
+    )
+
+
+def _create_exercise(page: Page, title, exercise_id=None, created_by=None):
+    return page.evaluate(
+        """async ([title, exerciseId, createdBy]) => {
+            const uuid = await window.__repos.settings.get('user_uuid');
+            const cb = createdBy || uuid;
+            if (exerciseId) {
+                await window.__repos.exercises.createWithId(exerciseId, {
+                    title, description: '', asymmetric: false, alternate: false,
+                    image_urls: [], video_urls: [], default_reps: 10, default_weight: 20,
+                    created_by: cb,
+                });
+                return exerciseId;
+            }
+            return await window.__repos.exercises.create({
+                title, description: '', asymmetric: false, alternate: false,
+                image_urls: [], video_urls: [], default_reps: 10, default_weight: 20,
+                created_by: cb,
+            });
+        }""",
+        [title, exercise_id, created_by],
+    )
+
+
+def _create_combo(page: Page, title, exercise_ids, combo_id=None, created_by=None):
+    return page.evaluate(
+        """async ([title, exerciseIds, comboId, createdBy]) => {
+            const uuid = await window.__repos.settings.get('user_uuid');
+            const cb = createdBy || uuid;
+            const id = comboId || crypto.randomUUID();
+            await window.__repos.combos.createWithId(id, {
+                title, description: '', type: 'NONE', timer_config: {}, created_by: cb,
+            });
+            const exercises = exerciseIds.map((eid, i) => ({
+                exerciseId: eid, position: i, defaultReps: 5, defaultWeight: 10,
+            }));
+            await window.__repos.combos.setExercises(id, exercises);
+            return id;
+        }""",
+        [title, exercise_ids, combo_id, created_by],
+    )
+
+
+def _create_session(page: Page, title, items, session_id=None, created_by=None):
+    return page.evaluate(
+        """async ([title, items, sessionId, createdBy]) => {
+            const uuid = await window.__repos.settings.get('user_uuid');
+            const cb = createdBy || uuid;
+            const id = sessionId || crypto.randomUUID();
+            await window.__repos.sessions.createWithId(id, {
+                title, description: '', created_by: cb,
+            });
+            const sessionItems = items.map((item, i) => ({
+                item_id: item.item_id,
+                item_type: item.item_type,
+                repetitions: item.repetitions || 1,
+                weight: item.weight !== undefined ? item.weight : 0.0,
+            }));
+            await window.__repos.sessions.setItems(id, sessionItems);
+            return id;
+        }""",
+        [title, items, session_id, created_by],
+    )
+
+
+def _create_collection(page: Page, label, session_ids, collection_id=None, created_by=None):
+    return page.evaluate(
+        """async ([label, sessionIds, collectionId, createdBy]) => {
+            const uuid = await window.__repos.settings.get('user_uuid');
+            const cb = createdBy || uuid;
+            const id = collectionId || crypto.randomUUID();
+            await window.__repos.collections.createWithId(id, { label, created_by: cb });
+            await window.__repos.collections.setSessions(id, sessionIds);
+            return id;
+        }""",
+        [label, session_ids, collection_id, created_by],
+    )
+
+
+def _build_full_export_json(page: Page):
+    """Build a full export JSON envelope from current database state."""
+    return page.evaluate(
+        """async () => {
+            const exercises = await window.__repos.exercises.getAll();
+            const combos = await window.__repos.combos.getAllWithExercises();
+            const sessions = await window.__repos.sessions.getAllWithItems();
+            const collections = await window.__repos.collections.getAllWithSessions();
+            const executionLogs = await window.__repos.executionLogs.getAllWithItems();
+            const userName = await window.__repos.settings.get('user_name');
+            const userUuid = await window.__repos.settings.get('user_uuid');
+
+            return JSON.stringify({
+                metadata: {
+                    appName: 'trainus',
+                    appVersion: '1.0.0',
+                    schemaVersion: 1,
+                    exportDate: new Date().toISOString(),
+                    exportedBy: { name: userName || 'User', uuid: userUuid },
+                },
+                data: {
+                    exercises, combos, sessions, collections, executionLogs,
+                },
+            });
+        }"""
+    )
+
+
+def _build_different_user_export_json(page: Page):
+    """Build an export JSON with a different user UUID."""
+    return page.evaluate(
+        """async () => {
+            const exercises = await window.__repos.exercises.getAll();
+            const combos = await window.__repos.combos.getAllWithExercises();
+            const sessions = await window.__repos.sessions.getAllWithItems();
+            const collections = await window.__repos.collections.getAllWithSessions();
+
+            return JSON.stringify({
+                metadata: {
+                    appName: 'trainus',
+                    appVersion: '1.0.0',
+                    schemaVersion: 1,
+                    exportDate: new Date().toISOString(),
+                    exportedBy: { name: 'Other User', uuid: 'other-user-uuid-789' },
+                },
+                data: {
+                    exercises, combos, sessions, collections,
+                },
+            });
+        }"""
+    )
+
+
+def _load_fixture(filename: str) -> str:
+    """Read a static JSON fixture from tests/fixtures/."""
+    path = os.path.join(os.path.dirname(__file__), "fixtures", filename)
+    with open(path, "r", encoding="utf-8") as f:
+        return f.read()
+
+
+def _create_execution_log(page: Page, session_id: str, exercise_id: str) -> str:
+    """Create an execution log with one completed item; returns the log ID."""
+    return page.evaluate(
+        """async ([sessionId, exerciseId]) => {
+            const logId = await window.__repos.executionLogs.create({
+                session_id: sessionId,
+                started_at: new Date().toISOString(),
+                finished_at: new Date().toISOString(),
+            });
+            await window.__repos.executionLogs.addItem({
+                log_id: logId,
+                exercise_id: exerciseId,
+                round_number: 1,
+                reps_done: 10,
+                weight_used: 50,
+                side: null,
+                completed: true,
+                timestamp: new Date().toISOString(),
+            });
+            return logId;
+        }""",
+        [session_id, exercise_id],
+    )
+
+
+def _trigger_import_with_json(page: Page, json_str: str, test_id: str = "exercise-import-btn"):
+    """Trigger import by intercepting file chooser."""
+    with page.expect_file_chooser() as fc_info:
+        page.click(f'[data-testid="{test_id}"]')
+    file_chooser = fc_info.value
+    file_chooser.set_files(
+        [
+            {
+                "name": "test-import.json",
+                "mimeType": "application/json",
+                "buffer": json_str.encode("utf-8"),
+            }
+        ]
+    )
+
+
+def test_full_export_import_roundtrip(page: Page, app_url: str):
+    """Export all data then import back, verify all entities are restored."""
+    _go_to(page, app_url, "#/exercises")
+    _clean_all(page)
+
+    exercise_id = _create_exercise(page, "Push-ups")
+    combo_id = _create_combo(page, "Upper Body", [exercise_id])
+    session_id = _create_session(
+        page, "Day 1", [{"item_id": exercise_id, "item_type": "exercise", "repetitions": 10, "weight": 0}]
+    )
+    _create_collection(page, "Week 1", [session_id])
+
+    json_str = _build_full_export_json(page)
+
+    page.evaluate(
+        """async () => {
+            const exercises = await window.__repos.exercises.getAll();
+            for (const ex of exercises) await window.__repos.exercises.delete(ex.id);
+            const combos = await window.__repos.combos.getAll();
+            for (const c of combos) await window.__repos.combos.delete(c.id);
+            const sessions = await window.__repos.sessions.getAll();
+            for (const s of sessions) await window.__repos.sessions.delete(s.id);
+            const collections = await window.__repos.collections.getAll();
+            for (const c of collections) await window.__repos.collections.delete(c.id);
+        }"""
+    )
+
+    page.click('a[href="#/exercises"]')
+    page.wait_for_timeout(500)
+    expect(page.locator('[data-testid="exercise-empty"]')).to_be_visible()
+
+    _trigger_import_with_json(page, json_str)
+
+    # Wait for the import dialog to finish parsing and land on a known step.
+    # Under parallel load, 500ms fixed wait is unreliable — wait for the actual
+    # apply button to become visible instead (present in both 'preview' and
+    # 'collisions' steps).
+    expect(page.locator('[data-testid="import-apply"]')).to_be_visible(timeout=10000)
+
+    page.locator('[data-testid="import-apply"]').click()
+
+    # Wait for the report step rather than using a fixed timeout.
+    expect(page.locator('[data-testid="import-report-step"]')).to_be_visible(timeout=15000)
+    page.click('[data-testid="import-done"]')
+    page.wait_for_timeout(500)
+
+    exercise_count = page.evaluate("async () => (await window.__repos.exercises.getAll()).length")
+    combo_count = page.evaluate("async () => (await window.__repos.combos.getAll()).length")
+    session_count = page.evaluate("async () => (await window.__repos.sessions.getAll()).length")
+    collection_count = page.evaluate("async () => (await window.__repos.collections.getAll()).length")
+
+    assert exercise_count == 1, f"Expected 1 exercise, got {exercise_count}"
+    assert combo_count == 1, f"Expected 1 combo, got {combo_count}"
+    assert session_count == 1, f"Expected 1 session, got {session_count}"
+    assert collection_count == 1, f"Expected 1 collection, got {collection_count}"
+
+
+def test_cross_entity_reference_integrity(page: Page, app_url: str):
+    """After ID collision remapping, combo exercises still reference correctly."""
+    _go_to(page, app_url, "#/exercises")
+    _clean_all(page)
+
+    other_uuid = "other-user-uuid-123"
+    ex_id = _create_exercise(page, "Squats", created_by=other_uuid)
+    _create_combo(page, "Leg Day", [ex_id], created_by=other_uuid)
+
+    json_str = _build_different_user_export_json(page)
+
+    page.evaluate(
+        """async () => {
+            const exercises = await window.__repos.exercises.getAll();
+            for (const ex of exercises) await window.__repos.exercises.delete(ex.id);
+            const combos = await window.__repos.combos.getAll();
+            for (const c of combos) await window.__repos.combos.delete(c.id);
+        }"""
+    )
+
+    page.click('a[href="#/exercises"]')
+    page.wait_for_timeout(500)
+
+    _trigger_import_with_json(page, json_str)
+    page.wait_for_timeout(500)
+
+    page.locator('[data-testid="import-suffix-input"]').fill("OD")
+    page.locator('[data-testid="import-suffix-confirm"]').click()
+    page.wait_for_timeout(500)
+
+    page.locator('[data-testid="import-apply"]').click()
+    page.wait_for_timeout(1000)
+    page.click('[data-testid="import-done"]')
+    page.wait_for_timeout(500)
+
+    combo = page.evaluate(
+        """async () => {
+            const combos = await window.__repos.combos.getAll();
+            if (combos.length === 0) return null;
+            return await window.__repos.combos.getById(combos[0].id);
+        }"""
+    )
+
+    assert combo is not None, "Combo should exist after import"
+    assert len(combo.get("exercises", [])) == 1, "Combo should have 1 exercise"
+    assert combo["exercises"][0]["title"] == "Squats [OD]", f"Exercise title should have suffix: {combo['exercises'][0]['title']}"
+
+
+def test_per_entity_export_from_detail_views(page: Page, app_url: str):
+    """Export single combo/session/collection from their detail views."""
+    _go_to(page, app_url, "#/exercises")
+    _clean_all(page)
+
+    ex_id = _create_exercise(page, "Pull-ups")
+    combo_id = _create_combo(page, "Back Blast", [ex_id])
+
+    page.click('a[href="#/combos"]')
+    page.wait_for_timeout(500)
+    page.click(f'[data-testid="combo-card-{combo_id}"]')
+    page.wait_for_timeout(500)
+
+    expect(page.locator('[data-testid="combo-export-single-btn"]')).to_be_visible()
+
+
+def test_different_user_suffix_applies_to_all_types(page: Page, app_url: str):
+    """Suffix is applied to exercises, combos, sessions, and collections from different user."""
+    _go_to(page, app_url, "#/exercises")
+    _clean_all(page)
+
+    other_uuid = "other-user-456"
+    ex_id = _create_exercise(page, "Burpees", created_by=other_uuid)
+    _create_combo(page, "HIIT", [ex_id], created_by=other_uuid)
+    _create_session(
+        page, "Cardio Day", [{"item_id": ex_id, "item_type": "exercise", "repetitions": 15, "weight": 0}],
+        created_by=other_uuid,
+    )
+    _create_collection(page, "Cardio Week", [], created_by=other_uuid)
+
+    json_str = _build_different_user_export_json(page)
+
+    page.evaluate(
+        """async () => {
+            const exercises = await window.__repos.exercises.getAll();
+            for (const ex of exercises) await window.__repos.exercises.delete(ex.id);
+            const combos = await window.__repos.combos.getAll();
+            for (const c of combos) await window.__repos.combos.delete(c.id);
+            const sessions = await window.__repos.sessions.getAll();
+            for (const s of sessions) await window.__repos.sessions.delete(s.id);
+            const collections = await window.__repos.collections.getAll();
+            for (const c of collections) await window.__repos.collections.delete(c.id);
+        }"""
+    )
+
+    page.click('a[href="#/exercises"]')
+    page.wait_for_timeout(500)
+
+    _trigger_import_with_json(page, json_str)
+    page.wait_for_timeout(500)
+
+    page.locator('[data-testid="import-suffix-input"]').fill("HI")
+    page.locator('[data-testid="import-suffix-confirm"]').click()
+    page.wait_for_timeout(500)
+    page.locator('[data-testid="import-apply"]').click()
+    page.wait_for_timeout(1000)
+    page.click('[data-testid="import-done"]')
+    page.wait_for_timeout(500)
+
+    exercise_title = page.evaluate(
+        """async () => {
+            const exercises = await window.__repos.exercises.getAll();
+            return exercises[0]?.title;
+        }"""
+    )
+    combo_title = page.evaluate(
+        """async () => {
+            const combos = await window.__repos.combos.getAll();
+            return combos[0]?.title;
+        }"""
+    )
+    session_title = page.evaluate(
+        """async () => {
+            const sessions = await window.__repos.sessions.getAll();
+            return sessions[0]?.title;
+        }"""
+    )
+    collection_label = page.evaluate(
+        """async () => {
+            const collections = await window.__repos.collections.getAll();
+            return collections[0]?.label;
+        }"""
+    )
+
+    assert "[HI]" in exercise_title, f"Exercise title should have suffix: {exercise_title}"
+    assert "[HI]" in combo_title, f"Combo title should have suffix: {combo_title}"
+    assert "[HI]" in session_title, f"Session title should have suffix: {session_title}"
+    assert "[HI]" in collection_label, f"Collection label should have suffix: {collection_label}"
+
+
+def test_same_user_collision_combo(page: Page, app_url: str):
+    """Same-user combo collision shows replace/skip options."""
+    _go_to(page, app_url, "#/exercises")
+    _clean_all(page)
+
+    local_uuid = page.evaluate("async () => await window.__repos.settings.get('user_uuid')")
+    ex_id = _create_exercise(page, "Deadlifts")
+    _create_combo(page, "Power", [ex_id], created_by=local_uuid)
+
+    json_str = _build_full_export_json(page)
+
+    page.click('a[href="#/combos"]')
+    page.wait_for_timeout(500)
+
+    _trigger_import_with_json(page, json_str, "combo-import-btn")
+    page.wait_for_timeout(500)
+
+    expect(page.locator('[data-testid="collision-group-combos"]')).to_be_visible()
+
+
+def test_same_user_collision_session(page: Page, app_url: str):
+    """Same-user session collision shows replace/skip options."""
+    _go_to(page, app_url, "#/exercises")
+    _clean_all(page)
+
+    local_uuid = page.evaluate("async () => await window.__repos.settings.get('user_uuid')")
+    ex_id = _create_exercise(page, "Lunges")
+    _create_session(
+        page, "Leg Day", [{"item_id": ex_id, "item_type": "exercise", "repetitions": 12, "weight": 0}],
+        created_by=local_uuid,
+    )
+
+    json_str = _build_full_export_json(page)
+
+    page.click('a[href="#/sessions"]')
+    page.wait_for_timeout(500)
+
+    _trigger_import_with_json(page, json_str, "session-import-btn")
+    page.wait_for_timeout(500)
+
+    expect(page.locator('[data-testid="collision-group-sessions"]')).to_be_visible()
+
+
+def test_same_user_collision_collection(page: Page, app_url: str):
+    """Same-user collection collision shows replace/skip options."""
+    _go_to(page, app_url, "#/exercises")
+    _clean_all(page)
+
+    local_uuid = page.evaluate("async () => await window.__repos.settings.get('user_uuid')")
+    ex_id = _create_exercise(page, "Plank")
+    session_id = _create_session(
+        page, "Core", [{"item_id": ex_id, "item_type": "exercise", "repetitions": 3, "weight": 0}],
+        created_by=local_uuid,
+    )
+    _create_collection(page, "Core Week", [session_id], created_by=local_uuid)
+
+    json_str = _build_full_export_json(page)
+
+    page.click('a[href="#/collections"]')
+    page.wait_for_timeout(500)
+
+    _trigger_import_with_json(page, json_str, "collection-import-btn")
+    page.wait_for_timeout(500)
+
+    expect(page.locator('[data-testid="collision-group-collections"]')).to_be_visible()
+
+
+def test_export_filter_all_enabled(page: Page, app_url: str):
+    """All checkboxes are enabled in the export filter dialog."""
+    _go_to(page, app_url, "#/settings")
+    _clean_all(page)
+
+    page.click('a[href="#/settings"]')
+    page.wait_for_timeout(500)
+    page.click('[data-testid="settings-export"]')
+    page.wait_for_timeout(500)
+
+    for test_id in [
+        "export-filter-exercises",
+        "export-filter-combos",
+        "export-filter-sessions",
+        "export-filter-collections",
+        "export-filter-execution-logs",
+        "export-filter-settings",
+    ]:
+        checkbox = page.locator(f'[data-testid="{test_id}"] input')
+        expect(checkbox).to_be_enabled()
+
+    page.click('[data-testid="export-filter-cancel"]')
+
+
+def test_import_combo_list_view(page: Page, app_url: str):
+    """Import button is visible on combo list view."""
+    _go_to(page, app_url, "#/combos")
+    expect(page.locator('[data-testid="combo-import-btn"]')).to_be_visible()
+    expect(page.locator('[data-testid="combo-export-btn"]')).to_be_visible()
+
+
+def test_import_session_list_view(page: Page, app_url: str):
+    """Import button is visible on session list view."""
+    _go_to(page, app_url, "#/sessions")
+    expect(page.locator('[data-testid="session-import-btn"]')).to_be_visible()
+    expect(page.locator('[data-testid="session-export-btn"]')).to_be_visible()
+
+
+def test_import_collection_list_view(page: Page, app_url: str):
+    """Import button is visible on collection list view."""
+    _go_to(page, app_url, "#/collections")
+    expect(page.locator('[data-testid="collection-import-btn"]')).to_be_visible()
+    expect(page.locator('[data-testid="collection-export-btn"]')).to_be_visible()
+
+
+def test_full_export_from_settings(page: Page, app_url: str):
+    """Full export button in settings is visible."""
+    _go_to(page, app_url, "#/settings")
+    _clean_all(page)
+    _create_exercise(page, "Test Exercise")
+
+    page.click('a[href="#/settings"]')
+    page.wait_for_timeout(500)
+    expect(page.locator('[data-testid="settings-export-all"]')).to_be_visible()
+
+    # Clean up so subsequent tests (chromium variants) start with an empty DB.
+    _clean_all(page)
+
+
+def test_import_as_mine_combo(page: Page, app_url: str):
+    """Import-as-mine button is visible on combo list."""
+    _go_to(page, app_url, "#/combos")
+    expect(page.locator('[data-testid="combo-import-as-mine-btn"]')).to_be_visible()
+
+
+def test_import_as_mine_session(page: Page, app_url: str):
+    """Import-as-mine button is visible on session list."""
+    _go_to(page, app_url, "#/sessions")
+    expect(page.locator('[data-testid="session-import-as-mine-btn"]')).to_be_visible()
+
+
+def test_new_id_propagation_to_combo(page: Page, app_url: str):
+    """When a different-user exercise collides with a local exercise (same ID, different created_by),
+    a new UUID is generated and the combo's exercise FK is remapped to that new UUID."""
+    _go_to(page, app_url, "#/exercises")
+    _clean_all(page)
+
+    # Create a local exercise with a known, fixed UUID owned by the local user.
+    # This will collide with the imported exercise below (same ID, different created_by).
+    conflicting_id = "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee"
+    _create_exercise(page, "Local Exercise", exercise_id=conflicting_id)
+
+    other_uuid = "other-user-uuid-collision-999"
+    combo_id = "11111111-2222-3333-4444-555555555555"
+
+    import_json = _load_fixture("cross_user_id_collision.json")
+
+    _trigger_import_with_json(page, import_json)
+    page.wait_for_timeout(500)
+
+    page.locator('[data-testid="import-suffix-input"]').fill("OT")
+    page.locator('[data-testid="import-suffix-confirm"]').click()
+    page.wait_for_timeout(500)
+
+    page.locator('[data-testid="import-apply"]').click()
+    expect(page.locator('[data-testid="import-report-step"]')).to_be_visible(timeout=15000)
+    page.click('[data-testid="import-done"]')
+    page.wait_for_timeout(500)
+
+    result = page.evaluate(
+        """async ([conflictingId, otherUuid]) => {
+            const allExercises = await window.__repos.exercises.getAll();
+            const localEx = allExercises.find(e => e.id === conflictingId);
+            const importedEx = allExercises.find(e => e.created_by === otherUuid);
+
+            const allCombos = await window.__repos.combos.getAllWithExercises();
+            const importedCombo = allCombos.find(c => c.created_by === otherUuid);
+
+            return {
+                localExExists: !!localEx,
+                importedExId: importedEx?.id ?? null,
+                comboExerciseRef: importedCombo?.exercises?.[0]?.exercise_id ?? null,
+            };
+        }""",
+        [conflicting_id, other_uuid],
+    )
+
+    assert result["localExExists"], "Local exercise must still exist with its original ID"
+    assert result["importedExId"] is not None, "Imported exercise must exist"
+    assert result["importedExId"] != conflicting_id, (
+        f"Imported exercise must have a new UUID, not the conflicting one ({conflicting_id})"
+    )
+    assert result["comboExerciseRef"] == result["importedExId"], (
+        f"Combo exercise FK ({result['comboExerciseRef']}) must point to the "
+        f"new exercise UUID ({result['importedExId']}), not the original conflicting ID"
+    )
+
+
+# ---------------------------------------------------------------------------
+# New coverage tests added to complete all import/export paths
+# ---------------------------------------------------------------------------
+
+FIXTURE_USER_UUID = "facade00-0000-4000-a000-000000000001"
+FIXTURE_EX1_ID = "facade00-0000-4000-a000-e00000000001"
+FIXTURE_COMBO_ID = "facade00-0000-4000-a000-c00000000001"
+FIXTURE_SESSION_ID = "facade00-0000-4000-a000-500000000001"
+FIXTURE_LOG_ID = "facade00-0000-4000-a000-100000000001"
+
+
+def test_execution_logs_same_user_roundtrip(page: Page, app_url: str):
+    """Execution log (with one item) survives a same-user export → clear → reimport cycle."""
+    _go_to(page, app_url, "#/exercises")
+    _clean_all(page)
+
+    ex_id = _create_exercise(page, "Log Roundtrip Exercise")
+    session_id = _create_session(
+        page,
+        "Log Roundtrip Session",
+        [{"item_id": ex_id, "item_type": "exercise", "repetitions": 10, "weight": 0}],
+    )
+    _create_execution_log(page, session_id, ex_id)
+
+    json_str = _build_full_export_json(page)
+
+    # Delete everything — execution_log cascades from session delete
+    page.evaluate(
+        """async () => {
+            const exercises = await window.__repos.exercises.getAll();
+            for (const ex of exercises) await window.__repos.exercises.delete(ex.id);
+            const sessions = await window.__repos.sessions.getAll();
+            for (const s of sessions) await window.__repos.sessions.delete(s.id);
+        }"""
+    )
+
+    page.click('a[href="#/exercises"]')
+    page.wait_for_timeout(500)
+
+    _trigger_import_with_json(page, json_str)
+    expect(page.locator('[data-testid="import-apply"]')).to_be_visible(timeout=10000)
+    page.locator('[data-testid="import-apply"]').click()
+    expect(page.locator('[data-testid="import-report-step"]')).to_be_visible(timeout=15000)
+    page.click('[data-testid="import-done"]')
+    page.wait_for_timeout(500)
+
+    result = page.evaluate(
+        """async () => {
+            const logs = await window.__repos.executionLogs.getAllWithItems();
+            if (logs.length === 0) return { count: 0 };
+            const log = logs[0];
+            const sessionExists = !!(await window.__repos.sessions.getById(log.session_id));
+            return { count: logs.length, itemCount: log.items.length, sessionExists };
+        }"""
+    )
+
+    assert result["count"] == 1, f"Expected 1 execution log after reimport, got {result['count']}"
+    assert result["itemCount"] == 1, f"Expected 1 log item, got {result['itemCount']}"
+    assert result["sessionExists"], "Log session_id must reference an existing session after reimport"
+
+
+def test_execution_log_id_remapping(page: Page, app_url: str):
+    """When an exercise gets new_id on collision, the execution log item's exercise_id is remapped."""
+    _go_to(page, app_url, "#/exercises")
+    _clean_all(page)
+
+    # Collide with fixture's exercise 1: same ID, owned by local user → triggers new_id
+    _create_exercise(page, "Local Colliding Exercise", exercise_id=FIXTURE_EX1_ID)
+
+    _trigger_import_with_json(page, _load_fixture("cross_user_full.json"))
+    page.wait_for_timeout(500)
+
+    page.locator('[data-testid="import-suffix-input"]').fill("FX")
+    page.locator('[data-testid="import-suffix-confirm"]').click()
+    page.wait_for_timeout(500)
+
+    page.locator('[data-testid="import-apply"]').click()
+    expect(page.locator('[data-testid="import-report-step"]')).to_be_visible(timeout=15000)
+    page.click('[data-testid="import-done"]')
+    page.wait_for_timeout(500)
+
+    result = page.evaluate(
+        """async ([fixedExId, exporterUuid, logId]) => {
+            const importedEx = (await window.__repos.exercises.getAll())
+                .find(e => e.created_by === exporterUuid && e.id !== fixedExId);
+            const log = await window.__repos.executionLogs.getById(logId);
+            return {
+                importedExId: importedEx?.id ?? null,
+                logItemExerciseId: log?.items?.[0]?.exercise_id ?? null,
+            };
+        }""",
+        [FIXTURE_EX1_ID, FIXTURE_USER_UUID, FIXTURE_LOG_ID],
+    )
+
+    assert result["importedExId"] is not None, "Imported exercise must exist with a new UUID"
+    assert result["importedExId"] != FIXTURE_EX1_ID, (
+        f"Imported exercise must have a new UUID, not the colliding one ({FIXTURE_EX1_ID})"
+    )
+    assert result["logItemExerciseId"] == result["importedExId"], (
+        f"Log item exercise_id ({result['logItemExerciseId']}) must be remapped "
+        f"to the new exercise UUID ({result['importedExId']})"
+    )
+
+
+def test_session_with_combo_item_remapping(page: Page, app_url: str):
+    """Session item with item_type='combo' has its item_id remapped when the combo gets new_id."""
+    _go_to(page, app_url, "#/exercises")
+    _clean_all(page)
+
+    # Collide with fixture's combo: same ID, owned by local user → triggers new_id for imported combo
+    page.evaluate(
+        """async () => {
+            const uuid = await window.__repos.settings.get('user_uuid');
+            await window.__repos.combos.createWithId(
+                'facade00-0000-4000-a000-c00000000001',
+                { title: 'Local Combo', description: '', type: 'NONE',
+                  timer_config: {}, created_by: uuid }
+            );
+        }"""
+    )
+
+    _trigger_import_with_json(page, _load_fixture("cross_user_full.json"))
+    page.wait_for_timeout(500)
+
+    page.locator('[data-testid="import-suffix-input"]').fill("FX")
+    page.locator('[data-testid="import-suffix-confirm"]').click()
+    page.wait_for_timeout(500)
+
+    page.locator('[data-testid="import-apply"]').click()
+    expect(page.locator('[data-testid="import-report-step"]')).to_be_visible(timeout=15000)
+    page.click('[data-testid="import-done"]')
+    page.wait_for_timeout(500)
+
+    result = page.evaluate(
+        """async ([fixedComboId, exporterUuid, sessionId]) => {
+            const importedCombo = (await window.__repos.combos.getAll())
+                .find(c => c.created_by === exporterUuid);
+            const sess = await window.__repos.sessions.getById(sessionId);
+            const comboItem = sess?.items?.find(i => i.item_type === 'combo');
+            return {
+                importedComboId: importedCombo?.id ?? null,
+                sessionComboItemId: comboItem?.item_id ?? null,
+            };
+        }""",
+        [FIXTURE_COMBO_ID, FIXTURE_USER_UUID, FIXTURE_SESSION_ID],
+    )
+
+    assert result["importedComboId"] is not None, "Imported combo must exist with a new UUID"
+    assert result["importedComboId"] != FIXTURE_COMBO_ID, (
+        f"Imported combo must have a new UUID, not the colliding one ({FIXTURE_COMBO_ID})"
+    )
+    assert result["sessionComboItemId"] == result["importedComboId"], (
+        f"Session combo item_id ({result['sessionComboItemId']}) must be remapped "
+        f"to the new combo UUID ({result['importedComboId']})"
+    )
+
+
+def test_collection_session_remapping(page: Page, app_url: str):
+    """Collection session reference is remapped when the imported session gets new_id on collision."""
+    _go_to(page, app_url, "#/exercises")
+    _clean_all(page)
+
+    # Collide with fixture's session: same ID, owned by local user → triggers new_id for imported session
+    page.evaluate(
+        """async () => {
+            const uuid = await window.__repos.settings.get('user_uuid');
+            await window.__repos.sessions.createWithId(
+                'facade00-0000-4000-a000-500000000001',
+                { title: 'Local Session', description: '', created_by: uuid }
+            );
+        }"""
+    )
+
+    _trigger_import_with_json(page, _load_fixture("cross_user_full.json"))
+    page.wait_for_timeout(500)
+
+    page.locator('[data-testid="import-suffix-input"]').fill("FX")
+    page.locator('[data-testid="import-suffix-confirm"]').click()
+    page.wait_for_timeout(500)
+
+    page.locator('[data-testid="import-apply"]').click()
+    expect(page.locator('[data-testid="import-report-step"]')).to_be_visible(timeout=15000)
+    page.click('[data-testid="import-done"]')
+    page.wait_for_timeout(500)
+
+    result = page.evaluate(
+        """async (exporterUuid) => {
+            const importedSession = (await window.__repos.sessions.getAll())
+                .find(s => s.created_by === exporterUuid);
+            const allCollections = await window.__repos.collections.getAll();
+            const importedColl = allCollections.find(c => c.created_by === exporterUuid);
+            const collDetail = importedColl
+                ? await window.__repos.collections.getById(importedColl.id)
+                : null;
+            return {
+                importedSessionId: importedSession?.id ?? null,
+                collectionSessionRef: collDetail?.sessions?.[0]?.session_id ?? null,
+            };
+        }""",
+        FIXTURE_USER_UUID,
+    )
+
+    assert result["importedSessionId"] is not None, "Imported session must exist with a new UUID"
+    assert result["importedSessionId"] != FIXTURE_SESSION_ID, (
+        f"Imported session must have a new UUID, not the colliding one ({FIXTURE_SESSION_ID})"
+    )
+    assert result["collectionSessionRef"] == result["importedSessionId"], (
+        f"Collection session ref ({result['collectionSessionRef']}) must be remapped "
+        f"to the new session UUID ({result['importedSessionId']})"
+    )
+
+
+def test_settings_import_roundtrip(page: Page, app_url: str):
+    """Settings values from an import envelope are applied to the database."""
+    _go_to(page, app_url, "#/exercises")
+
+    original_lang = page.evaluate(
+        "async () => await window.__repos.settings.get('language')"
+    )
+
+    # Build a settings-only envelope using the local UUID to avoid the suffix prompt
+    json_str = page.evaluate(
+        """async () => {
+            const uuid = await window.__repos.settings.get('user_uuid');
+            return JSON.stringify({
+                metadata: {
+                    appName: 'trainus', appVersion: '1.0.0', schemaVersion: 1,
+                    exportDate: new Date().toISOString(),
+                    exportedBy: { name: 'Me', uuid },
+                },
+                data: { settings: { language: 'fr', theme: 'dark' } },
+            });
+        }"""
+    )
+
+    _trigger_import_with_json(page, json_str)
+    expect(page.locator('[data-testid="import-apply"]')).to_be_visible(timeout=10000)
+    page.locator('[data-testid="import-apply"]').click()
+    expect(page.locator('[data-testid="import-report-step"]')).to_be_visible(timeout=15000)
+    page.click('[data-testid="import-done"]')
+    page.wait_for_timeout(500)
+
+    lang = page.evaluate("async () => await window.__repos.settings.get('language')")
+    theme = page.evaluate("async () => await window.__repos.settings.get('theme')")
+
+    # Restore original settings so subsequent tests are not affected
+    page.evaluate(
+        """async ([lang]) => {
+            await window.__repos.settings.set('language', lang);
+            await window.__repos.settings.set('theme', 'light');
+        }""",
+        [original_lang or "en"],
+    )
+
+    assert lang == "fr", f"language should be 'fr' after import, got '{lang}'"
+    assert theme == "dark", f"theme should be 'dark' after import, got '{theme}'"
+
+
+def test_single_entity_export_buttons_session_collection(page: Page, app_url: str):
+    """Single-entity export button is visible on both session and collection detail views."""
+    _go_to(page, app_url, "#/exercises")
+    _clean_all(page)
+
+    ex_id = _create_exercise(page, "Detail Export Exercise")
+    session_id = _create_session(
+        page,
+        "Detail Export Session",
+        [{"item_id": ex_id, "item_type": "exercise", "repetitions": 5, "weight": 0}],
+    )
+    collection_id = _create_collection(page, "Detail Export Collection", [session_id])
+
+    # Session detail
+    page.click('a[href="#/sessions"]')
+    page.wait_for_timeout(500)
+    page.click(f'[data-testid="session-card-{session_id}"]')
+    page.wait_for_timeout(500)
+    expect(page.locator('[data-testid="session-export-single-btn"]')).to_be_visible()
+
+    # Collection detail
+    page.click('a[href="#/collections"]')
+    page.wait_for_timeout(500)
+    page.click(f'[data-testid="collection-card-{collection_id}"]')
+    page.wait_for_timeout(500)
+    expect(page.locator('[data-testid="collection-export-single-btn"]')).to_be_visible()
+
+
+def _export_via_button(page: Page, export_btn_selector: str, tmp_dir):
+    """Click an export button, confirm the save-file prompt, and return the parsed JSON."""
+    page.click(export_btn_selector)
+    page.wait_for_selector('[data-testid="save-file-input"]')
+    with page.expect_download() as download_info:
+        page.click('[data-testid="save-file-confirm"]')
+    out_path = str(tmp_dir / "export.json")
+    download_info.value.save_as(out_path)
+    with open(out_path, "r", encoding="utf-8") as f:
+        return json.load(f)
+
+
+def test_export_respects_active_search_filter(page: Page, app_url: str, tmp_path_factory):
+    """Exporting from a list view while a search filter is active only exports the filtered items."""
+    _go_to(page, app_url, "#/exercises")
+    _clean_all(page)
+
+    ex_a = _create_exercise(page, "Squats")
+    ex_b = _create_exercise(page, "Burpees")
+    _create_combo(page, "Squat Combo", [ex_a])
+    _create_combo(page, "Burpee Combo", [ex_b])
+    session_a = _create_session(
+        page, "Squat Session", [{"item_id": ex_a, "item_type": "exercise"}]
+    )
+    _create_session(page, "Burpee Session", [{"item_id": ex_b, "item_type": "exercise"}])
+    _create_collection(page, "Squat Week", [session_a])
+    _create_collection(page, "Burpee Week", [])
+
+    tmp_dir = tmp_path_factory.mktemp("filtered_export")
+
+    page.click('a[href="#/exercises"]')
+    page.wait_for_timeout(300)
+    page.click('[data-testid="exercise-search-toggle"]')
+    page.fill('[data-testid="exercise-search-input"]', "Squat")
+    page.wait_for_timeout(400)
+    data = _export_via_button(page, '[data-testid="exercise-export-btn"]', tmp_dir)
+    titles = [e["title"] for e in data["data"]["exercises"]]
+    assert titles == ["Squats"], f"Expected only the filtered exercise, got: {titles}"
+
+    page.click('a[href="#/combos"]')
+    page.wait_for_timeout(300)
+    page.click('[data-testid="combo-search-toggle"]')
+    page.fill('[data-testid="combo-search-input"]', "Squat")
+    page.wait_for_timeout(400)
+    data = _export_via_button(page, '[data-testid="combo-export-btn"]', tmp_dir)
+    titles = [c["title"] for c in data["data"]["combos"]]
+    assert titles == ["Squat Combo"], f"Expected only the filtered combo, got: {titles}"
+
+    page.click('a[href="#/sessions"]')
+    page.wait_for_timeout(300)
+    page.click('[data-testid="session-search-toggle"]')
+    page.fill('[data-testid="session-search-input"]', "Squat")
+    page.wait_for_timeout(400)
+    data = _export_via_button(page, '[data-testid="session-export-btn"]', tmp_dir)
+    titles = [s["title"] for s in data["data"]["sessions"]]
+    assert titles == ["Squat Session"], f"Expected only the filtered session, got: {titles}"
+
+    page.click('a[href="#/collections"]')
+    page.wait_for_timeout(300)
+    page.click('[data-testid="collection-search-toggle"]')
+    page.fill('[data-testid="collection-search-input"]', "Squat")
+    page.wait_for_timeout(400)
+    data = _export_via_button(page, '[data-testid="collection-export-btn"]', tmp_dir)
+    labels = [c["label"] for c in data["data"]["collections"]]
+    assert labels == ["Squat Week"], f"Expected only the filtered collection, got: {labels}"
+
+
+def test_single_export_bundles_dependencies(page: Page, app_url: str, tmp_path_factory):
+    """Exporting a combo/session/collection bundles the exercises/combos/sessions it depends on."""
+    _go_to(page, app_url, "#/exercises")
+    _clean_all(page)
+
+    ex_a = _create_exercise(page, "Squats")
+    ex_b = _create_exercise(page, "Lunges")
+    combo_id = _create_combo(page, "Leg Combo", [ex_a, ex_b])
+    session_id = _create_session(
+        page,
+        "Leg Day",
+        [
+            {"item_id": ex_a, "item_type": "exercise"},
+            {"item_id": combo_id, "item_type": "combo"},
+        ],
+    )
+    collection_id = _create_collection(page, "Leg Week", [session_id])
+
+    tmp_dir = tmp_path_factory.mktemp("dependency_export")
+
+    page.click('a[href="#/combos"]')
+    page.wait_for_timeout(500)
+    page.click(f'[data-testid="combo-card-{combo_id}"]')
+    page.wait_for_timeout(500)
+    data = _export_via_button(page, '[data-testid="combo-export-single-btn"]', tmp_dir)
+    exercise_titles = {e["title"] for e in data["data"].get("exercises", [])}
+    assert exercise_titles == {"Squats", "Lunges"}, (
+        f"Combo export should bundle its exercises, got: {exercise_titles}"
+    )
+
+    page.click('a[href="#/sessions"]')
+    page.wait_for_timeout(500)
+    page.click(f'[data-testid="session-card-{session_id}"]')
+    page.wait_for_timeout(500)
+    data = _export_via_button(page, '[data-testid="session-export-single-btn"]', tmp_dir)
+    exercise_titles = {e["title"] for e in data["data"].get("exercises", [])}
+    combo_titles = {c["title"] for c in data["data"].get("combos", [])}
+    assert exercise_titles == {"Squats", "Lunges"}, (
+        f"Session export should bundle all referenced exercises, got: {exercise_titles}"
+    )
+    assert combo_titles == {"Leg Combo"}, (
+        f"Session export should bundle its referenced combo, got: {combo_titles}"
+    )
+
+    page.click('a[href="#/collections"]')
+    page.wait_for_timeout(500)
+    page.click(f'[data-testid="collection-card-{collection_id}"]')
+    page.wait_for_timeout(500)
+    data = _export_via_button(page, '[data-testid="collection-export-single-btn"]', tmp_dir)
+    session_titles = {s["title"] for s in data["data"].get("sessions", [])}
+    combo_titles = {c["title"] for c in data["data"].get("combos", [])}
+    exercise_titles = {e["title"] for e in data["data"].get("exercises", [])}
+    assert session_titles == {"Leg Day"}, (
+        f"Collection export should bundle its session, got: {session_titles}"
+    )
+    assert combo_titles == {"Leg Combo"}, (
+        f"Collection export should bundle the session's combo, got: {combo_titles}"
+    )
+    assert exercise_titles == {"Squats", "Lunges"}, (
+        f"Collection export should bundle all transitive exercises, got: {exercise_titles}"
+    )
+
+
+def test_settings_export_filter_bundles_dependencies(page: Page, app_url: str, tmp_path_factory):
+    """Settings export filter dialog bundles dependencies even when only sessions is selected."""
+    _go_to(page, app_url, "#/exercises")
+    _clean_all(page)
+
+    ex_a = _create_exercise(page, "Squats")
+    combo_id = _create_combo(page, "Leg Combo", [ex_a])
+    _create_session(
+        page,
+        "Leg Day",
+        [{"item_id": combo_id, "item_type": "combo"}],
+    )
+
+    tmp_dir = tmp_path_factory.mktemp("settings_filter_export")
+
+    page.click('a[href="#/settings"]')
+    page.wait_for_timeout(500)
+    page.click('[data-testid="settings-export"]')
+    page.wait_for_selector('[data-testid="export-filter-sessions"]')
+
+    # Uncheck everything except sessions
+    for testid in ["export-filter-exercises", "export-filter-combos", "export-filter-collections"]:
+        page.locator(f'[data-testid="{testid}"] input[type="checkbox"]').uncheck()
+
+    page.click('[data-testid="export-filter-confirm"]')
+    page.wait_for_selector('[data-testid="save-file-input"]')
+    with page.expect_download() as download_info:
+        page.click('[data-testid="save-file-confirm"]')
+    out_path = str(tmp_dir / "export.json")
+    download_info.value.save_as(out_path)
+    with open(out_path, "r", encoding="utf-8") as f:
+        data = json.load(f)
+
+    exercise_titles = {e["title"] for e in data["data"].get("exercises", [])}
+    combo_titles = {c["title"] for c in data["data"].get("combos", [])}
+    assert combo_titles == {"Leg Combo"}, (
+        f"Sessions-only export should bundle the referenced combo, got: {combo_titles}"
+    )
+    assert exercise_titles == {"Squats"}, (
+        f"Sessions-only export should bundle the transitively referenced exercise, got: {exercise_titles}"
+    )
diff --git a/tests/test_step8_execution.py b/tests/test_step8_execution.py
new file mode 100644
index 0000000..d219a7d
--- /dev/null
+++ b/tests/test_step8_execution.py
@@ -0,0 +1,516 @@
+"""
+Step 8 — Execution Mode Tests
+
+- test_start_session_navigates_to_execute: Clicking play from detail view navigates to execute view
+- test_session_list_play_buttons: Play buttons appear on each session card in the list
+- test_execute_view_elements: Execute view shows title, progress, current step, next step
+- test_steps_advance_on_done: Pressing Done advances to the next step
+- test_reps_weight_editable_and_saved: Reps and weight inputs are editable and saved to log
+- test_session_complete_after_last_step: Completing all steps redirects to session detail
+- test_asymmetric_side_shown: Side toggle visible for asymmetric exercises only
+- test_asymmetric_side_logged: Side value is saved in the execution log
+- test_combo_rounds_auto_advance: Non-final combo rounds advance silently (no pause screen)
+- test_final_round_screen_shown: Final-round screen appears after last exercise of last round
+- test_continue_advances_past_combo: Continue button advances to next session item
+- test_one_more_round_appends_round: One More Round inserts an extra round into the queue
+- test_exit_mid_session_saves_partial_log: Exit saves only completed items to log
+- test_prefill_from_last_session_run: Re-executing a session prefills from last run
+- test_no_prior_log_uses_defaults: No prior log uses session item defaults for prefill
+- test_progress_bar_reflects_position: Progress label updates as steps are completed
+- test_combo_context_shown: Combo name and round number shown in step card for combo exercises
+"""
+import pytest
+from playwright.sync_api import Page, expect
+
+
+def _wait_for_db(page: Page, app_url: str):
+    page.goto(app_url)
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-ready') === 'true'",
+        timeout=15000,
+    )
+
+
+def _wait_for_execute(page: Page):
+    """Wait for the execute view to be fully loaded."""
+    page.wait_for_selector('[data-testid="execute-session-title"]', timeout=10000)
+    page.wait_for_timeout(300)
+
+
+def _create_exercise(page: Page, title: str, asymmetric=False, alternate=False,
+                      default_reps=10, default_weight=0):
+    return page.evaluate(f"""async () => {{
+        const userId = await window.__repos.settings.get('user_uuid')
+        return window.__repos.exercises.create({{
+            title: {repr(title)},
+            description: '',
+            asymmetric: {'true' if asymmetric else 'false'},
+            alternate: {'true' if alternate else 'false'},
+            image_urls: '[]',
+            video_urls: '[]',
+            default_reps: {default_reps},
+            default_weight: {default_weight},
+            created_by: userId
+        }})
+    }}""")
+
+
+def _create_session_with_exercises(page: Page, title: str, items: list):
+    """items: list of dicts with exerciseId, reps, weight."""
+    items_json = str(items).replace("'", '"').replace("True", "true").replace("False", "false")
+    return page.evaluate(f"""async () => {{
+        const userId = await window.__repos.settings.get('user_uuid')
+        const sessId = await window.__repos.sessions.create({{
+            title: {repr(title)}, description: '', created_by: userId
+        }})
+        const items = {items_json}
+        const mapped = items.map((it, i) => ({{
+            item_id: it.item_id, item_type: it.item_type,
+            position: i, repetitions: it.repetitions, weight: it.weight
+        }}))
+        await window.__repos.sessions.setItems(sessId, mapped)
+        return sessId
+    }}""")
+
+
+def _create_combo(page: Page, title: str, exercises: list):
+    """exercises: list of {{exerciseId, defaultReps, defaultWeight}}."""
+    exercises_json = str(exercises).replace("'", '"').replace("True", "true").replace("False", "false")
+    return page.evaluate(f"""async () => {{
+        const userId = await window.__repos.settings.get('user_uuid')
+        const comboId = await window.__repos.combos.create({{
+            title: {repr(title)}, description: '', type: 'NONE',
+            timer_config: {{}}, created_by: userId
+        }})
+        const exercises = {exercises_json}
+        await window.__repos.combos.setExercises(comboId, exercises.map(e => ({{
+            exerciseId: e.exerciseId,
+            defaultReps: e.defaultReps,
+            defaultWeight: e.defaultWeight
+        }})))
+        return comboId
+    }}""")
+
+
+def _clean_all(page: Page):
+    page.evaluate("""async () => {
+        const sessions = await window.__repos.sessions.getAll()
+        for (const s of sessions) await window.__repos.sessions.delete(s.id)
+        const combos = await window.__repos.combos.getAll()
+        for (const c of combos) await window.__repos.combos.delete(c.id)
+        const exercises = await window.__repos.exercises.getAll()
+        for (const e of exercises) await window.__repos.exercises.delete(e.id)
+    }""")
+
+
+# ── fixtures ──────────────────────────────────────────────────────────────
+
+
+@pytest.fixture
+def simple_session(page: Page, app_url: str):
+    """A session with one exercise."""
+    _wait_for_db(page, app_url)
+    _clean_all(page)
+    ex_id = _create_exercise(page, "Press", default_reps=8, default_weight=50)
+    sess_id = _create_session_with_exercises(page, "Simple Session", [
+        {"item_id": ex_id, "item_type": "exercise", "repetitions": 8, "weight": 50}
+    ])
+    return {"sess_id": sess_id, "ex_id": ex_id}
+
+
+@pytest.fixture
+def two_step_session(page: Page, app_url: str):
+    """A session with two exercises."""
+    _wait_for_db(page, app_url)
+    _clean_all(page)
+    ex1 = _create_exercise(page, "Step One", default_reps=5, default_weight=30)
+    ex2 = _create_exercise(page, "Step Two", default_reps=10, default_weight=0)
+    sess_id = _create_session_with_exercises(page, "Two Step Session", [
+        {"item_id": ex1, "item_type": "exercise", "repetitions": 5, "weight": 30},
+        {"item_id": ex2, "item_type": "exercise", "repetitions": 10, "weight": 0},
+    ])
+    return {"sess_id": sess_id, "ex1": ex1, "ex2": ex2}
+
+
+@pytest.fixture
+def asymmetric_session(page: Page, app_url: str):
+    """A session with an asymmetric exercise."""
+    _wait_for_db(page, app_url)
+    _clean_all(page)
+    ex_id = _create_exercise(page, "Lunge", asymmetric=True, alternate=True,
+                             default_reps=12, default_weight=0)
+    sess_id = _create_session_with_exercises(page, "Asym Session", [
+        {"item_id": ex_id, "item_type": "exercise", "repetitions": 12, "weight": 0}
+    ])
+    return {"sess_id": sess_id, "ex_id": ex_id}
+
+
+@pytest.fixture
+def combo_session(page: Page, app_url: str):
+    """A session with a 2-exercise combo run for 2 rounds."""
+    _wait_for_db(page, app_url)
+    _clean_all(page)
+    ex1 = _create_exercise(page, "Squat", default_reps=15, default_weight=0)
+    ex2 = _create_exercise(page, "Jump", default_reps=20, default_weight=0)
+    combo_id = _create_combo(page, "HIIT", [
+        {"exerciseId": ex1, "defaultReps": 15, "defaultWeight": 0},
+        {"exerciseId": ex2, "defaultReps": 20, "defaultWeight": 0},
+    ])
+    sess_id = _create_session_with_exercises(page, "Combo Session", [
+        {"item_id": combo_id, "item_type": "combo", "repetitions": 2, "weight": 0}
+    ])
+    return {"sess_id": sess_id, "combo_id": combo_id, "ex1": ex1, "ex2": ex2}
+
+
+@pytest.fixture
+def mixed_session(page: Page, app_url: str):
+    """A session with an exercise followed by a combo."""
+    _wait_for_db(page, app_url)
+    _clean_all(page)
+    ex_solo = _create_exercise(page, "Solo Ex", default_reps=5, default_weight=0)
+    ex_c1 = _create_exercise(page, "Combo Ex1", default_reps=10, default_weight=0)
+    ex_c2 = _create_exercise(page, "Combo Ex2", default_reps=10, default_weight=0)
+    combo_id = _create_combo(page, "Mini Combo", [
+        {"exerciseId": ex_c1, "defaultReps": 10, "defaultWeight": 0},
+        {"exerciseId": ex_c2, "defaultReps": 10, "defaultWeight": 0},
+    ])
+    sess_id = _create_session_with_exercises(page, "Mixed Session", [
+        {"item_id": ex_solo, "item_type": "exercise", "repetitions": 5, "weight": 0},
+        {"item_id": combo_id, "item_type": "combo", "repetitions": 1, "weight": 0},
+    ])
+    return {"sess_id": sess_id}
+
+
+# ── tests ─────────────────────────────────────────────────────────────────
+
+
+def test_start_session_navigates_to_execute(page: Page, app_url: str, simple_session):
+    """Clicking play button from the session detail view navigates to execute view."""
+    sess_id = simple_session["sess_id"]
+    page.goto(f"{app_url}#/sessions/{sess_id}")
+    page.wait_for_timeout(600)
+
+    execute_btn = page.locator('[data-testid="session-execute-btn"]')
+    expect(execute_btn).to_be_visible()
+    execute_btn.click()
+    page.wait_for_timeout(800)
+
+    assert f"/sessions/{sess_id}/execute" in page.url
+    expect(page.locator('[data-testid="execute-session-title"]')).to_be_visible()
+
+
+def test_session_list_play_buttons(page: Page, app_url: str, simple_session):
+    """Every session card in the list shows a play button."""
+    sess_id = simple_session["sess_id"]
+    page.goto(f"{app_url}#/sessions")
+    page.wait_for_timeout(600)
+
+    play_btn = page.locator(f'[data-testid="session-card-play-{sess_id}"]')
+    expect(play_btn).to_be_visible()
+
+
+def test_execute_view_elements(page: Page, app_url: str, two_step_session):
+    """Execute view shows session title, progress, current step, and next step preview."""
+    sess_id = two_step_session["sess_id"]
+    page.goto(f"{app_url}#/sessions/{sess_id}/execute")
+    _wait_for_execute(page)
+
+    expect(page.locator('[data-testid="execute-session-title"]')).to_have_text("Two Step Session")
+    expect(page.locator('[data-testid="execute-progress-label"]')).to_contain_text("0 / 2")
+    expect(page.locator('[data-testid="execute-current-step"]')).to_be_visible()
+    expect(page.locator('[data-testid="execute-reps-input"]')).to_be_visible()
+    expect(page.locator('[data-testid="execute-weight-input"]')).to_be_visible()
+    expect(page.locator('[data-testid="execute-done-btn"]')).to_be_visible()
+    expect(page.locator('[data-testid="execute-next-step"]')).to_be_visible()
+
+
+def test_steps_advance_on_done(page: Page, app_url: str, two_step_session):
+    """Pressing Done advances from one step to the next."""
+    sess_id = two_step_session["sess_id"]
+    page.goto(f"{app_url}#/sessions/{sess_id}/execute")
+    _wait_for_execute(page)
+
+    first_title = page.locator('[data-testid="execute-exercise-title"]').inner_text()
+    assert first_title == "Step One"
+
+    page.click('[data-testid="execute-done-btn"]')
+    page.wait_for_timeout(500)
+
+    second_title = page.locator('[data-testid="execute-exercise-title"]').inner_text()
+    assert second_title == "Step Two"
+
+    progress = page.locator('[data-testid="execute-progress-label"]').inner_text()
+    assert "1 / 2" in progress
+
+
+def test_reps_weight_editable_and_saved(page: Page, app_url: str, simple_session):
+    """Reps and weight inputs can be edited and the values are saved to the execution log."""
+    sess_id = simple_session["sess_id"]
+    page.goto(f"{app_url}#/sessions/{sess_id}/execute")
+    _wait_for_execute(page)
+
+    page.fill('[data-testid="execute-reps-input"]', "12")
+    page.fill('[data-testid="execute-weight-input"]', "55")
+    page.click('[data-testid="execute-done-btn"]')
+    page.wait_for_timeout(800)
+
+    # Check log saved correct values
+    result = page.evaluate(f"""async () => {{
+        const logs = await window.__repos.executionLogs.getBySessionId('{sess_id}')
+        if (!logs.length) return null
+        const items = await window.__repos.executionLogs.getItems(logs[0].id)
+        return items.length ? {{reps: items[0].reps_done, weight: items[0].weight_used}} : null
+    }}""")
+    assert result is not None
+    assert result["reps"] == 12
+    assert result["weight"] == 55.0
+
+
+def test_session_complete_after_last_step(page: Page, app_url: str, simple_session):
+    """Completing all steps redirects back to the session detail view."""
+    sess_id = simple_session["sess_id"]
+    page.goto(f"{app_url}#/sessions/{sess_id}/execute")
+    _wait_for_execute(page)
+
+    page.click('[data-testid="execute-done-btn"]')
+    page.wait_for_timeout(800)
+
+    assert f"/sessions/{sess_id}" in page.url
+    assert "/execute" not in page.url
+
+
+def test_asymmetric_side_shown(page: Page, app_url: str, asymmetric_session):
+    """Side toggle is visible for asymmetric exercises and hidden for non-asymmetric ones."""
+    _wait_for_db(page, app_url)
+    _clean_all(page)
+
+    ex_sym = _create_exercise(page, "Squat Sym", default_reps=10)
+    ex_asym = _create_exercise(page, "Lunge Asym", asymmetric=True, alternate=True, default_reps=10)
+    sess_id = _create_session_with_exercises(page, "Side Test Session", [
+        {"item_id": ex_sym, "item_type": "exercise", "repetitions": 10, "weight": 0},
+        {"item_id": ex_asym, "item_type": "exercise", "repetitions": 10, "weight": 0},
+    ])
+
+    page.goto(f"{app_url}#/sessions/{sess_id}/execute")
+    _wait_for_execute(page)
+
+    # First step: non-asymmetric — no side toggle
+    expect(page.locator('[data-testid="execute-side-toggle"]')).not_to_be_visible()
+
+    page.click('[data-testid="execute-done-btn"]')
+    page.wait_for_timeout(500)
+
+    # Second step: asymmetric — side toggle visible
+    side_toggle = page.locator('[data-testid="execute-side-toggle"]')
+    expect(side_toggle).to_be_visible()
+    assert "LEFT" in side_toggle.inner_text() or "RIGHT" in side_toggle.inner_text()
+
+    # Toggle side
+    initial = side_toggle.inner_text()
+    side_toggle.click()
+    page.wait_for_timeout(200)
+    toggled = side_toggle.inner_text()
+    assert initial != toggled
+
+
+def test_asymmetric_side_logged(page: Page, app_url: str, asymmetric_session):
+    """Side value is stored in execution_log_item.side for asymmetric exercises."""
+    sess_id = asymmetric_session["sess_id"]
+    page.goto(f"{app_url}#/sessions/{sess_id}/execute")
+    _wait_for_execute(page)
+
+    # Switch to RIGHT
+    page.click('[data-testid="execute-side-toggle"]')
+    page.wait_for_timeout(200)
+    page.click('[data-testid="execute-done-btn"]')
+    page.wait_for_timeout(800)
+
+    result = page.evaluate(f"""async () => {{
+        const logs = await window.__repos.executionLogs.getBySessionId('{sess_id}')
+        if (!logs.length) return null
+        const items = await window.__repos.executionLogs.getItems(logs[0].id)
+        return items.length ? items[0].side : null
+    }}""")
+    assert result == "right"
+
+
+def test_combo_rounds_auto_advance(page: Page, app_url: str, combo_session):
+    """Between non-final rounds of a combo, no final-round screen appears."""
+    sess_id = combo_session["sess_id"]
+    page.goto(f"{app_url}#/sessions/{sess_id}/execute")
+    _wait_for_execute(page)
+
+    # Step 1: Squat Round 1
+    page.click('[data-testid="execute-done-btn"]')
+    page.wait_for_timeout(500)
+
+    # Step 2: Jump Round 1 — after Done, should auto-advance to Round 2 (no pause screen)
+    page.click('[data-testid="execute-done-btn"]')
+    page.wait_for_timeout(500)
+
+    # No final-round screen; we should be on Squat Round 2
+    expect(page.locator('[data-testid="execute-final-round"]')).not_to_be_visible()
+    expect(page.locator('[data-testid="execute-exercise-title"]')).to_have_text("Squat")
+    combo_ctx = page.locator('[data-testid="execute-combo-context"]').inner_text()
+    assert "2" in combo_ctx
+
+
+def test_final_round_screen_shown(page: Page, app_url: str, combo_session):
+    """Final-round screen appears after the last exercise of the last round."""
+    sess_id = combo_session["sess_id"]
+    page.goto(f"{app_url}#/sessions/{sess_id}/execute")
+    _wait_for_execute(page)
+
+    # Complete all 4 steps (2 exercises × 2 rounds)
+    for _ in range(3):
+        page.click('[data-testid="execute-done-btn"]')
+        page.wait_for_timeout(500)
+
+    # Step 4 — last exercise of last round
+    page.click('[data-testid="execute-done-btn"]')
+    page.wait_for_timeout(500)
+
+    expect(page.locator('[data-testid="execute-final-round"]')).to_be_visible()
+    expect(page.locator('[data-testid="execute-continue-btn"]')).to_be_visible()
+    expect(page.locator('[data-testid="execute-one-more-btn"]')).to_be_visible()
+
+
+def test_continue_advances_past_combo(page: Page, app_url: str, mixed_session):
+    """Continue → after last combo round advances to the next session item."""
+    sess_id = mixed_session["sess_id"]
+    page.goto(f"{app_url}#/sessions/{sess_id}/execute")
+    _wait_for_execute(page)
+
+    # Solo Ex (step 1)
+    page.click('[data-testid="execute-done-btn"]')
+    page.wait_for_timeout(500)
+
+    # Combo Ex1 (step 2, round 1 of 1)
+    page.click('[data-testid="execute-done-btn"]')
+    page.wait_for_timeout(500)
+
+    # Combo Ex2 (step 3, last step of last round) → final-round screen
+    page.click('[data-testid="execute-done-btn"]')
+    page.wait_for_timeout(500)
+
+    expect(page.locator('[data-testid="execute-final-round"]')).to_be_visible()
+
+    # Click Continue → should finish session and redirect (no more items)
+    page.click('[data-testid="execute-continue-btn"]')
+    page.wait_for_timeout(800)
+
+    assert f"/sessions/{sess_id}" in page.url
+    assert "/execute" not in page.url
+
+
+def test_one_more_round_appends_round(page: Page, app_url: str, combo_session):
+    """One More Round inserts an extra round and updates the progress."""
+    sess_id = combo_session["sess_id"]
+    page.goto(f"{app_url}#/sessions/{sess_id}/execute")
+    _wait_for_execute(page)
+
+    # Complete all 4 steps to reach final-round screen
+    for _ in range(4):
+        page.click('[data-testid="execute-done-btn"]')
+        page.wait_for_timeout(500)
+
+    expect(page.locator('[data-testid="execute-final-round"]')).to_be_visible()
+
+    # Click One More Round
+    page.click('[data-testid="execute-one-more-btn"]')
+    page.wait_for_timeout(500)
+
+    # Should be on first exercise of new round
+    progress = page.locator('[data-testid="execute-progress-label"]').inner_text()
+    assert "/ 6" in progress  # 4 original + 2 new = 6 total
+
+    combo_ctx = page.locator('[data-testid="execute-combo-context"]').inner_text()
+    assert "3" in combo_ctx  # Round 3
+
+
+def test_exit_mid_session_saves_partial_log(page: Page, app_url: str, two_step_session):
+    """Exiting mid-session saves only the completed steps to the execution log."""
+    sess_id = two_step_session["sess_id"]
+    page.goto(f"{app_url}#/sessions/{sess_id}/execute")
+    _wait_for_execute(page)
+
+    # Complete step 1 only
+    page.click('[data-testid="execute-done-btn"]')
+    page.wait_for_timeout(500)
+
+    # Exit mid-session
+    page.click('[data-testid="execute-exit-btn"]')
+    page.wait_for_timeout(800)
+
+    assert f"/sessions/{sess_id}" in page.url
+    assert "/execute" not in page.url
+
+    result = page.evaluate(f"""async () => {{
+        const logs = await window.__repos.executionLogs.getBySessionId('{sess_id}')
+        if (!logs.length) return null
+        const items = await window.__repos.executionLogs.getItems(logs[0].id)
+        return {{items: items.length, finishedAt: logs[0].finished_at}}
+    }}""")
+    assert result is not None
+    assert result["items"] == 1
+    assert result["finishedAt"] is not None
+
+
+def test_prefill_from_last_session_run(page: Page, app_url: str, simple_session):
+    """Re-executing a session prefills reps/weight from the last run."""
+    sess_id = simple_session["sess_id"]
+
+    # First run with custom values
+    page.goto(f"{app_url}#/sessions/{sess_id}/execute")
+    _wait_for_execute(page)
+
+    page.fill('[data-testid="execute-reps-input"]', "15")
+    page.fill('[data-testid="execute-weight-input"]', "75")
+    page.click('[data-testid="execute-done-btn"]')
+    page.wait_for_timeout(800)
+
+    # Second run — should prefill from last run
+    page.goto(f"{app_url}#/sessions/{sess_id}/execute")
+    _wait_for_execute(page)
+
+    assert page.locator('[data-testid="execute-reps-input"]').input_value() == "15"
+    assert page.locator('[data-testid="execute-weight-input"]').input_value() == "75"
+
+
+def test_no_prior_log_uses_defaults(page: Page, app_url: str, simple_session):
+    """With no prior log, session item defaults are used for prefill."""
+    sess_id = simple_session["sess_id"]
+    page.goto(f"{app_url}#/sessions/{sess_id}/execute")
+    _wait_for_execute(page)
+
+    # Default reps=8, weight=50 (from fixture)
+    assert page.locator('[data-testid="execute-reps-input"]').input_value() == "8"
+    assert page.locator('[data-testid="execute-weight-input"]').input_value() == "50"
+
+
+def test_progress_bar_reflects_position(page: Page, app_url: str, two_step_session):
+    """Progress label updates from 0/2 → 1/2 → redirects after 2/2."""
+    sess_id = two_step_session["sess_id"]
+    page.goto(f"{app_url}#/sessions/{sess_id}/execute")
+    _wait_for_execute(page)
+
+    expect(page.locator('[data-testid="execute-progress-label"]')).to_contain_text("0 / 2")
+
+    page.click('[data-testid="execute-done-btn"]')
+    page.wait_for_timeout(500)
+
+    expect(page.locator('[data-testid="execute-progress-label"]')).to_contain_text("1 / 2")
+
+
+def test_combo_context_shown(page: Page, app_url: str, combo_session):
+    """Combo name and round number are shown in the step card for combo exercises."""
+    sess_id = combo_session["sess_id"]
+    page.goto(f"{app_url}#/sessions/{sess_id}/execute")
+    _wait_for_execute(page)
+
+    combo_ctx = page.locator('[data-testid="execute-combo-context"]')
+    expect(combo_ctx).to_be_visible()
+    ctx_text = combo_ctx.inner_text()
+    assert "HIIT" in ctx_text
+    assert "1" in ctx_text  # round 1
+    assert "2" in ctx_text  # of 2
diff --git a/tests/test_step9_stats.py b/tests/test_step9_stats.py
new file mode 100644
index 0000000..a466318
--- /dev/null
+++ b/tests/test_step9_stats.py
@@ -0,0 +1,512 @@
+"""
+Step 9 — Statistics
+- test_stats_shows_creation_date: StatsView displays the database creation date
+- test_stats_shows_empty_when_no_date: StatsView shows empty message when no creation date
+- test_stats_date_format_english: Date is formatted as MM/DD/YYYY in English
+- test_stats_date_format_french: Date is formatted as DD/MM/YYYY in French
+- test_stats_date_format_updates_on_language_change: Switching language updates the date format reactively
+- test_stats_date_range_tabs_visible: All four date range tabs are rendered
+- test_stats_summary_cards_zero_when_no_data: Summary cards show 0 when no execution logs exist
+- test_stats_summary_cards_with_data: Summary cards show correct counts after seeding logs
+- test_stats_date_range_filter: Changing date range updates the sessions count
+- test_stats_frequency_no_data_message: Frequency no-data message shown when no sessions
+- test_stats_volume_no_data_message: Volume no-data message shown when no sessions with weight
+- test_stats_progression_no_data_message: Progression no-data shown before exercise selected
+- test_stats_frequency_chart_renders: Frequency chart canvas renders after seeding data
+- test_stats_volume_chart_renders: Volume chart canvas renders when sessions have weight data
+- test_stats_progression_chart_renders: Progression chart renders after selecting an exercise
+- test_stats_streak_consecutive_days: Streak counts consecutive days with sessions
+"""
+from datetime import datetime, timedelta, timezone
+
+import pytest
+from playwright.sync_api import Page, expect
+
+_KNOWN_DATE = "2026-03-15T10:00:00.000Z"
+
+
+# ── Helpers ───────────────────────────────────────────────────────────────────
+
+
+def _wait_for_db(page: Page, app_url: str):
+    page.goto(app_url)
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-ready') === 'true'",
+        timeout=15000,
+    )
+
+
+def _set_date_and_reload(page: Page, app_url: str, date: str | None):
+    _wait_for_db(page, app_url)
+    page.evaluate("async () => { await window.__repos.settings.set('language', 'en') }")
+    if date is None:
+        page.evaluate("async () => { await window.__repos.settings.set('db_created_at', null) }")
+    else:
+        page.evaluate(
+            f"async () => {{ await window.__repos.settings.set('db_created_at', '{date}') }}"
+        )
+    page.wait_for_function(
+        "window.__repos.settings.get('language').then(v => v === 'en')",
+        timeout=5000,
+    )
+    if date is None:
+        page.wait_for_function(
+            "window.__repos.settings.get('db_created_at')"
+            ".then(v => v === null || v === undefined || v === '')",
+            timeout=5000,
+        )
+    else:
+        page.wait_for_function(
+            f"window.__repos.settings.get('db_created_at').then(v => v === '{date}')",
+            timeout=5000,
+        )
+
+
+def _go_to_stats(page: Page):
+    """Navigate to the stats page and wait for the view to finish loading."""
+    page.click('a[href="#/stats"]')
+    page.wait_for_url("**/#/stats", timeout=5000)
+    page.wait_for_selector('.stats-view', timeout=5000)
+    # Wait for async onMounted to finish (cards rendered)
+    page.wait_for_selector('[data-testid="stats-total-sessions"]', timeout=5000)
+
+
+def _iso_days_ago(days: int) -> str:
+    """Return an ISO-8601 UTC timestamp for N days ago."""
+    dt = datetime.now(timezone.utc) - timedelta(days=days)
+    return dt.strftime('%Y-%m-%dT%H:%M:%S.000Z')
+
+
+def _create_exercise(page: Page, title: str) -> str:
+    return page.evaluate(
+        f"""async () => {{
+            const userId = await window.__repos.settings.get('user_uuid')
+            return window.__repos.exercises.create({{
+                title: {repr(title)},
+                description: '',
+                asymmetric: false,
+                alternate: false,
+                image_urls: '[]',
+                video_urls: '[]',
+                default_reps: 10,
+                default_weight: 0,
+                created_by: userId
+            }})
+        }}"""
+    )
+
+
+def _create_session(page: Page, title: str) -> str:
+    return page.evaluate(
+        f"""async () => {{
+            const userId = await window.__repos.settings.get('user_uuid')
+            return window.__repos.sessions.create({{
+                title: {repr(title)}, description: '', created_by: userId
+            }})
+        }}"""
+    )
+
+
+def _create_log_with_items(
+    page: Page,
+    session_id: str,
+    exercise_id: str,
+    started_at: str,
+    reps: int = 10,
+    weight: float = 0.0,
+    completed: bool = True,
+) -> str:
+    """Seed one execution log with one item."""
+    finished_at = started_at  # same timestamp is fine for tests
+    return page.evaluate(
+        f"""async () => {{
+            const logId = await window.__repos.executionLogs.create({{
+                session_id: '{session_id}',
+                started_at: '{started_at}',
+                finished_at: '{finished_at}'
+            }})
+            await window.__repos.executionLogs.addItem({{
+                log_id: logId,
+                exercise_id: '{exercise_id}',
+                reps_done: {reps},
+                weight_used: {weight},
+                side: null,
+                completed: {'true' if completed else 'false'},
+                timestamp: '{started_at}'
+            }})
+            return logId
+        }}"""
+    )
+
+
+def _delete_all_logs(page: Page):
+    """Remove all execution logs (to reset state between tests)."""
+    page.evaluate(
+        """async () => {
+            const logs = await window.__repos.executionLogs.getAll()
+            for (const log of logs) {
+                await window.__repos.executionLogs.delete(log.id)
+            }
+        }"""
+    )
+
+
+def _delete_all_exercises(page: Page):
+    page.evaluate(
+        """async () => {
+            const items = await window.__repos.exercises.getAll()
+            for (const item of items) {
+                await window.__repos.exercises.delete(item.id)
+            }
+        }"""
+    )
+
+
+def _delete_all_sessions(page: Page):
+    page.evaluate(
+        """async () => {
+            const items = await window.__repos.sessions.getAll()
+            for (const item of items) {
+                await window.__repos.sessions.delete(item.id)
+            }
+        }"""
+    )
+
+
+# ── Creation date tests (unchanged logic) ────────────────────────────────────
+
+
+def test_stats_shows_creation_date(page: Page, app_url: str):
+    """StatsView displays the database creation date."""
+    _set_date_and_reload(page, app_url, _KNOWN_DATE)
+    _go_to_stats(page)
+
+    creation_msg = page.locator('[data-testid="stats-using-since"]')
+    expect(creation_msg).to_be_visible()
+    text = creation_msg.text_content()
+    assert 'You are using TrainUs since' in text, f"Expected creation date message, got: {text}"
+
+
+def test_stats_shows_empty_when_no_date(page: Page, app_url: str):
+    """StatsView still loads when no creation date is set."""
+    _set_date_and_reload(page, app_url, None)
+    _go_to_stats(page)
+
+    assert page.locator('[data-testid="stats-using-since"]').count() == 0
+
+    # Restore a valid date for subsequent tests
+    page.evaluate(
+        f"async () => {{ await window.__repos.settings.set('db_created_at', '{_KNOWN_DATE}') }}"
+    )
+    page.wait_for_function(
+        f"window.__repos.settings.get('db_created_at').then(v => v === '{_KNOWN_DATE}')",
+        timeout=5000,
+    )
+
+
+def test_stats_date_format_english(page: Page, app_url: str):
+    """Date is formatted as MM/DD/YYYY in English."""
+    _set_date_and_reload(page, app_url, _KNOWN_DATE)
+    _go_to_stats(page)
+
+    text = page.locator('[data-testid="stats-using-since"]').text_content()
+    assert '03/15/2026' in text, f"Expected English date format, got: {text}"
+
+
+def test_stats_date_format_french(page: Page, app_url: str):
+    """Date is formatted as DD/MM/YYYY in French."""
+    _set_date_and_reload(page, app_url, _KNOWN_DATE)
+
+    page.click('a[href="#/settings"]')
+    page.wait_for_url("**/#/settings", timeout=5000)
+    page.wait_for_selector('[data-testid="settings-language"]')
+    page.select_option('[data-testid="settings-language"]', 'en')
+    page.wait_for_timeout(300)
+    page.select_option('[data-testid="settings-language"]', 'fr')
+    page.wait_for_timeout(500)
+
+    _go_to_stats(page)
+
+    text = page.locator('[data-testid="stats-using-since"]').text_content()
+    assert '15/03/2026' in text, f"Expected French date format, got: {text}"
+
+    page.click('a[href="#/settings"]')
+    page.wait_for_url("**/#/settings", timeout=5000)
+    page.wait_for_selector('[data-testid="settings-language"]')
+    page.select_option('[data-testid="settings-language"]', 'en')
+    page.wait_for_timeout(300)
+
+
+def test_stats_date_format_updates_on_language_change(page: Page, app_url: str):
+    """Switching language updates the date format reactively without navigation."""
+    _set_date_and_reload(page, app_url, _KNOWN_DATE)
+
+    page.click('a[href="#/settings"]')
+    page.wait_for_url("**/#/settings", timeout=5000)
+    page.wait_for_selector('[data-testid="settings-language"]')
+    page.select_option('[data-testid="settings-language"]', 'en')
+    page.wait_for_timeout(300)
+
+    _go_to_stats(page)
+
+    text = page.locator('[data-testid="stats-using-since"]').text_content()
+    assert '03/15/2026' in text, f"Expected English date format, got: {text}"
+
+    page.click('a[href="#/settings"]')
+    page.wait_for_url("**/#/settings", timeout=5000)
+    page.wait_for_selector('[data-testid="settings-language"]')
+    page.select_option('[data-testid="settings-language"]', 'fr')
+    page.wait_for_timeout(500)
+
+    _go_to_stats(page)
+
+    text = page.locator('[data-testid="stats-using-since"]').text_content()
+    assert '15/03/2026' in text, f"Expected French date format, got: {text}"
+
+    page.click('a[href="#/settings"]')
+    page.wait_for_url("**/#/settings", timeout=5000)
+    page.wait_for_selector('[data-testid="settings-language"]')
+    page.select_option('[data-testid="settings-language"]', 'en')
+    page.wait_for_timeout(300)
+
+
+# ── New Step 9 tests ─────────────────────────────────────────────────────────
+
+
+def test_stats_date_range_tabs_visible(page: Page, app_url: str):
+    """All four date range tabs are rendered on the stats page."""
+    _wait_for_db(page, app_url)
+    _go_to_stats(page)
+
+    for key in ('7d', '30d', '3m', 'all'):
+        tab = page.locator(f'[data-testid="date-range-{key}"]')
+        expect(tab).to_be_visible()
+
+    # 30d should be active by default
+    active = page.locator('[data-testid="date-range-30d"]')
+    assert 'active' in (active.get_attribute('class') or ''), "30d tab should be active by default"
+
+
+def test_stats_summary_cards_zero_when_no_data(page: Page, app_url: str):
+    """Summary cards show 0 when there are no execution logs."""
+    _wait_for_db(page, app_url)
+    _delete_all_logs(page)
+    _go_to_stats(page)
+
+    sessions_card = page.locator('[data-testid="stats-total-sessions"] .stat-value')
+    exercises_card = page.locator('[data-testid="stats-total-exercises"] .stat-value')
+    streak_card = page.locator('[data-testid="stats-streak"] .stat-value')
+
+    expect(sessions_card).to_have_text('0')
+    expect(exercises_card).to_have_text('0')
+    expect(streak_card).to_have_text('0')
+
+
+def test_stats_summary_cards_with_data(page: Page, app_url: str):
+    """Summary cards reflect correct counts after seeding two execution logs."""
+    _wait_for_db(page, app_url)
+    _delete_all_logs(page)
+    _delete_all_exercises(page)
+    _delete_all_sessions(page)
+
+    ex_id = _create_exercise(page, 'Stats Push-up')
+    sess_id = _create_session(page, 'Stats Session')
+
+    _create_log_with_items(page, sess_id, ex_id, _iso_days_ago(1), reps=10, completed=True)
+    _create_log_with_items(page, sess_id, ex_id, _iso_days_ago(2), reps=8, completed=True)
+
+    page.reload()
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-ready') === 'true'",
+        timeout=15000,
+    )
+    _go_to_stats(page)
+
+    # Click "All time" so both logs are counted regardless of default 30d window
+    page.click('[data-testid="date-range-all"]')
+    page.wait_for_timeout(500)
+
+    sessions_val = page.locator('[data-testid="stats-total-sessions"] .stat-value').text_content()
+    exercises_val = page.locator('[data-testid="stats-total-exercises"] .stat-value').text_content()
+
+    assert int(sessions_val) >= 2, f"Expected ≥2 sessions, got {sessions_val}"
+    assert int(exercises_val) >= 2, f"Expected ≥2 exercises done, got {exercises_val}"
+
+
+def test_stats_date_range_filter(page: Page, app_url: str):
+    """Switching to 7d hides logs older than 7 days; All time shows all."""
+    _wait_for_db(page, app_url)
+    _delete_all_logs(page)
+    _delete_all_exercises(page)
+    _delete_all_sessions(page)
+
+    ex_id = _create_exercise(page, 'Range Exercise')
+    sess_id = _create_session(page, 'Range Session')
+
+    # One log yesterday (within 7d), one log 20 days ago (outside 7d, inside 30d)
+    _create_log_with_items(page, sess_id, ex_id, _iso_days_ago(1), completed=True)
+    _create_log_with_items(page, sess_id, ex_id, _iso_days_ago(20), completed=True)
+
+    page.reload()
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-ready') === 'true'",
+        timeout=15000,
+    )
+    _go_to_stats(page)
+
+    # 30d should show 2
+    page.click('[data-testid="date-range-30d"]')
+    page.wait_for_timeout(500)
+    val_30d = page.locator('[data-testid="stats-total-sessions"] .stat-value').text_content()
+    assert int(val_30d) >= 2, f"Expected ≥2 sessions in 30d, got {val_30d}"
+
+    # 7d should show 1
+    page.click('[data-testid="date-range-7d"]')
+    page.wait_for_timeout(500)
+    val_7d = page.locator('[data-testid="stats-total-sessions"] .stat-value').text_content()
+    assert int(val_7d) == 1, f"Expected 1 session in 7d, got {val_7d}"
+
+
+def test_stats_frequency_no_data_message(page: Page, app_url: str):
+    """Frequency section shows a no-data message when no sessions exist."""
+    _wait_for_db(page, app_url)
+    _delete_all_logs(page)
+    _go_to_stats(page)
+
+    nodata = page.locator('[data-testid="stats-frequency-nodata"]')
+    expect(nodata).to_be_visible()
+    assert page.locator('[data-testid="stats-frequency-chart"]').count() == 0
+
+
+def test_stats_volume_no_data_message(page: Page, app_url: str):
+    """Volume section shows a no-data message when no sessions exist."""
+    _wait_for_db(page, app_url)
+    _delete_all_logs(page)
+    _go_to_stats(page)
+
+    nodata = page.locator('[data-testid="stats-volume-nodata"]')
+    expect(nodata).to_be_visible()
+    assert page.locator('[data-testid="stats-volume-chart"]').count() == 0
+
+
+def test_stats_progression_no_data_message(page: Page, app_url: str):
+    """Progression section shows select-exercise prompt before an exercise is picked."""
+    _wait_for_db(page, app_url)
+    _go_to_stats(page)
+
+    nodata = page.locator('[data-testid="stats-progression-nodata"]')
+    expect(nodata).to_be_visible()
+    assert page.locator('[data-testid="stats-progression-chart"]').count() == 0
+
+
+def test_stats_frequency_chart_renders(page: Page, app_url: str):
+    """Frequency chart canvas appears after seeding sessions in current period."""
+    _wait_for_db(page, app_url)
+    _delete_all_logs(page)
+    _delete_all_exercises(page)
+    _delete_all_sessions(page)
+
+    ex_id = _create_exercise(page, 'Freq Exercise')
+    sess_id = _create_session(page, 'Freq Session')
+    _create_log_with_items(page, sess_id, ex_id, _iso_days_ago(1), completed=True)
+
+    page.reload()
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-ready') === 'true'",
+        timeout=15000,
+    )
+    _go_to_stats(page)
+
+    page.click('[data-testid="date-range-all"]')
+    page.wait_for_timeout(500)
+
+    chart = page.locator('[data-testid="stats-frequency-chart"]')
+    expect(chart).to_be_visible()
+    canvas = chart.locator('canvas')
+    expect(canvas).to_be_visible()
+
+
+def test_stats_volume_chart_renders(page: Page, app_url: str):
+    """Volume chart appears when sessions have weight data."""
+    _wait_for_db(page, app_url)
+    _delete_all_logs(page)
+    _delete_all_exercises(page)
+    _delete_all_sessions(page)
+
+    ex_id = _create_exercise(page, 'Vol Exercise')
+    sess_id = _create_session(page, 'Vol Session')
+    _create_log_with_items(page, sess_id, ex_id, _iso_days_ago(1), reps=10, weight=50.0, completed=True)
+
+    page.reload()
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-ready') === 'true'",
+        timeout=15000,
+    )
+    _go_to_stats(page)
+
+    page.click('[data-testid="date-range-all"]')
+    page.wait_for_timeout(500)
+
+    chart = page.locator('[data-testid="stats-volume-chart"]')
+    expect(chart).to_be_visible()
+    canvas = chart.locator('canvas')
+    expect(canvas).to_be_visible()
+
+
+def test_stats_progression_chart_renders(page: Page, app_url: str):
+    """Progression chart renders after selecting an exercise from the dropdown."""
+    _wait_for_db(page, app_url)
+    _delete_all_logs(page)
+    _delete_all_exercises(page)
+    _delete_all_sessions(page)
+
+    ex_id = _create_exercise(page, 'Prog Exercise')
+    sess_id = _create_session(page, 'Prog Session')
+    _create_log_with_items(page, sess_id, ex_id, _iso_days_ago(1), reps=12, weight=60.0, completed=True)
+
+    page.reload()
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-ready') === 'true'",
+        timeout=15000,
+    )
+    _go_to_stats(page)
+
+    page.click('[data-testid="date-range-all"]')
+    page.wait_for_timeout(500)
+
+    # The dropdown should have the exercise as an option
+    select = page.locator('[data-testid="stats-progression-exercise"]')
+    expect(select).to_be_visible()
+    select.select_option(label='Prog Exercise')
+    page.wait_for_timeout(500)
+
+    chart = page.locator('[data-testid="stats-progression-chart"]')
+    expect(chart).to_be_visible()
+    canvas = chart.locator('canvas')
+    expect(canvas).to_be_visible()
+
+
+def test_stats_streak_consecutive_days(page: Page, app_url: str):
+    """Streak counter reflects consecutive days with at least one session."""
+    _wait_for_db(page, app_url)
+    _delete_all_logs(page)
+    _delete_all_exercises(page)
+    _delete_all_sessions(page)
+
+    ex_id = _create_exercise(page, 'Streak Exercise')
+    sess_id = _create_session(page, 'Streak Session')
+
+    # Three consecutive days ending today
+    _create_log_with_items(page, sess_id, ex_id, _iso_days_ago(0), completed=True)
+    _create_log_with_items(page, sess_id, ex_id, _iso_days_ago(1), completed=True)
+    _create_log_with_items(page, sess_id, ex_id, _iso_days_ago(2), completed=True)
+
+    page.reload()
+    page.wait_for_function(
+        "document.documentElement.getAttribute('data-db-ready') === 'true'",
+        timeout=15000,
+    )
+    _go_to_stats(page)
+
+    streak_val = page.locator('[data-testid="stats-streak"] .stat-value').text_content()
+    assert int(streak_val) >= 3, f"Expected streak ≥ 3, got {streak_val}"
diff --git a/vite.config.js b/vite.config.js
new file mode 100644
index 0000000..8bc6168
--- /dev/null
+++ b/vite.config.js
@@ -0,0 +1,69 @@
+import { defineConfig } from 'vite'
+import vue from '@vitejs/plugin-vue'
+import { VitePWA } from 'vite-plugin-pwa'
+import { readFileSync, copyFileSync, existsSync } from 'fs'
+
+const pkg = JSON.parse(readFileSync('./package.json', 'utf-8'))
+
+function copySqliteWasm() {
+  return {
+    name: 'copy-sqlite-wasm',
+    buildStart() {
+      const src = 'node_modules/@sqlite.org/sqlite-wasm/dist/sqlite3.wasm'
+      const dest = 'public/sqlite3.wasm'
+      if (existsSync(src)) copyFileSync(src, dest)
+    },
+  }
+}
+
+export default defineConfig({
+  base: './',
+  plugins: [
+    vue(),
+    copySqliteWasm(),
+    VitePWA({
+      registerType: 'autoUpdate',
+      manifest: false,
+      workbox: {
+        globPatterns: ['**/*.{js,css,html,ico,png,svg,wasm,woff,woff2}'],
+        maximumFileSizeToCacheInBytes: 10 * 1024 * 1024,
+        runtimeCaching: [
+          {
+            urlPattern: ({ request }) => request.destination === 'image',
+            handler: 'CacheFirst',
+            options: {
+              cacheName: 'exercise-images',
+              expiration: {
+                maxEntries: 300,
+                maxAgeSeconds: 30 * 24 * 60 * 60,
+              },
+              cacheableResponse: {
+                statuses: [0, 200],
+              },
+            },
+          },
+        ],
+      },
+      devOptions: {
+        enabled: true,
+        type: 'module',
+      },
+    }),
+  ],
+  define: {
+    __APP_VERSION__: JSON.stringify(pkg.version),
+    __APP_NAME__: JSON.stringify(pkg.name),
+  },
+  server: {
+    headers: {
+      'Cross-Origin-Opener-Policy': 'same-origin',
+      // 'credentialless' is a relaxed alternative to 'require-corp' that
+      // allows cross-origin images without CORP headers — useful in dev.
+      // Production deployments should use 'require-corp' (see README).
+      'Cross-Origin-Embedder-Policy': 'credentialless',
+    },
+  },
+  optimizeDeps: {
+    exclude: ['@sqlite.org/sqlite-wasm'],
+  },
+})
diff --git a/website/.hugo_build.lock b/website/.hugo_build.lock
new file mode 100644
index 0000000..e69de29
diff --git a/website/archetypes/default.md b/website/archetypes/default.md
new file mode 100644
index 0000000..c6f3fce
--- /dev/null
+++ b/website/archetypes/default.md
@@ -0,0 +1,5 @@
++++
+title = '{{ replace .File.ContentBaseName "-" " " | title }}'
+date = {{ .Date }}
+draft = true
++++
diff --git a/website/assets/css/main.css b/website/assets/css/main.css
new file mode 100644
index 0000000..487f33f
--- /dev/null
+++ b/website/assets/css/main.css
@@ -0,0 +1,716 @@
+/* ── Design tokens ── */
+:root {
+  --accent-1: #12a892;
+  --accent-2: #1e7fc0;
+  --accent-grad: linear-gradient(135deg, #12a892, #1e7fc0);
+  --ink: #1a1a1a;
+  --paper: #ffffff;
+  --paper-alt: #f7f9f9;
+  --muted: #5c6b6a;
+  --border: #e0e6e5;
+  --max-width: 760px;
+  --header-height: 60px;
+}
+
+/* ── Reset ── */
+*,
+*::before,
+*::after {
+  box-sizing: border-box;
+}
+
+html {
+  font-family:
+    system-ui,
+    -apple-system,
+    'Segoe UI',
+    Roboto,
+    'Helvetica Neue',
+    Arial,
+    sans-serif;
+  font-size: 17px;
+  line-height: 1.65;
+  color: var(--ink);
+  background: var(--paper);
+  scroll-behavior: smooth;
+}
+
+body {
+  margin: 0;
+  display: flex;
+  flex-direction: column;
+  min-height: 100vh;
+}
+
+main {
+  flex: 1;
+}
+
+a {
+  color: var(--accent-1);
+  text-decoration: none;
+}
+a:hover {
+  color: var(--accent-2);
+  text-decoration: underline;
+}
+img {
+  max-width: 100%;
+}
+
+/* ── Container ── */
+.container {
+  max-width: calc(var(--max-width) + 2rem);
+  margin: 0 auto;
+  padding: 0 1.25rem;
+}
+
+/* ── Site header ── */
+.site-header {
+  background: var(--paper);
+  position: sticky;
+  top: 0;
+  z-index: 100;
+  box-shadow: 0 1px 0 var(--border);
+}
+
+.site-header::after {
+  content: '';
+  display: block;
+  height: 3px;
+  background: linear-gradient(135deg, #12a892, #1e7fc0);
+}
+
+.header-inner {
+  display: flex;
+  align-items: center;
+  gap: 1.25rem;
+  height: var(--header-height);
+}
+
+.site-brand {
+  display: flex;
+  align-items: center;
+  gap: 0.5rem;
+  font-weight: 700;
+  font-size: 1.05rem;
+  color: var(--ink);
+  text-decoration: none;
+  flex-shrink: 0;
+}
+
+.site-brand:hover {
+  color: var(--accent-1);
+  text-decoration: none;
+}
+.site-brand img {
+  width: 32px;
+  height: 32px;
+}
+
+/* ── Navigation ── */
+.site-nav {
+  display: flex;
+  align-items: center;
+  gap: 0.125rem;
+  margin-left: auto;
+}
+
+.nav-link {
+  color: var(--muted);
+  font-weight: 500;
+  font-size: 0.9rem;
+  text-decoration: none;
+  padding: 0.3rem 0.6rem;
+  border-radius: 4px;
+  transition:
+    color 0.15s,
+    background-color 0.15s;
+}
+
+.nav-link:hover {
+  color: var(--accent-1);
+  background: #f0faf8;
+  text-decoration: none;
+}
+.nav-link.active {
+  color: var(--accent-1);
+  font-weight: 600;
+}
+
+/* ── Language switcher ── */
+.lang-switcher {
+  display: flex;
+  align-items: center;
+  gap: 0.1rem;
+  flex-shrink: 0;
+}
+
+.lang-switcher a,
+.lang-switcher .lang-active {
+  font-size: 1.15rem;
+  line-height: 1;
+  text-decoration: none;
+  padding: 0.1rem 0.15rem;
+  border-radius: 3px;
+  transition: opacity 0.15s;
+  display: inline-flex;
+}
+
+.lang-switcher a {
+  opacity: 0.4;
+}
+.lang-switcher a:hover {
+  opacity: 0.75;
+  text-decoration: none;
+}
+.lang-switcher .lang-active {
+  opacity: 1;
+}
+
+/* ── Site footer ── */
+.site-footer {
+  background: var(--paper-alt);
+  border-top: 1px solid var(--border);
+  padding: 1.5rem 0;
+  font-size: 0.85rem;
+  color: var(--muted);
+  margin-top: auto;
+}
+
+.footer-inner {
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  gap: 0.75rem;
+  flex-wrap: wrap;
+  text-align: center;
+}
+
+.footer-inner a {
+  color: var(--muted);
+}
+.footer-inner a:hover {
+  color: var(--accent-1);
+}
+.footer-sep {
+  opacity: 0.4;
+}
+
+/* ── Article (single page) ── */
+.article-wrap {
+  padding: 2.5rem 0 4rem;
+}
+
+.article-header {
+  margin-bottom: 2rem;
+  padding-bottom: 1.25rem;
+  border-bottom: 1px solid var(--border);
+}
+
+.article-title {
+  font-size: 1.9rem;
+  font-weight: 700;
+  line-height: 1.25;
+  color: var(--ink);
+  margin: 0 0 0.5rem;
+}
+
+.article-meta {
+  font-size: 0.875rem;
+  color: var(--muted);
+  margin: 0;
+}
+
+/* ── Table of contents ── */
+.toc {
+  background: var(--paper-alt);
+  border: 1px solid var(--border);
+  border-radius: 6px;
+  padding: 0.75rem 1rem;
+  margin: 0 0 2rem;
+  font-size: 0.9rem;
+}
+
+.toc summary {
+  font-weight: 600;
+  cursor: pointer;
+  color: var(--ink);
+  list-style: none;
+  display: flex;
+  align-items: center;
+  gap: 0.4rem;
+  user-select: none;
+}
+
+.toc summary::-webkit-details-marker {
+  display: none;
+}
+
+.toc summary::before {
+  content: '▸';
+  font-size: 0.7em;
+  color: var(--accent-1);
+  transition: transform 0.15s;
+  display: inline-block;
+}
+
+.toc[open] summary::before {
+  transform: rotate(90deg);
+}
+
+.toc nav {
+  margin-top: 0.6rem;
+}
+
+.toc ul {
+  margin: 0;
+  padding-left: 1rem;
+  list-style: none;
+}
+
+.toc ul ul {
+  padding-left: 1rem;
+  margin-top: 0.1rem;
+}
+.toc li {
+  margin: 0.2rem 0;
+}
+.toc a {
+  color: var(--muted);
+}
+.toc a:hover {
+  color: var(--accent-1);
+}
+
+/* ── ToC sidebar (hidden on mobile, shown on wide screens) ── */
+.toc-sidebar {
+  display: none;
+}
+
+.toc-sidebar-title {
+  font-weight: 600;
+  color: var(--ink);
+  margin: 0 0 0.1rem;
+}
+
+/* ── Article body ── */
+.article-body h2 {
+  font-size: 1.35rem;
+  font-weight: 700;
+  margin: 2.25rem 0 0.75rem;
+  padding-bottom: 0.3rem;
+  border-bottom: 1px solid var(--border);
+}
+
+.article-body h3 {
+  font-size: 1.1rem;
+  font-weight: 600;
+  margin: 1.75rem 0 0.5rem;
+}
+
+.article-body h4 {
+  font-size: 1rem;
+  font-weight: 600;
+  margin: 1.25rem 0 0.35rem;
+}
+
+.article-body p {
+  margin: 0 0 1rem;
+}
+
+.article-body ul,
+.article-body ol {
+  margin: 0 0 1rem 0;
+  padding-left: 1.4rem;
+}
+
+.article-body li + li {
+  margin-top: 0.2rem;
+}
+
+.article-body code {
+  background: #eef2f2;
+  padding: 0.1em 0.35em;
+  border-radius: 3px;
+  font-size: 0.875em;
+  font-family: 'SFMono-Regular', Consolas, 'Liberation Mono', Menlo, monospace;
+}
+
+.article-body pre {
+  background: #eef2f2;
+  padding: 1rem 1.25rem;
+  border-radius: 6px;
+  overflow-x: auto;
+  margin: 0 0 1.25rem;
+  line-height: 1.5;
+}
+
+.article-body pre code {
+  background: none;
+  padding: 0;
+  font-size: 0.85rem;
+}
+
+.article-body blockquote {
+  margin: 0 0 1rem;
+  padding: 0.75rem 1rem 0.75rem 1.25rem;
+  border-left: 4px solid var(--accent-1);
+  background: var(--paper-alt);
+  color: var(--muted);
+}
+
+.article-body blockquote p {
+  margin-bottom: 0;
+}
+
+.article-body table {
+  width: 100%;
+  border-collapse: collapse;
+  margin: 0 0 1.25rem;
+  font-size: 0.9rem;
+}
+
+.article-body th,
+.article-body td {
+  text-align: left;
+  padding: 0.5rem 0.75rem;
+  border: 1px solid var(--border);
+}
+
+.article-body th {
+  background: var(--paper-alt);
+  font-weight: 600;
+}
+.article-body tr:nth-child(even) td {
+  background: #fbfcfc;
+}
+
+.article-body img {
+  border: 1px solid var(--ink);
+  border-radius: 4px;
+  display: block;
+  margin: 1rem auto;
+}
+
+.article-body hr {
+  border: none;
+  border-top: 1px solid var(--border);
+  margin: 2rem 0;
+}
+
+/* ── List page ── */
+.list-wrap {
+  padding: 2.5rem 0 4rem;
+}
+
+.list-header {
+  margin-bottom: 2rem;
+  padding-bottom: 1rem;
+  border-bottom: 1px solid var(--border);
+}
+.list-title {
+  font-size: 1.75rem;
+  font-weight: 700;
+  margin: 0 0 0.4rem;
+}
+.list-description {
+  color: var(--muted);
+  margin: 0;
+}
+
+.post-list {
+  list-style: none;
+  margin: 0;
+  padding: 0;
+  display: flex;
+  flex-direction: column;
+  gap: 1.25rem;
+}
+
+.post-card {
+  position: relative;
+  border: 1px solid var(--border);
+  border-radius: 8px;
+  padding: 1.25rem 1.5rem;
+  transition:
+    border-color 0.15s,
+    box-shadow 0.15s;
+}
+
+.post-card:hover {
+  border-color: var(--accent-1);
+  box-shadow: 0 2px 10px rgba(18, 168, 146, 0.08);
+}
+
+.post-card-title a::after {
+  content: '';
+  position: absolute;
+  inset: 0;
+  border-radius: inherit;
+}
+
+.post-card-title {
+  font-size: 1.1rem;
+  font-weight: 600;
+  margin: 0 0 0.3rem;
+}
+
+.post-card-title a {
+  color: var(--ink);
+}
+.post-card-title a:hover {
+  color: var(--accent-1);
+  text-decoration: none;
+}
+
+.post-card-meta {
+  font-size: 0.8rem;
+  color: var(--muted);
+  margin: 0 0 0.6rem;
+}
+
+.post-card-summary {
+  font-size: 0.95rem;
+  color: var(--muted);
+  margin: 0 0 0.75rem;
+  line-height: 1.5;
+}
+
+.post-card-chapters {
+  margin: 0 0 0.75rem;
+  padding: 0;
+  list-style: none;
+  display: flex;
+  flex-wrap: wrap;
+  gap: 0.4rem 0.9rem;
+  font-size: 0.82rem;
+  color: var(--muted);
+}
+
+.post-card-chapters li {
+  position: relative;
+  padding-left: 0.7rem;
+}
+.post-card-chapters li::before {
+  content: '·';
+  position: absolute;
+  left: 0;
+}
+
+.read-more {
+  font-size: 0.875rem;
+  font-weight: 500;
+  color: var(--accent-1);
+}
+.read-more:hover {
+  color: var(--accent-2);
+  text-decoration: none;
+}
+.read-more::after {
+  content: ' →';
+}
+
+/* ── Mermaid diagrams ── */
+.mermaid {
+  overflow-x: auto;
+  text-align: center;
+  margin: 1.5rem 0;
+  background: var(--paper-alt);
+  border-radius: 6px;
+  padding: 1.25rem;
+}
+
+/* ── Hero ── */
+.hero {
+  background: linear-gradient(135deg, rgba(18, 168, 146, 0.07) 0%, rgba(30, 127, 192, 0.1) 100%);
+  padding: 5rem 1.25rem;
+  text-align: center;
+}
+
+.hero-inner {
+  max-width: 640px;
+  margin: 0 auto;
+}
+
+.hero-logo {
+  width: 96px;
+  height: 96px;
+  margin-bottom: 1.25rem;
+  filter: drop-shadow(0 4px 12px rgba(18, 168, 146, 0.25));
+}
+
+.hero-title {
+  font-size: 3rem;
+  font-weight: 800;
+  color: var(--ink);
+  margin: 0 0 0.75rem;
+  line-height: 1.1;
+}
+
+.hero-tagline {
+  font-size: 1.15rem;
+  color: var(--muted);
+  margin: 0 0 2.5rem;
+  line-height: 1.55;
+}
+
+.hero-actions {
+  display: flex;
+  gap: 1rem;
+  justify-content: center;
+  flex-wrap: wrap;
+}
+
+/* ── Buttons ── */
+.btn {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  padding: 0.75rem 1.75rem;
+  border-radius: 6px;
+  font-size: 1rem;
+  font-weight: 600;
+  text-decoration: none;
+  border: none;
+  cursor: pointer;
+  font-family: inherit;
+  transition:
+    opacity 0.15s,
+    box-shadow 0.15s;
+}
+
+.btn:hover {
+  text-decoration: none;
+}
+
+.btn-primary {
+  background: linear-gradient(135deg, #12a892, #1e7fc0);
+  color: #fff;
+  box-shadow: 0 2px 8px rgba(18, 168, 146, 0.3);
+}
+
+.btn-primary:hover {
+  opacity: 0.9;
+  color: #fff;
+  box-shadow: 0 4px 16px rgba(18, 168, 146, 0.35);
+}
+
+.btn-secondary {
+  background: transparent;
+  color: var(--accent-1);
+  border: 2px solid var(--accent-1);
+}
+
+.btn-secondary:hover {
+  background: rgba(18, 168, 146, 0.06);
+  color: var(--accent-1);
+}
+
+.btn-disabled {
+  background: #d0d9d8;
+  color: #8a9e9c;
+  cursor: not-allowed;
+  box-shadow: none;
+}
+
+.btn-disabled:hover {
+  opacity: 1;
+  color: #8a9e9c;
+}
+
+/* ── Features ── */
+.features {
+  padding: 4rem 1.25rem;
+  background: var(--paper);
+  border-top: 1px solid var(--border);
+}
+
+.features-grid {
+  display: grid;
+  grid-template-columns: repeat(2, 1fr);
+  gap: 2rem;
+  max-width: var(--max-width);
+  margin: 0 auto;
+}
+
+.feature-card {
+  text-align: center;
+  padding: 1.75rem 1.25rem;
+}
+
+.feature-icon {
+  font-size: 2.25rem;
+  line-height: 1;
+  margin-bottom: 1rem;
+}
+
+.feature-title {
+  font-size: 1.05rem;
+  font-weight: 700;
+  margin: 0 0 0.5rem;
+  color: var(--ink);
+}
+
+.feature-desc {
+  font-size: 0.9rem;
+  color: var(--muted);
+  margin: 0;
+  line-height: 1.6;
+}
+
+/* ── Responsive ── */
+@media (min-width: 900px) {
+  /* Four-column features grid */
+  .features .container {
+    max-width: 960px;
+  }
+  .features-grid {
+    grid-template-columns: repeat(4, 1fr);
+    max-width: none;
+  }
+
+  /* Two-column article layout: content + sticky ToC sidebar */
+  .container.article-wrap {
+    max-width: calc(var(--max-width) + 240px + 2rem + 2.5rem);
+    display: grid;
+    grid-template-columns: minmax(0, 1fr) 240px;
+    gap: 2rem;
+    align-items: start;
+  }
+  .article-wrap > article {
+    min-width: 0;
+  }
+  .toc-inline {
+    display: none;
+  }
+  .toc-sidebar {
+    display: block;
+    position: sticky;
+    top: calc(var(--header-height) + 1.5rem);
+    max-height: calc(100vh - var(--header-height) - 3rem);
+    overflow-y: auto;
+  }
+}
+
+@media (max-width: 600px) {
+  html {
+    font-size: 16px;
+  }
+  .site-nav .nav-link {
+    padding: 0.25rem 0.4rem;
+  }
+  .article-title {
+    font-size: 1.5rem;
+  }
+  .hero {
+    padding: 3.5rem 1.25rem;
+  }
+  .hero-title {
+    font-size: 2.25rem;
+  }
+  .hero-logo {
+    width: 72px;
+    height: 72px;
+  }
+}
diff --git a/website/content/_index.en.md b/website/content/_index.en.md
new file mode 100644
index 0000000..afab344
--- /dev/null
+++ b/website/content/_index.en.md
@@ -0,0 +1,4 @@
+---
+title: 'TrainUs'
+description: 'Local-first multilingual and open source fitness training app'
+---
diff --git a/website/content/_index.fr.md b/website/content/_index.fr.md
new file mode 100644
index 0000000..2b71653
--- /dev/null
+++ b/website/content/_index.fr.md
@@ -0,0 +1,4 @@
+---
+title: 'TrainUs'
+description: 'Application de fitness locale, multilingue et open source.'
+---
diff --git a/website/content/blog/2026-06-14-lancement.en.md b/website/content/blog/2026-06-14-lancement.en.md
new file mode 100644
index 0000000..6840868
--- /dev/null
+++ b/website/content/blog/2026-06-14-lancement.en.md
@@ -0,0 +1,59 @@
+---
+title: 'Launching the TrainUs website'
+date: 2026-06-14
+description: 'Introducing TrainUs: a local-first, bilingual, installable fitness tracking PWA that runs entirely in the browser.'
+---
+
+> Cet article est disponible en français : [Lancement du site TrainUs]({{< relref "2026-06-14-lancement.fr.md" >}})
+
+Today I'm publishing the documentation site for **TrainUs**, a fitness tracking app I've been building for the past few months.
+
+## What is TrainUs?
+
+TrainUs is a progressive web app (PWA) that runs **entirely in the browser**. There is no server, no account to create, no data sent anywhere. Everything is stored locally on your device using SQLite WASM and the OPFS API (Origin Private File System).
+
+The app is **bilingual** (English and French) and **installable** on your phone or computer like a native app — with full offline support.
+
+## Why this project?
+
+Most fitness apps I've tried share the same limitations: they require an account, send your data to the cloud, and disappear if the subscription ends or the service shuts down. And when you want to share a workout or export your data to another tool, it's often impossible — or locked behind a proprietary format.
+
+I wanted something simple, that works without an internet connection, collects nothing, and lets you share your data freely. So I built it.
+
+> **AI wrote almost all the code.** I have the technical skills to carry out this kind of project, but not the time — and to be transparent: the vast majority of the source code was written by AI assistants, not by me. I directed the architecture, reviewed every change, guided the implementation, and made all the decisions. But if authorship means writing the actual lines, that credit belongs mostly to the AI. The rise of these tools changed the equation entirely: what would have taken me months of evenings and weekends became achievable, and I got to compare quite a few models and assistants throughout the process — which is a benefit in itself.
+
+## What the app can do
+
+TrainUs covers the full training cycle:
+
+- **Exercises** — define each movement with a description, default reps, weight, side management (left/right), and image/video links.
+- **Combos** — group exercises into circuits with a built-in timer (EMOM, AMRAP, TABATA, or classic superset).
+- **Sessions** — compose workouts from exercises and combos, in any order you like.
+- **Collections** — organize multiple sessions into a weekly program or training phase.
+- **Execution mode** — follow a session in real time: timers, actual reps, weight used, left/right side, audio cues.
+- **Statistics** — charts for frequency, volume, and progression per exercise.
+- **Import / export** — share exercises and sessions between devices or with other users via JSON files.
+- **Backup** — download the SQLite database directly; the app regularly reminds you to make a backup.
+
+## Technical choices
+
+| Aspect   | Choice                     | Reason                                               |
+| -------- | -------------------------- | ---------------------------------------------------- |
+| UI       | Vue 3 (Composition API)    | Lightweight, declarative reactivity, good ecosystem  |
+| Database | SQLite WASM + OPFS         | Performant local persistence, no server needed       |
+| PWA      | vite-plugin-pwa + Workbox  | Full caching, native installation                    |
+| i18n     | i18next + i18next-vue      | Instant language switch without page reload          |
+| Charts   | Chart.js 4 + vue-chartjs 5 | Lightweight, well documented, simple Vue integration |
+| Build    | Vite 7                     | Fast builds, good WASM asset handling                |
+
+The choice of **SQLite WASM with the `opfs-sahpool` VFS** deserves a special mention. It is the most performant configuration available in a browser: synchronous I/O via `FileSystemSyncAccessHandle`, without requiring COOP/COEP headers. The only trade-off is that SQLite must run inside a Web Worker (synchronous OPFS APIs are not available on the main thread) — which is good practice anyway to avoid blocking the UI.
+
+## What's next?
+
+The app is in **preview** — functional and fairly complete — but not yet publicly released. The next step is to deploy it and finalize the documentation.
+
+The source code is available on GitHub under the GNU AGPL v3 license (link in the footer).
+
+---
+
+_This post opens the project blog. Future articles will cover technical decisions, upcoming features, and usage feedback._
diff --git a/website/content/blog/2026-06-14-lancement.fr.md b/website/content/blog/2026-06-14-lancement.fr.md
new file mode 100644
index 0000000..8ddb66b
--- /dev/null
+++ b/website/content/blog/2026-06-14-lancement.fr.md
@@ -0,0 +1,59 @@
+---
+title: 'Lancement du site TrainUs'
+date: 2026-06-14
+description: 'Présentation du projet TrainUs : une application de suivi fitness locale, bilingue et installable, entièrement dans le navigateur.'
+---
+
+> This article is available in English: [Launching the TrainUs website]({{< relref "2026-06-14-lancement.en.md" >}})
+
+Aujourd'hui, je publie le site de documentation de **TrainUs**, une application de suivi fitness que je développe depuis quelques mois.
+
+## C'est quoi TrainUs ?
+
+TrainUs est une application web progressive (PWA) qui tourne **entièrement dans le navigateur**. Il n'y a pas de serveur, pas de compte à créer, pas de données envoyées quelque part. Tout est stocké localement sur votre appareil grâce à SQLite WASM et l'API OPFS (Origin Private File System).
+
+L'application est **bilingue** (français et anglais) et **installable** sur votre téléphone ou votre ordinateur comme une vraie application native — avec support hors-ligne complet.
+
+## Pourquoi ce projet ?
+
+La plupart des applications de fitness que j'ai essayées partagent les mêmes limitations : elles exigent un compte, envoient vos données dans le cloud, et disparaissent si l'abonnement s'arrête ou si le service ferme. Et quand on veut partager un entraînement ou exporter ses données vers un autre outil, c'est souvent impossible — ou verrouillé derrière un format propriétaire.
+
+Je voulais quelque chose de simple, qui fonctionne sans connexion, qui ne collecte rien, et qui permette de partager librement ses données. Alors je l'ai construit.
+
+> **L'IA a écrit presque tout le code.** J'ai les compétences techniques pour mener ce type de projet, mais pas le temps — et pour être transparent : la grande majorité du code source a été écrite par des assistants IA, pas par moi. J'ai dirigé l'architecture, relu chaque modification, guidé l'implémentation et pris toutes les décisions. Mais si l'auteur, c'est celui qui tape les lignes, ce crédit revient en grande partie à l'IA. L'émergence de ces outils a complètement changé l'équation : ce qui m'aurait pris des mois de soirées et de week-ends est devenu réalisable, et j'ai pu tester et comparer pas mal de modèles et d'assistants au fil du développement — ce qui est en soi un bénéfice.
+
+## Ce que l'application permet de faire
+
+TrainUs couvre l'ensemble du cycle d'entraînement :
+
+- **Exercices** — définir chaque mouvement avec description, reps par défaut, poids, gestion des côtés (gauche/droite), liens image et vidéo.
+- **Combos** — regrouper des exercices en circuits avec minuteur intégré (EMOM, AMRAP, TABATA ou superset classique).
+- **Séances** — composer des séances à partir d'exercices et de combos, dans l'ordre que vous voulez.
+- **Collections** — organiser plusieurs séances en programme hebdomadaire ou en phase d'entraînement.
+- **Mode exécution** — suivre une séance en temps réel : minuteurs, reps réelles, poids utilisé, côté gauche/droite, audio.
+- **Statistiques** — graphiques de fréquence, de volume et de progression par exercice.
+- **Import / export** — partager exercices et séances entre appareils ou avec d'autres utilisateurs via des fichiers JSON.
+- **Sauvegarde** — télécharger la base SQLite directement ; l'application rappelle régulièrement de faire une sauvegarde.
+
+## Choix techniques
+
+| Aspect          | Choix                      | Raison                                            |
+| --------------- | -------------------------- | ------------------------------------------------- |
+| Framework UI    | Vue 3 (Composition API)    | Légèreté, réactivité déclarative, bon écosystème  |
+| Base de données | SQLite WASM + OPFS         | Persistance locale performante, pas de serveur    |
+| PWA             | vite-plugin-pwa + Workbox  | Mise en cache complète, installation native       |
+| i18n            | i18next + i18next-vue      | Changement de langue instantané sans rechargement |
+| Graphiques      | Chart.js 4 + vue-chartjs 5 | Légère, bien documentée, intégration Vue simple   |
+| Build           | Vite 7                     | Build rapide, bonne gestion des assets WASM       |
+
+Le choix de **SQLite WASM avec le VFS `opfs-sahpool`** mérite une mention particulière. C'est la configuration la plus performante disponible dans un navigateur : I/O synchrone via `FileSystemSyncAccessHandle`, sans avoir besoin des en-têtes COOP/COEP. Le seul compromis est qu'il faut exécuter SQLite dans un Web Worker (les APIs OPFS synchrones ne sont pas disponibles sur le thread principal) — ce qui est de toute façon une bonne pratique pour ne pas bloquer l'interface.
+
+## Et maintenant ?
+
+L'application est en **préversion** — fonctionnelle et assez complète — mais pas encore publiée. La prochaine étape est de la déployer publiquement et de finaliser la documentation en français.
+
+Le code source est disponible sur GitHub sous licence GNU AGPL v3 (lien en pied de page).
+
+---
+
+_Ce billet inaugure le blog du projet. Les prochains articles parleront des décisions techniques, des fonctionnalités à venir et des retours d'usage._
diff --git a/website/content/blog/_index.en.md b/website/content/blog/_index.en.md
new file mode 100644
index 0000000..b3476d7
--- /dev/null
+++ b/website/content/blog/_index.en.md
@@ -0,0 +1,4 @@
+---
+title: 'Blog'
+description: 'News and announcements from the TrainUs project.'
+---
diff --git a/website/content/blog/_index.fr.md b/website/content/blog/_index.fr.md
new file mode 100644
index 0000000..1a2626a
--- /dev/null
+++ b/website/content/blog/_index.fr.md
@@ -0,0 +1,4 @@
+---
+title: 'Blog'
+description: 'Actualités et annonces du projet TrainUs.'
+---
diff --git a/website/content/blog/release-template.en.md b/website/content/blog/release-template.en.md
new file mode 100644
index 0000000..f311235
--- /dev/null
+++ b/website/content/blog/release-template.en.md
@@ -0,0 +1,26 @@
+---
+title: 'TrainUs {VERSION} released'
+date: { YYYY-MM-DD }
+description: '{ONE LINE SUMMARY OF THIS RELEASE}'
+draft: true
+---
+
+> This post is available in French: [{TITRE_ARTICLE_FR}](/blog/{YYYY-MM-DD}-release-{VERSION}/)
+
+TrainUs **{VERSION}** is now available.
+
+## What's new
+
+{DESCRIBE NEW FEATURES — one paragraph or a bullet list}
+
+## Bug fixes
+
+{LIST BUG FIXES, or remove this section if none}
+
+## How to get it
+
+The app is available at [{APP_URL}]({APP_URL}). It updates automatically — just reload the page in your browser.
+
+To install or update the PWA on your device, open the app and use the browser's install prompt (or menu → "Install app").
+
+Source code and release notes: [{FORGEJO_URL}/{FORGEJO_OWNER}/{FORGEJO_REPO}/releases/tag/{VERSION}]({FORGEJO_URL}/{FORGEJO_OWNER}/{FORGEJO_REPO}/releases/tag/{VERSION})
diff --git a/website/content/contact.en.md b/website/content/contact.en.md
new file mode 100644
index 0000000..8b23ca8
--- /dev/null
+++ b/website/content/contact.en.md
@@ -0,0 +1,22 @@
+---
+title: 'Contact'
+description: 'Reach out to report a bug, suggest an idea or contribute to the project.'
+---
+
+To report a bug, suggest an idea or contribute to the project, you can open an issue on the repository or send us an e-mail:
+
+<p id="email-contact"></p>
+<script>
+(function () {
+  var u = 'trainus.steadfast012';
+  var d = 'passmail.net';
+  var a = document.createElement('a');
+  a.href = 'mailto:' + u + '@' + d;
+  a.textContent = u + '@' + d;
+  document.getElementById('email-contact').appendChild(a);
+})();
+</script>
+
+<noscript>
+  Enable JavaScript to display the e-mail address.
+</noscript>
diff --git a/website/content/contact.fr.md b/website/content/contact.fr.md
new file mode 100644
index 0000000..082e662
--- /dev/null
+++ b/website/content/contact.fr.md
@@ -0,0 +1,22 @@
+---
+title: 'Contact'
+description: 'Nous contacter pour signaler un bug, proposer une idée ou contribuer au projet.'
+---
+
+Pour signaler un bug, proposer une idée ou contribuer au projet, vous pouvez ouvrir une issue sur le dépôt ou nous écrire par e-mail :
+
+<p id="email-contact"></p>
+<script>
+(function () {
+  var u = 'trainus.steadfast012';
+  var d = 'passmail.net';
+  var a = document.createElement('a');
+  a.href = 'mailto:' + u + '@' + d;
+  a.textContent = u + '@' + d;
+  document.getElementById('email-contact').appendChild(a);
+})();
+</script>
+
+<noscript>
+  Activez JavaScript pour afficher l'adresse e-mail.
+</noscript>
diff --git a/website/content/developers/_index.en.md b/website/content/developers/_index.en.md
new file mode 100644
index 0000000..680148c
--- /dev/null
+++ b/website/content/developers/_index.en.md
@@ -0,0 +1,4 @@
+---
+title: 'Developers'
+description: 'TrainUs technical documentation: architecture, database layer, and guides for contributing to the project.'
+---
diff --git a/website/content/developers/_index.fr.md b/website/content/developers/_index.fr.md
new file mode 100644
index 0000000..981948a
--- /dev/null
+++ b/website/content/developers/_index.fr.md
@@ -0,0 +1,4 @@
+---
+title: 'Développeurs'
+description: 'Documentation technique de TrainUs : architecture, base de données, et guides pour contribuer au projet.'
+---
diff --git a/website/content/developers/getting-started.en.md b/website/content/developers/getting-started.en.md
new file mode 100644
index 0000000..02ae60e
--- /dev/null
+++ b/website/content/developers/getting-started.en.md
@@ -0,0 +1,81 @@
+---
+title: 'Getting Started'
+description: 'Set up your dev environment, run TrainUs locally, and make your first change.'
+slug: 'getting-started'
+weight: 1
+date: 2026-06-16
+---
+
+## What You'll Need
+
+- **Node.js** ≥ 18
+- **Python** ≥ 3.10 (only needed to run the test suite)
+- A modern browser — Firefox 111+, Chrome 102+, or Safari 16.4+. TrainUs relies on OPFS (Origin Private File System) for its database, which doesn't exist in older browsers or in private/incognito windows.
+
+## Clone and Install
+
+```bash
+git clone <repo-url>
+cd trainUs
+npm install
+```
+
+## Run the App
+
+```bash
+npm run dev
+```
+
+This starts the Vite dev server at `http://localhost:5173`. Open it in your browser — on first launch, TrainUs creates a local database and generates a random user ID for you. There's nothing else to configure: no `.env` file, no server, no account.
+
+## A Quick Tour of `src/`
+
+You don't need to memorize this — just enough to know where to look:
+
+| Folder          | What's in it                                                                                   |
+| --------------- | ---------------------------------------------------------------------------------------------- |
+| `views/`        | One Vue component per route (`ExerciseListView.vue`, `SettingsView.vue`, …)                    |
+| `components/`   | Smaller, reusable pieces used across views (dialogs, the action bar, …)                        |
+| `composables/`  | Reactive state + logic shared between components (`useExercises`, `useSessionExecution`, …)    |
+| `db/`           | Everything SQLite: the worker, the schema, and one repository per entity in `db/repositories/` |
+| `i18n/locales/` | Translation files — `en.json`, `fr.json`, `da.json`                                            |
+| `styles/`       | CSS variables (theming) and global layout rules                                                |
+| `utils/`        | Small pure helper functions (validation, date formatting, Markdown rendering, …)               |
+
+The [Reference]({{< relref "technical.en.md" >}}) page covers this in full detail — schema, routes, every composable. Keep it open in a tab once you start working on something real.
+
+## Run the Test Suite
+
+TrainUs is tested end-to-end with Playwright, driven from Python. The dev server starts automatically for the duration of the test run — you don't need `npm run dev` running separately.
+
+```bash
+cd tests
+python -m venv .venv
+.venv/bin/pip install -r requirements.txt
+.venv/bin/playwright install firefox chromium
+cd ..
+npm test                 # Firefox only — the project's primary target
+npm run test:parallel    # Firefox + Chromium, in parallel
+```
+
+See `tests/README.md` in the repository for the full setup if anything above doesn't work out of the box.
+
+## Make a Small Change
+
+Before tackling anything real, it's worth closing the loop once: edit something, see it reload, run the checks.
+
+1. With `npm run dev` running, open `src/i18n/locales/en.json` and change the value of `"settings.title"` to something else — e.g. `"Settings (testing)"`.
+2. Save the file. The browser should hot-reload and show your change on the Settings page.
+3. Revert the change, then run the formatter to confirm your editor setup matches the project's:
+
+   ```bash
+   npm run format:check
+   ```
+
+That's the full inner loop: edit → reload → format check. The [How-to Guides]({{< relref "how-to-guides.en.md" >}}) page walks through complete, realistic tasks (adding a language, adding a theme, deploying, adding a migration) built on exactly this loop.
+
+## Going Further
+
+- [How-to Guides]({{< relref "how-to-guides.en.md" >}}) — concrete recipes for common contributor tasks.
+- [Reference]({{< relref "technical.en.md" >}}) — architecture, database schema, routes, and every composable, in detail.
+- [Understanding the Architecture]({{< relref "understanding-the-architecture.en.md" >}}) — the why behind the choices: local-first, the Worker thread, the migration system.
diff --git a/website/content/developers/getting-started.fr.md b/website/content/developers/getting-started.fr.md
new file mode 100644
index 0000000..06f21df
--- /dev/null
+++ b/website/content/developers/getting-started.fr.md
@@ -0,0 +1,81 @@
+---
+title: 'Démarrage rapide'
+description: 'Installez votre environnement de développement, lancez TrainUs en local, et faites votre première modification.'
+slug: 'demarrage-rapide'
+weight: 1
+date: 2026-06-16
+---
+
+## Ce dont vous aurez besoin
+
+- **Node.js** ≥ 18
+- **Python** ≥ 3.10 (uniquement pour lancer la suite de tests)
+- Un navigateur récent — Firefox 111+, Chrome 102+, ou Safari 16.4+. TrainUs s'appuie sur OPFS (Origin Private File System) pour sa base de données, qui n'existe pas dans les navigateurs anciens ni dans les fenêtres de navigation privée.
+
+## Cloner et installer
+
+```bash
+git clone <repo-url>
+cd trainUs
+npm install
+```
+
+## Lancer l'application
+
+```bash
+npm run dev
+```
+
+Cela démarre le serveur de développement Vite sur `http://localhost:5173`. Ouvrez-le dans votre navigateur — au premier lancement, TrainUs crée une base de données locale et génère un identifiant utilisateur aléatoire pour vous. Il n'y a rien d'autre à configurer : pas de fichier `.env`, pas de serveur, pas de compte.
+
+## Petit tour de `src/`
+
+Pas besoin de tout retenir — juste assez pour savoir où chercher :
+
+| Dossier         | Ce qu'on y trouve                                                                                       |
+| --------------- | ------------------------------------------------------------------------------------------------------- |
+| `views/`        | Un composant Vue par route (`ExerciseListView.vue`, `SettingsView.vue`, …)                              |
+| `components/`   | Des éléments plus petits et réutilisables entre les vues (dialogues, barre d'action, …)                 |
+| `composables/`  | État réactif + logique partagés entre composants (`useExercises`, `useSessionExecution`, …)             |
+| `db/`           | Tout ce qui touche à SQLite : le worker, le schéma, et un repository par entité dans `db/repositories/` |
+| `i18n/locales/` | Fichiers de traduction — `en.json`, `fr.json`, `da.json`                                                |
+| `styles/`       | Variables CSS (thèmes) et règles de mise en page globales                                               |
+| `utils/`        | Petites fonctions utilitaires pures (validation, formatage de dates, rendu Markdown, …)                 |
+
+La page [Référence]({{< relref "technical.fr.md" >}}) couvre tout ça en détail — schéma, routes, chaque composable. Gardez-la ouverte dans un onglet dès que vous travaillez sur quelque chose de concret.
+
+## Lancer la suite de tests
+
+TrainUs est testé de bout en bout avec Playwright, piloté depuis Python. Le serveur de développement démarre automatiquement pendant la durée des tests — pas besoin de garder `npm run dev` lancé séparément.
+
+```bash
+cd tests
+python -m venv .venv
+.venv/bin/pip install -r requirements.txt
+.venv/bin/playwright install firefox chromium
+cd ..
+npm test                 # Firefox uniquement — la cible principale du projet
+npm run test:parallel    # Firefox + Chromium, en parallèle
+```
+
+Voir `tests/README.md` dans le dépôt pour la configuration complète si quelque chose ne fonctionne pas du premier coup.
+
+## Faire une petite modification
+
+Avant de vous lancer dans quelque chose de réel, ça vaut le coup de boucler la boucle une fois : modifier, voir le rechargement, lancer les vérifications.
+
+1. Avec `npm run dev` lancé, ouvrez `src/i18n/locales/en.json` et changez la valeur de `"settings.title"` en autre chose — par exemple `"Settings (testing)"`.
+2. Enregistrez le fichier. Le navigateur devrait se recharger automatiquement et afficher votre changement sur la page Réglages.
+3. Annulez la modification, puis lancez le formateur pour vérifier que votre éditeur est bien configuré comme celui du projet :
+
+   ```bash
+   npm run format:check
+   ```
+
+C'est toute la boucle de travail : modifier → recharger → vérifier le formatage. La page [Guides pratiques]({{< relref "how-to-guides.fr.md" >}}) détaille des tâches complètes et réalistes (ajouter une langue, ajouter un thème, déployer, ajouter une migration) construites exactement sur cette même boucle.
+
+## Pour aller plus loin
+
+- [Guides pratiques]({{< relref "how-to-guides.fr.md" >}}) — des recettes concrètes pour les tâches courantes de contribution.
+- [Référence]({{< relref "technical.fr.md" >}}) — architecture, schéma de base de données, routes et chaque composable, en détail.
+- [Comprendre l'architecture]({{< relref "understanding-the-architecture.fr.md" >}}) — le pourquoi des choix : local-first, le thread Worker, le système de migration.
diff --git a/website/content/developers/how-to-guides.en.md b/website/content/developers/how-to-guides.en.md
new file mode 100644
index 0000000..90ec6aa
--- /dev/null
+++ b/website/content/developers/how-to-guides.en.md
@@ -0,0 +1,329 @@
+---
+title: 'How-to Guides'
+description: 'Step-by-step recipes for common contributor tasks: languages, themes, deployment, migrations.'
+slug: 'how-to-guides'
+weight: 2
+date: 2026-06-16
+---
+
+## Add a New Language
+
+> TrainUs already ships three languages today — English, French, and Danish (`da`) — not just the EN/FR pair the project website emphasizes. The steps below walk through adding one more, using Spanish (`es`) as the worked example.
+
+Adding a language requires four touch points: a new locale file, wiring it into the i18n initializer, a selector option in Settings, and a decision-log entry.
+
+1. `src/i18n/locales/<code>.json` — create the translation file
+2. `src/i18n/index.js` — import and register the locale
+3. `src/views/SettingsView.vue` — add the `<option>` in the language selector
+4. `docs/decisions-log.md` — record the decision
+
+### 1. Create the translation file
+
+Copy `src/i18n/locales/en.json` to `src/i18n/locales/<code>.json`, where `<code>` is the two-letter BCP 47 language tag (e.g. `es`, `de`, `it`).
+
+Translate every string value. Do **not** change any key name. Keep all interpolation placeholders (`{{date}}`, `{{title}}`, etc.) and HTML entities exactly as they appear in the source.
+
+### 2. Register the locale in i18next
+
+Open `src/i18n/index.js`. Add an import at the top alongside the existing ones:
+
+```js
+import es from './locales/es.json'
+```
+
+Then add the locale to the `resources` object inside `i18next.init`:
+
+```js
+resources: {
+  en: { translation: en },
+  fr: { translation: fr },
+  da: { translation: da },
+  es: { translation: es },   // ← new
+},
+```
+
+### 3. Add the option in the Settings selector
+
+Open `src/views/SettingsView.vue` and locate the `<select>` element with `id="settings-language"`. Add one `<option>` after the existing ones:
+
+```html
+<option value="es">Español</option>
+```
+
+Use the language's native name as the label (not the English name), so speakers can identify it without reading English.
+
+### 4. Update the decision log
+
+Add an entry to `docs/decisions-log.md` recording the addition and why.
+
+### Checklist
+
+- [ ] `src/i18n/locales/<code>.json` created and fully translated
+- [ ] Import added in `src/i18n/index.js`
+- [ ] `<option>` added in `src/views/SettingsView.vue`
+- [ ] Language can be selected in Settings and the UI switches correctly
+- [ ] `docs/decisions-log.md` updated
+
+---
+
+## Add a New Theme
+
+A theme is a named set of CSS variable overrides scoped to a `[data-theme='<name>']` attribute. The app reads the active theme from the database and sets that attribute on `<html>` before the first render.
+
+1. `src/styles/variables.css` — define the CSS variable block
+2. `src/i18n/locales/{en,fr,da}.json` — add the display label, in every supported language
+3. `src/views/SettingsView.vue` — add the `<option>` in the theme selector
+4. Manual smoke-test in the browser
+5. `docs/decisions-log.md` — record the decision
+
+### 1. Define the CSS variables
+
+Open `src/styles/variables.css` and append a new block at the end. Copy the `:root` block as a starting point and change only the values that differ from the default light theme.
+
+```css
+/* My theme */
+[data-theme='<name>'] {
+  --bg-color1: ...;
+  --bg-color2: ...;
+  --front-color1: ...;
+  --front-color2: ...;
+  --navbar-bg-color: ...;
+  --navbar-front-color: ...;
+  --navbar-hover-bg-color: ...;
+  --navbar-hover-front-color: ...;
+  --actionbar-bg-color: ...;
+  --actionbar-font-color: ...;
+  --border-color: ...;
+  --input-bg: ...;
+  --input-border: ...;
+  --btn-primary-bg: ...;
+  --btn-primary-color: ...;
+  --btn-danger-bg: ...;
+  --btn-danger-color: ...;
+  --success-color: ...;
+  --warning-color: ...;
+}
+```
+
+The selector value (e.g. `trainus`) becomes the theme's key everywhere else. See the variable reference at the bottom of this recipe for what each one affects.
+
+### 2. Add the display label in every supported language
+
+TrainUs ships three languages today — English, French, and Danish (see [Add a New Language](#add-a-new-language) above) — so the new theme's label needs an entry in **all three** locale files, not just English and French. Add `"themeMyName"` to the `"settings"` object, after `"themeDark"`, in each:
+
+`src/i18n/locales/en.json`:
+
+```json
+"themeMyName": "My Theme Label"
+```
+
+`src/i18n/locales/fr.json`:
+
+```json
+"themeMyName": "Mon thème"
+```
+
+`src/i18n/locales/da.json`:
+
+```json
+"themeMyName": "Mit tema"
+```
+
+If a language ends up missing the key, i18next falls back to `fallbackLng: 'en'` rather than crashing — but it's still worth catching during the smoke-test below, since a stray English label in another language's UI is easy to miss otherwise.
+
+### 3. Add the option in the settings selector
+
+In `src/views/SettingsView.vue`, locate the theme `<select>` block (search for `settings-theme`). Add one `<option>` after the existing ones:
+
+```html
+<option value="<name>">{{ $t('settings.themeMyName') }}</option>
+```
+
+The `value` must match the selector name from step 1.
+
+### 4. Smoke-test
+
+1. `npm run dev`
+2. Open Settings → Theme → select your new theme.
+3. Verify: navbar, background, buttons, and inputs all render with the new palette.
+4. Refresh the page to confirm the theme persists (loaded from the database on startup).
+5. Switch through each language (English, French, Danish) and confirm the theme's label is translated, not falling back to English.
+6. Export settings and re-import to confirm the theme key round-trips correctly.
+
+### 5. Update the decision log
+
+Add an entry to `docs/decisions-log.md` recording the addition and why.
+
+### Variable reference
+
+| Variable                     | Affects                             |
+| ---------------------------- | ----------------------------------- |
+| `--bg-color1`                | Main page background                |
+| `--bg-color2`                | Card / secondary surface background |
+| `--front-color1`             | Primary text                        |
+| `--front-color2`             | Secondary / muted text              |
+| `--navbar-bg-color`          | Side navigation background          |
+| `--navbar-front-color`       | Side navigation text & icons        |
+| `--navbar-hover-bg-color`    | Nav item hover background           |
+| `--navbar-hover-front-color` | Nav item hover text                 |
+| `--actionbar-bg-color`       | Top action bar background           |
+| `--actionbar-font-color`     | Top action bar text & icons         |
+| `--border-color`             | Card and input borders              |
+| `--input-bg`                 | Input field background              |
+| `--input-border`             | Input field border                  |
+| `--btn-primary-bg`           | Primary button background           |
+| `--btn-primary-color`        | Primary button text                 |
+| `--btn-danger-bg`            | Danger / delete button background   |
+| `--btn-danger-color`         | Danger button text                  |
+| `--success-color`            | Success messages and indicators     |
+| `--warning-color`            | Warning messages and indicators     |
+
+### Checklist
+
+- [ ] CSS variable block added in `src/styles/variables.css`
+- [ ] Display label added in every supported language (English, French, Danish)
+- [ ] `<option>` added in `src/views/SettingsView.vue`
+- [ ] Theme selectable, persists on reload, and round-trips through export/import
+- [ ] `docs/decisions-log.md` updated
+
+---
+
+## Add a Database Migration
+
+> **Ask first.** Per the project rules, `SCHEMA_VERSION` is only bumped once a schema has actually been deployed to users — and only after confirming with the project owner. Adding a column directly to `SCHEMA_SQL` (in `src/db/schema.js`) is enough for in-place changes before a release; you don't need any of the steps below for that case. Reach for a real migration only when existing users already have data under the old schema.
+
+A `SCHEMA_VERSION` bump always ships together with exactly one entry in the `RELEASES` registry (`src/db/releases.js`), which is the single source of truth both the startup migration and the Restore Database compatibility check read from.
+
+1. Bump `SCHEMA_VERSION` in `src/db/schema.js`.
+2. Write the SQL that brings a live database from the previous version to the new one.
+3. Add the corresponding entry to `RELEASES` in `src/db/releases.js`.
+4. Test the upgrade path against a database still on the old version.
+5. Update the reference docs.
+
+### 1. Bump the version
+
+```js
+// src/db/schema.js
+export const SCHEMA_VERSION = 2 // was 1
+```
+
+### 2. Write the migration script
+
+A migration script is plain SQL — `ALTER TABLE`, data backfills, anything needed to bring the previous schema in line with the new one. It runs inside the same transaction as the `schema_version` stamp, so partial failures roll back cleanly.
+
+### 3. Register the release
+
+```js
+// src/db/releases.js
+export const RELEASES = [
+  { schemaVersion: 1, appVersion: '1.0.0', dbBreak: false, migrationScript: null },
+  {
+    schemaVersion: 2,
+    appVersion: '1.1.0',
+    dbBreak: true,
+    migrationScript: `ALTER TABLE exercise ADD COLUMN category TEXT;`,
+  },
+]
+```
+
+- `dbBreak: false` with `migrationScript: null` is a valid no-op entry (only the `schema_version` row is stamped) — use it for a version bump that doesn't actually need to touch existing data.
+- `dbBreak: true` requires a non-null `migrationScript`; `getMigrationScripts()` throws if one is missing for a breaking release in range.
+
+### 4. Test the upgrade path
+
+Two code paths read `RELEASES`, and both need a check:
+
+- **Startup migration**: open the app with an existing database stamped at the old `schema_version`. The app should show the blocking "download a backup first" screen, then apply your script and continue with data intact.
+- **Restore Database**: restore a `.sqlite3` backup taken at the old schema version into a build running the new one — `checkCompatibility()` should detect the gap and run the same script during the restore's adaptation step.
+
+See [Reference]({{< relref "technical.en.md" >}}) for the full migration state machine and flowchart, and [Understanding the Architecture]({{< relref "understanding-the-architecture.en.md" >}}) for why the system is built this way (forced backup, transactional migrations, fail-safe on a newer-than-app database).
+
+### 5. Update the docs
+
+- The schema table and ER diagram in [Reference]({{< relref "technical.en.md" >}})
+- `docs/decisions-log.md`, with the date, decision, and rationale
+
+### Checklist
+
+- [ ] Confirmed with the project owner that a real version bump (not an in-place change) is warranted
+- [ ] `SCHEMA_VERSION` bumped
+- [ ] `RELEASES` entry added with a correct `migrationScript` (or `null` for a no-op)
+- [ ] Startup migration tested against an old-version database
+- [ ] Restore Database adaptation tested against an old-version backup
+- [ ] Reference docs and `docs/decisions-log.md` updated
+
+---
+
+## Deploy TrainUs
+
+TrainUs is a static site: `npm run build` outputs everything needed to `dist/`, ready to copy to any web server or CDN. There's a single deployment — each new build replaces the previous one at the site root, with no per-version folders. The service worker handles client-side code updates, and the startup migration system (see [Reference]({{< relref "technical.en.md" >}})) handles any database schema changes, so the same OPFS data simply carries over.
+
+```bash
+npm run build      # outputs static files to dist/
+npm run preview    # preview the production build locally
+```
+
+TrainUs uses the `opfs-sahpool` VFS (see [Reference]({{< relref "technical.en.md" >}})), which doesn't strictly require COOP/COEP headers. Setting them anyway is recommended as defense-in-depth, and they may become required if the VFS implementation ever changes — the dev server already sets them as a precaution:
+
+```
+Cross-Origin-Opener-Policy: same-origin
+Cross-Origin-Embedder-Policy: require-corp
+```
+
+**Nginx**
+
+```nginx
+location / {
+    add_header Cross-Origin-Opener-Policy "same-origin";
+    add_header Cross-Origin-Embedder-Policy "require-corp";
+}
+```
+
+**Apache**
+
+```apache
+<IfModule mod_headers.c>
+    Header always set Cross-Origin-Opener-Policy "same-origin"
+    Header always set Cross-Origin-Embedder-Policy "require-corp"
+</IfModule>
+```
+
+**Caddy**
+
+```caddy
+header {
+    Cross-Origin-Opener-Policy "same-origin"
+    Cross-Origin-Embedder-Policy "require-corp"
+}
+```
+
+**Netlify** (`public/_headers`)
+
+```
+/*
+  Cross-Origin-Opener-Policy: same-origin
+  Cross-Origin-Embedder-Policy: require-corp
+```
+
+**Vercel** (`vercel.json`)
+
+```json
+{
+  "headers": [
+    {
+      "source": "/(.*)",
+      "headers": [
+        { "key": "Cross-Origin-Opener-Policy", "value": "same-origin" },
+        { "key": "Cross-Origin-Embedder-Policy", "value": "require-corp" }
+      ]
+    }
+  ]
+}
+```
+
+### Checklist
+
+- [ ] `npm run build` completed without errors
+- [ ] `dist/` deployed to the site root, replacing the previous build
+- [ ] COOP/COEP headers configured on the server (recommended, not strictly required for `opfs-sahpool`)
+- [ ] App loads and OPFS initializes correctly
diff --git a/website/content/developers/how-to-guides.fr.md b/website/content/developers/how-to-guides.fr.md
new file mode 100644
index 0000000..bfd7811
--- /dev/null
+++ b/website/content/developers/how-to-guides.fr.md
@@ -0,0 +1,329 @@
+---
+title: 'Guides pratiques'
+description: 'Recettes pas à pas pour les tâches courantes de contribution : langues, thèmes, déploiement, migrations.'
+slug: 'guides-pratiques'
+weight: 2
+date: 2026-06-16
+---
+
+## Ajouter une nouvelle langue
+
+> TrainUs propose déjà trois langues aujourd'hui — anglais, français et danois (`da`) — pas seulement la paire EN/FR mise en avant sur le site du projet. Les étapes ci-dessous montrent comment en ajouter une de plus, avec l'espagnol (`es`) comme exemple travaillé.
+
+Ajouter une langue demande quatre points de contact : un nouveau fichier de traduction, son enregistrement dans l'initialiseur i18n, une option dans le sélecteur des Réglages, et une entrée dans le journal de décisions.
+
+1. `src/i18n/locales/<code>.json` — créer le fichier de traduction
+2. `src/i18n/index.js` — importer et enregistrer la locale
+3. `src/views/SettingsView.vue` — ajouter l'`<option>` dans le sélecteur de langue
+4. `docs/decisions-log.md` — consigner la décision
+
+### 1. Créer le fichier de traduction
+
+Copiez `src/i18n/locales/en.json` vers `src/i18n/locales/<code>.json`, où `<code>` est le code de langue à deux lettres BCP 47 (par exemple `es`, `de`, `it`).
+
+Traduisez chaque valeur de chaîne. Ne changez **aucun** nom de clé. Conservez tous les marqueurs d'interpolation (`{{date}}`, `{{title}}`, etc.) et les entités HTML exactement comme dans la source.
+
+### 2. Enregistrer la locale dans i18next
+
+Ouvrez `src/i18n/index.js`. Ajoutez un import en haut, à côté des autres :
+
+```js
+import es from './locales/es.json'
+```
+
+Puis ajoutez la locale à l'objet `resources` dans `i18next.init` :
+
+```js
+resources: {
+  en: { translation: en },
+  fr: { translation: fr },
+  da: { translation: da },
+  es: { translation: es },   // ← nouveau
+},
+```
+
+### 3. Ajouter l'option dans le sélecteur des Réglages
+
+Ouvrez `src/views/SettingsView.vue` et repérez l'élément `<select>` avec `id="settings-language"`. Ajoutez une `<option>` après les autres :
+
+```html
+<option value="es">Español</option>
+```
+
+Utilisez le nom natif de la langue comme libellé (pas le nom anglais), pour que les locuteurs puissent l'identifier sans avoir à lire l'anglais.
+
+### 4. Mettre à jour le journal de décisions
+
+Ajoutez une entrée dans `docs/decisions-log.md` consignant l'ajout et sa raison.
+
+### Liste de vérification
+
+- [ ] `src/i18n/locales/<code>.json` créé et entièrement traduit
+- [ ] Import ajouté dans `src/i18n/index.js`
+- [ ] `<option>` ajoutée dans `src/views/SettingsView.vue`
+- [ ] La langue est sélectionnable dans les Réglages et l'interface change correctement
+- [ ] `docs/decisions-log.md` mis à jour
+
+---
+
+## Ajouter un nouveau thème
+
+Un thème est un ensemble nommé de surcharges de variables CSS, scopées à un attribut `[data-theme='<name>']`. L'application lit le thème actif depuis la base de données et pose cet attribut sur `<html>` avant le premier rendu.
+
+1. `src/styles/variables.css` — définir le bloc de variables CSS
+2. `src/i18n/locales/{en,fr,da}.json` — ajouter le libellé d'affichage, dans toutes les langues prises en charge
+3. `src/views/SettingsView.vue` — ajouter l'`<option>` dans le sélecteur de thème
+4. Test manuel dans le navigateur
+5. `docs/decisions-log.md` — consigner la décision
+
+### 1. Définir les variables CSS
+
+Ouvrez `src/styles/variables.css` et ajoutez un nouveau bloc à la fin. Copiez le bloc `:root` comme point de départ et ne changez que les valeurs qui diffèrent du thème clair par défaut.
+
+```css
+/* Mon thème */
+[data-theme='<name>'] {
+  --bg-color1: ...;
+  --bg-color2: ...;
+  --front-color1: ...;
+  --front-color2: ...;
+  --navbar-bg-color: ...;
+  --navbar-front-color: ...;
+  --navbar-hover-bg-color: ...;
+  --navbar-hover-front-color: ...;
+  --actionbar-bg-color: ...;
+  --actionbar-font-color: ...;
+  --border-color: ...;
+  --input-bg: ...;
+  --input-border: ...;
+  --btn-primary-bg: ...;
+  --btn-primary-color: ...;
+  --btn-danger-bg: ...;
+  --btn-danger-color: ...;
+  --success-color: ...;
+  --warning-color: ...;
+}
+```
+
+La valeur du sélecteur (par exemple `trainus`) devient la clé du thème partout ailleurs. Voir la table de référence des variables en bas de cette recette pour savoir ce que chacune affecte.
+
+### 2. Ajouter le libellé d'affichage dans toutes les langues prises en charge
+
+TrainUs propose déjà trois langues aujourd'hui — anglais, français et danois (voir « Ajouter une nouvelle langue » ci-dessus) — donc le libellé du nouveau thème doit avoir une entrée dans **les trois** fichiers de locale, pas seulement en anglais et en français. Ajoutez `"themeMyName"` à l'objet `"settings"`, après `"themeDark"`, dans chacun :
+
+`src/i18n/locales/en.json` :
+
+```json
+"themeMyName": "My Theme Label"
+```
+
+`src/i18n/locales/fr.json` :
+
+```json
+"themeMyName": "Mon thème"
+```
+
+`src/i18n/locales/da.json` :
+
+```json
+"themeMyName": "Mit tema"
+```
+
+Si une langue se retrouve sans la clé, i18next retombe sur `fallbackLng: 'en'` plutôt que de planter — mais ça vaut quand même le coup de le repérer pendant le test manuel ci-dessous, car un libellé resté en anglais dans une autre langue passe facilement inaperçu.
+
+### 3. Ajouter l'option dans le sélecteur des réglages
+
+Dans `src/views/SettingsView.vue`, repérez le bloc `<select>` du thème (recherchez `settings-theme`). Ajoutez une `<option>` après les autres :
+
+```html
+<option value="<name>">{{ $t('settings.themeMyName') }}</option>
+```
+
+La `value` doit correspondre au nom du sélecteur défini à l'étape 1.
+
+### 4. Test manuel
+
+1. `npm run dev`
+2. Ouvrez Réglages → Thème → sélectionnez votre nouveau thème.
+3. Vérifiez : la barre de navigation, le fond, les boutons et les champs s'affichent tous avec la nouvelle palette.
+4. Rechargez la page pour confirmer que le thème persiste (chargé depuis la base de données au démarrage).
+5. Parcourez chaque langue (anglais, français, danois) et vérifiez que le libellé du thème est bien traduit, sans retomber sur l'anglais.
+6. Exportez les réglages puis réimportez-les pour confirmer que la clé du thème survit à l'aller-retour.
+
+### 5. Mettre à jour le journal de décisions
+
+Ajoutez une entrée dans `docs/decisions-log.md` consignant l'ajout et sa raison.
+
+### Référence des variables
+
+| Variable                     | Affecte                                 |
+| ---------------------------- | --------------------------------------- |
+| `--bg-color1`                | Fond principal de la page               |
+| `--bg-color2`                | Fond des cartes / surfaces secondaires  |
+| `--front-color1`             | Texte principal                         |
+| `--front-color2`             | Texte secondaire / discret              |
+| `--navbar-bg-color`          | Fond du menu de navigation latéral      |
+| `--navbar-front-color`       | Texte et icônes du menu latéral         |
+| `--navbar-hover-bg-color`    | Fond au survol d'un élément de menu     |
+| `--navbar-hover-front-color` | Texte au survol d'un élément de menu    |
+| `--actionbar-bg-color`       | Fond de la barre d'action en haut       |
+| `--actionbar-font-color`     | Texte et icônes de la barre d'action    |
+| `--border-color`             | Bordures des cartes et des champs       |
+| `--input-bg`                 | Fond des champs de saisie               |
+| `--input-border`             | Bordure des champs de saisie            |
+| `--btn-primary-bg`           | Fond du bouton principal                |
+| `--btn-primary-color`        | Texte du bouton principal               |
+| `--btn-danger-bg`            | Fond du bouton danger / suppression     |
+| `--btn-danger-color`         | Texte du bouton danger                  |
+| `--success-color`            | Messages et indicateurs de succès       |
+| `--warning-color`            | Messages et indicateurs d'avertissement |
+
+### Liste de vérification
+
+- [ ] Bloc de variables CSS ajouté dans `src/styles/variables.css`
+- [ ] Libellé d'affichage ajouté dans toutes les langues prises en charge (anglais, français, danois)
+- [ ] `<option>` ajoutée dans `src/views/SettingsView.vue`
+- [ ] Thème sélectionnable, persistant au rechargement, et qui survit à l'export/import
+- [ ] `docs/decisions-log.md` mis à jour
+
+---
+
+## Ajouter une migration de base de données
+
+> **Demandez d'abord.** Selon les règles du projet, `SCHEMA_VERSION` n'est incrémenté qu'une fois un schéma réellement déployé auprès des utilisateurs — et seulement après confirmation avec le responsable du projet. Ajouter une colonne directement dans `SCHEMA_SQL` (dans `src/db/schema.js`) suffit pour les changements en place avant une publication ; aucune des étapes ci-dessous n'est nécessaire dans ce cas. Ne passez par une vraie migration que lorsque des utilisateurs existants ont déjà des données sous l'ancien schéma.
+
+Une augmentation de `SCHEMA_VERSION` s'accompagne toujours d'exactement une entrée dans le registre `RELEASES` (`src/db/releases.js`), qui est la source de vérité unique lue à la fois par la migration au démarrage et par la vérification de compatibilité de Restaurer la base de données.
+
+1. Augmentez `SCHEMA_VERSION` dans `src/db/schema.js`.
+2. Écrivez le SQL qui fait passer une base de données existante de l'ancienne version à la nouvelle.
+3. Ajoutez l'entrée correspondante dans `RELEASES` dans `src/db/releases.js`.
+4. Testez le chemin de mise à niveau sur une base encore à l'ancienne version.
+5. Mettez à jour la documentation de référence.
+
+### 1. Augmenter la version
+
+```js
+// src/db/schema.js
+export const SCHEMA_VERSION = 2 // était 1
+```
+
+### 2. Écrire le script de migration
+
+Un script de migration est du SQL classique — `ALTER TABLE`, remplissage de données, tout ce qui est nécessaire pour amener l'ancien schéma au niveau du nouveau. Il s'exécute dans la même transaction que l'estampillage `schema_version`, donc un échec partiel se rétablit proprement.
+
+### 3. Déclarer la release
+
+```js
+// src/db/releases.js
+export const RELEASES = [
+  { schemaVersion: 1, appVersion: '1.0.0', dbBreak: false, migrationScript: null },
+  {
+    schemaVersion: 2,
+    appVersion: '1.1.0',
+    dbBreak: true,
+    migrationScript: `ALTER TABLE exercise ADD COLUMN category TEXT;`,
+  },
+]
+```
+
+- `dbBreak: false` avec `migrationScript: null` est une entrée « no-op » valide (seule la ligne `schema_version` est estampillée) — à utiliser pour une augmentation de version qui n'a pas besoin de toucher aux données existantes.
+- `dbBreak: true` exige un `migrationScript` non nul ; `getMigrationScripts()` lève une erreur si un script manque pour une release « breaking » dans la plage demandée.
+
+### 4. Tester le chemin de mise à niveau
+
+Deux chemins de code lisent `RELEASES`, et les deux doivent être vérifiés :
+
+- **Migration au démarrage** : ouvrez l'application avec une base existante estampillée à l'ancien `schema_version`. L'application doit afficher l'écran bloquant « téléchargez d'abord une sauvegarde », puis appliquer votre script et continuer avec les données intactes.
+- **Restaurer la base de données** : restaurez une sauvegarde `.sqlite3` prise à l'ancienne version de schéma dans une version de l'application tournant sur la nouvelle — `checkCompatibility()` doit détecter l'écart et exécuter le même script pendant l'étape d'adaptation de la restauration.
+
+Voir la [Référence]({{< relref "technical.fr.md" >}}) pour la machine à états complète de la migration et son diagramme de flux, et [Comprendre l'architecture]({{< relref "understanding-the-architecture.fr.md" >}}) pour le pourquoi de cette conception (sauvegarde forcée, migrations transactionnelles, échec sécurisé sur une base plus récente que l'application).
+
+### 5. Mettre à jour la documentation
+
+- Le tableau du schéma et le diagramme entité-relation dans la [Référence]({{< relref "technical.fr.md" >}})
+- `docs/decisions-log.md`, avec la date, la décision et la justification
+
+### Liste de vérification
+
+- [ ] Confirmation obtenue du responsable du projet qu'une vraie augmentation de version (pas un changement en place) est justifiée
+- [ ] `SCHEMA_VERSION` augmenté
+- [ ] Entrée `RELEASES` ajoutée avec un `migrationScript` correct (ou `null` pour un no-op)
+- [ ] Migration au démarrage testée sur une base à l'ancienne version
+- [ ] Adaptation de Restaurer la base de données testée sur une sauvegarde à l'ancienne version
+- [ ] Documentation de référence et `docs/decisions-log.md` mis à jour
+
+---
+
+## Déployer TrainUs
+
+TrainUs est un site statique : `npm run build` génère tout ce qu'il faut dans `dist/`, prêt à être copié sur n'importe quel serveur web ou CDN. Le déploiement est unique : chaque nouvelle build remplace la précédente à la racine du site, sans dossiers par version. Le service worker gère les mises à jour de code côté client, et le système de migration au démarrage (voir [Référence]({{< relref "technical.fr.md" >}})) gère les changements de schéma de base de données, si bien que les mêmes données OPFS sont simplement conservées.
+
+```bash
+npm run build      # génère les fichiers statiques dans dist/
+npm run preview    # prévisualiser la build de production en local
+```
+
+TrainUs utilise le VFS `opfs-sahpool` (voir la [Référence]({{< relref "technical.fr.md" >}})), qui n'a pas strictement besoin des en-têtes COOP/COEP. Les poser tout de même est recommandé par défense en profondeur, et ils pourraient devenir nécessaires si le VFS utilisé venait à changer — le serveur de développement les pose déjà par précaution :
+
+```
+Cross-Origin-Opener-Policy: same-origin
+Cross-Origin-Embedder-Policy: require-corp
+```
+
+**Nginx**
+
+```nginx
+location / {
+    add_header Cross-Origin-Opener-Policy "same-origin";
+    add_header Cross-Origin-Embedder-Policy "require-corp";
+}
+```
+
+**Apache**
+
+```apache
+<IfModule mod_headers.c>
+    Header always set Cross-Origin-Opener-Policy "same-origin"
+    Header always set Cross-Origin-Embedder-Policy "require-corp"
+</IfModule>
+```
+
+**Caddy**
+
+```caddy
+header {
+    Cross-Origin-Opener-Policy "same-origin"
+    Cross-Origin-Embedder-Policy "require-corp"
+}
+```
+
+**Netlify** (`public/_headers`)
+
+```
+/*
+  Cross-Origin-Opener-Policy: same-origin
+  Cross-Origin-Embedder-Policy: require-corp
+```
+
+**Vercel** (`vercel.json`)
+
+```json
+{
+  "headers": [
+    {
+      "source": "/(.*)",
+      "headers": [
+        { "key": "Cross-Origin-Opener-Policy", "value": "same-origin" },
+        { "key": "Cross-Origin-Embedder-Policy", "value": "require-corp" }
+      ]
+    }
+  ]
+}
+```
+
+### Liste de vérification
+
+- [ ] `npm run build` terminé sans erreur
+- [ ] `dist/` déployé à la racine du site, en remplaçant la build précédente
+- [ ] En-têtes COOP/COEP configurés sur le serveur (recommandé, pas strictement requis pour `opfs-sahpool`)
+- [ ] L'application se charge et OPFS s'initialise correctement
diff --git a/website/content/developers/technical.en.md b/website/content/developers/technical.en.md
new file mode 100644
index 0000000..9e7ec15
--- /dev/null
+++ b/website/content/developers/technical.en.md
@@ -0,0 +1,1122 @@
+---
+title: 'Reference'
+description: 'Architecture, database schema, features, routing, i18n, versioning, and build commands — the full technical reference.'
+weight: 3
+date: 2026-06-16
+---
+
+> This page describes every part of TrainUs in detail: tech stack, schema, routes, composables. For a guided first run, see [Getting Started]({{< relref "getting-started.en.md" >}}); for concrete tasks, see [How-to Guides]({{< relref "how-to-guides.en.md" >}}); for the "why" behind the choices, see [Understanding the Architecture]({{< relref "understanding-the-architecture.en.md" >}}).
+
+> **AI authorship.** The vast majority of the source code in this project was written by AI assistants (primarily Claude). The human author directed the architecture, reviewed every change, guided the implementation, and made all design and product decisions — but in terms of who typed the lines, that credit belongs mostly to the AI. This is stated here for transparency, not as a caveat: the code was reviewed and validated at every step.
+
+## 1. Architecture
+
+TrainUs is a **Progressive Web Application (PWA)** that runs entirely in the browser — there is no backend server, and all data is stored locally via SQLite WASM with OPFS (Origin Private File System) persistence. The app works offline after the first load and can be installed on the home screen. See [Understanding the Architecture]({{< relref "understanding-the-architecture.en.md" >}}) for why it's built this way.
+
+### Tech Stack
+
+| Layer        | Technology                 |
+| ------------ | -------------------------- |
+| UI Framework | Vue 3 (Composition API)    |
+| Build Tool   | Vite                       |
+| Routing      | Vue Router (hash mode)     |
+| i18n         | i18next + i18next-vue      |
+| Database     | SQLite WASM + OPFS         |
+| Charts       | Chart.js 4 + vue-chartjs 5 |
+| Icons        | Bootstrap Icons            |
+| Markdown     | marked + DOMPurify         |
+| PWA          | vite-plugin-pwa + Workbox  |
+| Formatting   | Prettier                   |
+| Testing      | Playwright (Python)        |
+| License      | GNU AGPL v3                |
+
+### Project Structure
+
+```
+trainUs/
+├── index.html                      # Entry point
+├── package.json                    # Dependencies & npm scripts
+├── vite.config.js                  # Vite + PWA + CORS configuration
+├── public/
+│   ├── manifest.json               # PWA manifest (hand-authored)
+│   ├── icon-192.png                # PWA icon 192×192
+│   ├── icon-512.png                # PWA icon 512×512
+│   └── sqlite3-opfs-async-proxy.js # OPFS async proxy for SQLite worker
+├── src/
+│   ├── main.js                     # App bootstrap (DB init, settings restore)
+│   ├── App.vue                     # Root component (shell layout, nav)
+│   ├── router/
+│   │   └── index.js                # Vue Router — all 21 routes
+│   ├── views/                      # Page-level components (one per route)
+│   ├── components/                 # Reusable UI components
+│   ├── composables/                # Vue composables (reactive data & logic)
+│   ├── db/
+│   │   ├── database.js             # DB manager (worker bridge)
+│   │   ├── worker.js               # Web Worker (SQLite WASM + OPFS)
+│   │   ├── schema.js                # DDL + SCHEMA_VERSION + MIGRATIONS
+│   │   ├── releases.js              # Release registry for restore compatibility
+│   │   └── repositories/            # Per-entity data access layer
+│   ├── i18n/
+│   │   ├── index.js                # i18next initialization
+│   │   └── locales/
+│   │       ├── en.json             # English translations
+│   │       └── fr.json             # French translations
+│   ├── styles/
+│   │   ├── variables.css           # CSS custom properties (light/dark themes)
+│   │   └── layout.css              # Global layout, nav, action bar
+│   └── utils/                      # Pure helper functions (validation, dateFormatter, markdown, …)
+├── docs/                           # All documentation
+└── tests/                          # Playwright Python test suite
+```
+
+### Main Thread / Worker Architecture
+
+SQLite runs in a **Web Worker** to access OPFS APIs, which are unavailable on the main thread.
+
+```
+Main Thread                           Worker Thread
+┌──────────────────────┐              ┌──────────────────┐
+│ database.js          │──postMsg()──▶│ worker.js        │
+│  exec / run /        │◀──postMsg()──│ sqlite3 WASM     │
+│  selectAll /         │              │ OPFS storage     │
+│  exportDatabase /    │              └──────────────────┘
+│  importDatabase      │
+├──────────────────────┤
+│ repositories/        │  Pure async CRUD per entity
+├──────────────────────┤
+│ composables/         │  Reactive ref wrappers for Vue
+└──────────────────────┘
+```
+
+Communication is fully Promise-based: `database.js` wraps every `postMessage()` in a Promise resolved by a matching reply ID.
+
+### COOP / COEP Headers
+
+```
+Cross-Origin-Opener-Policy: same-origin
+Cross-Origin-Embedder-Policy: require-corp
+```
+
+See [How-to Guides → Deploy TrainUs]({{< relref "how-to-guides.en.md" >}}#deploy-trainus) for server configuration snippets, and [Understanding the Architecture]({{< relref "understanding-the-architecture.en.md" >}}) for why the VFS used here doesn't strictly require them.
+
+### Responsive Design
+
+| Breakpoint | Layout                                   |
+| ---------- | ---------------------------------------- |
+| > 700 px   | Fixed sidebar navigation (labeled links) |
+| ≤ 700 px   | Bottom navigation bar (icons + labels)   |
+| ≤ 400 px   | Icon-only bottom navigation              |
+
+### Theming
+
+Light and dark themes are implemented via CSS custom properties on `:root` / `[data-theme="dark"]`. The theme is persisted in the `settings` table and applied before the first render (no flash).
+
+---
+
+## 2. Database Layer
+
+### VFS: OPFS SyncAccessHandle Pool
+
+The app uses the `opfs-sahpool` VFS:
+
+- Synchronous I/O through `FileSystemSyncAccessHandle`
+- Works on all major browsers since March 2023 (Firefox 111+, Chrome 102+, Safari 16.4+)
+- Does not require COOP/COEP headers (though we have them)
+- Single-connection only (fine for a single-user PWA)
+
+If OPFS is unavailable (private browsing mode, outdated browser), the app displays a full-screen error. There is no in-memory fallback. See [Understanding the Architecture]({{< relref "understanding-the-architecture.en.md" >}}) for why this VFS was chosen and why there's no fallback.
+
+### Schema
+
+12 tables, all defined with `CREATE TABLE IF NOT EXISTS` (idempotent). The current `SCHEMA_VERSION` is **1**.
+
+| Table                | Purpose                                                |
+| -------------------- | ------------------------------------------------------ |
+| `schema_version`     | Migration tracking (`version` + `applied_at`)          |
+| `settings`           | Key-value configuration (user_uuid, name, theme, …)    |
+| `exercise`           | Exercise definitions (title UNIQUE)                    |
+| `combo`              | Combo definitions (title UNIQUE)                       |
+| `combo_exercise`     | Combo ↔ exercise junction (position, reps, weight)     |
+| `session`            | Session definitions (title UNIQUE)                     |
+| `session_item`       | Session ↔ item junction (type, position, reps, weight) |
+| `collection`         | Collections (label UNIQUE)                             |
+| `collection_session` | Collection ↔ session junction (position)               |
+| `execution_log`      | Execution records (started_at, finished_at)            |
+| `execution_log_item` | Per-exercise execution results (reps, weight, side, …) |
+| `suffix`             | External user registry for import disambiguation       |
+
+#### Entity-Relationship Diagram
+
+```mermaid
+erDiagram
+    SETTINGS {
+        text key PK
+        text value
+    }
+    EXERCISE {
+        text id PK
+        text title UK
+        text description
+        boolean asymmetric
+        boolean alternate
+        text image_urls
+        text video_urls
+        integer default_reps
+        real default_weight
+        text created_by
+    }
+    COMBO {
+        text id PK
+        text title UK
+        text description
+        text type
+        text timer_config
+        text created_by
+    }
+    COMBO_EXERCISE {
+        text combo_id FK
+        text exercise_id FK
+        integer position
+        integer default_reps
+        real default_weight
+    }
+    SESSION {
+        text id PK
+        text title UK
+        text description
+        text created_by
+    }
+    SESSION_ITEM {
+        text session_id FK
+        text item_id
+        text item_type
+        integer position
+        integer repetitions
+        real weight
+    }
+    COLLECTION {
+        text id PK
+        text label UK
+        text created_by
+    }
+    COLLECTION_SESSION {
+        text collection_id FK
+        text session_id FK
+        integer position
+    }
+    EXECUTION_LOG {
+        text id PK
+        text session_id FK
+        datetime started_at
+        datetime finished_at
+    }
+    EXECUTION_LOG_ITEM {
+        text id PK
+        text log_id FK
+        text exercise_id FK
+        text combo_id
+        integer round_number
+        integer reps_done
+        real weight_used
+        text side
+        boolean completed
+        datetime timestamp
+    }
+    SUFFIX {
+        text user_uuid PK
+        text user_name
+        text suffix UK
+    }
+
+    COMBO ||--|{ COMBO_EXERCISE : contains
+    EXERCISE ||--o{ COMBO_EXERCISE : "used in"
+    SESSION ||--|{ SESSION_ITEM : contains
+    COLLECTION ||--|{ COLLECTION_SESSION : contains
+    SESSION ||--o{ COLLECTION_SESSION : "used in"
+    SESSION ||--o{ EXECUTION_LOG : "executed as"
+    EXECUTION_LOG ||--|{ EXECUTION_LOG_ITEM : records
+    EXERCISE ||--o{ EXECUTION_LOG_ITEM : tracks
+```
+
+**Notable column details:**
+
+- `session_item.item_type`: `"exercise"` or `"combo"` — used to JOIN with the correct table for titles
+- `execution_log_item.combo_id` / `round_number`: NULL for standalone exercises; populated for exercises executed inside a combo (no FK constraint — combo may be deleted after execution)
+- `settings` keys: `user_uuid`, `user_name`, `app_version`, `language`, `theme`, `db_created_at`, `last_backup_at`, `backup_reminder_days`
+
+#### UNIQUE Constraints
+
+Title/label uniqueness is enforced at the DB level on `exercise.title`, `combo.title`, `session.title`, `collection.label`. Violations surface as `UNIQUE constraint failed` errors handled by the repositories.
+
+#### Suffix Table
+
+Stores the mapping between external user UUIDs and their assigned suffix tags. Used during import to disambiguate titles from other users (see §3.9).
+
+### Migration System
+
+At startup, `database.js` sends a `getSchemaStatus` message to the worker, which detects the DB state without modifying existing data:
+
+- **Fresh DB** (no `schema_version` rows): run `SCHEMA_SQL` and stamp `SCHEMA_VERSION`.
+- **Up to date** (`dbVersion === SCHEMA_VERSION`): continue normally.
+- **Newer than app** (`dbVersion > SCHEMA_VERSION`): blocking error (`DB_NEWER_THAN_APP`), data untouched.
+- **Older than app** (`dbVersion < SCHEMA_VERSION`): the app pauses on a blocking migration screen. The user must download a backup first; only then is the **Update** button enabled, which sends `runMigrations` to the worker.
+
+`runMigrations` applies the pending migration scripts from `getMigrationScripts(dbVersion, SCHEMA_VERSION)` in `src/db/releases.js`. Each release's script runs inside a transaction together with its `INSERT INTO schema_version (version) VALUES (N)`; on error the transaction is rolled back, the DB stays at the previous version, and a blocking `DB_MIGRATION_FAILED` error is shown (the user holds the backup downloaded just before).
+
+```mermaid
+flowchart TD
+    A[App start: db.init] --> B[Worker: open OPFS pool dir .trainus, open trainus.db]
+    B --> C{schema_version table\nexists with rows?}
+    C -- no: fresh DB --> D[Run SCHEMA_SQL\nINSERT schema_version = SCHEMA_VERSION]
+    C -- yes --> E{dbVersion vs SCHEMA_VERSION}
+    E -- equal --> F[Up to date — continue]
+    E -- "dbVersion > app" --> G[Blocking error overlay\nDB untouched]
+    E -- "dbVersion < app" --> H[Blocking migration screen\nDB untouched, app paused]
+    H --> H2[User clicks Download backup\nexportDatabase + formatBackupFilename\nupdate last_backup_at]
+    H2 --> H3[Update button enabled\nuser clicks Update]
+    H3 --> I[For each release N in dbVersion+1..SCHEMA_VERSION:\nBEGIN; migrationScript; INSERT schema_version N; COMMIT]
+    I -- error --> J[ROLLBACK\nBlocking error overlay\nDB still at previous version + user has backup]
+    I -- ok --> F
+    D --> K[_initDefaults: settings rows]
+    F --> K
+    K --> L[App ready]
+```
+
+In-place schema changes (adding columns directly in `SCHEMA_SQL`) are acceptable before any release to users. A `SCHEMA_VERSION` bump is reserved for schema changes made after a version has been deployed — at that point the release ships a `migrationScript` in `RELEASES` (see §6). See [How-to Guides → Add a Database Migration]({{< relref "how-to-guides.en.md" >}}#add-a-database-migration) for the step-by-step recipe.
+
+### Repository Pattern
+
+Each entity has a dedicated repository in `src/db/repositories/` providing standard methods: `create`, `getById`, `getAll`, `update`, `delete`, `search`. Junction table management is included in the parent repository (e.g., `setExercises()` in `comboRepository`).
+
+Repositories use only `database.exec()`, `database.run()`, and `database.selectAll()` — no SQLite-specific constructs outside this layer.
+
+### Vue Composables
+
+Reactive wrappers in `src/composables/` expose `ref`-based state (`items`, `loading`, `error`) and async methods for use in Vue components. Components never import repositories directly; they use composables.
+
+| Composable            | Wraps                                        |
+| --------------------- | -------------------------------------------- |
+| `useExercises`        | `exerciseRepository`                         |
+| `useCombos`           | `comboRepository`                            |
+| `useSessions`         | `sessionRepository`                          |
+| `useCollections`      | `collectionRepository`                       |
+| `useExecutionLogs`    | `executionLogRepository`                     |
+| `useSettings`         | `settingsRepository`                         |
+| `useStats`            | Multiple repositories (read-only aggregates) |
+| `useSessionExecution` | `executionLogRepository` + queue logic       |
+| `useJsonExport`       | All repositories + `jsonEnvelope.js`         |
+| `useJsonImport`       | All repositories + `suffixRepository`        |
+| `useBackupStatus`     | `settingsRepository`                         |
+| `useInstallPrompt`    | `beforeinstallprompt` event (browser API)    |
+| `useHtmlExport`       | Pure data rendering — no repository calls    |
+
+---
+
+## 3. Features
+
+### 3.1 Settings
+
+**View:** `src/views/SettingsView.vue` — `#/settings`
+
+**Startup restoration:** On app startup (`src/main.js`), after DB initialization and before the first render, `language` and `theme` are read from `settings` and applied. This prevents any flash of default values.
+
+#### Available settings
+
+| Setting                  | Control                                    | Persistence key                 |
+| ------------------------ | ------------------------------------------ | ------------------------------- |
+| Language                 | `<select>` (English / Français / Dansk)    | `settings.language`             |
+| User Name                | Text input (required, non-empty)           | `settings.user_name`            |
+| User ID                  | Read-only UUID display                     | `settings.user_uuid`            |
+| Theme                    | `<select>` (Light / Dark)                  | `settings.theme`                |
+| Sound Volume             | Slider (0–100%) + Test button              | `settings.audio_volume`         |
+| Download DB              | Button → downloads `.sqlite3`              | —                               |
+| Restore DB               | File picker → validation pipeline          | —                               |
+| Initialize DB            | Button + mandatory checkbox                | —                               |
+| Backup reminder interval | Number input (1–365, default 7)            | `settings.backup_reminder_days` |
+| Export Data              | Button → entity filter dialog              | —                               |
+| Import Data              | Button → file picker                       | —                               |
+| Suffix management        | List of registered suffixes                | `suffix` table                  |
+| Credits                  | Button → modal (icon/library attributions) | —                               |
+| About                    | Button → modal (version, author)           | —                               |
+
+Sound Volume is detailed in [§ 3.7 Audio Cues](#audio-cues).
+
+#### Download Database
+
+Calls `sqlite3_js_db_export()` in the worker. The raw SQLite file is downloaded as `trainus-{version}-backup-YYYYMMDD-HHhMMmSSs.sqlite3` and `last_backup_at` is set on success.
+
+#### Restore Database
+
+Multi-step pipeline executed in the worker:
+
+```mermaid
+flowchart TD
+    A[User clicks Restore] --> B[File picker]
+    B --> C[Confirm dialog]
+    C -->|Cancel| Z[Abort]
+    C -->|OK| D[Show spinner]
+    D --> E[Deserialize into :memory: DB]
+    E -->|Invalid file| F[Error: INVALID_FILE]
+    E -->|Valid| G[Check required tables]
+    G -->|Missing| H[Error: INCOMPLETE_DB]
+    G -->|Present| I[Read schema versions]
+    I --> J[Check compatibility]
+    J -->|Incompatible| K[Error: INCOMPATIBLE_VERSION]
+    J -->|Compatible| L{Needs adaptation?}
+    L -->|Yes| M[Run adapt scripts]
+    M -->|Failed| N[Error: ADAPT_FAILED]
+    M -->|OK| O[Table-by-table copy in transaction]
+    L -->|No| O
+    O -->|Failed| P[Error: RESTORE_FAILED]
+    O -->|OK| Q[Success report card]
+```
+
+The table-by-table copy only transfers columns present in both schemas. The entire operation runs in a transaction; on failure it rolls back. After success, settings (language, theme) are re-applied in-place without a page reload.
+
+Version compatibility is managed by `src/db/releases.js`: a `RELEASES` array where each entry declares `schemaVersion`, `appVersion`, `dbBreak`, and optional `migrationScript`. `checkCompatibility()` walks this history to determine if a migration path exists. The same `migrationScript` artifacts drive both restore adaptation and the startup migration (§ Migration System).
+
+#### Initialize Database
+
+Deletes all data from all tables in FK-safe order (children first), then calls `_initDefaults()` to regenerate `user_uuid`, `user_name`, `app_version`, `db_created_at`. The page reloads to reflect the fresh state. A mandatory confirmation checkbox prevents accidental use.
+
+**Key files:**
+`src/views/SettingsView.vue`, `src/db/database.js`, `src/db/worker.js`, `src/db/releases.js`, `src/db/repositories/settingsRepository.js`
+
+#### Credits Dialog
+
+A modal opened from the **Credits** card on the Settings page, attributing third-party assets and libraries:
+
+| Item                    | License   | Source                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
+| ----------------------- | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| App icon (Mighty Force) | CC BY 3.0 | [game-icons.net](https://game-icons.net), by Delapouite                                                                                                                                                                                                                                                                                                                                                                                                                                |
+| Bootstrap Icons         | MIT       | [icons.getbootstrap.com](https://icons.getbootstrap.com)                                                                                                                                                                                                                                                                                                                                                                                                                               |
+| Third-party libraries   | —         | [Vue](https://vuejs.org), [Vue Router](https://router.vuejs.org), [Vite](https://vitejs.dev), [SQLite WASM](https://sqlite.org/wasm/), [Chart.js](https://www.chartjs.org), [vue-chartjs](https://vue-chartjs.org), [i18next](https://www.i18next.com), [i18next-vue](https://i18next.github.io/i18next-vue/), [Prettier](https://prettier.io), [vite-plugin-pwa](https://vite-pwa-org.netlify.app), [marked](https://marked.js.org), [DOMPurify](https://github.com/cure53/DOMPurify) |
+| Testing Tools           | —         | [Playwright](https://playwright.dev/python/), [pytest](https://pytest.org)                                                                                                                                                                                                                                                                                                                                                                                                             |
+
+The icon and library names/links are hardcoded in the component; attribution text comes from the `credits.*` i18n namespace.
+
+**Component:** `src/components/CreditsDialog.vue`
+
+#### About Dialog
+
+A modal opened from the **About TrainUs** card at the bottom of the Settings page. It displays:
+
+| Field               | Source                                                |
+| ------------------- | ----------------------------------------------------- |
+| Application Version | `__APP_VERSION__` (Vite global from `package.json`)   |
+| Database Version    | `SCHEMA_VERSION` (from `src/db/schema.js`)            |
+| Created by          | Static string: David Florance                         |
+| Repository          | Placeholder link (`href="#"`)                         |
+| Website             | Placeholder link (`href="#"`)                         |
+| View License        | Disabled button with "License to be determined." note |
+
+**Component:** `src/components/AboutDialog.vue`
+
+i18n keys are under the `about.*` namespace in all locale files.
+
+---
+
+### 3.2 Exercise Management
+
+**Views:** `ExerciseListView`, `ExerciseFormView`, `ExerciseDetailView`
+
+**Routes:** `#/exercises`, `#/exercises/new`, `#/exercises/:id`, `#/exercises/:id/edit`
+
+#### Form fields
+
+| Field          | Validation                                                                 |
+| -------------- | -------------------------------------------------------------------------- |
+| Title          | Required, UNIQUE (DB-level)                                                |
+| Description    | Optional; rendered as Markdown in the detail view (`marked` + `DOMPurify`) |
+| Asymmetric     | Boolean; reveals Alternate sub-option                                      |
+| Alternate      | Radio: alternate per rep vs per set                                        |
+| Default Reps   | ≥ 0                                                                        |
+| Default Weight | ≥ 0                                                                        |
+| Image URLs     | Each must be valid HTTP(S) URL                                             |
+| Video URLs     | Each must be valid HTTP(S) URL                                             |
+
+`ExerciseFormView` is shared for create and edit modes, distinguished by `route.name` (`exercise-new` vs `exercise-edit`).
+
+#### Action bar (Teleport pattern)
+
+Views inject buttons into the shared action bar using `<Teleport to="#actionbar-actions" defer>`. The `defer` attribute (Vue 3.5+) resolves the target in the next render cycle, avoiding a race condition with the `v-else`-gated shell.
+
+#### Validation utility
+
+`src/utils/validation.js` provides reusable validators returning i18n keys:
+
+- `validateRequired(value)` → `'validation.required'`
+- `validateMin(value, min)` → `'validation.minValue'`
+- `validateUrl(value)` → `'validation.invalidUrl'`
+
+#### Search
+
+Toggleable search bar with 250ms debounce → `exerciseRepository.search()` (SQL `LIKE %query%`). A clear (×) button is shown inside the input whenever it has a value; it empties the field and refocuses it. Clearing the input (via the button, manually, or toggling search off) calls `fetchAll()`. The same pattern (search bar, debounce, clear button) is duplicated across `ExerciseListView`, `ComboListView`, `SessionListView`, and `CollectionsView` rather than factored into a shared composable.
+
+#### Media embedding
+
+- **Images**: Displayed in a responsive grid with lazy loading. `@error` handler hides broken images.
+- **YouTube**: Video IDs extracted from `youtube.com/watch?v=` and `youtu.be/` formats, embedded via `youtube-nocookie.com`.
+- **Other URLs**: Rendered as clickable links.
+
+**Key files:** `src/views/ExerciseListView.vue`, `src/views/ExerciseFormView.vue`, `src/views/ExerciseDetailView.vue`, `src/utils/validation.js`, `src/utils/markdown.js`, `src/utils/youtube.js`
+
+---
+
+### 3.3 Combo Management
+
+**Views:** `ComboListView`, `CombosView`, `ComboFormView`, `ComboDetailView`
+
+**Routes:** `#/combos`, `#/combos/new`, `#/combos/:id`, `#/combos/:id/edit`
+
+A combo is an ordered group of exercises with an optional timed format (EMOM, AMRAP, TABATA, or NONE for plain supersets).
+
+#### Form fields
+
+| Field        | Notes                                                            |
+| ------------ | ---------------------------------------------------------------- |
+| Title        | Required, UNIQUE                                                 |
+| Description  | Optional; rendered as Markdown in the detail view                |
+| Type         | NONE / EMOM / AMRAP / TABATA                                     |
+| Timer config | Duration (min) for EMOM/AMRAP; rounds for TABATA; stored as JSON |
+| Exercises    | Ordered list with per-exercise reps (≥ 1) and weight (≥ 0)       |
+
+Each exercise in the combo has its own `default_reps` and `default_weight` stored in the `combo_exercise` junction table. These override the exercise's own defaults when the combo is used in a session.
+
+#### Exercise ordering
+
+Move up / move down buttons adjust position. `comboRepository.setExercises()` replaces the entire junction table for a combo in one operation (delete + re-insert).
+
+#### `getExercises()` return shape
+
+```js
+{
+  ;(exerciseId, exerciseTitle, position, defaultReps, defaultWeight, asymmetric, alternate)
+}
+```
+
+`asymmetric` and `alternate` are included so execution mode can determine side handling without an extra query.
+
+**Key files:** `src/views/ComboListView.vue`, `src/views/ComboFormView.vue`, `src/views/ComboDetailView.vue`, `src/db/repositories/comboRepository.js`
+
+---
+
+### 3.4 Session Management
+
+**Views:** `SessionListView`, `SessionsView`, `SessionFormView`, `SessionDetailView`, `SessionExecuteView`
+
+**Routes:** `#/sessions`, `#/sessions/new`, `#/sessions/:id`, `#/sessions/:id/edit`, `#/sessions/:id/execute`
+
+A session is an ordered list of items — each item is either an **exercise** or a **combo**, with per-item repetitions and weight.
+
+#### Session items
+
+`session_item` uses a polymorphic `item_id` + `item_type` pair:
+
+```sql
+item_type IN ('exercise', 'combo')
+```
+
+`sessionRepository.getItems()` executes two separate queries (one joining with `exercise`, one joining with `combo`) and merges results sorted by `position`. SQLite doesn't support conditional JOINs across different tables in a single query.
+
+#### Form fields
+
+| Field       | Notes                                                          |
+| ----------- | -------------------------------------------------------------- |
+| Title       | Required, UNIQUE                                               |
+| Description | Optional; rendered as Markdown in the detail view              |
+| Items       | Ordered list; each item has repetitions (≥ 1) and weight (≥ 0) |
+
+The item type selector (exercise vs combo) controls which dropdown is populated. Items can be moved up/down and removed.
+
+#### Repetitions semantics
+
+For a session item that is a combo, `repetitions` = number of full passes through the combo's exercise list (not individual exercise repetitions).
+
+**Key files:** `src/views/SessionListView.vue`, `src/views/SessionFormView.vue`, `src/views/SessionDetailView.vue`, `src/db/repositories/sessionRepository.js`
+
+---
+
+### 3.5 Collection Management
+
+**Views:** `CollectionsView`, `CollectionFormView`, `CollectionDetailView`
+
+**Routes:** `#/collections`, `#/collections/new`, `#/collections/:id`, `#/collections/:id/edit`
+
+A collection is an ordered group of sessions — useful for organizing weekly plans or training phases.
+
+#### Form fields
+
+| Field    | Notes                                              |
+| -------- | -------------------------------------------------- |
+| Label    | Required, UNIQUE                                   |
+| Sessions | Ordered list; each session can appear at most once |
+
+`collectionRepository.getAll()` includes a `sessionCount` field via a COUNT query on `collection_session` — avoiding loading full session data for the list view.
+
+**Key files:** `src/views/CollectionsView.vue`, `src/views/CollectionFormView.vue`, `src/views/CollectionDetailView.vue`, `src/db/repositories/collectionRepository.js`
+
+---
+
+### 3.6 Home Page
+
+**View:** `HomeView` — `#/home`
+
+Landing page with a quick overview of recent training activity.
+
+| Widget                    | Data source                                                                     |
+| ------------------------- | ------------------------------------------------------------------------------- |
+| Sessions last 7 days      | `executionLogRepository.getCountSince(isoDate)`                                 |
+| Sessions last 30 days     | `executionLogRepository.getCountSince(isoDate)`                                 |
+| 4 most recent sessions    | `executionLogRepository.getRecentWithItems(4)` (JOIN with `session` and items)  |
+| History by day (filtered) | `executionLogRepository.getAllWithItems()` — filtered client-side by date range |
+
+#### Recent sessions
+
+The 4 most recently executed sessions are shown as cards. Each card displays the session title, execution date (locale-formatted via `dateFormatter.js`), total duration (when `finished_at` is set), a **play button (▶)** to re-execute, and a compact inline summary of every exercise/combo performed with actual reps, weight, and per-item duration.
+
+The inline summary groups items using `groupItems()` / `enrichItemsWithTiming()` / `comboRounds()` helpers defined in `HomeView`. Item timing is derived from consecutive `execution_log_item.timestamp` deltas relative to `execution_log.started_at`.
+
+#### History section
+
+All execution logs are loaded once at mount via `getAllWithItems()` and then filtered client-side by the active date range (default: last 30 days). The result is grouped by calendar day (descending) using a Vue `computed`. Each day group has a heading and one compact card per session, also with duration, play button, and inline item summary.
+
+Two `<input type="date">` pickers (from / to) let the user adjust the range interactively without a network round-trip.
+
+#### HTML export
+
+An action bar button (`bi-filetype-html`) renders only when at least one execution log exists. Clicking it calls `useHtmlExport.exportHomeAsHtml()`, which:
+
+1. Fetches `/icon.svg` and encodes it as a base64 `data:` URI (`TextEncoder` + `btoa`).
+2. Builds a fully self-contained HTML document from the current reactive state — stats cards, recent sessions, and history filtered by the active date range.
+3. Strips play buttons, navigation links, and date pickers from the output (read-only export).
+4. Downloads as `trainus-home-YYYY-MM-DD.html`.
+
+**Key files:** `src/views/HomeView.vue`, `src/composables/useHtmlExport.js`, `src/db/repositories/executionLogRepository.js`, `src/utils/dateFormatter.js`
+
+---
+
+### 3.7 Execution Mode
+
+**View:** `SessionExecuteView` — `#/sessions/:id/execute`
+
+**Composable:** `useSessionExecution`
+
+Execution Mode steps through a session one exercise at a time, logging actual reps, weight, and side.
+
+#### Execution Queue Model
+
+At execution start, `useSessionExecution` builds a **flat linear queue** of step objects from the session items:
+
+- An **exercise** item → 1 step
+- A **combo** item → `totalRounds × M` steps, where `totalRounds` depends on combo type:
+
+| Combo type  | `repetitions` meaning | `totalRounds` formula                                 |
+| ----------- | --------------------- | ----------------------------------------------------- |
+| NONE/TABATA | Number of full rounds | `repetitions`                                         |
+| EMOM        | Total duration (min)  | `floor(repetitions / M)` — each exercise = 1 min slot |
+| AMRAP       | Total duration (min)  | `1` — only one pass is queued; user repeats freely    |
+
+```
+Session items:
+  1. Exercise A  ×3 reps                     → 1 step
+  2. Combo "HIIT" ×2 rounds (2 exercises)    → 4 steps (NONE/TABATA)
+       Round 1: Push-up ×10, Squat ×15
+       Round 2: Push-up ×10, Squat ×15
+  3. Exercise B  ×5 reps                     → 1 step
+
+Queue (flat):
+  [0] Exercise A
+  [1] Push-up — HIIT, Round 1/2
+  [2] Squat   — HIIT, Round 1/2
+      ↓ auto-advance (not last round)
+  [3] Push-up — HIIT, Round 2/2
+  [4] Squat   — HIIT, Round 2/2
+      ↓ final-round screen: [Continue →] [+ One More Round]
+  [5] Exercise B
+```
+
+For an **EMOM** combo with 2 exercises and `repetitions = 6` (= 6-minute duration): `totalRounds = floor(6/2) = 3`, producing 6 steps of 1 minute each.
+
+Each step carries: `exerciseId`, `exerciseTitle`, `prefillReps`, `prefillWeight`, `prefillSide`, `comboId?`, `comboTitle?`, `roundNumber?`, `totalRounds?`, `asymmetric`, `alternate`, `isFinalComboStep`, `comboExercises`.
+
+#### `isFinalComboStep` flag
+
+Set to `true` only on the last exercise of the last round of a combo. When the user presses **Done** on that step, the composable shows the final-round screen instead of auto-advancing.
+
+#### Prefill logic
+
+On init, `executionLogRepository.getLastItemsBySession(sessionId)` fetches the most recent `execution_log` for the session and returns a map `exerciseId → {reps_done, weight_used, side}`. Steps use this map for prefill, falling back to session item defaults when no prior log exists.
+
+#### `+ One More Round`
+
+When the user presses **+ One More Round**, the composable:
+
+1. Looks up the completed steps for the current final round (actual reps/weight used)
+2. Inserts a new batch of steps at `currentIndex + 1` in the queue
+3. Marks `isFinalComboStep = true` on the last new step
+4. Advances `currentIndex` to the first new step
+
+#### Asymmetric exercise side handling
+
+If `asymmetric = true` and `alternate = true`, the side flips after each step of the same exercise. If `alternate = false`, it flips after each full set. The final side value is logged in `execution_log_item.side`.
+
+#### Partial log on exit
+
+Pressing **✕** (exit) saves all **completed** steps to `execution_log` and omits unfinished steps. The log is marked with `finished_at = null` to indicate a partial run. Completed items are still included in statistics.
+
+#### Exercise Detail Toggle
+
+The exercise title in the current step card is a toggle button. Clicking it:
+
+1. Expands an inline detail panel (description rendered as Markdown, images, video links).
+2. **Pauses the active timer** — but only if it was running at click time (`detailPausedTimer` flag tracks this).
+
+Collapsing the panel resumes the timer only when `detailPausedTimer` is true, leaving manually-paused timers untouched.
+
+The detail panel is loaded lazily on first expand via `exerciseRepository.getById(step.exerciseId)`. Subsequent toggles within the same step reuse the cached `detailExercise` ref. A `watch(currentStep, …)` resets `showDetail`, `detailExercise`, and `detailPausedTimer` whenever the step advances.
+
+For online state detection (to conditionally show video links), `SessionExecuteView` uses `useOnlineStatus()`. YouTube ID extraction uses the shared `src/utils/youtube.js` utility (same function used in `ExerciseDetailView`).
+
+#### UI Layout
+
+```
+┌─────────────────────────────────────────┐
+│  Session Title                [✕ exit]  │
+│  ████████████░░░░░  3 / 6 steps         │
+├─────────────────────────────────────────┤
+│  ▶ NOW                                  │
+│  ┌───────────────────────────────────┐  │
+│  │  Push-up ˅                        │  │  ← title is a toggle button
+│  │  ┌─────────────────────────────┐  │  │  ← detail panel (when expanded)
+│  │  │  Keep your body straight…   │  │  │
+│  │  │  [image] [image]            │  │  │
+│  │  └─────────────────────────────┘  │  │
+│  │  Combo: HIIT — Round 2 of 2       │  │
+│  │  Reps:   [ 10 ]                   │  │
+│  │  Weight: [  0 ] kg                │  │
+│  │  Side:   RIGHT ↔                  │  │  ← asymmetric only
+│  │          [ ✓ Done ]               │  │
+│  └───────────────────────────────────┘  │
+│  ↓ NEXT                                 │
+│  Squat — 15 reps  (HIIT, Round 2)       │
+└─────────────────────────────────────────┘
+```
+
+#### Audio Cues
+
+`src/composables/useAudioCues.js` provides two functions built on the Web Audio API:
+
+| Function          | Frequency | Duration | Role                                |
+| ----------------- | --------- | -------- | ----------------------------------- |
+| `playBip(volume)` | 440 Hz    | 0.1 s    | Soft tick — countdown, midpoint     |
+| `playBIP(volume)` | 880 Hz    | 0.3 s    | Loud signal — phase change, time-up |
+
+`AudioContext` is created lazily on first use (singleton). Volume is loaded from `settings.audio_volume` (0–100) and converted to a 0.0–1.0 multiplier.
+
+Sound logic lives in `useSessionExecution` as three private helpers:
+
+- **`_emomSounds(remaining)`** — fires `playBip` at r = 30, 2, 1 (EMOM only).
+- **`_amrapLastMinuteSounds(remaining)`** — fires `playBip` at r = 30, 2, 1 (last minute of AMRAP).
+- **`_tabataCountdown(remaining, totalTime)`** — fires `playBip` at `floor(totalTime / 2)`, r = 2, and r = 1.
+
+AMRAP timer logic in `_maybeStartAmrapTimer`:
+
+```
+r > 60:
+  elapsed minute changes → playBip        (per-minute tick)
+  r === round(duration / 2) → playBIP     (half-time signal; takes priority over minute tick)
+r ≤ 60:
+  _amrapLastMinuteSounds(r)
+r = 0 (expire):
+  playBIP                                 (time-up signal)
+```
+
+The **bip, bip, BIP** sequence (r = 2, r = 1, r = 0/expire) is evenly spaced at 1-second intervals because `onTick` fires at r = 2 and r = 1, and `onExpire` fires at r = 0 — each exactly one timer tick apart.
+
+**Key files:** `src/views/SessionExecuteView.vue`, `src/composables/useSessionExecution.js`, `src/composables/useAudioCues.js`, `src/db/repositories/executionLogRepository.js`, `src/utils/youtube.js`
+
+---
+
+### 3.8 Statistics
+
+**View:** `StatsView` — `#/stats`
+
+**Composable:** `useStats`
+
+**Libraries:** Chart.js 4 + vue-chartjs 5, registered locally in `StatsView.vue` (not globally, to avoid side effects on other routes).
+
+#### Date range filter
+
+Four tabs control which period is shown: **7d**, **30d** (default), **3m**, **All**.
+
+#### Summary cards
+
+| Card           | Query                                                                                     |
+| -------------- | ----------------------------------------------------------------------------------------- |
+| Sessions       | Count of `execution_log` rows in the period                                               |
+| Exercises done | Count of `execution_log_item` (completed) rows in the period                              |
+| Day streak     | Consecutive calendar days (ending today) with at least one log; always across all history |
+
+Streak uses `setUTCHours(0,0,0,0)` for date comparison to match SQLite's `DATE(started_at)` UTC extraction.
+
+#### Charts
+
+| Chart       | Type | Metric                                                                       |
+| ----------- | ---- | ---------------------------------------------------------------------------- |
+| Frequency   | Bar  | Sessions per week or per month (toggle)                                      |
+| Volume      | Bar  | `SUM(reps_done × weight_used)` per session execution                         |
+| Progression | Line | Reps (left axis) + max weight (right axis) over time for a selected exercise |
+
+Volume only counts weighted exercises (weight > 0). The Progression chart only lists exercises with at least one execution log entry.
+
+#### Database creation date
+
+Displayed at the top as "You are using TrainUs since [date]", read from `settings.db_created_at`. Formatted via `dateFormatter.js` and reactive to language changes.
+
+**Key files:** `src/views/StatsView.vue`, `src/composables/useStats.js`, `src/utils/dateFormatter.js`
+
+---
+
+### 3.9 Import / Export (JSON)
+
+**Composables:** `useJsonExport`, `useJsonImport`
+
+**Components:** `ImportDialog`, `ExportFilterDialog`, `ModalDialog`
+
+**Utilities:** `src/utils/jsonEnvelope.js`
+
+#### JSON envelope format
+
+```json
+{
+  "metadata": {
+    "appName": "trainus",
+    "appVersion": "1.0.0",
+    "schemaVersion": 1,
+    "exportDate": "2026-03-30T12:00:00.000Z",
+    "exportedBy": { "name": "User Name", "uuid": "uuid-string" }
+  },
+  "data": {
+    "exercises": [...],
+    "combos": [...],
+    "sessions": [...],
+    "collections": [...],
+    "executionLogs": [...],
+    "settings": [...]
+  }
+}
+```
+
+Only the keys present in `data` are exported/imported. Single-entity exports (e.g., export one exercise) include only that entity's array.
+
+#### Export entry points
+
+| Entry point                                         | Scope                                                                     |
+| --------------------------------------------------- | ------------------------------------------------------------------------- |
+| Exercise / Combo / Session / Collection list view   | All items of that entity type, or only the active search filter's matches |
+| Exercise / Combo / Session / Collection detail view | Single item                                                               |
+| Settings → Export Data                              | Any combination of entity types (filter dialog)                           |
+
+The filter dialog shows checkboxes per entity type. The full export from Settings produces `trainus-full-YYYY-MM-DD.json`.
+
+List-view exports pass the view's trimmed search query (if any) into `exportAllExercises/Combos/Sessions/Collections(query)` in `useJsonExport.js`, which use `search()`/`searchWithExercises()`/`searchWithItems()`/`searchWithSessions()` instead of `getAll()`/`getAllWithX()` when a query is present.
+
+Combo/session/collection exports (single, list, or filter-dialog) are never just the requested entity's own table row — `collectComboDependencies`/`collectSessionDependencies`/`collectCollectionDependencies` in `useJsonExport.js` walk the nested FK references (a session's items, a combo's exercises, a collection's sessions) to fetch the full dependent entities and add them as top-level `exercises`/`combos`/`sessions` arrays in the envelope. `exportByFilter` cascades this collections → sessions → combos → exercises so a partial checkbox selection still produces a file that imports standalone, without dangling references on a device that doesn't already have those dependencies.
+
+#### Import entry points
+
+| Entry point                                       | Notes                            |
+| ------------------------------------------------- | -------------------------------- |
+| Exercise / Combo / Session / Collection list view | Per-entity import via action bar |
+| Settings → Import Data                            | Multi-entity envelope supported  |
+
+All import entry points use the same generalized `analyzeAll` / `applyAllImport` flow, including single-entity exercise files (a separate legacy flow existed historically but turned out to produce an identical analysis shape, so it was removed).
+
+#### Collision strategy
+
+| Scenario                                                        | Behavior                                                                                                                                 |
+| --------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
+| Same user (`created_by` = local `user_uuid`), no ID/title match | Insert with original ID                                                                                                                  |
+| Same user, same ID exists                                       | Prompt: **Replace** / **Skip** (with batch **Replace All** / **Skip All**)                                                               |
+| Same user, different ID but same title as an existing row       | Same Replace/Skip prompt, resolved against the existing row's ID; Skip redirects same-batch references to it                             |
+| Different user, UUID unknown                                    | Prompt for suffix → register in `suffix` table                                                                                           |
+| Different user, same ID + same `created_by`                     | Update in place (no new ID)                                                                                                              |
+| Different user, same ID + different `created_by`                | Generate new UUID                                                                                                                        |
+| Different user, suffixed title collides with an existing row    | Same Replace/Skip prompt (no separate rename step) — almost always a re-import of a previously-imported item from the same external user |
+
+**Title format for external imports:** `"Original Title [SUFFIX]"`.
+
+#### Cross-entity reference remapping
+
+When an entity's ID changes during import (new UUID generated), all referencing entities are updated:
+
+- `combo_exercise.exercise_id`
+- `session_item.item_id` (for exercises and combos)
+- `collection_session.session_id`
+- `execution_log.session_id`
+- `execution_log_item.exercise_id`
+
+#### Settings import restrictions
+
+Settings are imported with exclusions to preserve local identity:
+
+| Key                                                      | Imported?             |
+| -------------------------------------------------------- | --------------------- |
+| `user_uuid`                                              | No — always preserved |
+| `app_version`                                            | No — always preserved |
+| `db_created_at`                                          | No — always preserved |
+| `last_backup_at`                                         | No — always preserved |
+| `user_name`, `language`, `theme`, `backup_reminder_days` | Yes                   |
+
+#### Execution log import
+
+Execution logs are only imported if the referenced session exists locally or was imported in the same batch.
+
+#### Import dialog flow
+
+```mermaid
+stateDiagram-v2
+    [*] --> Loading: File selected
+    Loading --> SuffixPrompt: External user detected
+    Loading --> Preview: Same user
+    SuffixPrompt --> Preview: Suffix entered
+    Preview --> Collisions: Conflicts found
+    Preview --> Applying: No conflicts
+    Collisions --> Applying: All resolved
+    Applying --> Report: Done
+    Report --> [*]: Dismissed
+```
+
+#### Suffix management
+
+The Settings page lists all registered suffixes (from the `suffix` table). Renaming a suffix cascades to all entity title/label columns via SQL `REPLACE()`:
+
+```sql
+UPDATE exercise SET title = REPLACE(title, '[OLD]', '[NEW]') WHERE title LIKE '%[OLD]%'
+```
+
+Applied across `exercise`, `combo`, `session`, and `collection` tables.
+
+**Key files:** `src/composables/useJsonExport.js`, `src/composables/useJsonImport.js`, `src/utils/jsonEnvelope.js`, `src/components/ImportDialog.vue`, `src/components/ExportFilterDialog.vue`, `src/db/repositories/suffixRepository.js`
+
+---
+
+### 3.10 Backup
+
+**Composable:** `useBackupStatus` (module-level singleton refs)
+
+**Component:** `BackupReminder` (teleported into `#actionbar-actions`)
+
+**Utility:** `src/utils/backupFilename.js`
+
+#### Filename format
+
+```
+trainus-{version}-backup-YYYYMMDD-HHhMMmSSs.sqlite3
+```
+
+Local time, zero-padded. Letters `h`, `m`, `s` replace colons for Windows filesystem compatibility.
+
+#### Settings keys
+
+| Key                    | Default             | Written by                        |
+| ---------------------- | ------------------- | --------------------------------- |
+| `db_created_at`        | Set on first launch | `database._initDefaults()`        |
+| `last_backup_at`       | Absent              | Download success, Restore success |
+| `backup_reminder_days` | `"7"`               | Settings number input             |
+
+#### Stale detection
+
+```
+effectiveDate = last_backup_at OR db_created_at (fallback)
+isStale = (effectiveDate absent) OR (now_utc − effectiveDate) > backup_reminder_days × 86400s
+```
+
+#### Reminder UI
+
+`BackupReminder.vue` is mounted once in `App.vue` (inside the DB-ready branch) and teleports into `#actionbar-actions`. It shows a warning-styled button with `bi-exclamation-triangle-fill`. Clicking navigates to `#/settings` and scrolls to the `#settings-backup-section` anchor. The reminder is not dismissible.
+
+`useBackupStatus` uses module-level refs so the same state is shared across all component instances (singleton pattern).
+
+#### Date formatting
+
+`src/utils/dateFormatter.js` provides two locale-aware pure functions used throughout the app:
+
+| Function                      | English            | French                 |
+| ----------------------------- | ------------------ | ---------------------- |
+| `formatDate(date, lang?)`     | `MM/DD/YYYY`       | `DD/MM/YYYY`           |
+| `formatDateTime(date, lang?)` | `toLocaleString()` | `DD/MM/YYYY, HH:MM:SS` |
+
+The optional `lang` parameter allows Vue computed properties to pass the reactive language ref, ensuring date displays update immediately on language switch.
+
+**Key files:** `src/composables/useBackupStatus.js`, `src/components/BackupReminder.vue`, `src/utils/backupFilename.js`, `src/utils/dateFormatter.js`
+
+---
+
+### 3.11 PWA
+
+**Plugin:** `vite-plugin-pwa` + Workbox
+
+#### Service worker
+
+| Config                          | Value        | Rationale                                    |
+| ------------------------------- | ------------ | -------------------------------------------- |
+| `registerType`                  | `autoUpdate` | Silently activates new SW on next navigation |
+| `maximumFileSizeToCacheInBytes` | 10 MB        | Covers `sqlite3.wasm` (~8 MB)                |
+| `manifest`                      | `false`      | Hand-authored `public/manifest.json` kept    |
+
+Workbox handles content-hash-based precaching of the entire app shell at install time, enabling full offline support. The WASM binary is included in the precache manifest via the 10 MB limit.
+
+#### App manifest
+
+`public/manifest.json` declares `name`, `short_name`, `display: standalone`, `theme_color`, `background_color`, and two icons (192×192 and 512×512) with both `maskable` and `any` purposes.
+
+#### Install prompt
+
+`useInstallPrompt.js` captures the `beforeinstallprompt` event at module load time (singleton ref `canInstall`). `InstallPrompt.vue` teleports a download icon button into the action bar when `canInstall` is true. The prompt is session-dismissible (no persistence needed).
+
+#### Accessibility
+
+ARIA additions applied across the app:
+
+- `aria-label` on all icon-only action bar buttons across all views
+- `role="progressbar"` + `aria-valuenow/min/max` on the execution progress bar
+- `role="alert"` + `aria-describedby` on form error messages
+- `required` / `aria-required` on required inputs
+- `role="dialog"` + `aria-modal` + `aria-labelledby` + focus-on-mount + Escape key on `ModalDialog`
+
+**Key files:** `vite.config.js`, `public/manifest.json`, `src/composables/useInstallPrompt.js`, `src/components/InstallPrompt.vue`
+
+---
+
+### 3.12 Save Filename Prompt
+
+Every file saved to disk (JSON exports, the home HTML export, the SQLite backup — including the forced pre-migration backup) prompts for a filename instead of downloading silently under an auto-generated name.
+
+**Composable:** `useSaveFilePrompt` (module-level singleton, same pattern as `useBackupStatus`). `promptFilename(defaultFilename)` splits the default name into stem + extension at the last dot, stores it in the singleton `pendingSave` ref, and returns a `Promise<string|null>` that resolves once the dialog is dismissed (`null` if cancelled).
+
+**Component:** `SaveFileDialog.vue`, mounted once at the root of `App.vue` so it is available regardless of which view (or the blocking migration screen) triggers a save. Renders an editable stem input (prefilled, text selected) next to a fixed, read-only extension. Enter confirms; an empty stem falls back to the default.
+
+The three low-level download helpers (`downloadJson` in `jsonEnvelope.js`, `downloadBackup` in `useBackupDownload.js`, the local `downloadHtml` in `useHtmlExport.js`) call `promptFilename()` before building the blob/anchor, and no-op if the user cancels — no other call site changed. For backups specifically, `markBackedUp()` (and, on the migration screen, enabling the Update button) only runs if the save wasn't cancelled.
+
+**Key files:** `src/composables/useSaveFilePrompt.js`, `src/components/SaveFileDialog.vue`, `src/utils/jsonEnvelope.js`, `src/composables/useBackupDownload.js`, `src/composables/useHtmlExport.js`, `src/App.vue`
+
+---
+
+## 4. Routing
+
+All routes use hash mode (`createWebHashHistory`). The root path `/` redirects to `/home`.
+
+| Route                    | View                   | Notes               |
+| ------------------------ | ---------------------- | ------------------- |
+| `#/home`                 | `HomeView`             | Activity overview   |
+| `#/exercises`            | `ExerciseListView`     | List + search       |
+| `#/exercises/new`        | `ExerciseFormView`     | Create mode         |
+| `#/exercises/:id`        | `ExerciseDetailView`   | Read-only           |
+| `#/exercises/:id/edit`   | `ExerciseFormView`     | Edit mode           |
+| `#/combos`               | `ComboListView`        | List + search       |
+| `#/combos/new`           | `ComboFormView`        | Create mode         |
+| `#/combos/:id`           | `ComboDetailView`      | Read-only           |
+| `#/combos/:id/edit`      | `ComboFormView`        | Edit mode           |
+| `#/sessions`             | `SessionListView`      | List + search       |
+| `#/sessions/new`         | `SessionFormView`      | Create mode         |
+| `#/sessions/:id`         | `SessionDetailView`    | Read-only           |
+| `#/sessions/:id/edit`    | `SessionFormView`      | Edit mode           |
+| `#/sessions/:id/execute` | `SessionExecuteView`   | Execution mode      |
+| `#/collections`          | `CollectionsView`      | List + search       |
+| `#/collections/new`      | `CollectionFormView`   | Create mode         |
+| `#/collections/:id`      | `CollectionDetailView` | Read-only           |
+| `#/collections/:id/edit` | `CollectionFormView`   | Edit mode           |
+| `#/stats`                | `StatsView`            | Statistics + charts |
+| `#/settings`             | `SettingsView`         | User settings       |
+
+The `navKeyMap` in `App.vue` maps sub-routes (e.g., `exercise-detail`, `exercise-edit`) to their top-level nav key (`exercises`), so the nav item stays highlighted when the user navigates into detail/edit views.
+
+---
+
+## 5. Internationalization
+
+**Libraries:** `i18next` + `i18next-vue`
+
+**Locale files:** `src/i18n/locales/en.json` (English, default), `src/i18n/locales/fr.json` (French), `src/i18n/locales/da.json` (Danish)
+
+**Initialization:** `src/i18n/index.js` registers all three locales and sets the default language to English. The composable `useTranslation()` from `i18next-vue` is used in all components — no direct i18next calls in templates.
+
+**Startup:** `src/main.js` calls `i18next.changeLanguage(stored_language)` before the first render, so the UI always opens in the user's persisted language.
+
+**Language switching:** The Settings language selector calls `i18next.changeLanguage()` and persists the new value to `settings.language`. All reactive `t()` calls update immediately.
+
+**Date formatting:** `dateFormatter.js` reads `i18next.language` as fallback but accepts an explicit `lang` parameter to enable reactive date display in Vue computed properties.
+
+See [How-to Guides → Add a New Language]({{< relref "how-to-guides.en.md" >}}#add-a-new-language) to add support for an additional language.
+
+---
+
+## 6. Versioning
+
+### App version
+
+Sourced from `package.json`, injected by Vite as `__APP_VERSION__` (a global string constant). Available at build time (SW cache name) and runtime (export metadata, settings table, backup filenames). It is informational only — it plays no role in data location or migration decisions.
+
+### Database file naming
+
+The OPFS database lives at a stable, version-independent location: directory `.trainus`, file `trainus.db`. OPFS is _origin_-scoped, so the data automatically survives app updates; schema changes are handled by the startup migration system (§2 Migration System), not by relocating the data.
+
+> Historical note: before Step 16 the directory was named `.trainus-{appVersion}`, orphaning the data on every release. Old versioned directories from dev machines are simply abandoned (clear them via browser devtools if needed).
+
+### Schema version
+
+`SCHEMA_VERSION` in `src/db/schema.js` is an integer stored in the `schema_version` table. It drives both the startup migration check and the Restore Database compatibility check.
+
+**Rule:** `SCHEMA_VERSION` is only incremented when a schema change is deployed to users. In-place changes before first release (adding columns directly in `SCHEMA_SQL`) do not require a bump.
+
+### Release registry
+
+`src/db/releases.js` exports a `RELEASES` array — the single source of truth for schema history. Each entry declares `{ schemaVersion, appVersion, dbBreak, migrationScript }`, where `migrationScript` is the SQL bringing a live DB from `schemaVersion - 1` to `schemaVersion` (or `null` for a no-op migration when `dbBreak` is false). Every `SCHEMA_VERSION` bump must ship exactly one `RELEASES` entry.
+
+Two consumers share this registry:
+
+- `getMigrationScripts(from, to)` — ordered scripts for the startup migration.
+- `checkCompatibility(imported, current)` — Restore Database flow.
+
+---
+
+## 7. Build Commands
+
+```bash
+npm install
+npm run dev             # Vite dev server at http://localhost:5173
+npm run build            # Production build to dist/
+npm run preview          # Preview production build locally
+npm run format           # Format all files with Prettier
+npm run format:check     # CI check (non-zero exit on diff)
+```
+
+COOP/COEP headers are injected automatically by `vite.config.js` for the dev server. See [How-to Guides → Deploy TrainUs]({{< relref "how-to-guides.en.md" >}}#deploy-trainus) for production deployment.
+
+See `tests/README.md` for the full test setup and run instructions.
+
+---
+
+## 8. Annexes
+
+### Annex A — Content Width Cap on List/Detail Views
+
+On wide desktop viewports (e.g., 1920×1080), content pages do not span the full available width. Cards stop at ~800px.
+
+| View                                                  | Cap    |
+| ----------------------------------------------------- | ------ |
+| List views (exercises, combos, sessions, collections) | 800 px |
+| Detail views                                          | 800 px |
+| Form views                                            | 600 px |
+| Settings view                                         | 600 px |
+
+The cap is implemented per-view (not globally) so each screen can opt into a different readable width.
+
+#### To add multi-column layout on wide screens
+
+1. Raise the cap on list views to `1200px` (or remove it) and replace the vertical stack with a CSS grid using `grid-template-columns: repeat(auto-fill, minmax(320px, 1fr))`.
+2. Keep detail and settings views at their current caps.
+3. Wrap only the cards in an inner `<div class="grid-wrapper">` to avoid restyling the action bar and empty-state messages.
+4. Apply the same pattern to all list views for consistency.
diff --git a/website/content/developers/technical.fr.md b/website/content/developers/technical.fr.md
new file mode 100644
index 0000000..e76e137
--- /dev/null
+++ b/website/content/developers/technical.fr.md
@@ -0,0 +1,1124 @@
+---
+title: 'Référence'
+description: 'Architecture, schéma de base de données, fonctionnalités, routage, i18n, versionnement et commandes de build — la référence technique complète.'
+weight: 3
+date: 2026-06-16
+---
+
+> Cette page décrit chaque partie de TrainUs en détail : pile technique, schéma, routes, composables. Pour une première prise en main guidée, voir [Démarrage rapide]({{< relref "getting-started.fr.md" >}}) ; pour des tâches concrètes, voir [Guides pratiques]({{< relref "how-to-guides.fr.md" >}}) ; pour le « pourquoi » des choix, voir [Comprendre l'architecture]({{< relref "understanding-the-architecture.fr.md" >}}).
+
+> **Paternité IA.** La grande majorité du code source de ce projet a été écrite par des assistants IA (principalement Claude). L'auteur humain a dirigé l'architecture, relu chaque modification, guidé l'implémentation et pris toutes les décisions de conception et de produit — mais si l'auteur, c'est celui qui tape les lignes, ce crédit revient en grande partie à l'IA. Cela est indiqué ici par souci de transparence, et non comme une mise en garde : le code a été relu et validé à chaque étape.
+
+## 1. Architecture
+
+TrainUs est une **Progressive Web Application (PWA)** qui tourne entièrement dans le navigateur — il n'y a pas de serveur backend, et toutes les données sont stockées localement via SQLite WASM avec une persistance OPFS (Origin Private File System). L'application fonctionne hors ligne après le premier chargement et peut être installée sur l'écran d'accueil. Voir [Comprendre l'architecture]({{< relref "understanding-the-architecture.fr.md" >}}) pour le pourquoi de ces choix.
+
+### Pile technique
+
+| Couche          | Technologie                |
+| --------------- | -------------------------- |
+| Framework UI    | Vue 3 (Composition API)    |
+| Build           | Vite                       |
+| Routage         | Vue Router (mode hash)     |
+| i18n            | i18next + i18next-vue      |
+| Base de données | SQLite WASM + OPFS         |
+| Graphiques      | Chart.js 4 + vue-chartjs 5 |
+| Icônes          | Bootstrap Icons            |
+| Markdown        | marked + DOMPurify         |
+| PWA             | vite-plugin-pwa + Workbox  |
+| Formatage       | Prettier                   |
+| Tests           | Playwright (Python)        |
+| Licence         | GNU AGPL v3                |
+
+### Structure du projet
+
+```
+trainUs/
+├── index.html                      # Point d'entrée
+├── package.json                    # Dépendances & scripts npm
+├── vite.config.js                  # Configuration Vite + PWA + CORS
+├── public/
+│   ├── manifest.json               # Manifeste PWA (écrit à la main)
+│   ├── icon-192.png                # Icône PWA 192×192
+│   ├── icon-512.png                # Icône PWA 512×512
+│   └── sqlite3-opfs-async-proxy.js # Proxy OPFS async pour le worker SQLite
+├── src/
+│   ├── main.js                     # Démarrage de l'app (init DB, restauration des réglages)
+│   ├── App.vue                     # Composant racine (layout général, navigation)
+│   ├── router/
+│   │   └── index.js                # Vue Router — les 21 routes
+│   ├── views/                      # Composants de page (un par route)
+│   ├── components/                 # Composants UI réutilisables
+│   ├── composables/                # Composables Vue (données réactives & logique)
+│   ├── db/
+│   │   ├── database.js             # Gestionnaire de DB (pont vers le worker)
+│   │   ├── worker.js                # Web Worker (SQLite WASM + OPFS)
+│   │   ├── schema.js                # DDL + SCHEMA_VERSION + MIGRATIONS
+│   │   ├── releases.js              # Registre des releases pour la compatibilité de restauration
+│   │   └── repositories/            # Couche d'accès aux données, par entité
+│   ├── i18n/
+│   │   ├── index.js                # Initialisation i18next
+│   │   └── locales/
+│   │       ├── en.json             # Traductions anglaises
+│   │       └── fr.json             # Traductions françaises
+│   ├── styles/
+│   │   ├── variables.css           # Variables CSS personnalisées (thèmes clair/sombre)
+│   │   └── layout.css              # Mise en page globale, navigation, barre d'action
+│   └── utils/                      # Fonctions utilitaires pures (validation, dateFormatter, markdown, …)
+├── docs/                           # Toute la documentation
+└── tests/                          # Suite de tests Playwright en Python
+```
+
+### Architecture thread principal / Worker
+
+SQLite tourne dans un **Web Worker** pour accéder aux API OPFS, indisponibles sur le thread principal.
+
+```
+Thread principal                      Thread Worker
+┌──────────────────────┐              ┌──────────────────┐
+│ database.js          │──postMsg()──▶│ worker.js        │
+│  exec / run /        │◀──postMsg()──│ sqlite3 WASM     │
+│  selectAll /         │              │ stockage OPFS    │
+│  exportDatabase /    │              └──────────────────┘
+│  importDatabase      │
+├──────────────────────┤
+│ repositories/        │  CRUD asynchrone pur, par entité
+├──────────────────────┤
+│ composables/         │  Wrappers réactifs pour Vue
+└──────────────────────┘
+```
+
+La communication est entièrement basée sur des Promises : `database.js` enveloppe chaque `postMessage()` dans une Promise résolue par un ID de réponse correspondant.
+
+### En-têtes COOP / COEP
+
+```
+Cross-Origin-Opener-Policy: same-origin
+Cross-Origin-Embedder-Policy: require-corp
+```
+
+Voir [Guides pratiques → Déployer TrainUs]({{< relref "how-to-guides.fr.md" >}}#déployer-trainus) pour la configuration côté serveur, et [Comprendre l'architecture]({{< relref "understanding-the-architecture.fr.md" >}}) pour savoir pourquoi le VFS utilisé ici n'en a pas strictement besoin.
+
+### Design responsive
+
+| Seuil    | Mise en page                                   |
+| -------- | ---------------------------------------------- |
+| > 700 px | Menu latéral fixe (liens avec libellés)        |
+| ≤ 700 px | Barre de navigation en bas (icônes + libellés) |
+| ≤ 400 px | Navigation en bas, icônes seules               |
+
+### Thèmes
+
+Les thèmes clair et sombre sont implémentés via des variables CSS personnalisées sur `:root` / `[data-theme="dark"]`. Le thème est conservé dans la table `settings` et appliqué avant le premier rendu (pas de flash).
+
+---
+
+## 2. Couche base de données
+
+### VFS : OPFS SyncAccessHandle Pool
+
+L'application utilise le VFS `opfs-sahpool` :
+
+- E/S synchrones via `FileSystemSyncAccessHandle`
+- Fonctionne sur tous les navigateurs majeurs depuis mars 2023 (Firefox 111+, Chrome 102+, Safari 16.4+)
+- Ne nécessite pas les en-têtes COOP/COEP (même si nous les avons)
+- Connexion unique seulement (suffisant pour une PWA mono-utilisateur)
+
+Si OPFS n'est pas disponible (navigation privée, navigateur ancien), l'application affiche une erreur en plein écran. Il n'y a pas de repli en mémoire. Voir [Comprendre l'architecture]({{< relref "understanding-the-architecture.fr.md" >}}) pour savoir pourquoi ce VFS a été choisi et pourquoi il n'y a pas de repli.
+
+### Schéma
+
+12 tables, toutes définies avec `CREATE TABLE IF NOT EXISTS` (idempotent). Le `SCHEMA_VERSION` actuel est **1**.
+
+| Table                | Rôle                                                            |
+| -------------------- | --------------------------------------------------------------- |
+| `schema_version`     | Suivi des migrations (`version` + `applied_at`)                 |
+| `settings`           | Configuration clé-valeur (user_uuid, nom, thème, …)             |
+| `exercise`           | Définitions d'exercices (title UNIQUE)                          |
+| `combo`              | Définitions de combos (title UNIQUE)                            |
+| `combo_exercise`     | Jonction combo ↔ exercice (position, reps, poids)               |
+| `session`            | Définitions de séances (title UNIQUE)                           |
+| `session_item`       | Jonction séance ↔ élément (type, position, reps, poids)         |
+| `collection`         | Collections (label UNIQUE)                                      |
+| `collection_session` | Jonction collection ↔ séance (position)                         |
+| `execution_log`      | Journaux d'exécution (started_at, finished_at)                  |
+| `execution_log_item` | Résultats d'exécution par exercice (reps, poids, côté, …)       |
+| `suffix`             | Registre des utilisateurs externes, pour désambiguïser l'import |
+
+#### Diagramme entité-relation
+
+```mermaid
+erDiagram
+    SETTINGS {
+        text key PK
+        text value
+    }
+    EXERCISE {
+        text id PK
+        text title UK
+        text description
+        boolean asymmetric
+        boolean alternate
+        text image_urls
+        text video_urls
+        integer default_reps
+        real default_weight
+        text created_by
+    }
+    COMBO {
+        text id PK
+        text title UK
+        text description
+        text type
+        text timer_config
+        text created_by
+    }
+    COMBO_EXERCISE {
+        text combo_id FK
+        text exercise_id FK
+        integer position
+        integer default_reps
+        real default_weight
+    }
+    SESSION {
+        text id PK
+        text title UK
+        text description
+        text created_by
+    }
+    SESSION_ITEM {
+        text session_id FK
+        text item_id
+        text item_type
+        integer position
+        integer repetitions
+        real weight
+    }
+    COLLECTION {
+        text id PK
+        text label UK
+        text created_by
+    }
+    COLLECTION_SESSION {
+        text collection_id FK
+        text session_id FK
+        integer position
+    }
+    EXECUTION_LOG {
+        text id PK
+        text session_id FK
+        datetime started_at
+        datetime finished_at
+    }
+    EXECUTION_LOG_ITEM {
+        text id PK
+        text log_id FK
+        text exercise_id FK
+        text combo_id
+        integer round_number
+        integer reps_done
+        real weight_used
+        text side
+        boolean completed
+        datetime timestamp
+    }
+    SUFFIX {
+        text user_uuid PK
+        text user_name
+        text suffix UK
+    }
+
+    COMBO ||--|{ COMBO_EXERCISE : contains
+    EXERCISE ||--o{ COMBO_EXERCISE : "used in"
+    SESSION ||--|{ SESSION_ITEM : contains
+    COLLECTION ||--|{ COLLECTION_SESSION : contains
+    SESSION ||--o{ COLLECTION_SESSION : "used in"
+    SESSION ||--o{ EXECUTION_LOG : "executed as"
+    EXECUTION_LOG ||--|{ EXECUTION_LOG_ITEM : records
+    EXERCISE ||--o{ EXECUTION_LOG_ITEM : tracks
+```
+
+**Détails de colonnes notables :**
+
+- `session_item.item_type` : `"exercise"` ou `"combo"` — utilisé pour faire un JOIN avec la bonne table pour récupérer les titres
+- `execution_log_item.combo_id` / `round_number` : NULL pour les exercices autonomes ; renseignés pour les exercices exécutés au sein d'un combo (pas de contrainte FK — le combo peut être supprimé après exécution)
+- Clés de `settings` : `user_uuid`, `user_name`, `app_version`, `language`, `theme`, `db_created_at`, `last_backup_at`, `backup_reminder_days`
+
+#### Contraintes UNIQUE
+
+L'unicité des titres/libellés est imposée au niveau de la base sur `exercise.title`, `combo.title`, `session.title`, `collection.label`. Les violations remontent comme des erreurs `UNIQUE constraint failed`, gérées par les repositories.
+
+#### Table suffix
+
+Stocke la correspondance entre les UUID d'utilisateurs externes et les suffixes qui leur sont attribués. Utilisée pendant l'import pour désambiguïser les titres provenant d'autres utilisateurs (voir §3.9).
+
+### Système de migration
+
+Au démarrage, `database.js` envoie un message `getSchemaStatus` au worker, qui détecte l'état de la base sans modifier les données existantes :
+
+- **Base neuve** (pas de ligne dans `schema_version`) : exécute `SCHEMA_SQL` et estampille `SCHEMA_VERSION`.
+- **À jour** (`dbVersion === SCHEMA_VERSION`) : continue normalement.
+- **Plus récente que l'application** (`dbVersion > SCHEMA_VERSION`) : erreur bloquante (`DB_NEWER_THAN_APP`), données intactes.
+- **Plus ancienne que l'application** (`dbVersion < SCHEMA_VERSION`) : l'application s'arrête sur un écran de migration bloquant. L'utilisateur doit d'abord télécharger une sauvegarde ; ce n'est qu'alors que le bouton **Mettre à jour** s'active, ce qui envoie `runMigrations` au worker.
+
+`runMigrations` applique les scripts de migration en attente, fournis par `getMigrationScripts(dbVersion, SCHEMA_VERSION)` dans `src/db/releases.js`. Le script de chaque release s'exécute dans une transaction avec son `INSERT INTO schema_version (version) VALUES (N)` ; en cas d'erreur, la transaction est annulée, la base reste à la version précédente, et une erreur bloquante `DB_MIGRATION_FAILED` est affichée (l'utilisateur dispose de la sauvegarde téléchargée juste avant).
+
+```mermaid
+flowchart TD
+    A[Démarrage app : db.init] --> B[Worker : ouvre le dossier OPFS pool .trainus, ouvre trainus.db]
+    B --> C{Table schema_version\nexiste avec des lignes ?}
+    C -- non : base neuve --> D[Exécute SCHEMA_SQL\nINSERT schema_version = SCHEMA_VERSION]
+    C -- oui --> E{dbVersion vs SCHEMA_VERSION}
+    E -- égal --> F[À jour — continue]
+    E -- "dbVersion > app" --> G[Erreur bloquante\nBase intacte]
+    E -- "dbVersion < app" --> H[Écran de migration bloquant\nBase intacte, app en pause]
+    H --> H2[Utilisateur clique Télécharger la sauvegarde\nexportDatabase + formatBackupFilename\nmise à jour de last_backup_at]
+    H2 --> H3[Bouton Mettre à jour activé\nutilisateur clique Mettre à jour]
+    H3 --> I[Pour chaque release N de dbVersion+1 à SCHEMA_VERSION :\nBEGIN ; migrationScript ; INSERT schema_version N ; COMMIT]
+    I -- erreur --> J[ROLLBACK\nErreur bloquante\nBase toujours à la version précédente + utilisateur a la sauvegarde]
+    I -- ok --> F
+    D --> K[_initDefaults : lignes settings]
+    F --> K
+    K --> L[Application prête]
+```
+
+Les changements de schéma en place (ajouter des colonnes directement dans `SCHEMA_SQL`) sont acceptables avant toute publication auprès des utilisateurs. Une augmentation de `SCHEMA_VERSION` est réservée aux changements de schéma faits après qu'une version a été déployée — à ce moment, la release embarque un `migrationScript` dans `RELEASES` (voir §6). Voir [Guides pratiques → Ajouter une migration de base de données]({{< relref "how-to-guides.fr.md" >}}#ajouter-une-migration-de-base-de-données) pour la recette pas à pas.
+
+### Pattern Repository
+
+Chaque entité a un repository dédié dans `src/db/repositories/` fournissant les méthodes standards : `create`, `getById`, `getAll`, `update`, `delete`, `search`. La gestion des tables de jonction est intégrée au repository parent (par exemple `setExercises()` dans `comboRepository`).
+
+Les repositories n'utilisent que `database.exec()`, `database.run()` et `database.selectAll()` — aucune construction spécifique à SQLite hors de cette couche.
+
+### Composables Vue
+
+Les wrappers réactifs dans `src/composables/` exposent un état basé sur des `ref` (`items`, `loading`, `error`) et des méthodes asynchrones, à destination des composants Vue. Les composants n'importent jamais les repositories directement ; ils passent par les composables.
+
+| Composable            | Enveloppe                                          |
+| --------------------- | -------------------------------------------------- |
+| `useExercises`        | `exerciseRepository`                               |
+| `useCombos`           | `comboRepository`                                  |
+| `useSessions`         | `sessionRepository`                                |
+| `useCollections`      | `collectionRepository`                             |
+| `useExecutionLogs`    | `executionLogRepository`                           |
+| `useSettings`         | `settingsRepository`                               |
+| `useStats`            | Plusieurs repositories (agrégats en lecture seule) |
+| `useSessionExecution` | `executionLogRepository` + logique de file         |
+| `useJsonExport`       | Tous les repositories + `jsonEnvelope.js`          |
+| `useJsonImport`       | Tous les repositories + `suffixRepository`         |
+| `useBackupStatus`     | `settingsRepository`                               |
+| `useInstallPrompt`    | Événement `beforeinstallprompt` (API navigateur)   |
+| `useHtmlExport`       | Rendu de données pur — aucun appel à un repository |
+
+---
+
+## 3. Fonctionnalités
+
+### 3.1 Réglages
+
+**Vue :** `src/views/SettingsView.vue` — `#/settings`
+
+**Restauration au démarrage :** au lancement de l'application (`src/main.js`), après l'initialisation de la base et avant le premier rendu, `language` et `theme` sont lus depuis `settings` et appliqués. Cela évite tout flash de valeurs par défaut.
+
+#### Réglages disponibles
+
+| Réglage                            | Contrôle                                                    | Clé de persistance              |
+| ---------------------------------- | ----------------------------------------------------------- | ------------------------------- |
+| Langue                             | `<select>` (English / Français / Dansk)                     | `settings.language`             |
+| Nom d'utilisateur                  | Champ texte (requis, non vide)                              | `settings.user_name`            |
+| Identifiant utilisateur            | Affichage UUID en lecture seule                             | `settings.user_uuid`            |
+| Thème                              | `<select>` (Clair / Sombre)                                 | `settings.theme`                |
+| Volume sonore                      | Curseur (0–100 %) + bouton Tester                           | `settings.audio_volume`         |
+| Télécharger la DB                  | Bouton → télécharge un `.sqlite3`                           | —                               |
+| Restaurer la DB                    | Sélecteur de fichier → pipeline de validation               | —                               |
+| Initialiser la DB                  | Bouton + case à cocher obligatoire                          | —                               |
+| Intervalle de rappel de sauvegarde | Champ numérique (1–365, défaut 7)                           | `settings.backup_reminder_days` |
+| Exporter des données               | Bouton → boîte de filtre par entité                         | —                               |
+| Importer des données               | Bouton → sélecteur de fichier                               | —                               |
+| Gestion des suffixes               | Liste des suffixes enregistrés                              | table `suffix`                  |
+| Crédits                            | Bouton → fenêtre modale (attributions icônes/bibliothèques) | —                               |
+| À propos                           | Bouton → fenêtre modale (version, auteur)                   | —                               |
+
+Le volume sonore est détaillé en [§ 3.7 Signaux sonores](#signaux-sonores).
+
+#### Télécharger la base de données
+
+Appelle `sqlite3_js_db_export()` dans le worker. Le fichier SQLite brut est téléchargé sous le nom `trainus-{version}-backup-YYYYMMDD-HHhMMmSSs.sqlite3` et `last_backup_at` est mis à jour en cas de succès.
+
+#### Restaurer la base de données
+
+Pipeline en plusieurs étapes, exécuté dans le worker :
+
+```mermaid
+flowchart TD
+    A[Utilisateur clique Restaurer] --> B[Sélecteur de fichier]
+    B --> C[Boîte de confirmation]
+    C -->|Annuler| Z[Abandon]
+    C -->|OK| D[Affiche le spinner]
+    D --> E[Désérialise dans une DB :memory:]
+    E -->|Fichier invalide| F[Erreur : INVALID_FILE]
+    E -->|Valide| G[Vérifie les tables requises]
+    G -->|Manquantes| H[Erreur : INCOMPLETE_DB]
+    G -->|Présentes| I[Lit les versions de schéma]
+    I --> J[Vérifie la compatibilité]
+    J -->|Incompatible| K[Erreur : INCOMPATIBLE_VERSION]
+    J -->|Compatible| L{Adaptation nécessaire ?}
+    L -->|Oui| M[Exécute les scripts d'adaptation]
+    M -->|Échec| N[Erreur : ADAPT_FAILED]
+    M -->|OK| O[Copie table par table dans une transaction]
+    L -->|Non| O
+    O -->|Échec| P[Erreur : RESTORE_FAILED]
+    O -->|OK| Q[Carte récapitulative de succès]
+```
+
+La copie table par table ne transfère que les colonnes présentes dans les deux schémas. L'opération entière s'exécute dans une transaction ; en cas d'échec, elle est annulée. Après succès, les réglages (langue, thème) sont réappliqués sur place, sans rechargement de page.
+
+La compatibilité des versions est gérée par `src/db/releases.js` : un tableau `RELEASES` où chaque entrée déclare `schemaVersion`, `appVersion`, `dbBreak`, et un `migrationScript` optionnel. `checkCompatibility()` parcourt cet historique pour déterminer si un chemin de migration existe. Les mêmes scripts `migrationScript` pilotent à la fois l'adaptation de restauration et la migration au démarrage (§ Système de migration).
+
+#### Initialiser la base de données
+
+Supprime toutes les données de toutes les tables, dans l'ordre sûr pour les clés étrangères (enfants en premier), puis appelle `_initDefaults()` pour régénérer `user_uuid`, `user_name`, `app_version`, `db_created_at`. La page se recharge pour refléter le nouvel état. Une case de confirmation obligatoire empêche tout usage accidentel.
+
+**Fichiers clés :**
+`src/views/SettingsView.vue`, `src/db/database.js`, `src/db/worker.js`, `src/db/releases.js`, `src/db/repositories/settingsRepository.js`
+
+#### Fenêtre « Crédits »
+
+Une fenêtre modale ouverte depuis la carte **Crédits** de la page Réglages, attribuant les ressources et bibliothèques tierces :
+
+| Élément                       | Licence   | Source                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
+| ----------------------------- | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| Icône de l'app (Mighty Force) | CC BY 3.0 | [game-icons.net](https://game-icons.net), par Delapouite                                                                                                                                                                                                                                                                                                                                                                                                                               |
+| Bootstrap Icons               | MIT       | [icons.getbootstrap.com](https://icons.getbootstrap.com)                                                                                                                                                                                                                                                                                                                                                                                                                               |
+| Bibliothèques tierces         | —         | [Vue](https://vuejs.org), [Vue Router](https://router.vuejs.org), [Vite](https://vitejs.dev), [SQLite WASM](https://sqlite.org/wasm/), [Chart.js](https://www.chartjs.org), [vue-chartjs](https://vue-chartjs.org), [i18next](https://www.i18next.com), [i18next-vue](https://i18next.github.io/i18next-vue/), [Prettier](https://prettier.io), [vite-plugin-pwa](https://vite-pwa-org.netlify.app), [marked](https://marked.js.org), [DOMPurify](https://github.com/cure53/DOMPurify) |
+| Outils de test                | —         | [Playwright](https://playwright.dev/python/), [pytest](https://pytest.org)                                                                                                                                                                                                                                                                                                                                                                                                             |
+
+Les noms et liens des icônes/bibliothèques sont écrits en dur dans le composant ; le texte d'attribution provient de l'espace de noms i18n `credits.*`.
+
+**Composant :** `src/components/CreditsDialog.vue`
+
+#### Fenêtre « À propos »
+
+Une fenêtre modale ouverte depuis la carte **À propos de TrainUs** en bas de la page Réglages. Elle affiche :
+
+| Champ                         | Source                                                            |
+| ----------------------------- | ----------------------------------------------------------------- |
+| Version de l'application      | `__APP_VERSION__` (variable globale Vite issue de `package.json`) |
+| Version de la base de données | `SCHEMA_VERSION` (depuis `src/db/schema.js`)                      |
+| Créé par                      | Texte fixe : David Florance                                       |
+| Dépôt                         | Lien provisoire (`href="#"`)                                      |
+| Site web                      | Lien provisoire (`href="#"`)                                      |
+| Voir la licence               | Bouton désactivé, avec la note « Licence à déterminer. »          |
+
+**Composant :** `src/components/AboutDialog.vue`
+
+Les clés i18n sont sous l'espace de noms `about.*` dans tous les fichiers de locale.
+
+---
+
+### 3.2 Gestion des exercices
+
+**Vues :** `ExerciseListView`, `ExerciseFormView`, `ExerciseDetailView`
+
+**Routes :** `#/exercises`, `#/exercises/new`, `#/exercises/:id`, `#/exercises/:id/edit`
+
+#### Champs du formulaire
+
+| Champ                  | Validation                                                                   |
+| ---------------------- | ---------------------------------------------------------------------------- |
+| Titre                  | Requis, UNIQUE (au niveau base)                                              |
+| Description            | Optionnelle ; rendue en Markdown dans la vue détail (`marked` + `DOMPurify`) |
+| Asymétrique            | Booléen ; révèle la sous-option Alternance                                   |
+| Alternance             | Bouton radio : alterner par répétition ou par série                          |
+| Répétitions par défaut | ≥ 0                                                                          |
+| Poids par défaut       | ≥ 0                                                                          |
+| URLs d'images          | Chaque URL doit être une URL HTTP(S) valide                                  |
+| URLs de vidéos         | Chaque URL doit être une URL HTTP(S) valide                                  |
+
+`ExerciseFormView` est partagée entre les modes création et édition, distingués via `route.name` (`exercise-new` vs `exercise-edit`).
+
+#### Barre d'action (pattern Teleport)
+
+Les vues injectent des boutons dans la barre d'action partagée via `<Teleport to="#actionbar-actions" defer>`. L'attribut `defer` (Vue 3.5+) résout la cible au cycle de rendu suivant, ce qui évite une condition de course avec le shell conditionné par `v-else`.
+
+#### Utilitaire de validation
+
+`src/utils/validation.js` fournit des validateurs réutilisables, qui renvoient des clés i18n :
+
+- `validateRequired(value)` → `'validation.required'`
+- `validateMin(value, min)` → `'validation.minValue'`
+- `validateUrl(value)` → `'validation.invalidUrl'`
+
+#### Recherche
+
+Barre de recherche activable, avec une temporisation de 250ms → `exerciseRepository.search()` (SQL `LIKE %query%`). Un bouton d'effacement (×) s'affiche dans le champ dès qu'il contient une valeur ; il vide le champ et lui redonne le focus. Vider le champ (via ce bouton, manuellement, ou en désactivant la recherche) appelle `fetchAll()`. Le même schéma (barre de recherche, temporisation, bouton d'effacement) est dupliqué dans `ExerciseListView`, `ComboListView`, `SessionListView` et `CollectionsView` plutôt que factorisé dans un composable partagé.
+
+#### Intégration des médias
+
+- **Images** : affichées dans une grille responsive, avec chargement différé. Un gestionnaire `@error` masque les images cassées.
+- **YouTube** : les ID de vidéo sont extraits des formats `youtube.com/watch?v=` et `youtu.be/`, et intégrés via `youtube-nocookie.com`.
+- **Autres URLs** : affichées comme des liens cliquables.
+
+**Fichiers clés :** `src/views/ExerciseListView.vue`, `src/views/ExerciseFormView.vue`, `src/views/ExerciseDetailView.vue`, `src/utils/validation.js`, `src/utils/markdown.js`, `src/utils/youtube.js`
+
+---
+
+### 3.3 Gestion des combos
+
+**Vues :** `ComboListView`, `CombosView`, `ComboFormView`, `ComboDetailView`
+
+**Routes :** `#/combos`, `#/combos/new`, `#/combos/:id`, `#/combos/:id/edit`
+
+Un combo est un groupe ordonné d'exercices avec un format minuté optionnel (EMOM, AMRAP, TABATA, ou NONE pour de simples supersets).
+
+#### Champs du formulaire
+
+| Champ                     | Notes                                                                      |
+| ------------------------- | -------------------------------------------------------------------------- |
+| Titre                     | Requis, UNIQUE                                                             |
+| Description               | Optionnelle ; rendue en Markdown dans la vue détail                        |
+| Type                      | NONE / EMOM / AMRAP / TABATA                                               |
+| Configuration du minuteur | Durée (min) pour EMOM/AMRAP ; nombre de tours pour TABATA ; stocké en JSON |
+| Exercices                 | Liste ordonnée avec, par exercice, répétitions (≥ 1) et poids (≥ 0)        |
+
+Chaque exercice du combo a ses propres `default_reps` et `default_weight`, stockés dans la table de jonction `combo_exercise`. Ces valeurs surchargent les valeurs par défaut de l'exercice lorsque le combo est utilisé dans une séance.
+
+#### Ordonnancement des exercices
+
+Les boutons monter/descendre ajustent la position. `comboRepository.setExercises()` remplace en une seule opération toute la table de jonction d'un combo (suppression + réinsertion).
+
+#### Forme du retour de `getExercises()`
+
+```js
+{
+  ;(exerciseId, exerciseTitle, position, defaultReps, defaultWeight, asymmetric, alternate)
+}
+```
+
+`asymmetric` et `alternate` sont inclus pour que le mode exécution puisse déterminer la gestion du côté sans requête supplémentaire.
+
+**Fichiers clés :** `src/views/ComboListView.vue`, `src/views/ComboFormView.vue`, `src/views/ComboDetailView.vue`, `src/db/repositories/comboRepository.js`
+
+---
+
+### 3.4 Gestion des séances
+
+**Vues :** `SessionListView`, `SessionsView`, `SessionFormView`, `SessionDetailView`, `SessionExecuteView`
+
+**Routes :** `#/sessions`, `#/sessions/new`, `#/sessions/:id`, `#/sessions/:id/edit`, `#/sessions/:id/execute`
+
+Une séance est une liste ordonnée d'éléments — chaque élément est soit un **exercice**, soit un **combo**, avec des répétitions et un poids propres à l'élément.
+
+#### Éléments de séance
+
+`session_item` utilise une paire polymorphe `item_id` + `item_type` :
+
+```sql
+item_type IN ('exercise', 'combo')
+```
+
+`sessionRepository.getItems()` exécute deux requêtes séparées (une avec JOIN sur `exercise`, une avec JOIN sur `combo`) puis fusionne les résultats triés par `position`. SQLite ne supporte pas les JOIN conditionnels entre différentes tables dans une seule requête.
+
+#### Champs du formulaire
+
+| Champ       | Notes                                                                     |
+| ----------- | ------------------------------------------------------------------------- |
+| Titre       | Requis, UNIQUE                                                            |
+| Description | Optionnelle ; rendue en Markdown dans la vue détail                       |
+| Éléments    | Liste ordonnée ; chaque élément a des répétitions (≥ 1) et un poids (≥ 0) |
+
+Le sélecteur de type d'élément (exercice vs combo) contrôle quel menu déroulant est rempli. Les éléments peuvent être déplacés vers le haut/bas ou supprimés.
+
+#### Sémantique des répétitions
+
+Pour un élément de séance qui est un combo, `repetitions` = le nombre de passages complets dans la liste d'exercices du combo (pas les répétitions individuelles par exercice).
+
+**Fichiers clés :** `src/views/SessionListView.vue`, `src/views/SessionFormView.vue`, `src/views/SessionDetailView.vue`, `src/db/repositories/sessionRepository.js`
+
+---
+
+### 3.5 Gestion des collections
+
+**Vues :** `CollectionsView`, `CollectionFormView`, `CollectionDetailView`
+
+**Routes :** `#/collections`, `#/collections/new`, `#/collections/:id`, `#/collections/:id/edit`
+
+Une collection est un groupe ordonné de séances — utile pour organiser des programmes hebdomadaires ou des phases d'entraînement.
+
+#### Champs du formulaire
+
+| Champ   | Notes                                                         |
+| ------- | ------------------------------------------------------------- |
+| Libellé | Requis, UNIQUE                                                |
+| Séances | Liste ordonnée ; chaque séance ne peut apparaître qu'une fois |
+
+`collectionRepository.getAll()` inclut un champ `sessionCount`, via une requête COUNT sur `collection_session` — ce qui évite de charger toutes les données de séance pour la vue liste.
+
+**Fichiers clés :** `src/views/CollectionsView.vue`, `src/views/CollectionFormView.vue`, `src/views/CollectionDetailView.vue`, `src/db/repositories/collectionRepository.js`
+
+---
+
+### 3.6 Page d'accueil
+
+**Vue :** `HomeView` — `#/home`
+
+Page d'accueil avec un aperçu rapide de l'activité d'entraînement récente.
+
+| Widget                          | Source de données                                                                    |
+| ------------------------------- | ------------------------------------------------------------------------------------ |
+| Séances des 7 derniers jours    | `executionLogRepository.getCountSince(isoDate)`                                      |
+| Séances des 30 derniers jours   | `executionLogRepository.getCountSince(isoDate)`                                      |
+| Les 4 séances les plus récentes | `executionLogRepository.getRecentWithItems(4)` (JOIN avec `session` et ses éléments) |
+| Historique par jour (filtré)    | `executionLogRepository.getAllWithItems()` — filtré côté client par plage de dates   |
+
+#### Séances récentes
+
+Les 4 séances les plus récemment exécutées sont affichées sous forme de cartes. Chaque carte affiche le titre de la séance, la date d'exécution (formatée selon la locale via `dateFormatter.js`), la durée totale (quand `finished_at` est renseigné), un **bouton lecture (▶)** pour relancer la séance, et un résumé compact intégré de chaque exercice/combo réalisé, avec les répétitions, le poids et la durée par élément réellement effectués.
+
+Le résumé intégré regroupe les éléments via les fonctions `groupItems()` / `enrichItemsWithTiming()` / `comboRounds()`, définies dans `HomeView`. Le minutage par élément est dérivé des écarts entre `execution_log_item.timestamp` consécutifs, relativement à `execution_log.started_at`.
+
+#### Section historique
+
+Tous les journaux d'exécution sont chargés une seule fois au montage via `getAllWithItems()`, puis filtrés côté client selon la plage de dates active (par défaut : les 30 derniers jours). Le résultat est regroupé par jour calendaire (du plus récent au plus ancien) via une `computed` Vue. Chaque groupe de jour a un en-tête et une carte compacte par séance, elle aussi avec durée, bouton lecture et résumé intégré des éléments.
+
+Deux sélecteurs `<input type="date">` (de / à) permettent d'ajuster la plage de façon interactive, sans aller-retour réseau.
+
+#### Export HTML
+
+Un bouton de la barre d'action (`bi-filetype-html`) ne s'affiche que si au moins un journal d'exécution existe. Cliquer dessus appelle `useHtmlExport.exportHomeAsHtml()`, qui :
+
+1. Récupère `/icon.svg` et l'encode en URI `data:` base64 (`TextEncoder` + `btoa`).
+2. Construit un document HTML entièrement autonome à partir de l'état réactif courant — cartes de statistiques, séances récentes, et historique filtré selon la plage de dates active.
+3. Retire les boutons lecture, les liens de navigation et les sélecteurs de date du résultat (export en lecture seule).
+4. Télécharge le fichier sous le nom `trainus-home-YYYY-MM-DD.html`.
+
+**Fichiers clés :** `src/views/HomeView.vue`, `src/composables/useHtmlExport.js`, `src/db/repositories/executionLogRepository.js`, `src/utils/dateFormatter.js`
+
+---
+
+### 3.7 Mode exécution
+
+**Vue :** `SessionExecuteView` — `#/sessions/:id/execute`
+
+**Composable :** `useSessionExecution`
+
+Le mode exécution déroule une séance exercice par exercice, en enregistrant les répétitions, le poids et le côté réellement effectués.
+
+#### Modèle de file d'exécution
+
+Au lancement de l'exécution, `useSessionExecution` construit une **file linéaire à plat** d'objets « étape » à partir des éléments de la séance :
+
+- Un élément **exercice** → 1 étape
+- Un élément **combo** → `totalRounds × M` étapes, où `totalRounds` dépend du type de combo :
+
+| Type de combo | Signification de `repetitions` | Formule de `totalRounds`                                               |
+| ------------- | ------------------------------ | ---------------------------------------------------------------------- |
+| NONE/TABATA   | Nombre de tours complets       | `repetitions`                                                          |
+| EMOM          | Durée totale (min)             | `floor(repetitions / M)` — chaque exercice = un créneau d'1 min        |
+| AMRAP         | Durée totale (min)             | `1` — un seul passage est mis en file ; l'utilisateur répète librement |
+
+```
+Éléments de séance :
+  1. Exercice A  ×3 reps                     → 1 étape
+  2. Combo « HIIT » ×2 tours (2 exercices)   → 4 étapes (NONE/TABATA)
+       Tour 1 : Pompes ×10, Squat ×15
+       Tour 2 : Pompes ×10, Squat ×15
+  3. Exercice B  ×5 reps                     → 1 étape
+
+File (à plat) :
+  [0] Exercice A
+  [1] Pompes — HIIT, Tour 1/2
+  [2] Squat   — HIIT, Tour 1/2
+      ↓ avance automatique (pas le dernier tour)
+  [3] Pompes — HIIT, Tour 2/2
+  [4] Squat   — HIIT, Tour 2/2
+      ↓ écran de dernier tour : [Continuer →] [+ Un tour de plus]
+  [5] Exercice B
+```
+
+Pour un combo **EMOM** avec 2 exercices et `repetitions = 6` (= durée de 6 minutes) : `totalRounds = floor(6/2) = 3`, ce qui produit 6 étapes d'une minute chacune.
+
+Chaque étape porte : `exerciseId`, `exerciseTitle`, `prefillReps`, `prefillWeight`, `prefillSide`, `comboId?`, `comboTitle?`, `roundNumber?`, `totalRounds?`, `asymmetric`, `alternate`, `isFinalComboStep`, `comboExercises`.
+
+#### Le drapeau `isFinalComboStep`
+
+Mis à `true` uniquement sur le dernier exercice du dernier tour d'un combo. Quand l'utilisateur clique sur **Terminé** sur cette étape, le composable affiche l'écran de dernier tour au lieu d'avancer automatiquement.
+
+#### Logique de pré-remplissage
+
+À l'initialisation, `executionLogRepository.getLastItemsBySession(sessionId)` récupère le `execution_log` le plus récent pour la séance et renvoie une correspondance `exerciseId → {reps_done, weight_used, side}`. Les étapes utilisent cette correspondance pour le pré-remplissage, et retombent sur les valeurs par défaut de l'élément de séance s'il n'existe aucun journal antérieur.
+
+#### « + Un tour de plus »
+
+Quand l'utilisateur clique sur **+ Un tour de plus**, le composable :
+
+1. Récupère les étapes complétées pour le dernier tour en cours (répétitions/poids réellement utilisés)
+2. Insère un nouveau lot d'étapes à `currentIndex + 1` dans la file
+3. Marque `isFinalComboStep = true` sur la dernière nouvelle étape
+4. Avance `currentIndex` jusqu'à la première nouvelle étape
+
+#### Gestion du côté pour les exercices asymétriques
+
+Si `asymmetric = true` et `alternate = true`, le côté change à chaque étape du même exercice. Si `alternate = false`, il change après chaque série complète. La valeur finale du côté est enregistrée dans `execution_log_item.side`.
+
+#### Journal partiel en cas de sortie
+
+Cliquer sur **✕** (sortir) enregistre toutes les étapes **complétées** dans `execution_log` et omet les étapes non terminées. Le journal est marqué avec `finished_at = null` pour indiquer une exécution partielle. Les éléments complétés restent comptabilisés dans les statistiques.
+
+#### Bascule du détail de l'exercice
+
+Le titre de l'exercice dans la carte de l'étape en cours est un bouton à bascule. Cliquer dessus :
+
+1. Déplie un panneau de détail intégré (description rendue en Markdown, images, liens vidéo).
+2. **Met en pause le chronomètre actif** — mais seulement s'il tournait au moment du clic (le drapeau `detailPausedTimer` le retient).
+
+Replier le panneau ne relance le chronomètre que si `detailPausedTimer` est vrai, laissant intacts les chronomètres mis en pause manuellement.
+
+Le panneau de détail est chargé à la demande, au premier dépliage, via `exerciseRepository.getById(step.exerciseId)`. Les bascules suivantes au sein de la même étape réutilisent le `detailExercise` mis en cache. Un `watch(currentStep, …)` réinitialise `showDetail`, `detailExercise` et `detailPausedTimer` à chaque avancée d'étape.
+
+Pour la détection de l'état de connexion (afficher ou non les liens vidéo), `SessionExecuteView` utilise `useOnlineStatus()`. L'extraction de l'ID YouTube utilise l'utilitaire partagé `src/utils/youtube.js` (la même fonction que dans `ExerciseDetailView`).
+
+#### Disposition de l'interface
+
+```
+┌─────────────────────────────────────────┐
+│  Titre de la séance          [✕ sortir] │
+│  ████████████░░░░░  3 / 6 étapes        │
+├─────────────────────────────────────────┤
+│  ▶ MAINTENANT                           │
+│  ┌───────────────────────────────────┐  │
+│  │  Pompes ˅                         │  │  ← le titre est un bouton bascule
+│  │  ┌─────────────────────────────┐  │  │  ← panneau de détail (si déplié)
+│  │  │  Gardez le corps droit…     │  │  │
+│  │  │  [image] [image]            │  │  │
+│  │  └─────────────────────────────┘  │  │
+│  │  Combo : HIIT — Tour 2 sur 2      │  │
+│  │  Reps :   [ 10 ]                  │  │
+│  │  Poids :  [  0 ] kg                │  │
+│  │  Côté :   DROIT ↔                  │  │  ← asymétrique uniquement
+│  │          [ ✓ Terminé ]             │  │
+│  └───────────────────────────────────┘  │
+│  ↓ SUIVANT                              │
+│  Squat — 15 reps  (HIIT, Tour 2)        │
+└─────────────────────────────────────────┘
+```
+
+#### Signaux sonores
+
+`src/composables/useAudioCues.js` fournit deux fonctions construites sur la Web Audio API :
+
+| Fonction          | Fréquence | Durée | Rôle                                            |
+| ----------------- | --------- | ----- | ----------------------------------------------- |
+| `playBip(volume)` | 440 Hz    | 0.1 s | Tic discret — décompte, mi-parcours             |
+| `playBIP(volume)` | 880 Hz    | 0.3 s | Signal fort — changement de phase, fin du temps |
+
+`AudioContext` est créé de façon différée, au premier usage (singleton). Le volume est lu depuis `settings.audio_volume` (0–100) et converti en multiplicateur 0.0–1.0.
+
+La logique des sons vit dans `useSessionExecution` sous forme de trois fonctions privées :
+
+- **`_emomSounds(remaining)`** — déclenche `playBip` à r = 30, 2, 1 (EMOM uniquement).
+- **`_amrapLastMinuteSounds(remaining)`** — déclenche `playBip` à r = 30, 2, 1 (dernière minute de l'AMRAP).
+- **`_tabataCountdown(remaining, totalTime)`** — déclenche `playBip` à `floor(totalTime / 2)`, r = 2, et r = 1.
+
+Logique du minuteur AMRAP dans `_maybeStartAmrapTimer` :
+
+```
+r > 60 :
+  changement de minute écoulée → playBip      (tic par minute)
+  r === round(duration / 2) → playBIP          (signal mi-temps ; prioritaire sur le tic minute)
+r ≤ 60 :
+  _amrapLastMinuteSounds(r)
+r = 0 (expiration) :
+  playBIP                                      (signal de fin de temps)
+```
+
+La séquence **bip, bip, BIP** (r = 2, r = 1, r = 0/expiration) est espacée régulièrement d'une seconde, car `onTick` se déclenche à r = 2 et r = 1, et `onExpire` se déclenche à r = 0 — chacun exactement à un tic de minuteur d'écart.
+
+**Fichiers clés :** `src/views/SessionExecuteView.vue`, `src/composables/useSessionExecution.js`, `src/composables/useAudioCues.js`, `src/db/repositories/executionLogRepository.js`, `src/utils/youtube.js`
+
+---
+
+### 3.8 Statistiques
+
+**Vue :** `StatsView` — `#/stats`
+
+**Composable :** `useStats`
+
+**Bibliothèques :** Chart.js 4 + vue-chartjs 5, enregistrées localement dans `StatsView.vue` (pas globalement, pour éviter des effets de bord sur les autres routes).
+
+#### Filtre de plage de dates
+
+Quatre onglets contrôlent la période affichée : **7j**, **30j** (par défaut), **3m**, **Tout**.
+
+#### Cartes de résumé
+
+| Carte              | Requête                                                                                                                |
+| ------------------ | ---------------------------------------------------------------------------------------------------------------------- |
+| Séances            | Nombre de lignes `execution_log` sur la période                                                                        |
+| Exercices réalisés | Nombre de lignes `execution_log_item` (complétées) sur la période                                                      |
+| Série de jours     | Jours calendaires consécutifs (jusqu'à aujourd'hui) avec au moins un journal ; toujours calculée sur tout l'historique |
+
+La série utilise `setUTCHours(0,0,0,0)` pour comparer les dates et correspondre à l'extraction UTC `DATE(started_at)` de SQLite.
+
+#### Graphiques
+
+| Graphique   | Type   | Métrique                                                                                |
+| ----------- | ------ | --------------------------------------------------------------------------------------- |
+| Fréquence   | Barres | Séances par semaine ou par mois (au choix)                                              |
+| Volume      | Barres | `SUM(reps_done × weight_used)` par exécution de séance                                  |
+| Progression | Ligne  | Répétitions (axe gauche) + poids max (axe droit) au fil du temps pour un exercice donné |
+
+Le volume ne compte que les exercices avec poids (poids > 0). Le graphique de progression ne liste que les exercices ayant au moins un journal d'exécution.
+
+#### Date de création de la base
+
+Affichée en haut sous la forme « Vous utilisez TrainUs depuis le [date] », lue depuis `settings.db_created_at`. Formatée via `dateFormatter.js` et réactive aux changements de langue.
+
+**Fichiers clés :** `src/views/StatsView.vue`, `src/composables/useStats.js`, `src/utils/dateFormatter.js`
+
+---
+
+### 3.9 Import / Export (JSON)
+
+**Composables :** `useJsonExport`, `useJsonImport`
+
+**Composants :** `ImportDialog`, `ExportFilterDialog`, `ModalDialog`
+
+**Utilitaires :** `src/utils/jsonEnvelope.js`
+
+#### Format de l'enveloppe JSON
+
+```json
+{
+  "metadata": {
+    "appName": "trainus",
+    "appVersion": "1.0.0",
+    "schemaVersion": 1,
+    "exportDate": "2026-03-30T12:00:00.000Z",
+    "exportedBy": { "name": "User Name", "uuid": "uuid-string" }
+  },
+  "data": {
+    "exercises": [...],
+    "combos": [...],
+    "sessions": [...],
+    "collections": [...],
+    "executionLogs": [...],
+    "settings": [...]
+  }
+}
+```
+
+Seules les clés présentes dans `data` sont exportées/importées. Les exports d'une seule entité (par exemple, un seul exercice exporté) n'incluent que le tableau de cette entité.
+
+#### Points d'entrée d'export
+
+| Point d'entrée                                    | Portée                                                                                       |
+| ------------------------------------------------- | -------------------------------------------------------------------------------------------- |
+| Vue liste Exercice / Combo / Séance / Collection  | Tous les éléments de ce type d'entité, ou seulement ceux filtrés si une recherche est active |
+| Vue détail Exercice / Combo / Séance / Collection | Un seul élément                                                                              |
+| Réglages → Exporter des données                   | N'importe quelle combinaison de types d'entité (boîte de filtre)                             |
+
+La boîte de filtre affiche des cases à cocher par type d'entité. L'export complet depuis Réglages produit `trainus-full-YYYY-MM-DD.json`.
+
+Les exports depuis une vue liste transmettent la requête de recherche active (le cas échéant) à `exportAllExercises/Combos/Sessions/Collections(query)` dans `useJsonExport.js`, qui utilisent `search()`/`searchWithExercises()`/`searchWithItems()`/`searchWithSessions()` au lieu de `getAll()`/`getAllWithX()` quand une requête est présente.
+
+Les exports de combo/séance/collection (unitaire, liste, ou boîte de filtre) ne contiennent jamais que la ligne de l'entité demandée — `collectComboDependencies`/`collectSessionDependencies`/`collectCollectionDependencies` dans `useJsonExport.js` parcourent les références FK imbriquées (les items d'une séance, les exercices d'un combo, les séances d'une collection) pour récupérer les entités dépendantes complètes et les ajouter comme tableaux `exercises`/`combos`/`sessions` au niveau racine de l'enveloppe. `exportByFilter` enchaîne cette logique collections → séances → combos → exercices afin qu'une sélection partielle des cases à cocher produise quand même un fichier important de façon autonome, sans référence manquante sur un appareil qui n'a pas déjà ces dépendances.
+
+#### Points d'entrée d'import
+
+| Point d'entrée                                   | Notes                                       |
+| ------------------------------------------------ | ------------------------------------------- |
+| Vue liste Exercice / Combo / Séance / Collection | Import par entité, depuis la barre d'action |
+| Réglages → Importer des données                  | Enveloppe multi-entités prise en charge     |
+
+Tous les points d'entrée d'import passent par le même flux généralisé `analyzeAll` / `applyAllImport`, y compris les fichiers d'exercice à entité unique (un flux historique séparé existait autrefois, mais produisait en fait une forme d'analyse identique, et a donc été supprimé).
+
+#### Stratégie de gestion des conflits
+
+| Scénario                                                                              | Comportement                                                                                                                                                |
+| ------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| Même utilisateur (`created_by` = `user_uuid` local), pas de correspondance d'ID/titre | Insertion avec l'ID d'origine                                                                                                                               |
+| Même utilisateur, même ID existant                                                    | Invite : **Remplacer** / **Ignorer** (avec le lot **Remplacer tout** / **Ignorer tout**)                                                                    |
+| Même utilisateur, ID différent mais même titre qu'une ligne existante                 | Même invite Remplacer/Ignorer, résolue contre l'ID de la ligne existante ; Ignorer redirige les références du même lot vers elle                            |
+| Utilisateur différent, UUID inconnu                                                   | Demande un suffixe → enregistré dans la table `suffix`                                                                                                      |
+| Utilisateur différent, même ID + même `created_by`                                    | Mise à jour en place (pas de nouvel ID)                                                                                                                     |
+| Utilisateur différent, même ID + `created_by` différent                               | Génère un nouvel UUID                                                                                                                                       |
+| Utilisateur différent, titre suffixé en conflit avec une ligne existante              | Même invite Remplacer/Ignorer (pas d'étape de renommage séparée) — presque toujours une réimportation d'un élément déjà importé du même utilisateur externe |
+
+**Format de titre pour les imports externes :** `"Titre original [SUFFIXE]"`.
+
+#### Remappage des références entre entités
+
+Quand l'ID d'une entité change pendant l'import (nouvel UUID généré), toutes les entités qui y font référence sont mises à jour :
+
+- `combo_exercise.exercise_id`
+- `session_item.item_id` (pour les exercices et les combos)
+- `collection_session.session_id`
+- `execution_log.session_id`
+- `execution_log_item.exercise_id`
+
+#### Restrictions sur l'import des réglages
+
+Les réglages sont importés avec des exclusions, pour préserver l'identité locale :
+
+| Clé                                                      | Importée ?               |
+| -------------------------------------------------------- | ------------------------ |
+| `user_uuid`                                              | Non — toujours préservée |
+| `app_version`                                            | Non — toujours préservée |
+| `db_created_at`                                          | Non — toujours préservée |
+| `last_backup_at`                                         | Non — toujours préservée |
+| `user_name`, `language`, `theme`, `backup_reminder_days` | Oui                      |
+
+#### Import des journaux d'exécution
+
+Les journaux d'exécution ne sont importés que si la séance référencée existe localement ou a été importée dans le même lot.
+
+#### Flux de la boîte de dialogue d'import
+
+```mermaid
+stateDiagram-v2
+    [*] --> Loading: Fichier sélectionné
+    Loading --> SuffixPrompt: Utilisateur externe détecté
+    Loading --> Preview: Même utilisateur
+    SuffixPrompt --> Preview: Suffixe saisi
+    Preview --> Collisions: Conflits trouvés
+    Preview --> Applying: Aucun conflit
+    Collisions --> Applying: Tous résolus
+    Applying --> Report: Terminé
+    Report --> [*]: Fermé
+```
+
+#### Gestion des suffixes
+
+La page Réglages liste tous les suffixes enregistrés (depuis la table `suffix`). Renommer un suffixe se propage à toutes les colonnes titre/libellé des entités via le `REPLACE()` SQL :
+
+```sql
+UPDATE exercise SET title = REPLACE(title, '[OLD]', '[NEW]') WHERE title LIKE '%[OLD]%'
+```
+
+Appliqué aux tables `exercise`, `combo`, `session` et `collection`.
+
+**Fichiers clés :** `src/composables/useJsonExport.js`, `src/composables/useJsonImport.js`, `src/utils/jsonEnvelope.js`, `src/components/ImportDialog.vue`, `src/components/ExportFilterDialog.vue`, `src/db/repositories/suffixRepository.js`
+
+---
+
+### 3.10 Sauvegarde
+
+**Composable :** `useBackupStatus` (refs singleton au niveau module)
+
+**Composant :** `BackupReminder` (téléporté dans `#actionbar-actions`)
+
+**Utilitaire :** `src/utils/backupFilename.js`
+
+#### Format du nom de fichier
+
+```
+trainus-{version}-backup-YYYYMMDD-HHhMMmSSs.sqlite3
+```
+
+Heure locale, avec des zéros de remplissage. Les lettres `h`, `m`, `s` remplacent les deux-points pour la compatibilité avec le système de fichiers Windows.
+
+#### Clés de réglages
+
+| Clé                    | Défaut                      | Écrite par                                       |
+| ---------------------- | --------------------------- | ------------------------------------------------ |
+| `db_created_at`        | Réglée au premier lancement | `database._initDefaults()`                       |
+| `last_backup_at`       | Absente                     | Succès de téléchargement, succès de restauration |
+| `backup_reminder_days` | `"7"`                       | Champ numérique des Réglages                     |
+
+#### Détection d'ancienneté
+
+```
+effectiveDate = last_backup_at OU db_created_at (repli)
+isStale = (effectiveDate absente) OU (now_utc − effectiveDate) > backup_reminder_days × 86400s
+```
+
+`db_created_at` comme repli donne aux nouveaux utilisateurs une période de grâce égale à l'intervalle de rappel, avant que l'avertissement n'apparaisse.
+
+#### Interface du rappel
+
+`BackupReminder.vue` est monté une seule fois dans `App.vue` (dans la branche « base prête ») et se téléporte dans `#actionbar-actions`. Il affiche un bouton de style avertissement avec l'icône `bi-exclamation-triangle-fill`. Cliquer dessus navigue vers `#/settings` et fait défiler jusqu'à l'ancre `#settings-backup-section`. Le rappel ne peut pas être masqué.
+
+`useBackupStatus` utilise des refs au niveau module, afin que le même état soit partagé entre toutes les instances de composant (pattern singleton).
+
+#### Formatage des dates
+
+`src/utils/dateFormatter.js` fournit deux fonctions pures, sensibles à la locale, utilisées partout dans l'application :
+
+| Fonction                      | Anglais            | Français               |
+| ----------------------------- | ------------------ | ---------------------- |
+| `formatDate(date, lang?)`     | `MM/DD/YYYY`       | `DD/MM/YYYY`           |
+| `formatDateTime(date, lang?)` | `toLocaleString()` | `DD/MM/YYYY, HH:MM:SS` |
+
+Le paramètre optionnel `lang` permet aux propriétés calculées (`computed`) de Vue de passer la ref réactive de langue, pour que l'affichage des dates se mette à jour immédiatement lors d'un changement de langue.
+
+**Fichiers clés :** `src/composables/useBackupStatus.js`, `src/components/BackupReminder.vue`, `src/utils/backupFilename.js`, `src/utils/dateFormatter.js`
+
+---
+
+### 3.11 PWA
+
+**Plugin :** `vite-plugin-pwa` + Workbox
+
+#### Service worker
+
+| Configuration                   | Valeur       | Justification                                                 |
+| ------------------------------- | ------------ | ------------------------------------------------------------- |
+| `registerType`                  | `autoUpdate` | Active silencieusement le nouveau SW à la navigation suivante |
+| `maximumFileSizeToCacheInBytes` | 10 Mo        | Couvre `sqlite3.wasm` (~8 Mo)                                 |
+| `manifest`                      | `false`      | Conserve le `public/manifest.json` écrit à la main            |
+
+Workbox gère la précache, basée sur le hash du contenu, de toute la coquille de l'application au moment de l'installation, ce qui permet un support hors ligne complet. Le binaire WASM est inclus dans le manifeste de précache grâce à la limite de 10 Mo.
+
+#### Manifeste de l'application
+
+`public/manifest.json` déclare `name`, `short_name`, `display: standalone`, `theme_color`, `background_color`, et deux icônes (192×192 et 512×512) avec les usages `maskable` et `any`.
+
+#### Invite d'installation
+
+`useInstallPrompt.js` capture l'événement `beforeinstallprompt` au chargement du module (ref singleton `canInstall`). `InstallPrompt.vue` téléporte un bouton d'icône de téléchargement dans la barre d'action quand `canInstall` est vrai. L'invite peut être ignorée pour la session (pas besoin de persistance).
+
+#### Accessibilité
+
+Ajouts ARIA appliqués dans toute l'application :
+
+- `aria-label` sur tous les boutons icône-seule de la barre d'action, sur toutes les vues
+- `role="progressbar"` + `aria-valuenow/min/max` sur la barre de progression d'exécution
+- `role="alert"` + `aria-describedby` sur les messages d'erreur de formulaire
+- `required` / `aria-required` sur les champs requis
+- `role="dialog"` + `aria-modal` + `aria-labelledby` + focus au montage + touche Échap sur `ModalDialog`
+
+**Fichiers clés :** `vite.config.js`, `public/manifest.json`, `src/composables/useInstallPrompt.js`, `src/components/InstallPrompt.vue`
+
+---
+
+### 3.12 Invite de nom de fichier à la sauvegarde
+
+Chaque fichier enregistré sur disque (exports JSON, export HTML de l'accueil, sauvegarde SQLite — y compris la sauvegarde forcée avant migration) demande un nom de fichier, plutôt que de se télécharger silencieusement sous un nom généré automatiquement.
+
+**Composable :** `useSaveFilePrompt` (singleton au niveau module, même pattern que `useBackupStatus`). `promptFilename(defaultFilename)` découpe le nom par défaut en radical + extension au niveau du dernier point, le stocke dans la ref singleton `pendingSave`, et renvoie une `Promise<string|null>` résolue une fois la boîte de dialogue fermée (`null` en cas d'annulation).
+
+**Composant :** `SaveFileDialog.vue`, monté une seule fois à la racine de `App.vue`, pour être disponible quelle que soit la vue (ou l'écran de migration bloquant) qui déclenche une sauvegarde. Affiche un champ radical modifiable (pré-rempli, texte sélectionné) à côté d'une extension fixe en lecture seule. Entrée valide ; un radical vide retombe sur la valeur par défaut.
+
+Les trois fonctions de téléchargement de bas niveau (`downloadJson` dans `jsonEnvelope.js`, `downloadBackup` dans `useBackupDownload.js`, la fonction locale `downloadHtml` dans `useHtmlExport.js`) appellent `promptFilename()` avant de construire le blob/lien, et ne font rien si l'utilisateur annule — aucun autre point d'appel n'a changé. Pour les sauvegardes en particulier, `markBackedUp()` (et, sur l'écran de migration, l'activation du bouton Mettre à jour) ne s'exécute que si la sauvegarde n'a pas été annulée.
+
+**Fichiers clés :** `src/composables/useSaveFilePrompt.js`, `src/components/SaveFileDialog.vue`, `src/utils/jsonEnvelope.js`, `src/composables/useBackupDownload.js`, `src/composables/useHtmlExport.js`, `src/App.vue`
+
+---
+
+## 4. Routage
+
+Toutes les routes utilisent le mode hash (`createWebHashHistory`). Le chemin racine `/` redirige vers `/home`.
+
+| Route                    | Vue                    | Notes                     |
+| ------------------------ | ---------------------- | ------------------------- |
+| `#/home`                 | `HomeView`             | Aperçu de l'activité      |
+| `#/exercises`            | `ExerciseListView`     | Liste + recherche         |
+| `#/exercises/new`        | `ExerciseFormView`     | Mode création             |
+| `#/exercises/:id`        | `ExerciseDetailView`   | Lecture seule             |
+| `#/exercises/:id/edit`   | `ExerciseFormView`     | Mode édition              |
+| `#/combos`               | `ComboListView`        | Liste + recherche         |
+| `#/combos/new`           | `ComboFormView`        | Mode création             |
+| `#/combos/:id`           | `ComboDetailView`      | Lecture seule             |
+| `#/combos/:id/edit`      | `ComboFormView`        | Mode édition              |
+| `#/sessions`             | `SessionListView`      | Liste + recherche         |
+| `#/sessions/new`         | `SessionFormView`      | Mode création             |
+| `#/sessions/:id`         | `SessionDetailView`    | Lecture seule             |
+| `#/sessions/:id/edit`    | `SessionFormView`      | Mode édition              |
+| `#/sessions/:id/execute` | `SessionExecuteView`   | Mode exécution            |
+| `#/collections`          | `CollectionsView`      | Liste + recherche         |
+| `#/collections/new`      | `CollectionFormView`   | Mode création             |
+| `#/collections/:id`      | `CollectionDetailView` | Lecture seule             |
+| `#/collections/:id/edit` | `CollectionFormView`   | Mode édition              |
+| `#/stats`                | `StatsView`            | Statistiques + graphiques |
+| `#/settings`             | `SettingsView`         | Réglages utilisateur      |
+
+`navKeyMap` dans `App.vue` fait correspondre les sous-routes (par exemple `exercise-detail`, `exercise-edit`) à leur clé de navigation de premier niveau (`exercises`), pour que l'élément du menu reste mis en évidence lorsque l'utilisateur navigue vers une vue détail/édition.
+
+---
+
+## 5. Internationalisation
+
+**Bibliothèques :** `i18next` + `i18next-vue`
+
+**Fichiers de locale :** `src/i18n/locales/en.json` (anglais, par défaut), `src/i18n/locales/fr.json` (français), `src/i18n/locales/da.json` (danois)
+
+**Initialisation :** `src/i18n/index.js` enregistre les trois locales et fixe l'anglais comme langue par défaut. Le composable `useTranslation()` de `i18next-vue` est utilisé dans tous les composants — aucun appel direct à i18next dans les templates.
+
+**Démarrage :** `src/main.js` appelle `i18next.changeLanguage(stored_language)` avant le premier rendu, pour que l'interface s'ouvre toujours dans la langue persistée de l'utilisateur.
+
+**Changement de langue :** le sélecteur de langue des Réglages appelle `i18next.changeLanguage()` et enregistre la nouvelle valeur dans `settings.language`. Tous les appels réactifs `t()` se mettent à jour immédiatement.
+
+**Formatage des dates :** `dateFormatter.js` lit `i18next.language` comme repli, mais accepte un paramètre `lang` explicite pour permettre un affichage réactif des dates dans les propriétés calculées Vue.
+
+Voir [Guides pratiques → Ajouter une nouvelle langue]({{< relref "how-to-guides.fr.md" >}}#ajouter-une-nouvelle-langue) pour ajouter le support d'une langue supplémentaire.
+
+---
+
+## 6. Versionnement
+
+### Version de l'application
+
+Issue de `package.json`, injectée par Vite sous la forme `__APP_VERSION__` (une constante globale de type chaîne). Disponible au build (nom du cache du SW) et à l'exécution (métadonnées d'export, table settings, noms de fichiers de sauvegarde). Elle est purement informative — elle ne joue aucun rôle dans l'emplacement des données ni dans les décisions de migration.
+
+### Nommage du fichier de base de données
+
+La base de données OPFS vit à un emplacement stable, indépendant de la version : dossier `.trainus`, fichier `trainus.db`. OPFS est scopé par _origine_, donc les données survivent automatiquement aux mises à jour de l'application ; les changements de schéma sont gérés par le système de migration au démarrage (§2 Système de migration), pas par un déplacement des données.
+
+> Note historique : avant l'étape 16, le dossier s'appelait `.trainus-{appVersion}`, abandonnant les données à chaque release. Les anciens dossiers versionnés des machines de développement sont simplement laissés à l'abandon (à nettoyer via les outils de développement du navigateur si besoin).
+
+### Version de schéma
+
+`SCHEMA_VERSION` dans `src/db/schema.js` est un entier stocké dans la table `schema_version`. Il pilote à la fois la vérification de migration au démarrage et la vérification de compatibilité de Restaurer la base de données.
+
+**Règle :** `SCHEMA_VERSION` n'est incrémenté que lorsqu'un changement de schéma est déployé auprès des utilisateurs. Les changements en place avant la première publication (ajouter des colonnes directement dans `SCHEMA_SQL`) ne nécessitent pas d'augmentation.
+
+### Registre des releases
+
+`src/db/releases.js` exporte un tableau `RELEASES` — la source de vérité unique pour l'historique du schéma. Chaque entrée déclare `{ schemaVersion, appVersion, dbBreak, migrationScript }`, où `migrationScript` est le SQL qui amène une base existante de `schemaVersion - 1` à `schemaVersion` (ou `null` pour une migration no-op quand `dbBreak` est faux). Chaque augmentation de `SCHEMA_VERSION` doit s'accompagner d'exactement une entrée `RELEASES`.
+
+Deux consommateurs partagent ce registre :
+
+- `getMigrationScripts(from, to)` — scripts ordonnés pour la migration au démarrage.
+- `checkCompatibility(imported, current)` — flux de Restaurer la base de données.
+
+---
+
+## 7. Commandes de build
+
+```bash
+npm install
+npm run dev              # Serveur de développement Vite sur http://localhost:5173
+npm run build             # Build de production dans dist/
+npm run preview           # Prévisualiser la build de production en local
+npm run format            # Formate tous les fichiers avec Prettier
+npm run format:check      # Vérification CI (code de sortie non nul en cas de différence)
+```
+
+Les en-têtes COOP/COEP sont injectés automatiquement par `vite.config.js` pour le serveur de développement. Voir [Guides pratiques → Déployer TrainUs]({{< relref "how-to-guides.fr.md" >}}#déployer-trainus) pour le déploiement en production.
+
+Voir `tests/README.md` pour la configuration complète des tests et les instructions d'exécution.
+
+---
+
+## 8. Annexes
+
+### Annexe A — Largeur de contenu limitée sur les vues liste/détail
+
+Sur les grands écrans de bureau (par exemple 1920×1080), les pages de contenu n'occupent pas toute la largeur disponible. Les cartes s'arrêtent à environ 800px.
+
+| Vue                                                  | Limite |
+| ---------------------------------------------------- | ------ |
+| Vues liste (exercices, combos, séances, collections) | 800 px |
+| Vues détail                                          | 800 px |
+| Vues formulaire                                      | 600 px |
+| Vue réglages                                         | 600 px |
+
+La limite est implémentée par vue (pas globalement) afin que chaque écran puisse opter pour une largeur de lecture différente.
+
+#### Pour ajouter une mise en page multi-colonnes sur grand écran
+
+1. Augmentez la limite des vues liste à `1200px` (ou supprimez-la) et remplacez la pile verticale par une grille CSS avec `grid-template-columns: repeat(auto-fill, minmax(320px, 1fr))`.
+2. Conservez les vues détail et réglages à leurs limites actuelles.
+3. N'enveloppez que les cartes dans un `<div class="grid-wrapper">` interne, pour éviter de redessiner la barre d'action et les messages d'état vide.
+4. Appliquez le même pattern à toutes les vues liste, par cohérence.
diff --git a/website/content/developers/understanding-the-architecture.en.md b/website/content/developers/understanding-the-architecture.en.md
new file mode 100644
index 0000000..ddffc2f
--- /dev/null
+++ b/website/content/developers/understanding-the-architecture.en.md
@@ -0,0 +1,60 @@
+---
+title: 'Understanding the Architecture'
+description: "The why behind TrainUs's technical choices: local-first, the Worker thread, the migration system, and a few notable feature decisions."
+slug: 'understanding-the-architecture'
+weight: 4
+date: 2026-06-16
+---
+
+> This page explains _why_ TrainUs is built the way it is. For the facts — schema, routes, exact fields — see [Reference]({{< relref "technical.en.md" >}}).
+
+## Why No Backend?
+
+Many fitness apps run on an account and a central server. TrainUs makes the opposite choice: it's a Progressive Web Application that runs entirely in the browser, with all data stored locally via SQLite WASM and OPFS. There's no server to operate, no account system to build and secure, and the app keeps working — fully — with no network connection at all.
+
+The trade-off is the same one described for users in the [user-facing explanation]({{< relref "comprendre.en.md" >}}): no built-in cross-device sync, no cloud backup. For a contributor, the practical consequence is that there's no API layer to design or maintain — every feature is, by construction, a local read/write against the repositories in `src/db/repositories/`.
+
+## Why SQLite Runs in a Web Worker
+
+OPFS's synchronous file-access APIs (`FileSystemSyncAccessHandle`) are only available inside a Worker — they don't exist on the main thread. So `worker.js` owns the actual SQLite connection, and `database.js` on the main thread talks to it exclusively through `postMessage()`, wrapped in Promises keyed by a reply ID (see the diagram in [Reference §1]({{< relref "technical.en.md" >}}#main-thread--worker-architecture)).
+
+This also means every repository call is inherently async, even for trivial reads — there's no synchronous "just query the DB" escape hatch from a Vue component. Composables exist specifically to absorb that asynchrony behind a reactive `ref` interface so components don't each reinvent loading/error state.
+
+## Why the `opfs-sahpool` VFS — and No Fallback
+
+Of the OPFS VFS options SQLite WASM offers, `opfs-sahpool` was chosen because it gives synchronous I/O without requiring `SharedArrayBuffer`, which means it doesn't need COOP/COEP headers either (the alternative non-SAH OPFS VFS does). The dev server still sets them anyway, as a precaution — see [How-to Guides → Deploy TrainUs]({{< relref "how-to-guides.en.md" >}}#deploy-trainus) for the headers themselves.
+
+There's deliberately no in-memory fallback when OPFS is unavailable (old browser, private browsing). A silent fallback would mean the app _looks_ like it's saving the user's training data when it actually isn't — a fresh, empty database every reload, no warning. A clear, full-screen error was judged better than that kind of silent data loss.
+
+## Why the Migration System Is Built This Way
+
+The startup migration flow (full state machine in [Reference §2]({{< relref "technical.en.md" >}}#migration-system)) has a few properties that aren't obvious from the flowchart alone:
+
+- **The user must download a backup before the Update button is even enabled.** Schema migrations run unattended SQL against real user data; if a migration script has a bug, the safety net needs to already be in the user's hands before the risky step runs, not offered as an afterthought.
+- **Each migration runs in a transaction with its `schema_version` stamp.** A failure rolls back to a fully consistent previous state — the database is never left half-migrated. Combined with the forced backup, a failed migration is recoverable two ways: the DB still works at the old version, and the user holds an export anyway.
+- **A database newer than the running app (`dbVersion > SCHEMA_VERSION`) fails safe** with a blocking error instead of attempting anything. This catches the case of someone reverting to an older app build against data already migrated forward — guessing how to handle that would be far riskier than just stopping.
+- **The same `RELEASES` registry and `migrationScript` artifacts drive both the startup migration and the Restore Database adaptation path.** Restore already needed to solve "bring an older backup up to the current schema"; reusing that mechanism for the routine update path avoided building (and maintaining) two separate migration engines.
+
+This is also why `SCHEMA_VERSION` bumps are treated as a deliberate, ask-first decision (see [How-to Guides → Add a Database Migration]({{< relref "how-to-guides.en.md" >}}#add-a-database-migration)) rather than something to reach for casually: every bump obligates a tested migration script and a permanent `RELEASES` entry, forever.
+
+## A Few Notable Feature Design Decisions
+
+### Save dialog instead of the native file picker
+
+Every disk save (JSON exports, the SQLite backup, the HTML export) goes through a custom `SaveFileDialog.vue` prompting for a filename, rather than the browser's native `showSaveFilePicker()`. The native API was rejected specifically because it has no Firefox support, and Firefox is this project's primary test target — see [Reference §3.12]({{< relref "technical.en.md" >}}#312-save-filename-prompt) for how the dialog is wired into the three existing download call sites.
+
+### Partial execution logs on exit
+
+Exiting a session mid-way saves whatever steps were already completed, with `finished_at = null` marking it a partial run, rather than discarding the whole session or forcing the user to finish. Training sessions get interrupted in real life (phone call, equipment taken, time runs out) — losing a recorded warm-up because the rest didn't happen would make the statistics less trustworthy, not more.
+
+### Two different asymmetric side-flip strategies
+
+Asymmetric exercises support flipping sides either after every rep (`alternate: true`) or after a full set (`alternate: false`) — see [Reference §3.7]({{< relref "technical.en.md" >}}#asymmetric-exercise-side-handling). Both are real training patterns (alternating lunges vs. one-arm-at-a-time rows), so the choice was left as a per-exercise setting rather than picking one behavior for everyone.
+
+### Why EMOM, AMRAP, and TABATA each compute rounds differently
+
+The three timed combo types repurpose the same `repetitions` field on a session item for different meanings (full rounds for NONE/TABATA, total minutes for EMOM/AMRAP — see [Reference §3.7]({{< relref "technical.en.md" >}}#execution-queue-model)) instead of adding a separate field per type. This keeps the data model and the form UI uniform across combo types, at the cost of the field needing a type-dependent label ("Repetitions" vs. "Duration (min)") in the UI — a worthwhile trade since it avoids three parallel near-identical sets of fields.
+
+## Why the Content Width Cap Is Deliberate
+
+List, detail, form, and settings views all cap their content width well short of the viewport on wide desktop screens (see [Reference Annex A]({{< relref "technical.en.md" >}}#annex-a--content-width-cap-on-listdetail-views)) — this is a readability choice, not an oversight. A workout card or form stretched across a 1920px display would force the eye to travel further than it needs to for what is, fundamentally, short list content. The cap is applied per-view rather than globally so a future multi-column grid layout (see the recipe in that same annex) can be introduced gradually, one view at a time, without touching the others.
diff --git a/website/content/developers/understanding-the-architecture.fr.md b/website/content/developers/understanding-the-architecture.fr.md
new file mode 100644
index 0000000..abff372
--- /dev/null
+++ b/website/content/developers/understanding-the-architecture.fr.md
@@ -0,0 +1,60 @@
+---
+title: "Comprendre l'architecture"
+description: 'Le pourquoi des choix techniques de TrainUs : local-first, le thread Worker, le système de migration, et quelques décisions de conception notables.'
+slug: 'comprendre-l-architecture'
+weight: 4
+date: 2026-06-16
+---
+
+> Cette page explique _pourquoi_ TrainUs est construit ainsi. Pour les faits — schéma, routes, champs exacts — voir la [Référence]({{< relref "technical.fr.md" >}}).
+
+## Pourquoi pas de serveur ?
+
+Beaucoup d'applications de fitness fonctionnent avec un compte et un serveur central. TrainUs fait le choix inverse : c'est une Progressive Web Application qui tourne entièrement dans le navigateur, avec toutes les données stockées localement via SQLite WASM et OPFS. Il n'y a aucun serveur à exploiter, aucun système de comptes à concevoir et sécuriser, et l'application continue de fonctionner — intégralement — sans aucune connexion réseau.
+
+La contrepartie est la même que celle décrite côté utilisateur dans [Comprendre TrainUs]({{< relref "comprendre.fr.md" >}}) : pas de synchronisation automatique entre appareils, pas de sauvegarde dans le cloud. Pour un contributeur, la conséquence pratique est qu'il n'y a aucune couche API à concevoir ni à maintenir — chaque fonctionnalité est, par construction, une lecture/écriture locale contre les repositories de `src/db/repositories/`.
+
+## Pourquoi SQLite tourne dans un Web Worker
+
+Les API d'accès synchrone aux fichiers d'OPFS (`FileSystemSyncAccessHandle`) ne sont disponibles que dans un Worker — elles n'existent pas sur le thread principal. C'est donc `worker.js` qui possède la connexion SQLite proprement dite, et `database.js`, sur le thread principal, communique avec lui exclusivement via `postMessage()`, enveloppé dans des Promises identifiées par un ID de réponse (voir le diagramme dans la [Référence §1]({{< relref "technical.fr.md" >}}#1-architecture)).
+
+Cela signifie aussi que chaque appel à un repository est intrinsèquement asynchrone, même pour une lecture triviale — il n'y a pas d'échappatoire synchrone du type « interroger directement la base ». Les composables existent précisément pour absorber cette asynchronicité derrière une interface réactive en `ref`, afin que chaque composant n'ait pas à réinventer sa propre gestion du chargement et des erreurs.
+
+## Pourquoi le VFS `opfs-sahpool` — et pas de repli
+
+Parmi les options de VFS OPFS proposées par SQLite WASM, `opfs-sahpool` a été choisi parce qu'il offre des entrées/sorties synchrones sans nécessiter de `SharedArrayBuffer`, ce qui veut dire qu'il n'a pas non plus besoin des en-têtes COOP/COEP (contrairement à l'autre VFS OPFS, non-SAH). Le serveur de développement les pose tout de même, par précaution — voir [Guides pratiques → Déployer TrainUs]({{< relref "how-to-guides.fr.md" >}}#déployer-trainus) pour les en-têtes eux-mêmes.
+
+Il n'y a délibérément aucun repli en mémoire quand OPFS n'est pas disponible (navigateur ancien, navigation privée). Un repli silencieux donnerait l'impression que l'application enregistre bien les données d'entraînement alors que ce n'est pas le cas — une base vide à chaque rechargement, sans aucun avertissement. Une erreur claire en plein écran a été jugée préférable à ce genre de perte de données silencieuse.
+
+## Pourquoi le système de migration est construit ainsi
+
+Le flux de migration au démarrage (machine à états complète dans la [Référence §2]({{< relref "technical.fr.md" >}}#2-couche-base-de-données)) a quelques propriétés qui ne sont pas évidentes à la seule lecture du diagramme de flux :
+
+- **L'utilisateur doit télécharger une sauvegarde avant même que le bouton Mettre à jour soit activé.** Les migrations de schéma exécutent du SQL sans surveillance sur de vraies données utilisateur ; si un script de migration a un bug, le filet de sécurité doit déjà être entre les mains de l'utilisateur avant que l'étape risquée ne s'exécute, pas proposé après coup.
+- **Chaque migration s'exécute dans une transaction avec son estampillage `schema_version`.** Un échec revient à un état précédent parfaitement cohérent — la base n'est jamais laissée à moitié migrée. Combiné à la sauvegarde forcée, une migration échouée est récupérable de deux façons : la base fonctionne toujours à l'ancienne version, et l'utilisateur dispose de toute façon d'un export.
+- **Une base de données plus récente que l'application en cours d'exécution (`dbVersion > SCHEMA_VERSION`) échoue de façon sécurisée** avec une erreur bloquante plutôt que de tenter quoi que ce soit. Cela couvre le cas de quelqu'un revenant à une version plus ancienne de l'application alors que les données ont déjà été migrées en avant — deviner comment gérer ce cas serait bien plus risqué que de simplement s'arrêter.
+- **Le même registre `RELEASES` et les mêmes scripts `migrationScript` pilotent à la fois la migration au démarrage et l'adaptation de Restaurer la base de données.** La restauration devait déjà résoudre « amener une sauvegarde plus ancienne au schéma actuel » ; réutiliser ce mécanisme pour le chemin de mise à jour courant a évité de construire (et de maintenir) deux moteurs de migration séparés.
+
+C'est aussi pourquoi les augmentations de `SCHEMA_VERSION` sont traitées comme une décision délibérée, à valider avant d'agir (voir [Guides pratiques → Ajouter une migration de base de données]({{< relref "how-to-guides.fr.md" >}}#ajouter-une-migration-de-base-de-données)) plutôt que comme quelque chose à utiliser à la légère : chaque augmentation engage un script de migration testé et une entrée `RELEASES` permanente, pour toujours.
+
+## Quelques décisions de conception notables
+
+### Une boîte de dialogue de sauvegarde plutôt que le sélecteur natif
+
+Chaque enregistrement sur disque (exports JSON, sauvegarde SQLite, export HTML) passe par une `SaveFileDialog.vue` personnalisée qui demande un nom de fichier, plutôt que par l'API native `showSaveFilePicker()` du navigateur. L'API native a été rejetée précisément parce qu'elle n'est pas supportée par Firefox, qui est le navigateur de test principal du projet — voir la [Référence §3.12]({{< relref "technical.fr.md" >}}#312-invite-de-nom-de-fichier-à-la-sauvegarde) pour la façon dont la boîte de dialogue est branchée sur les trois points d'entrée de téléchargement existants.
+
+### Journaux d'exécution partiels en cas de sortie anticipée
+
+Quitter une séance en cours en sauvegarde les étapes déjà complétées, avec `finished_at = null` pour marquer une exécution partielle, plutôt que d'abandonner toute la séance ou de forcer l'utilisateur à la terminer. Les séances d'entraînement sont interrompues dans la vraie vie (coup de téléphone, matériel pris par quelqu'un d'autre, temps écoulé) — perdre un échauffement déjà enregistré parce que le reste n'a pas eu lieu rendrait les statistiques moins fiables, pas plus.
+
+### Deux stratégies différentes pour les exercices asymétriques
+
+Les exercices asymétriques permettent d'alterner le côté soit après chaque répétition (`alternate: true`), soit après une série complète (`alternate: false`) — voir [Référence §3.7]({{< relref "technical.fr.md" >}}#gestion-du-côté-pour-les-exercices-asymétriques). Les deux sont des pratiques d'entraînement réelles (fentes alternées vs. rangées un bras à la fois), donc le choix a été laissé en réglage par exercice plutôt que d'en imposer un seul à tout le monde.
+
+### Pourquoi EMOM, AMRAP et TABATA calculent chacun les tours différemment
+
+Les trois types de combo minutés réutilisent le même champ `repetitions` d'un élément de séance avec des significations différentes (tours complets pour NONE/TABATA, durée totale en minutes pour EMOM/AMRAP — voir [Référence §3.7]({{< relref "technical.fr.md" >}}#modèle-de-file-dexécution)) plutôt que d'ajouter un champ séparé par type. Cela garde le modèle de données et le formulaire uniformes entre les types de combo, au prix d'un libellé dépendant du type dans l'interface (« Répétitions » vs. « Durée (min) ») — un compromis qui en vaut la peine puisqu'il évite trois jeux de champs quasi identiques en parallèle.
+
+## Pourquoi la largeur de contenu est volontairement limitée
+
+Les vues liste, détail, formulaire et réglages limitent toutes la largeur de leur contenu bien en deçà de la largeur de l'écran sur les grands écrans de bureau (voir [Référence, Annexe A]({{< relref "technical.fr.md" >}}#annexe-a--largeur-de-contenu-limitée-sur-les-vues-listedétail)) — c'est un choix de lisibilité, pas un oubli. Une carte de séance ou un formulaire étiré sur un écran de 1920px forcerait l'œil à parcourir plus de distance que nécessaire pour ce qui est, fondamentalement, un contenu de liste assez court. La limite est appliquée par vue plutôt que globalement, pour qu'une future mise en page multi-colonnes (voir la recette dans cette même annexe) puisse être introduite progressivement, vue par vue, sans toucher aux autres.
diff --git a/website/content/docs/_index.en.md b/website/content/docs/_index.en.md
new file mode 100644
index 0000000..8158212
--- /dev/null
+++ b/website/content/docs/_index.en.md
@@ -0,0 +1,4 @@
+---
+title: 'Documentation'
+description: 'User guide for TrainUs — a local-first, bilingual fitness PWA.'
+---
diff --git a/website/content/docs/_index.fr.md b/website/content/docs/_index.fr.md
new file mode 100644
index 0000000..11978c8
--- /dev/null
+++ b/website/content/docs/_index.fr.md
@@ -0,0 +1,4 @@
+---
+title: 'Documentation'
+description: 'Guide utilisateur de TrainUs — une application fitness PWA locale et bilingue.'
+---
diff --git a/website/content/docs/comprendre.en.md b/website/content/docs/comprendre.en.md
new file mode 100644
index 0000000..ef07e95
--- /dev/null
+++ b/website/content/docs/comprendre.en.md
@@ -0,0 +1,55 @@
+---
+title: 'Understanding TrainUs'
+description: "The why behind the app's choices: local-first, JSON vs database, timers."
+slug: 'understanding-trainus'
+weight: 4
+date: 2026-06-16
+---
+
+## Why a Local App?
+
+Many fitness apps run on an account and a central server: convenient for syncing your devices, but it also means a third-party company hosts your data, and the app becomes unusable without a connection — or if the service shuts down one day.
+
+TrainUs makes the opposite choice: everything runs in your browser, your data is stored locally, and nothing is ever sent to a server. This choice has a cost — no automatic sync or backup between devices — but that cost is covered by simple, manual solutions: see the [How-to Guides]({{< relref "guides-pratiques.en.md" >}}) for backup and sync.
+
+## JSON or Database: Which to Choose?
+
+Two ways to export your data, for two different needs:
+
+|             | JSON export                                                  | Database export (SQLite)                 |
+| ----------- | ------------------------------------------------------------ | ---------------------------------------- |
+| Content     | One or more chosen data types (exercises, sessions...)       | Everything, no exceptions                |
+| Typical use | Share a session, back up a subset                            | Full backup, migration to another device |
+| On import   | Merge: conflicts resolved one by one, suffix if another user | Total replacement of existing data       |
+| File format | Text file, readable, editable with care                      | Binary file, never edit by hand          |
+
+Concretely: a **JSON** file is a plain text file describing your exercises, combos, sessions, or collections in a structured, readable format. A **SQLite** file (`.sqlite3` / `.db`) contains the app's entire database; it can be opened with a specialized tool (DB Browser for SQLite, for example) but should never be edited by hand.
+
+There's a third way to get data out of the app: the HTML export of the home page (see [How-to Guides]({{< relref "guides-pratiques.en.md" >}})). It's also a data export, even though the format differs — except it's one-way: an HTML file can't be re-imported into TrainUs. It isn't meant for backup but for reading by someone else, typically a friend or a coach.
+
+## What Really Happens on Import
+
+Importing a JSON file never deletes your existing data by surprise:
+
+- If it comes from **you** (same user ID): TrainUs compares it with what you already have. For each item that already exists (same ID, or same title if it's a different item), you choose to replace it or keep it, one by one or in bulk.
+- If it comes from **another user**: every imported title gets a short suffix you choose ("[JD]"), so it never gets confused with your own data. The suffix is remembered and reused if you import again from the same person. If the suffixed title conflicts with something already imported earlier (typically a new version of the same item, re-exported by the same person), you choose to replace it or keep it, exactly as with your own data.
+
+Either way, a summary screen shows what will change before anything is applied.
+
+By contrast, **restoring a database** (a `.sqlite3` file) replaces everything, with no possible merge — that's intentional: this mechanism is designed for full backup and restore, not selective sharing.
+
+## How the Timers Work (EMOM / AMRAP / TABATA)
+
+The three timed combo types each follow their own logic:
+
+- **EMOM** (_Every Minute On the Minute_): a new exercise starts every minute. The duration you set is divided by the number of exercises in the combo to work out how many rounds to run — each exercise occupies a 60-second slot.
+- **AMRAP** (_As Many Rounds As Possible_): a single countdown runs for the whole set duration; you cycle through the exercises in a loop, doing as many rounds as possible.
+- **TABATA**: a strict alternation of work and rest phases, repeated a given number of times.
+
+In all three cases, two different sounds guide you without having to watch the screen: a soft beep for intermediate cues, a louder BEEP for phase changes or time running out. For the minute-by-minute detail, see the [Audio Cues]({{< relref "user-guide.en.md" >}}#audio-cues) section of the Reference.
+
+Advancing between exercises or rounds is automatic for all three types — you don't have to confirm anything yourself while the timer is running.
+
+## What About the Statistics?
+
+To be honest, the Statistics screen is the one the app's author has the least personal feedback on — he doesn't use it himself day to day. The current charts (frequency, volume, per-exercise progression) are a reasonable starting point, but if something is missing for you, it's probably true for others too — your feedback is welcome.
diff --git a/website/content/docs/comprendre.fr.md b/website/content/docs/comprendre.fr.md
new file mode 100644
index 0000000..a2a7d11
--- /dev/null
+++ b/website/content/docs/comprendre.fr.md
@@ -0,0 +1,54 @@
+---
+title: 'Comprendre TrainUs'
+description: "Le pourquoi derrière les choix de l'application : local-first, JSON vs base de données, minuteries."
+weight: 4
+date: 2026-06-14
+---
+
+## Pourquoi une application locale ?
+
+Beaucoup d'applications de fitness fonctionnent avec un compte et un serveur central : c'est pratique pour synchroniser vos appareils, mais cela veut aussi dire qu'une société tierce héberge vos données, et que l'application devient inutilisable sans connexion — ou si le service ferme un jour.
+
+TrainUs fait le choix inverse : tout tourne dans votre navigateur, vos données sont stockées localement, et rien n'est jamais envoyé à un serveur. Ce choix a un coût — pas de synchronisation ni de sauvegarde automatiques entre appareils — mais ce coût est couvert par des solutions simples et manuelles : voir les [Guides pratiques]({{< relref "guides-pratiques.fr.md" >}}) pour la sauvegarde et la synchronisation.
+
+## JSON ou base de données : que choisir ?
+
+Deux façons d'exporter vos données, pour deux besoins différents :
+
+|                   | Export JSON                                                       | Export base de données (SQLite)                       |
+| ----------------- | ----------------------------------------------------------------- | ----------------------------------------------------- |
+| Contenu           | Un ou plusieurs types de données au choix (exercices, séances...) | Tout, sans exception                                  |
+| Usage typique     | Partager une séance, sauvegarder un sous-ensemble                 | Sauvegarde complète, migration vers un autre appareil |
+| À l'import        | Fusion : conflits gérés un par un, suffixe si autre utilisateur   | Remplacement total des données existantes             |
+| Format du fichier | Fichier texte, lisible, modifiable avec précaution                | Fichier binaire, à ne jamais modifier à la main       |
+
+Concrètement : un fichier **JSON** est un simple fichier texte qui décrit vos exercices, combos, séances ou collections dans un format structuré et lisible. Un fichier **SQLite** (`.sqlite3` / `.db`) contient la base de données complète de l'application ; il peut être ouvert avec un outil spécialisé (DB Browser for SQLite, par exemple) mais ne doit jamais être édité à la main.
+
+Il existe une troisième façon de faire sortir des données de l'application : l'export HTML de la page d'accueil (voir [Guides pratiques]({{< relref "guides-pratiques.fr.md" >}})). C'est aussi un export de données, même si le format est différent — sauf qu'il est à sens unique : un fichier HTML ne se réimporte pas dans TrainUs. Il n'est pas fait pour la sauvegarde mais pour la lecture par quelqu'un d'autre, typiquement un ami ou un coach.
+
+## Ce qu'il se passe vraiment à l'import
+
+Importer un fichier JSON ne supprime jamais vos données existantes par surprise :
+
+- S'il vient de **vous** (même identifiant utilisateur) : TrainUs compare avec ce que vous avez déjà. Pour chaque élément déjà présent (même identifiant, ou même titre s'il s'agit d'un élément différent), vous choisissez de le remplacer ou de le garder, un par un ou en lot.
+- S'il vient d'**un autre utilisateur** : tous les titres importés reçoivent un court suffixe que vous choisissez (« [JD] »), pour ne jamais se confondre avec vos propres données. Le suffixe est mémorisé et réutilisé si vous importez à nouveau depuis la même personne. Si le titre suffixé entre en conflit avec un élément déjà importé précédemment (typiquement une nouvelle version du même élément, réexportée par la même personne), vous choisissez de le remplacer ou de le garder, exactement comme pour vos propres données.
+
+Dans tous les cas, un écran récapitulatif montre ce qui va changer avant que rien ne soit appliqué.
+
+À l'inverse, **restaurer une base de données** (fichier `.sqlite3`) remplace tout, sans fusion possible — c'est voulu : ce mécanisme est pensé pour la sauvegarde et la restauration complètes, pas pour le partage sélectif.
+
+## Comment fonctionnent les minuteries (EMOM / AMRAP / TABATA)
+
+Les trois types de combo minuté suivent chacun leur propre logique :
+
+- **EMOM** (_Every Minute On the Minute_) : un nouvel exercice démarre chaque minute. La durée que vous réglez est divisée par le nombre d'exercices du combo pour savoir combien de tours faire — chaque exercice occupe une tranche de 60 secondes.
+- **AMRAP** (_As Many Rounds As Possible_) : un compte à rebours unique tourne pour toute la durée réglée ; vous enchaînez les exercices en boucle, en faisant autant de tours que possible.
+- **TABATA** : alternance stricte de phases de travail et de repos, répétées un nombre de fois donné.
+
+Dans les trois cas, deux sons différents vous guident sans avoir à regarder l'écran : un bip discret pour les repères intermédiaires, un BIP plus marqué pour les changements de phase ou la fin du temps. Pour le détail minute par minute, voir la section [Signaux sonores]({{< relref "user-guide.fr.md" >}}#signaux-sonores) de la Référence.
+
+L'avancement entre exercices ou tours est automatique pour les trois types — vous n'avez rien à valider vous-même pendant que le chronomètre tourne.
+
+## Et les statistiques ?
+
+Pour être honnête, l'écran Statistiques est celui sur lequel l'auteur de l'application a le moins de retour d'expérience personnel — il ne s'en sert pas lui-même au quotidien. Les graphiques actuels (fréquence, volume, progression par exercice) sont un point de départ raisonnable, mais s'il vous manque quelque chose, c'est probablement vrai pour d'autres aussi : vos retours sont bienvenus.
diff --git a/website/content/docs/demarrage-rapide/edit-mode.en.png b/website/content/docs/demarrage-rapide/edit-mode.en.png
new file mode 100644
index 0000000..61498e1
Binary files /dev/null and b/website/content/docs/demarrage-rapide/edit-mode.en.png differ
diff --git a/website/content/docs/demarrage-rapide/edit-mode.fr.png b/website/content/docs/demarrage-rapide/edit-mode.fr.png
new file mode 100644
index 0000000..5b9e6f4
Binary files /dev/null and b/website/content/docs/demarrage-rapide/edit-mode.fr.png differ
diff --git a/website/content/docs/demarrage-rapide/execution-mode.en.png b/website/content/docs/demarrage-rapide/execution-mode.en.png
new file mode 100644
index 0000000..3840205
Binary files /dev/null and b/website/content/docs/demarrage-rapide/execution-mode.en.png differ
diff --git a/website/content/docs/demarrage-rapide/execution-mode.fr.png b/website/content/docs/demarrage-rapide/execution-mode.fr.png
new file mode 100644
index 0000000..3083b2a
Binary files /dev/null and b/website/content/docs/demarrage-rapide/execution-mode.fr.png differ
diff --git a/website/content/docs/demarrage-rapide/index.en.md b/website/content/docs/demarrage-rapide/index.en.md
new file mode 100644
index 0000000..3219600
--- /dev/null
+++ b/website/content/docs/demarrage-rapide/index.en.md
@@ -0,0 +1,74 @@
+---
+title: 'Getting Started'
+description: 'What you need to know before you begin: principles, interface, edit and execution modes.'
+slug: 'getting-started'
+weight: 1
+date: 2026-06-16
+---
+
+## What is TrainUs?
+
+TrainUs is a training-tracking application. You create **exercises**, group them into **combos** (crossfit-style sequences, timed or not), then into **sessions**. Sessions can in turn be organized into **collections** — a multi-week program, for example.
+
+When it's time to train, you launch a session in **Execution Mode**: the app guides you step by step, with a timer for timed combos, and keeps a record of everything you actually did (reps, weight, duration) so you can track your progress in the statistics.
+
+> **Browser & install:** TrainUs needs a modern browser (Firefox 111+, Chrome 102+, Safari 16.4+). Private browsing is **not supported** because it disables the persistent storage the app relies on — you'll see a clear error message if your browser isn't compatible. Once loaded, the app works offline; look for the install icon (⬇) in the action bar to add it to your home screen as a PWA.
+
+## The Big Picture: A Local App
+
+TrainUs doesn't depend on any server. Everything — the app and your data — lives in your browser. There's no account to create: on first launch, the app simply generates an identifier for you.
+
+### The Benefits
+
+- **No account** to create, no password to remember.
+- **Works offline** from the very first load — useful at a gym with no network.
+- **Your data is yours**: it stays on your device, nobody else has access to it.
+
+### The Trade-offs — and Their Solutions
+
+This choice comes with two trade-offs, accepted from the start:
+
+- **No automatic sync between devices** — if you use TrainUs on your phone and your computer, each keeps its own data. To make them work together, see the "Sync Two Devices" recipe in the [How-to Guides]({{< relref "guides-pratiques.en.md" >}}).
+- **No automatic cloud backup** — if you lose your device, you lose your data, unless you've backed it up yourself. TrainUs reminds you regularly (a warning button appears once your last backup gets old) — see "Back Up Your Data" in the [How-to Guides]({{< relref "guides-pratiques.en.md" >}}).
+
+Neither of these is an oversight: they're simple, manual solutions that require neither an account nor a server.
+
+## Interface Overview
+
+### Desktop
+
+![Overview of TrainUs on a wide screen, Exercises screen: side menu, action bar, main content](overview-desktop.png)
+
+On a wide screen, a fixed menu sits on the left, an action bar is in the top right (search, create, export...), and the page content fills the center.
+
+### Mobile
+
+![Overview of TrainUs on a small screen, Exercises screen: bottom navigation bar](overview-mobile.png)
+
+On mobile, the menu becomes a bottom bar (icons only on very small screens), and the action bar stays at the top.
+
+## The Two Modes
+
+### Edit Mode
+
+![Exercise edit form](edit-mode.png)
+
+This is the mode where you build your material: creating or editing an exercise, combo, session, or collection, through regular forms.
+
+### Execution Mode
+
+![Session execution screen, current step and next step](execution-mode.png)
+
+This is the mode where you train: you start a session (▶ button), and the app shows you the current exercise, the next one, and a timer if the current combo is timed.
+
+## Always the Same Three Screens
+
+Whatever the type of item (exercise, combo, session, collection), you'll always find the same three screens: a **list**, a read-only **detail** view, and a **create / edit** screen. Once you've mastered one, you've mastered them all.
+
+TrainUs can also be driven entirely from the keyboard (navigation, lists, forms) — the full list of shortcuts is documented in the [Reference]({{< relref "user-guide.en.md" >}}#keyboard-shortcuts).
+
+## Going Further
+
+- [How-to Guides]({{< relref "guides-pratiques.en.md" >}}) — concrete recipes: sending a session to a friend, backing up your data, syncing two devices...
+- [Reference]({{< relref "user-guide.en.md" >}}) — every screen described in detail, with available actions and keyboard shortcuts.
+- [Understanding TrainUs]({{< relref "comprendre.en.md" >}}) — the why behind the choices: local-first, JSON or database, how the timers work.
diff --git a/website/content/docs/demarrage-rapide/index.fr.md b/website/content/docs/demarrage-rapide/index.fr.md
new file mode 100644
index 0000000..f9ccd1d
--- /dev/null
+++ b/website/content/docs/demarrage-rapide/index.fr.md
@@ -0,0 +1,71 @@
+---
+title: 'Démarrage rapide'
+description: "Ce qu'il faut savoir avant de commencer : principes, interface, modes saisie et exécution."
+weight: 1
+date: 2026-06-14
+---
+
+## Qu'est-ce que TrainUs ?
+
+TrainUs est une application de suivi d'entraînement physique. Vous y créez des **exercices**, vous les regroupez en **combos** (des enchaînements façon crossfit, avec ou sans minuterie), puis en **séances**. Vos séances peuvent à leur tour être rangées dans des **collections** — un programme sur plusieurs semaines, par exemple.
+
+Quand vient le moment de s'entraîner, vous lancez une séance en **mode exécution** : l'application vous guide pas à pas, avec un chronomètre pour les combos minutés, et garde une trace de tout ce que vous avez réellement fait (répétitions, poids, durée) pour pouvoir suivre votre progression dans les statistiques.
+
+## TrainUs : une application locale
+
+TrainUs ne dépend d'aucun serveur. Tout — l'application et vos données — vit dans votre navigateur. Il n'y a pas de compte à créer : au premier lancement, l'application génère simplement un identifiant pour vous.
+
+### Les avantages
+
+- **Aucun compte** à créer, aucun mot de passe à retenir.
+- **Fonctionne hors ligne** dès le premier chargement — utile en salle de sport sans réseau.
+- **Vos données vous appartiennent** : elles restent sur votre appareil, personne d'autre n'y a accès.
+
+### Les limites — et leurs solutions
+
+Ce choix a deux contreparties, assumées dès la conception :
+
+- **Pas de synchronisation automatique entre appareils** — si vous utilisez TrainUs sur votre téléphone et sur votre ordinateur, chacun garde ses propres données. Pour les faire travailler ensemble, voir le guide pratique « Synchroniser deux appareils » dans les [Guides pratiques]({{< relref "guides-pratiques.fr.md" >}}).
+- **Pas de sauvegarde automatique dans le cloud** — si vous perdez votre appareil, vous perdez vos données, sauf si vous les avez sauvegardées vous-même. TrainUs vous le rappelle régulièrement (un bouton d'alerte apparaît quand votre dernière sauvegarde devient ancienne) — voir « Sauvegarder ses données » dans les [Guides pratiques]({{< relref "guides-pratiques.fr.md" >}}).
+
+Ces deux points ne sont pas des oublis : ce sont des solutions manuelles et simples, qui ne demandent ni compte ni serveur.
+
+## Aperçu de l'interface
+
+### Grand écran
+
+![Vue d'ensemble de TrainUs sur grand écran, écran Exercices : menu latéral, barre d'action, contenu principal](overview-desktop.png)
+
+Sur un grand écran, un menu fixe occupe le côté gauche, une barre d'action se trouve en haut à droite (recherche, créer, exporter...), et le contenu de la page s'affiche au centre.
+
+### Petit écran
+
+![Vue d'ensemble de TrainUs sur petit écran, écran Exercices : barre de navigation en bas](overview-mobile.png)
+
+Sur mobile, le menu devient une barre en bas de l'écran (icônes seules sur les très petits écrans), et la barre d'action reste en haut.
+
+## Les deux modes
+
+### Mode saisie
+
+![Formulaire d'édition d'un exercice](edit-mode.png)
+
+C'est le mode dans lequel vous construisez votre matériel : créer ou modifier un exercice, un combo, une séance ou une collection, via des formulaires classiques.
+
+### Mode exécution
+
+![Écran d'exécution d'une séance, étape en cours et étape suivante](execution-mode.png)
+
+C'est le mode dans lequel vous vous entraînez : vous lancez une séance (bouton ▶), et l'application vous présente l'exercice en cours, le suivant, et un chronomètre si le combo en cours est minuté.
+
+## Toujours les mêmes trois écrans
+
+Quel que soit le type d'objet (exercice, combo, séance, collection), vous retrouverez toujours les trois mêmes écrans : une **liste**, un **détail** en lecture seule, et un écran de **création / édition**. Une fois que vous en maîtrisez un, vous les maîtrisez tous.
+
+TrainUs se pilote aussi entièrement au clavier (navigation, listes, formulaires) — la liste complète des raccourcis est documentée dans la [Référence]({{< relref "user-guide.fr.md" >}}#raccourcis-clavier).
+
+## Pour aller plus loin
+
+- [Guides pratiques]({{< relref "guides-pratiques.fr.md" >}}) — des recettes concrètes : envoyer une séance à un ami, sauvegarder vos données, synchroniser deux appareils...
+- [Référence]({{< relref "user-guide.fr.md" >}}) — chaque écran décrit en détail, avec les actions disponibles et les raccourcis clavier.
+- [Comprendre TrainUs]({{< relref "comprendre.fr.md" >}}) — le pourquoi des choix : local-first, JSON ou base de données, fonctionnement des minuteries.
diff --git a/website/content/docs/demarrage-rapide/overview-desktop.en.png b/website/content/docs/demarrage-rapide/overview-desktop.en.png
new file mode 100644
index 0000000..5ed2965
Binary files /dev/null and b/website/content/docs/demarrage-rapide/overview-desktop.en.png differ
diff --git a/website/content/docs/demarrage-rapide/overview-desktop.fr.png b/website/content/docs/demarrage-rapide/overview-desktop.fr.png
new file mode 100644
index 0000000..abbc57f
Binary files /dev/null and b/website/content/docs/demarrage-rapide/overview-desktop.fr.png differ
diff --git a/website/content/docs/demarrage-rapide/overview-mobile.en.png b/website/content/docs/demarrage-rapide/overview-mobile.en.png
new file mode 100644
index 0000000..f39cf2f
Binary files /dev/null and b/website/content/docs/demarrage-rapide/overview-mobile.en.png differ
diff --git a/website/content/docs/demarrage-rapide/overview-mobile.fr.png b/website/content/docs/demarrage-rapide/overview-mobile.fr.png
new file mode 100644
index 0000000..f4cd23a
Binary files /dev/null and b/website/content/docs/demarrage-rapide/overview-mobile.fr.png differ
diff --git a/website/content/docs/guides-pratiques.en.md b/website/content/docs/guides-pratiques.en.md
new file mode 100644
index 0000000..67361e2
--- /dev/null
+++ b/website/content/docs/guides-pratiques.en.md
@@ -0,0 +1,96 @@
+---
+title: 'How-to Guides'
+description: 'Short step-by-step guides for concrete needs: sharing, backup, sync, and tips.'
+slug: 'how-to-guides'
+weight: 2
+date: 2026-06-16
+---
+
+## Install TrainUs as an App on Android
+
+TrainUs is a Progressive Web App (PWA): it installs as a real app on your phone, with its own home screen icon, and runs without the browser's navigation bar.
+
+> **Important:** if TrainUs is already open in a browser tab, the installed app may not launch correctly — the browser and the installed app conflict with each other. Close the browser tab first before launching the installed app.
+
+### With Firefox
+
+1. Open TrainUs in Firefox.
+2. Tap the **⋮** menu (top right).
+3. Tap **Install** or **Add to Home Screen**. If you don't see this option, tap **More** first to reveal all available actions.
+4. Confirm by tapping **Add**.
+5. The TrainUs icon appears on your home screen.
+
+### With Chrome
+
+1. Open TrainUs in Chrome.
+2. Tap the **⋮** menu (top right).
+3. Tap **Add to Home Screen** or **Install App**.
+4. Confirm by tapping **Install** or **Add**.
+5. The TrainUs icon appears on your home screen.
+
+### If the icon is wrong or the app won't launch
+
+In some cases the icon displayed is incorrect, or the app refuses to open. To start fresh:
+
+1. **Uninstall** the app (long-press the icon → Uninstall).
+2. Open **Android Settings → Apps** and find your browser (Firefox or Chrome).
+3. Tap **Clear Cache** (or **Clear Data** if the problem persists).
+4. If the problem still persists, **restart Android**.
+5. Reopen TrainUs in the browser and reinstall the app.
+
+## Send One or More Sessions to a Friend
+
+1. Open the **Sessions** list.
+2. Click the download icon in the action bar to export every session, or open a single session and click the same icon to export just that one.
+3. A dialog suggests a file name (e.g. `trainus-sessions-2026-06-16`); confirm or rename it, then the `.json` file downloads.
+
+It's a perfectly normal text file: you can email it, drop it on a shared drive, or send it through WhatsApp like any other attachment.
+
+## Import a JSON File From a Friend
+
+1. On the matching list (or from **Settings → Import Data**), click the import icon and pick the `.json` file.
+2. Since the file comes from another user, TrainUs asks you for a short suffix (e.g. "JD"): every imported title will display with that suffix ("Push-ups [JD]"), so it never mixes with your own exercises.
+3. A summary screen shows what will be imported before anything changes. Confirm to finish.
+
+See the [Reference]({{< relref "user-guide.en.md" >}}) for the details of each screen and how suffixes are managed.
+
+## Share the Home Page as HTML
+
+Once you have a bit of history, a **`</> HTML`** button appears in the home page's action bar. It generates a single self-contained HTML file (images included) with your statistics and recent history — handy to email or print, with no active links or buttons.
+
+This is useful for sharing your activity with a friend, but it's mainly designed for your **coach**: they can follow your training history without installing TrainUs or accessing your data — you just send them this one file.
+
+## Back Up Your Data
+
+Two levels of backup, depending on the need:
+
+- **Full backup** (recommended regularly): **Settings → Download Database**. This produces a `.sqlite3` file containing absolutely everything. TrainUs reminds you to do this if your last backup gets too old.
+- **Selective backup**: a JSON export (see above) of a single data type — useful before a risky change, or to back up only your sessions for example.
+
+To restore a full backup: **Settings → Restore Database** — see the [Reference]({{< relref "user-guide.en.md" >}}). Keep in mind that restoring **replaces** all your current data.
+
+## Sync Two Devices
+
+TrainUs doesn't automatically sync anything between your devices (no server — see [Understanding TrainUs]({{< relref "comprendre.en.md" >}})). Two manual methods, depending on your need:
+
+**Mirror method — one device takes over the other**
+
+1. On the most up-to-date device: **Settings → Download Database**.
+2. Transfer the `.sqlite3` file to the other device (email, drive, USB key...).
+3. On the other device: **Settings → Restore Database**, select the file.
+
+Careful: restoring **replaces** all of device B's data with device A's — this is not a merge, it's one-way. Repeat the operation whenever you want to bring both devices back in sync, always from the one you used most recently.
+
+**Merge method — keep what exists on both devices**
+
+If both devices have their own data you want to keep, use JSON export/import per entity type instead of the full database. On import, use the **"Import as Mine"** button to avoid adding a suffix. TrainUs then detects items that already exist (same ID) and lets you choose, one by one or in bulk, to **replace** or **keep** your version.
+
+> **Note:** the user ID does not sync automatically between devices — only a prior full database transfer (mirror method) guarantees that both devices share the same user record.
+
+## Tip: Yoga
+
+For a yoga session, it's often simpler **not to split each posture into a separate exercise**: create a single "Yoga session" exercise (or one per sequence), with the description or images for the whole flow. Easier to manage, and closer to how you actually practice it.
+
+## Tip: Running
+
+TrainUs isn't built for run tracking, but you can run for a set time with the existing tools: create a "Run" exercise with 1 repetition, put it alone in an **AMRAP**-type combo, and set the AMRAP duration to the time you want to run. The timer will count down for you.
diff --git a/website/content/docs/guides-pratiques.fr.md b/website/content/docs/guides-pratiques.fr.md
new file mode 100644
index 0000000..f8799fa
--- /dev/null
+++ b/website/content/docs/guides-pratiques.fr.md
@@ -0,0 +1,95 @@
+---
+title: 'Guides pratiques'
+description: 'Mini-guides pas à pas pour des besoins concrets : partage, sauvegarde, synchronisation, astuces.'
+weight: 2
+date: 2026-06-14
+---
+
+## Installer TrainUs comme application sur Android
+
+TrainUs est une application web progressive (PWA) : elle s'installe comme une vraie application sur votre téléphone, avec sa propre icône sur l'écran d'accueil, et fonctionne sans barre de navigation du navigateur.
+
+> **Important :** si TrainUs est déjà ouvert dans un onglet de votre navigateur, l'application installée ne se lancera pas correctement — le navigateur et l'application se marchent sur les pieds. Fermez d'abord l'onglet dans le navigateur avant de lancer l'application installée.
+
+### Avec Firefox
+
+1. Ouvrez TrainUs dans Firefox.
+2. Appuyez sur le menu **⋮** (en haut à droite).
+3. Appuyez sur **Installer** ou **Ajouter à l'écran d'accueil**. Si vous ne voyez pas cette option, appuyez d'abord sur **Plus** pour afficher toutes les actions disponibles.
+4. Confirmez en appuyant sur **Ajouter**.
+5. L'icône TrainUs apparaît sur votre écran d'accueil.
+
+### Avec Chrome
+
+1. Ouvrez TrainUs dans Chrome.
+2. Appuyez sur le menu **⋮** (en haut à droite).
+3. Appuyez sur **Ajouter à l'écran d'accueil** ou **Installer l'application**.
+4. Confirmez en appuyant sur **Installer** ou **Ajouter**.
+5. L'icône TrainUs apparaît sur votre écran d'accueil.
+
+### Si l'icône est incorrecte ou l'application ne se lance pas
+
+Dans certains cas, l'icône affichée n'est pas la bonne, ou l'application refuse de se lancer. Pour repartir sur une base saine :
+
+1. **Désinstallez** l'application (appui long sur l'icône → Désinstaller).
+2. Ouvrez les **Paramètres Android → Applications** et trouvez votre navigateur (Firefox ou Chrome).
+3. Appuyez sur **Vider le cache** (voire **Effacer les données** si le problème persiste).
+4. Si le problème persiste, **redémarrez Android**.
+5. Réouvrez TrainUs dans le navigateur et réinstallez l'application.
+
+## Envoyer une ou plusieurs séances à un ami
+
+1. Ouvrez la liste des **Séances**.
+2. Cliquez sur l'icône de téléchargement dans la barre d'action pour exporter toutes les séances, ou ouvrez une séance puis cliquez sur la même icône pour n'exporter que celle-ci.
+3. Une boîte de dialogue propose un nom de fichier (par exemple `trainus-sessions-2026-06-14`) ; validez ou renommez-le, puis le fichier `.json` est téléchargé.
+
+C'est un fichier texte tout à fait normal : vous pouvez l'envoyer par e-mail, le déposer sur un drive partagé, ou le passer par WhatsApp comme n'importe quelle pièce jointe.
+
+## Importer un fichier JSON reçu d'un ami
+
+1. Sur la liste correspondante (ou depuis **Réglages → Importer des données**), cliquez sur l'icône d'import et choisissez le fichier `.json`.
+2. Comme le fichier vient d'un autre utilisateur, TrainUs vous demande un court suffixe (par exemple « JD ») : tous les titres importés seront affichés avec ce suffixe (« Pompes [JD] »), pour ne jamais se mélanger avec vos propres exercices.
+3. Un écran récapitule ce qui va être importé avant toute modification. Validez pour terminer.
+
+Voir la [Référence]({{< relref "user-guide.fr.md" >}}) pour le détail des écrans et de la gestion des suffixes.
+
+## Partager la page d'accueil en HTML
+
+Une fois que vous avez un peu d'historique, un bouton **`</> HTML`** apparaît dans la barre d'action de la page d'accueil. Il génère un seul fichier HTML autonome (images comprises) reprenant vos statistiques et votre historique récent — pratique à envoyer par mail ou à imprimer, sans aucun lien ni bouton actif.
+
+C'est utile pour partager votre activité avec un ami, mais c'est surtout pensé pour votre **coach** : il peut suivre votre historique d'entraînement sans avoir besoin d'installer TrainUs ni d'accéder à vos données — vous lui envoyez juste ce fichier.
+
+## Sauvegarder ses données
+
+Deux niveaux de sauvegarde, selon le besoin :
+
+- **Sauvegarde complète** (recommandé régulièrement) : **Réglages → Télécharger la base de données**. Cela produit un fichier `.sqlite3` contenant absolument tout. TrainUs vous rappelle de le faire si votre dernière sauvegarde devient trop ancienne.
+- **Sauvegarde sélective** : un export JSON (voir ci-dessus) d'un seul type de données — utile avant une manipulation que vous craignez, ou pour ne sauvegarder que vos séances par exemple.
+
+Pour restaurer une sauvegarde complète : **Réglages → Restaurer la base de données** — voir la [Référence]({{< relref "user-guide.fr.md" >}}). Gardez en tête que la restauration **remplace** toutes vos données actuelles.
+
+## Synchroniser deux appareils
+
+TrainUs ne synchronise rien automatiquement entre vos appareils (pas de serveur — voir [Comprendre TrainUs]({{< relref "comprendre.fr.md" >}})). Deux méthodes manuelles, selon votre besoin :
+
+**Méthode miroir — un appareil prend le dessus sur l'autre**
+
+1. Sur l'appareil le plus à jour : **Réglages → Télécharger la base de données**.
+2. Transférez le fichier `.sqlite3` vers l'autre appareil (mail, drive, clé USB...).
+3. Sur l'autre appareil : **Réglages → Restaurer la base de données**, sélectionnez le fichier.
+
+Attention : la restauration **remplace** toutes les données de l'appareil B par celles de l'appareil A — ce n'est pas une fusion, c'est un sens unique. Répétez l'opération chaque fois que vous voulez remettre les deux appareils d'accord, toujours depuis celui que vous avez utilisé le plus récemment.
+
+**Méthode fusion — garder ce qui existe sur les deux appareils**
+
+Si les deux appareils ont chacun des données propres que vous voulez conserver, passez par l'export/import JSON par type d'entité plutôt que par la base complète. À l'import, utilisez le bouton **« Importer comme les miens »** pour éviter l'ajout d'un suffixe. TrainUs détecte ensuite les éléments déjà existants (même identifiant) et vous laisse choisir, un par un ou en lot, de **remplacer** ou de **garder** votre version.
+
+> **Note :** l'identifiant utilisateur ne se synchronise pas automatiquement entre deux appareils — seul un transfert préalable de la base de données complète (méthode miroir) garantit que les deux appareils partagent le même utilisateur en base.
+
+## Astuce : le Yoga
+
+Pour une séance de yoga, il est souvent plus simple de **ne pas découper chaque posture en exercice séparé** : créez un seul exercice « Séance de yoga » (ou un par enchaînement), avec la description ou les images de la séance complète. Plus simple à gérer, et plus proche de la façon dont vous la pratiquez réellement.
+
+## Astuce : la course à pied
+
+TrainUs n'est pas pensé pour le suivi de course, mais vous pouvez courir un temps donné avec les outils existants : créez un exercice « Courir » avec 1 répétition, mettez-le seul dans un combo de type **AMRAP**, et réglez la durée de l'AMRAP sur le temps que vous voulez courir. Le chronomètre fera le compte à rebours pour vous.
diff --git a/website/content/docs/user-guide/combo-amrap.en.png b/website/content/docs/user-guide/combo-amrap.en.png
new file mode 100644
index 0000000..bd7f11a
Binary files /dev/null and b/website/content/docs/user-guide/combo-amrap.en.png differ
diff --git a/website/content/docs/user-guide/combo-amrap.fr.png b/website/content/docs/user-guide/combo-amrap.fr.png
new file mode 100644
index 0000000..4053ebe
Binary files /dev/null and b/website/content/docs/user-guide/combo-amrap.fr.png differ
diff --git a/website/content/docs/user-guide/combo-emom.en.png b/website/content/docs/user-guide/combo-emom.en.png
new file mode 100644
index 0000000..15b9611
Binary files /dev/null and b/website/content/docs/user-guide/combo-emom.en.png differ
diff --git a/website/content/docs/user-guide/combo-emom.fr.png b/website/content/docs/user-guide/combo-emom.fr.png
new file mode 100644
index 0000000..e85bfcc
Binary files /dev/null and b/website/content/docs/user-guide/combo-emom.fr.png differ
diff --git a/website/content/docs/user-guide/combo-tabata-rest.en.png b/website/content/docs/user-guide/combo-tabata-rest.en.png
new file mode 100644
index 0000000..65364f3
Binary files /dev/null and b/website/content/docs/user-guide/combo-tabata-rest.en.png differ
diff --git a/website/content/docs/user-guide/combo-tabata-rest.fr.png b/website/content/docs/user-guide/combo-tabata-rest.fr.png
new file mode 100644
index 0000000..bee651f
Binary files /dev/null and b/website/content/docs/user-guide/combo-tabata-rest.fr.png differ
diff --git a/website/content/docs/user-guide/combo-tabata-work.en.png b/website/content/docs/user-guide/combo-tabata-work.en.png
new file mode 100644
index 0000000..ab3d7d2
Binary files /dev/null and b/website/content/docs/user-guide/combo-tabata-work.en.png differ
diff --git a/website/content/docs/user-guide/combo-tabata-work.fr.png b/website/content/docs/user-guide/combo-tabata-work.fr.png
new file mode 100644
index 0000000..b70aaeb
Binary files /dev/null and b/website/content/docs/user-guide/combo-tabata-work.fr.png differ
diff --git a/website/content/docs/user-guide/index.en.md b/website/content/docs/user-guide/index.en.md
new file mode 100644
index 0000000..4dcfc28
--- /dev/null
+++ b/website/content/docs/user-guide/index.en.md
@@ -0,0 +1,670 @@
+---
+title: 'Reference'
+description: 'How to use TrainUs: exercises, combos, sessions, collections, execution, and statistics.'
+weight: 3
+date: 2026-06-16
+---
+
+> This page describes every TrainUs screen in detail: available actions, form fields, keyboard shortcuts. For a general introduction, see [Getting Started]({{< relref "demarrage-rapide.en.md" >}}); for the "why" behind the choices, see [Understanding TrainUs]({{< relref "comprendre.en.md" >}}).
+
+## Home
+
+The Home page (`#/home`) is the default landing page. It provides an overview of your recent training activity.
+
+### Activity Overview
+
+Two stat cards at the top:
+
+- **Sessions (last 7 days)**: Number of training sessions executed in the past 7 days.
+- **Sessions (last 30 days)**: Number of training sessions executed in the past 30 days.
+
+### Recent Sessions
+
+The 4 most recently executed sessions are shown as cards. Each card displays:
+
+- The session title and the date it was executed (formatted for your language).
+- The total duration of the session (if it was completed without exiting early).
+- A compact inline summary of every exercise performed — actual reps, weight, and duration per set. Combo items are shown with their round count and exercise breakdown.
+- A **play button (▶)** to immediately start a new run of that session.
+
+Click the card itself (anywhere except the play button) to navigate to the session detail view.
+
+If no sessions have been executed yet, an empty-state message is shown.
+
+> **Note**: Sessions appear here only after being executed in Execution Mode. Creating a session in the form does not add it to this list.
+
+### History
+
+Below the recent sessions, the **History** section shows all your past executions grouped by calendar day (most recent first).
+
+- Each day heading shows the date, and each card beneath it shows one session execution with its duration, inline exercise summary, and a play button.
+- Two date pickers (**From** / **To**) let you narrow the range. The default is the last 30 days.
+- The filter applies immediately — no reload needed.
+
+### HTML Export
+
+When you have execution history, an **HTML export button** (`</> HTML`) appears in the action bar. Clicking it generates a single self-contained HTML file of your home page — stats, recent sessions, and the current history range — without any navigation links, play buttons, or interactive controls. You're prompted to name the file before it's saved. The file can be saved, printed, or shared. Any images (such as the app icon) are embedded directly in the file.
+
+---
+
+## Navigation
+
+TrainUs uses a responsive navigation layout:
+
+- **Desktop** (screen wider than 700px): A fixed sidebar on the left with labeled links.
+- **Tablet / Mobile** (screen 700px or less): A bottom navigation bar with icons and labels.
+- **Small mobile** (screen 400px or less): A compact bottom bar with icons only.
+
+The navigation gives access to 7 sections: **Home**, **Exercises**, **Combos**, **Sessions**, **Collections**, **Statistics**, and **Settings**.
+
+---
+
+## Keyboard Shortcuts
+
+TrainUs supports keyboard shortcuts for faster navigation. Most shortcuts are **ignored when the cursor is inside a text field, textarea, or select** — exceptions are noted below.
+
+### Navigation Menu
+
+| Key                 | Action                                              |
+| ------------------- | --------------------------------------------------- |
+| `Tab` / `Shift+Tab` | Move focus into and out of the navigation menu      |
+| `↑` `↓` `←` `→`     | Move focus between menu items (when one is focused) |
+| `Enter`             | Navigate to the focused menu item                   |
+
+### List Views
+
+These shortcuts are available on the Exercises, Combos, Sessions, and Collections list pages.
+
+| Key                 | Action                                       |
+| ------------------- | -------------------------------------------- |
+| `Tab` / `Shift+Tab` | Move focus between cards in the list         |
+| `N`                 | Open the "New" form to create a new item     |
+| `↓`                 | Move focus to the next card in the list      |
+| `↑`                 | Move focus to the previous card in the list  |
+| `Enter`             | Open the currently focused card              |
+| `Escape`            | Clear list focus (deselect the focused card) |
+
+### Form Views
+
+These shortcuts are available on all create and edit forms (Exercise, Combo, Session, Collection). They work **even when a text field is focused**.
+
+| Key          | Action                                |
+| ------------ | ------------------------------------- |
+| `Ctrl+Enter` | Save the form (same as clicking Save) |
+| `Escape`     | Cancel and go back without saving     |
+
+Hover over the **Save** button to see the shortcut hint in a tooltip.
+
+### Detail Views
+
+These shortcuts are available on the Exercise, Combo, Session, and Collection detail pages.
+
+| Key      | Action                   |
+| -------- | ------------------------ |
+| `E`      | Open the edit form       |
+| `Escape` | Go back to the list view |
+
+### Dialogs
+
+| Key      | Action           |
+| -------- | ---------------- |
+| `Escape` | Close the dialog |
+
+---
+
+## Exercises
+
+The Exercises section is accessible via the **Exercises** link in the navigation. It lets you create, view, edit, search, and delete individual fitness exercises.
+
+### Exercise List
+
+|             |                                                                      |
+| ----------- | -------------------------------------------------------------------- |
+| **Route**   | `#/exercises`                                                        |
+| **Content** | A list of exercise cards, or an empty-state message if none exist    |
+| **Actions** | Search (magnifying glass icon) and New (plus icon) in the action bar |
+
+The list displays each exercise as a card showing:
+
+- **Title** (always visible)
+- **Reps badge** (if default reps > 0) — e.g., "12 reps"
+- **Weight badge** (if default weight > 0) — e.g., "10 kg"
+- **Asymmetric icon** (if the exercise is asymmetric)
+
+Click any card to open the exercise detail view.
+
+### Creating an Exercise
+
+|            |                                          |
+| ---------- | ---------------------------------------- |
+| **Route**  | `#/exercises/new`                        |
+| **Access** | Click the **+** button in the action bar |
+
+| Field          | Type        | Required | Notes                                                      |
+| -------------- | ----------- | -------- | ---------------------------------------------------------- |
+| Title          | Text        | Yes      | Must be unique across all exercises                        |
+| Description    | Textarea    | No       | [Basic Markdown supported](#appendix-markdown-cheat-sheet) |
+| Asymmetric     | Checkbox    | No       | When checked, shows alternation options                    |
+| Alternate      | Radio group | No       | Only visible when Asymmetric is checked                    |
+| Default Reps   | Number      | No       | Must be ≥ 0                                                |
+| Default Weight | Number      | No       | Must be ≥ 0                                                |
+| Image URLs     | URL list    | No       | Add one URL at a time; must be valid HTTP(S)               |
+| Video URLs     | URL list    | No       | Add one URL at a time; YouTube URLs are auto-embedded      |
+
+> **Images or videos?** Prefer images if you want to work offline: once an image has been displayed at least once on your device, it stays available offline. Videos, on the other hand, are loaded from the internet every time and therefore don't work without a connection.
+
+Click **Save** to create the exercise. Click **Cancel** to go back without saving.
+
+### Exercise Details
+
+|             |                                                   |
+| ----------- | ------------------------------------------------- |
+| **Route**   | `#/exercises/:id`                                 |
+| **Access**  | Click an exercise card in the list                |
+| **Actions** | Back, Edit (pencil), Delete (trash) in action bar |
+
+Displays all exercise information in read-only mode including images and embedded YouTube videos. The description is rendered as formatted Markdown (bold, italic, lists, code, etc.).
+
+### Editing an Exercise
+
+|            |                                             |
+| ---------- | ------------------------------------------- |
+| **Route**  | `#/exercises/:id/edit`                      |
+| **Access** | Click the **pencil** icon in the action bar |
+
+The edit form is identical to the create form but pre-populated with current data.
+
+### Deleting an Exercise
+
+Click the **trash** icon in the action bar. A confirmation dialog appears. If the exercise has past execution entries, the dialog shows how many will be deleted with it. Confirming permanently deletes the exercise — along with any execution log entries that reference it — and returns you to the list. The rest of each affected session log (its other exercises) is unaffected.
+
+### Searching Exercises
+
+Click the **magnifying glass** icon in the action bar. As you type, the list is filtered in real time (with a short delay). The search matches exercise titles (case-insensitive, partial match). A **clear (×)** button appears inside the field once it has text — click it to empty the field without leaving search mode. Click the magnifying glass icon again or clear the field to restore the full list.
+
+---
+
+## Combos
+
+The Combos section lets you group exercises together — useful for supersets, circuits, or timed formats (EMOM, AMRAP, TABATA).
+
+### Combo List
+
+|             |                                                                      |
+| ----------- | -------------------------------------------------------------------- |
+| **Route**   | `#/combos`                                                           |
+| **Content** | A list of combo cards, or an empty-state message if none exist       |
+| **Actions** | Search (magnifying glass icon) and New (plus icon) in the action bar |
+
+Each card shows: **Title**, **Type badge** (NONE / EMOM / AMRAP / TABATA), **Exercise count**.
+
+### Creating a Combo
+
+|            |                                          |
+| ---------- | ---------------------------------------- |
+| **Route**  | `#/combos/new`                           |
+| **Access** | Click the **+** button in the action bar |
+
+| Field        | Type         | Required | Notes                                                      |
+| ------------ | ------------ | -------- | ---------------------------------------------------------- |
+| Title        | Text         | Yes      | Must be unique across all combos                           |
+| Description  | Textarea     | No       | [Basic Markdown supported](#appendix-markdown-cheat-sheet) |
+| Type         | Dropdown     | No       | NONE (default), EMOM, AMRAP, or TABATA                     |
+| Timer Config | Number       | No       | Duration (minutes) for EMOM/AMRAP; Rounds for TABATA       |
+| Exercises    | Ordered list | No       | Add exercises from your library; reorder with arrows       |
+
+**Adding exercises to a combo:**
+
+1. Select an exercise from the dropdown and click **Add Exercise**.
+2. For each exercise, set **Reps** (≥ 1) and **Weight** in kg (≥ 0).
+3. Use the up/down arrows to reorder; use the trash icon to remove.
+
+Click **Save** to create the combo.
+
+### Combo Details
+
+|             |                                                   |
+| ----------- | ------------------------------------------------- |
+| **Route**   | `#/combos/:id`                                    |
+| **Access**  | Click a combo card in the list                    |
+| **Actions** | Back, Edit (pencil), Delete (trash) in action bar |
+
+Displays combo information including the ordered exercise list with reps and weight per exercise. Exercise names link to their detail view. The description is rendered as formatted Markdown.
+
+### Editing a Combo
+
+|            |                                             |
+| ---------- | ------------------------------------------- |
+| **Route**  | `#/combos/:id/edit`                         |
+| **Access** | Click the **pencil** icon in the action bar |
+
+### Deleting a Combo
+
+Click the **trash** icon in the action bar. Confirming permanently deletes the combo.
+
+---
+
+## Sessions
+
+The Sessions section lets you build training sessions — ordered lists of exercises and/or combos. Sessions are what you execute during a workout.
+
+### Session List
+
+|             |                                                                           |
+| ----------- | ------------------------------------------------------------------------- |
+| **Route**   | `#/sessions`                                                              |
+| **Content** | A list of session cards, or an empty-state message if none exist          |
+| **Actions** | Search (magnifying glass icon), New (plus icon), and play button per card |
+
+Each card shows: **Title**, **Item count**, and a **play button (▶)** to start execution.
+
+### Creating a Session
+
+|            |                                          |
+| ---------- | ---------------------------------------- |
+| **Route**  | `#/sessions/new`                         |
+| **Access** | Click the **+** button in the action bar |
+
+| Field       | Type         | Required | Notes                                                      |
+| ----------- | ------------ | -------- | ---------------------------------------------------------- |
+| Title       | Text         | Yes      | Must be unique across all sessions                         |
+| Description | Textarea     | No       | [Basic Markdown supported](#appendix-markdown-cheat-sheet) |
+| Items       | Ordered list | No       | Mix exercises and combos; reorder with arrows              |
+
+**Adding items to a session:**
+
+1. Choose the item type: **Exercise** or **Combo**.
+2. Select an item from the corresponding dropdown and click **Add**.
+3. For each item, set:
+   - **Repetitions** (≥ 1) — for a combo, this is the number of full passes through the combo's exercise list.
+   - **Weight** in kg (≥ 0) — overrides the exercise's default weight during execution.
+4. Use the up/down arrows to reorder; use the trash icon to remove.
+
+Click **Save** to create the session.
+
+### Session Details
+
+|             |                                                             |
+| ----------- | ----------------------------------------------------------- |
+| **Route**   | `#/sessions/:id`                                            |
+| **Access**  | Click a session card in the list                            |
+| **Actions** | Back, Play (▶), Edit (pencil), Delete (trash) in action bar |
+
+Displays the description (rendered as formatted Markdown) and the ordered list of items with their reps and weight. Item names link to their detail view.
+
+### Editing a Session
+
+|            |                                             |
+| ---------- | ------------------------------------------- |
+| **Route**  | `#/sessions/:id/edit`                       |
+| **Access** | Click the **pencil** icon in the action bar |
+
+The edit form is identical to the create form but pre-populated with current data.
+
+### Deleting a Session
+
+Click the **trash** icon in the action bar. A confirmation dialog appears; if the session has past execution logs, it shows how many will be deleted with it. Confirming permanently deletes the session along with all of its execution history — this cannot be undone.
+
+---
+
+## Collections
+
+The Collections section lets you group training sessions into ordered sets — useful for organizing weekly plans, training phases, or themed workouts.
+
+### Collection List
+
+|             |                                                                      |
+| ----------- | -------------------------------------------------------------------- |
+| **Route**   | `#/collections`                                                      |
+| **Content** | A list of collection cards, or an empty-state message if none exist  |
+| **Actions** | Search (magnifying glass icon) and New (plus icon) in the action bar |
+
+Each card shows: **Label** and **Session count badge** (e.g., "3 sessions").
+
+### Creating a Collection
+
+|            |                                          |
+| ---------- | ---------------------------------------- |
+| **Route**  | `#/collections/new`                      |
+| **Access** | Click the **+** button in the action bar |
+
+| Field    | Type         | Required | Notes                                               |
+| -------- | ------------ | -------- | --------------------------------------------------- |
+| Label    | Text         | Yes      | Must be unique across all collections               |
+| Sessions | Ordered list | No       | Add sessions from your library; reorder with arrows |
+
+Each session can appear at most once in a collection. Click **Save** to create the collection.
+
+### Collection Details
+
+|             |                                                   |
+| ----------- | ------------------------------------------------- |
+| **Route**   | `#/collections/:id`                               |
+| **Access**  | Click a collection card in the list               |
+| **Actions** | Back, Edit (pencil), Delete (trash) in action bar |
+
+Displays the ordered list of sessions. Session names link to their detail view.
+
+### Editing a Collection
+
+|            |                                             |
+| ---------- | ------------------------------------------- |
+| **Route**  | `#/collections/:id/edit`                    |
+| **Access** | Click the **pencil** icon in the action bar |
+
+### Deleting a Collection
+
+Click the **trash** icon in the action bar. Confirming permanently deletes the collection (sessions are **not** deleted — only the grouping is removed).
+
+---
+
+## Export / Import Data
+
+TrainUs can export and import your data as JSON files. This lets you share data between devices, collaborate with other users, or keep structured backups of individual entity types.
+
+### Exporting Data
+
+You can export from multiple places:
+
+| From                                                    | Scope                                                                                                        |
+| ------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------ |
+| Exercise / Combo / Session / Collection **list view**   | All items of that type, or only the matching ones if a search filter is active (download icon in action bar) |
+| Exercise / Combo / Session / Collection **detail view** | Single item (download icon in action bar)                                                                    |
+| **Settings → Export Data**                              | Any combination of entity types (filter dialog)                                                              |
+
+Before the file is saved, a dialog lets you rename it — it's prefilled with a default name built from the entity type and date (e.g., `trainus-exercises-2026-05-26` or `trainus-full-2026-05-26` for a full export from Settings). The `.json` extension is fixed and shown next to the name field. Press **Save** to accept the name (or just press Enter to keep the default), or **Cancel** to abort without saving anything.
+
+Exporting a combo, session, or collection (from a list, a detail view, or the filtered selection) always bundles the entities it depends on — exporting a session also includes its combos and exercises, exporting a collection also includes its sessions, combos, and exercises — so the file can be imported on its own without missing references, even if you only selected one entity type in the Settings filter dialog.
+
+### Importing Data
+
+To import data from a JSON file previously exported from TrainUs:
+
+1. Click the upload icon on a list view, or click **Import Data** in Settings.
+2. Select the `.json` file.
+
+**If the file is from your own account** (same user), you'll see any conflicts where items with the same ID already exist, or where a different item already has the same title. For each conflict you can:
+
+- **Replace**: Overwrite the existing item with the imported version (keeping its original ID in a title conflict).
+- **Skip**: Keep your current item. Anything else in the same file that referenced the imported item (e.g., a combo using that exercise) is automatically redirected to your existing item instead.
+- Use **Replace All** or **Skip All** for batch actions.
+
+**If the file is from a different user**, you'll be asked to choose a short suffix (e.g., "JD"). All imported titles will have the suffix appended: "Push-ups [JD]". If you import from the same external user again later, the existing suffix is reused automatically — and if the suffixed title conflicts with something you already imported earlier, the same Replace/Skip choice applies.
+
+A preview step shows you a summary of what will be imported before any changes are made. After import, a report shows how many items were added, updated, or skipped.
+
+### Managing Import Suffixes
+
+After importing from other users, an **Import Suffixes** section appears in Settings. You can:
+
+- **Edit** a suffix: Changing it automatically updates all titles across all entity types (exercises, combos, sessions, collections) that use the old suffix.
+- **Delete** a suffix entry (does not remove the imported items themselves).
+
+---
+
+## Execution Mode
+
+Execution Mode lets you run a session step-by-step, logging the reps and weight you actually performed.
+
+### Starting a Session
+
+- From the **Sessions list**: click the **play button (▶)** on any session card.
+- From the **Session detail view**: click the **play button** in the action bar.
+
+### During Execution
+
+The execution screen shows:
+
+1. **Progress bar** — how many steps you have completed out of the total.
+2. **Current step card** — the exercise you are doing right now, with editable reps and weight fields.
+3. **Next step preview** — the upcoming exercise (title, reps, and combo context if applicable).
+
+For asymmetric exercises, a **Side** button appears. Tap it to toggle between LEFT and RIGHT.
+
+Press **✓ Done** to log the current step and advance to the next one.
+
+### Exercise Details During Execution
+
+The exercise title in the current step card is tappable. Clicking it expands a detail panel showing the exercise's description, images, and video links — useful for checking form cues mid-workout.
+
+- **Click the title** → the panel expands and the timer (if active) pauses automatically.
+- **Click the title again** → the panel collapses and the timer resumes.
+
+If you had already manually paused the timer before expanding, it stays paused when you collapse — only timers paused by the expand are auto-resumed.
+
+The panel closes automatically when you advance to the next step.
+
+### Combos in Execution Mode
+
+When a session item is a combo:
+
+- Each exercise in the combo is shown as its own step, with the combo name and round number displayed.
+- Rounds advance **automatically** — completing the last exercise in a round moves straight to the first exercise of the next round, with no pause screen.
+- After the **last exercise of the last round**, a final-round screen appears:
+  - **Continue →** — move on to the next session item (or finish the session if none remain).
+  - **+ One More Round** — append an extra round and keep going.
+
+| EMOM                                                     | AMRAP                                                    |
+| -------------------------------------------------------- | -------------------------------------------------------- |
+| ![EMOM combo running, timer at 1 minute](combo-emom.png) | ![AMRAP combo running, countdown timer](combo-amrap.png) |
+
+| TABATA — work phase                                        | TABATA — rest phase                                                       |
+| ---------------------------------------------------------- | ------------------------------------------------------------------------- |
+| ![TABATA combo, work phase running](combo-tabata-work.png) | ![TABATA combo, rest screen between two exercises](combo-tabata-rest.png) |
+
+**EMOM and AMRAP — "Duration (min)" field**: When adding an EMOM or AMRAP combo to a session, the **Repetitions** field is relabelled **Duration (min)** to make its meaning explicit. For EMOM, this is the total number of minutes: the app divides by the number of exercises in the combo to compute how many rounds to run (each exercise occupies one 60-second slot). For AMRAP, the duration is the countdown timer length.
+
+### Audio Cues
+
+TrainUs uses short audio beeps to help you keep rhythm without watching the screen. Two sounds are used:
+
+- **bip** — a soft short tone (440 Hz): a gentle signal or countdown tick.
+- **BIP** — a louder longer tone (880 Hz): marks a significant event (phase change, time up).
+
+| Timer type | When                                               | Sound    |
+| ---------- | -------------------------------------------------- | -------- |
+| **EMOM**   | Every 30 seconds remaining                         | bip      |
+| **EMOM**   | 2 s and 1 s remaining                              | bip      |
+| **EMOM**   | Timer expires (auto-advance)                       | BIP      |
+| **AMRAP**  | Each elapsed full minute (except last minute)      | bip      |
+| **AMRAP**  | Exactly at the halfway point of the total duration | BIP      |
+| **AMRAP**  | 30 s remaining in the last minute                  | bip      |
+| **AMRAP**  | 2 s and 1 s remaining                              | bip, bip |
+| **AMRAP**  | Timer expires                                      | BIP      |
+| **TABATA** | Start of each work or rest phase                   | BIP      |
+| **TABATA** | Halfway through each work or rest interval         | bip      |
+| **TABATA** | 2 s and 1 s before each phase ends                 | bip, bip |
+
+The **bip, bip, BIP** pattern you hear at the end of each interval is an evenly-spaced 3-beat countdown (one beat per second) leading into the next phase.
+
+### Prefill from Last Run
+
+When you re-run a session, the reps and weight fields are prefilled with your values from the most recent run of that session. On the first run, fields default to the values configured on each session item.
+
+### Exiting Mid-Session
+
+Press the **✕** button at any time to exit. Steps you already completed are saved to history; unfinished steps are omitted. The session appears in history as a partial run.
+
+---
+
+## Statistics
+
+The Statistics page is accessible via the **Statistics** link in the navigation.
+
+### Database Creation Date
+
+At the top of the page: "You are using TrainUs since [date]" — when you first installed the app. The date format updates when you switch languages.
+
+### Date Range Filter
+
+Four tabs let you focus charts and summary cards on a specific period:
+
+| Tab      | Period                 |
+| -------- | ---------------------- |
+| 7 days   | Last 7 days            |
+| 30 days  | Last 30 days (default) |
+| 3 months | Last 3 months          |
+| All time | All recorded history   |
+
+### Summary Cards
+
+| Card           | What it shows                                                                                            |
+| -------------- | -------------------------------------------------------------------------------------------------------- |
+| Sessions       | Sessions executed in the selected period                                                                 |
+| Exercises done | Individual exercise sets completed in the period                                                         |
+| Day streak     | Consecutive calendar days (ending today) with at least one session; always calculated across all history |
+
+### Frequency Chart
+
+A bar chart showing how many sessions you executed per week or per month. Use the **Per week / Per month** toggle to switch the grouping.
+
+### Volume Chart
+
+A bar chart showing the total volume (reps × weight in kg) per session execution over time. Only weighted exercises (weight > 0) contribute to volume.
+
+### Progression Chart
+
+A line chart showing how your reps and max weight for a specific exercise evolve over time. Two lines are drawn on independent Y-axes — reps on the left, weight on the right.
+
+1. Select an exercise from the dropdown.
+2. Only exercises with at least one logged set appear in the list.
+
+---
+
+## Settings
+
+The Settings page (`#/settings`) lets you configure your preferences, manage your identity, and back up or restore your data. For the database and JSON export/import sections, see also [Understanding TrainUs]({{< relref "comprendre.en.md" >}}) and the [How-to Guides]({{< relref "guides-pratiques.en.md" >}}).
+
+### Language
+
+Select your preferred language (English or Français). The entire interface updates immediately. Your choice is saved and applied on next launch.
+
+### User Name
+
+Enter your name. The value is saved when you leave the field. Empty or whitespace-only names are rejected.
+
+### User ID
+
+Your unique identifier, generated automatically on first launch. Read-only. Used internally to identify your data during import/export.
+
+### Theme
+
+Switch between **Light** and **Dark** color schemes. Applied immediately and saved for future visits.
+
+### Sound Volume
+
+A slider sets the volume of the bip/BIP sounds used during timed combos (EMOM, AMRAP, TABATA) — see [Audio Cues](#audio-cues). The setting is applied immediately and saved for future sessions. Click **Test** to preview both sounds (bip then BIP) at the current volume.
+
+### Download Database
+
+Click **Download Database** to export a full backup of your data as a raw SQLite file. A dialog prompts you to confirm or rename the file before it's saved; the default name is:
+
+```
+trainus-{version}-backup-YYYYMMDD-HHhMMmSSs.sqlite3
+```
+
+The timestamp uses your local time and is zero-padded for easy sorting. This file can be restored using the Restore function, or inspected with any SQLite tool (e.g., DB Browser for SQLite). Cancelling the dialog leaves your backup status unchanged — the same prompt also appears for the mandatory backup on the update screen, and the **Update** button stays disabled until you actually save the file.
+
+### Restore Database
+
+The Restore function replaces **all** your current data with the contents of a previously downloaded database file.
+
+**Steps:**
+
+1. Click **Restore Database** and select a `.sqlite3` or `.db` file.
+2. A confirmation dialog warns you that all current data will be replaced.
+3. A spinner appears during the restore process.
+4. A report card shows the result.
+
+**On success**: a green header, a list of restored tables with row counts, and an optional note if the schema was adapted from an older version. Settings (name, language, theme) are updated in-place — no page reload needed.
+
+**On failure**, the report shows a specific error:
+
+| Error                | Meaning                                       |
+| -------------------- | --------------------------------------------- |
+| Invalid file         | Not a valid SQLite database or corrupted      |
+| Incomplete database  | Missing required tables (not a TrainUs file)  |
+| Incompatible version | No migration path from this schema version    |
+| Adaptation failed    | Schema migration from an older version failed |
+| Restore failed       | Error during the data copy process            |
+
+### Initialize Database
+
+Permanently deletes **all** your data and resets the database to its initial state.
+
+**Steps:**
+
+1. Click **Initialize Database**.
+2. Check the confirmation checkbox: "I understand that this will permanently delete all my data and cannot be reversed."
+3. Click **Initialize Database** to proceed.
+4. The page reloads with a fresh database.
+
+> **Warning:** This action cannot be undone. Use **Download Database** first if you want to keep your data.
+
+### Backup Reminder
+
+TrainUs shows a warning button (⚠) in the action bar when your last backup is older than the configured interval (default: 7 days), or when you have never backed up.
+
+- **What it shows**: Days since your last backup, or "No backup yet".
+- **Click the button**: Takes you to the Settings page, scrolling to the Database section.
+- **The reminder persists** until you back up or adjust the interval so the last backup is no longer stale.
+- **Grace period**: Fresh databases (created within the last 7 days, or the configured interval) do not show the warning immediately.
+
+### App Updates
+
+App updates are automatic and preserve your data — you never need to export and re-import anything when a new version of TrainUs is released.
+
+If an update changes the database structure, TrainUs shows a one-time update screen at startup. As a safety measure, it asks you to **download a backup** of your data first; the **Update** button becomes available once the backup has been saved. The update then runs in a few seconds and the app continues with all your data in place. If anything were to go wrong, your data is left unchanged and you hold the backup you just downloaded.
+
+The regular backup reminder remains your day-to-day safety net.
+
+In the Database section, you can also see:
+
+- **Last backup date** — when you last downloaded or restored a backup.
+- **Remind me every N days** — configurable interval (1–365, default 7).
+
+### Export / Import Data
+
+**Export Data** opens a filter dialog where you select which entity types to include. You can export any combination of exercises, combos, sessions, collections, and execution logs.
+
+**Import Data** opens a file picker for a `.json` file previously exported from TrainUs. See [Import / Export Data](#export--import-data) above for details on the import flow and collision handling.
+
+### Import Suffixes
+
+When you have imported data from other users, this section shows all registered suffixes. Each entry displays the external user's name and their assigned short tag. You can edit or delete entries — see [Managing Import Suffixes](#managing-import-suffixes) above.
+
+### Credits
+
+Click the **Credits** button to open the Credits dialog. It lists the open-source resources used to build TrainUs:
+
+- **Mighty Force** (app icon) — by Delapouite, from [game-icons.net](https://game-icons.net), license CC BY 3.0. game-icons.net is maintained by Lorc, Delapouite & contributors.
+- **Bootstrap Icons** (UI icons used throughout the application) — from [icons.getbootstrap.com](https://icons.getbootstrap.com), license MIT.
+- **Third-party libraries** — [Vue](https://vuejs.org), [Vue Router](https://router.vuejs.org), [Vite](https://vitejs.dev), [SQLite WASM](https://sqlite.org/wasm/), [Chart.js](https://www.chartjs.org), [vue-chartjs](https://vue-chartjs.org), [i18next](https://www.i18next.com), [i18next-vue](https://i18next.github.io/i18next-vue/), [Prettier](https://prettier.io), [vite-plugin-pwa](https://vite-pwa-org.netlify.app), [marked](https://marked.js.org), [DOMPurify](https://github.com/cure53/DOMPurify).
+- **Testing Tools** — [Playwright](https://playwright.dev/python/), [pytest](https://pytest.org).
+
+### About TrainUs
+
+Click the **About TrainUs** button to open the About dialog. It shows:
+
+- **App Version** — the current version of TrainUs (e.g., `1.0.0`).
+- **DB Version** — the current database schema version.
+- **Created by** — David Florance.
+- **License** — GNU AGPL v3.
+- **Links** — links to the project repository and website.
+- **Copyright Notice** — a short copyright statement and AGPL license summary shown directly in the dialog.
+- **View License** — opens the full GNU AGPL v3 license text in a dialog.
+
+---
+
+## Appendix: Markdown Cheat Sheet
+
+All description fields (exercises, combos, sessions) accept a subset of Markdown. What you type in the field is already close to what you see, but here's a quick reminder:
+
+| You type              | You get                      |
+| --------------------- | ---------------------------- |
+| `**bold**`            | **bold**                     |
+| `*italic*`            | _italic_                     |
+| `- item`              | <ul><li>item</li></ul>       |
+| `1. item`             | <ol><li>item</li></ol>       |
+| `` `code` ``          | `code`                       |
+| `[text](https://...)` | [text](https://example.com/) |
diff --git a/website/content/docs/user-guide/index.fr.md b/website/content/docs/user-guide/index.fr.md
new file mode 100644
index 0000000..e04766d
--- /dev/null
+++ b/website/content/docs/user-guide/index.fr.md
@@ -0,0 +1,672 @@
+---
+title: 'Référence'
+description: 'Comment utiliser TrainUs : exercices, combos, séances, collections, exécution et statistiques.'
+weight: 3
+date: 2026-06-14
+---
+
+> Cette page décrit chaque écran de TrainUs en détail : actions disponibles, champs des formulaires, raccourcis clavier. Pour une présentation générale, voir [Démarrage rapide]({{< relref "demarrage-rapide.fr.md" >}}) ; pour le « pourquoi » des choix, voir [Comprendre TrainUs]({{< relref "comprendre.fr.md" >}}).
+
+## Accueil
+
+La page d'accueil (`#/home`) est la page par défaut. Elle donne un aperçu de votre activité récente.
+
+### Aperçu de l'activité
+
+Deux cartes en haut de page :
+
+- **Séances (7 derniers jours)** : nombre de séances exécutées au cours des 7 derniers jours.
+- **Séances (30 derniers jours)** : nombre de séances exécutées au cours des 30 derniers jours.
+
+### Séances récentes
+
+Les 4 séances les plus récemment exécutées sont affichées en cartes. Chaque carte montre :
+
+- Le titre de la séance et la date d'exécution (au format de votre langue).
+- La durée totale de la séance (si elle a été terminée sans sortie anticipée).
+- Un résumé compact de chaque exercice réalisé — répétitions, poids et durée réels par série. Les éléments de type combo affichent le nombre de tours et le détail des exercices.
+- Un **bouton lecture (▶)** pour relancer immédiatement cette séance.
+
+Cliquez sur la carte (en dehors du bouton lecture) pour aller au détail de la séance.
+
+S'il n'y a encore aucune séance exécutée, un message d'état vide s'affiche.
+
+> **Note** : les séances n'apparaissent ici qu'une fois exécutées en mode exécution. Créer une séance dans le formulaire ne l'ajoute pas à cette liste.
+
+### Historique
+
+Sous les séances récentes, la section **Historique** montre toutes vos exécutions passées, groupées par jour (les plus récentes d'abord).
+
+- Chaque jour affiche sa date, et chaque carte en dessous montre une exécution avec sa durée, son résumé d'exercices et un bouton lecture.
+- Deux sélecteurs de date (**Du** / **Au**) permettent de restreindre la plage. Par défaut : les 30 derniers jours.
+- Le filtre s'applique immédiatement, sans rechargement.
+
+### Export HTML
+
+Dès que vous avez de l'historique, un bouton **`</> HTML`** apparaît dans la barre d'action. Il génère un fichier HTML autonome de votre page d'accueil — statistiques, séances récentes et plage d'historique actuelle — sans aucun lien de navigation, bouton lecture ni contrôle interactif. Une boîte de dialogue vous demande de nommer le fichier avant l'enregistrement. Le fichier peut être sauvegardé, imprimé ou partagé : avec un ami, ou avec votre coach pour qu'il suive votre historique d'entraînement. Les images (comme l'icône de l'application) sont intégrées directement dans le fichier.
+
+---
+
+## Navigation
+
+TrainUs utilise une navigation responsive :
+
+- **Grand écran** (plus de 700px) : un menu fixe sur la gauche, avec des liens libellés.
+- **Tablette / mobile** (700px ou moins) : une barre de navigation en bas, avec icônes et libellés.
+- **Petit mobile** (400px ou moins) : une barre compacte en bas, icônes seules.
+
+La navigation donne accès à 7 sections : **Accueil**, **Exercices**, **Combos**, **Séances**, **Collections**, **Statistiques** et **Réglages**.
+
+---
+
+## Raccourcis clavier
+
+TrainUs prend en charge des raccourcis clavier pour naviguer plus vite. La plupart sont **ignorés quand le curseur est dans un champ texte, une zone de texte ou une liste déroulante** — les exceptions sont précisées ci-dessous.
+
+### Menu de navigation
+
+| Touche            | Action                                                                     |
+| ----------------- | -------------------------------------------------------------------------- |
+| `Tab` / `Maj+Tab` | Déplacer le focus vers et hors du menu de navigation                       |
+| `↑` `↓` `←` `→`   | Déplacer le focus entre les éléments du menu (quand l'un d'eux a le focus) |
+| `Entrée`          | Aller à l'élément de menu ayant le focus                                   |
+
+### Écrans de liste
+
+Ces raccourcis sont disponibles sur les listes Exercices, Combos, Séances et Collections.
+
+| Touche            | Action                                         |
+| ----------------- | ---------------------------------------------- |
+| `Tab` / `Maj+Tab` | Déplacer le focus entre les cartes de la liste |
+| `N`               | Ouvrir le formulaire « Nouveau »               |
+| `↓`               | Focus sur la carte suivante                    |
+| `↑`               | Focus sur la carte précédente                  |
+| `Entrée`          | Ouvrir la carte ayant le focus                 |
+| `Échap`           | Désélectionner la carte ayant le focus         |
+
+### Écrans de formulaire
+
+Ces raccourcis sont disponibles sur tous les formulaires de création et d'édition (Exercice, Combo, Séance, Collection). Ils fonctionnent **même quand un champ texte a le focus**.
+
+| Touche        | Action                                                       |
+| ------------- | ------------------------------------------------------------ |
+| `Ctrl+Entrée` | Enregistrer le formulaire (équivalent au bouton Enregistrer) |
+| `Échap`       | Annuler et revenir en arrière sans enregistrer               |
+
+Survolez le bouton **Enregistrer** pour voir le raccourci dans une infobulle.
+
+### Écrans de détail
+
+Ces raccourcis sont disponibles sur les écrans de détail Exercice, Combo, Séance et Collection.
+
+| Touche  | Action                         |
+| ------- | ------------------------------ |
+| `E`     | Ouvrir le formulaire d'édition |
+| `Échap` | Revenir à la liste             |
+
+### Boîtes de dialogue
+
+| Touche  | Action                      |
+| ------- | --------------------------- |
+| `Échap` | Fermer la boîte de dialogue |
+
+---
+
+## Exercices
+
+La section Exercices, accessible via le lien **Exercices** du menu, permet de créer, voir, modifier, rechercher et supprimer des exercices individuels.
+
+### Liste des exercices
+
+|             |                                                                    |
+| ----------- | ------------------------------------------------------------------ |
+| **Route**   | `#/exercises`                                                      |
+| **Contenu** | Une liste de cartes d'exercice, ou un message si la liste est vide |
+| **Actions** | Recherche (loupe) et Nouveau (plus) dans la barre d'action         |
+
+Chaque carte affiche :
+
+- **Titre** (toujours visible)
+- **Badge répétitions** (si répétitions par défaut > 0) — ex. « 12 reps »
+- **Badge poids** (si poids par défaut > 0) — ex. « 10 kg »
+- **Icône asymétrique** (si l'exercice est asymétrique)
+
+Cliquez sur une carte pour ouvrir le détail de l'exercice.
+
+### Créer un exercice
+
+|           |                                     |
+| --------- | ----------------------------------- |
+| **Route** | `#/exercises/new`                   |
+| **Accès** | Bouton **+** dans la barre d'action |
+
+| Champ                  | Type          | Obligatoire | Notes                                                               |
+| ---------------------- | ------------- | ----------- | ------------------------------------------------------------------- |
+| Titre                  | Texte         | Oui         | Doit être unique parmi tous les exercices                           |
+| Description            | Zone de texte | Non         | [Markdown basique pris en charge](#annexe--aide-mémoire-markdown)   |
+| Asymétrique            | Case à cocher | Non         | Affiche les options d'alternance si cochée                          |
+| Alternance             | Boutons radio | Non         | Visible seulement si Asymétrique est cochée                         |
+| Répétitions par défaut | Nombre        | Non         | Doit être ≥ 0                                                       |
+| Poids par défaut       | Nombre        | Non         | Doit être ≥ 0                                                       |
+| URLs d'images          | Liste d'URLs  | Non         | Une URL à la fois ; HTTP(S) valide                                  |
+| URLs de vidéos         | Liste d'URLs  | Non         | Une URL à la fois ; les URLs YouTube sont intégrées automatiquement |
+
+> **Images ou vidéos ?** Préférez les images si vous voulez travailler hors ligne : une fois qu'une image a été affichée au moins une fois sur votre appareil, elle reste disponible hors ligne. Les vidéos, elles, sont chargées depuis internet à chaque visionnage et ne fonctionnent donc pas sans connexion.
+
+Cliquez sur **Enregistrer** pour créer l'exercice, ou **Annuler** pour revenir en arrière sans enregistrer.
+
+### Détail d'un exercice
+
+|             |                                                                         |
+| ----------- | ----------------------------------------------------------------------- |
+| **Route**   | `#/exercises/:id`                                                       |
+| **Accès**   | Cliquer sur une carte exercice dans la liste                            |
+| **Actions** | Retour, Modifier (crayon), Supprimer (corbeille) dans la barre d'action |
+
+Affiche toutes les informations en lecture seule, y compris images et vidéos YouTube intégrées. La description est rendue en Markdown formaté.
+
+### Modifier un exercice
+
+|           |                                         |
+| --------- | --------------------------------------- |
+| **Route** | `#/exercises/:id/edit`                  |
+| **Accès** | Icône **crayon** dans la barre d'action |
+
+Le formulaire d'édition est identique au formulaire de création, pré-rempli avec les données actuelles.
+
+### Supprimer un exercice
+
+Cliquez sur l'icône **corbeille** dans la barre d'action. Une boîte de dialogue de confirmation apparaît ; si l'exercice a déjà été exécuté, elle indique combien d'entrées de journal seront supprimées avec lui. En confirmant, l'exercice est supprimé définitivement — ainsi que les entrées de journal d'exécution qui le concernent — et vous revenez à la liste.
+
+> Le reste de chaque séance enregistrée (les autres exercices de ce même journal) reste intact.
+
+### Rechercher des exercices
+
+Cliquez sur l'icône **loupe** dans la barre d'action. À chaque caractère tapé, la liste se filtre en temps réel (avec un court délai). La recherche porte sur le titre (insensible à la casse, correspondance partielle). Un bouton **d'effacement (×)** apparaît dans le champ dès qu'il contient du texte — cliquez-le pour vider le champ sans quitter le mode recherche. Cliquez à nouveau sur l'icône loupe ou videz le champ pour retrouver la liste complète.
+
+---
+
+## Combos
+
+La section Combos permet de regrouper des exercices — utile pour des supersets, des circuits, ou des formats minutés (EMOM, AMRAP, TABATA).
+
+### Liste des combos
+
+|             |                                                               |
+| ----------- | ------------------------------------------------------------- |
+| **Route**   | `#/combos`                                                    |
+| **Contenu** | Une liste de cartes combo, ou un message si la liste est vide |
+| **Actions** | Recherche (loupe) et Nouveau (plus) dans la barre d'action    |
+
+Chaque carte affiche : **Titre**, **Badge type** (NONE / EMOM / AMRAP / TABATA), **Nombre d'exercices**.
+
+### Créer un combo
+
+|           |                                     |
+| --------- | ----------------------------------- |
+| **Route** | `#/combos/new`                      |
+| **Accès** | Bouton **+** dans la barre d'action |
+
+| Champ               | Type             | Obligatoire | Notes                                                             |
+| ------------------- | ---------------- | ----------- | ----------------------------------------------------------------- |
+| Titre               | Texte            | Oui         | Doit être unique parmi tous les combos                            |
+| Description         | Zone de texte    | Non         | [Markdown basique pris en charge](#annexe--aide-mémoire-markdown) |
+| Type                | Liste déroulante | Non         | NONE (par défaut), EMOM, AMRAP ou TABATA                          |
+| Réglage du minuteur | Nombre           | Non         | Durée en minutes pour EMOM/AMRAP ; nombre de tours pour TABATA    |
+| Exercices           | Liste ordonnée   | Non         | Ajoutés depuis votre bibliothèque ; réordonnables par flèches     |
+
+**Ajouter des exercices à un combo :**
+
+1. Choisissez un exercice dans la liste déroulante et cliquez sur **Ajouter l'exercice**.
+2. Pour chaque exercice, réglez **Répétitions** (≥ 1) et **Poids** en kg (≥ 0).
+3. Utilisez les flèches haut/bas pour réordonner, l'icône corbeille pour retirer.
+
+Cliquez sur **Enregistrer** pour créer le combo.
+
+### Détail d'un combo
+
+|             |                                                                         |
+| ----------- | ----------------------------------------------------------------------- |
+| **Route**   | `#/combos/:id`                                                          |
+| **Accès**   | Cliquer sur une carte combo dans la liste                               |
+| **Actions** | Retour, Modifier (crayon), Supprimer (corbeille) dans la barre d'action |
+
+Affiche les informations du combo, y compris la liste ordonnée des exercices avec répétitions et poids. Les noms d'exercices renvoient à leur détail. La description est rendue en Markdown formaté.
+
+### Modifier un combo
+
+|           |                                         |
+| --------- | --------------------------------------- |
+| **Route** | `#/combos/:id/edit`                     |
+| **Accès** | Icône **crayon** dans la barre d'action |
+
+### Supprimer un combo
+
+Cliquez sur l'icône **corbeille** dans la barre d'action. En confirmant, le combo est supprimé définitivement.
+
+---
+
+## Séances
+
+La section Séances permet de construire des séances d'entraînement — des listes ordonnées d'exercices et/ou de combos. Ce sont les séances que vous exécutez lors d'un entraînement.
+
+### Liste des séances
+
+|             |                                                                |
+| ----------- | -------------------------------------------------------------- |
+| **Route**   | `#/sessions`                                                   |
+| **Contenu** | Une liste de cartes séance, ou un message si la liste est vide |
+| **Actions** | Recherche (loupe), Nouveau (plus), et bouton lecture par carte |
+
+Chaque carte affiche : **Titre**, **Nombre d'éléments**, et un **bouton lecture (▶)** pour lancer l'exécution.
+
+### Créer une séance
+
+|           |                                     |
+| --------- | ----------------------------------- |
+| **Route** | `#/sessions/new`                    |
+| **Accès** | Bouton **+** dans la barre d'action |
+
+| Champ       | Type           | Obligatoire | Notes                                                             |
+| ----------- | -------------- | ----------- | ----------------------------------------------------------------- |
+| Titre       | Texte          | Oui         | Doit être unique parmi toutes les séances                         |
+| Description | Zone de texte  | Non         | [Markdown basique pris en charge](#annexe--aide-mémoire-markdown) |
+| Éléments    | Liste ordonnée | Non         | Mélange d'exercices et de combos ; réordonnable par flèches       |
+
+**Ajouter des éléments à une séance :**
+
+1. Choisissez le type d'élément : **Exercice** ou **Combo**.
+2. Sélectionnez un élément dans la liste déroulante correspondante et cliquez sur **Ajouter**.
+3. Pour chaque élément, réglez :
+   - **Répétitions** (≥ 1) — pour un combo, c'est le nombre de tours complets de la liste d'exercices du combo.
+   - **Poids** en kg (≥ 0) — remplace le poids par défaut de l'exercice pendant l'exécution.
+4. Utilisez les flèches haut/bas pour réordonner, l'icône corbeille pour retirer.
+
+Cliquez sur **Enregistrer** pour créer la séance.
+
+### Détail d'une séance
+
+|             |                                                               |
+| ----------- | ------------------------------------------------------------- |
+| **Route**   | `#/sessions/:id`                                              |
+| **Accès**   | Cliquer sur une carte séance dans la liste                    |
+| **Actions** | Retour, Lecture (▶), Modifier (crayon), Supprimer (corbeille) |
+
+Affiche la description (rendue en Markdown) et la liste ordonnée des éléments avec leurs répétitions et poids. Les noms d'éléments renvoient à leur détail.
+
+### Modifier une séance
+
+|           |                                         |
+| --------- | --------------------------------------- |
+| **Route** | `#/sessions/:id/edit`                   |
+| **Accès** | Icône **crayon** dans la barre d'action |
+
+Le formulaire d'édition est identique au formulaire de création, pré-rempli avec les données actuelles.
+
+### Supprimer une séance
+
+Cliquez sur l'icône **corbeille** dans la barre d'action. Une boîte de dialogue de confirmation apparaît ; si la séance a des journaux d'exécution passés, elle indique combien seront supprimés avec elle. En confirmant, la séance est supprimée définitivement, ainsi que tout son historique d'exécution — cette action est irréversible.
+
+---
+
+## Collections
+
+La section Collections permet de regrouper des séances dans des ensembles ordonnés — utile pour organiser un programme hebdomadaire, des phases d'entraînement, ou des séances thématiques.
+
+### Liste des collections
+
+|             |                                                                    |
+| ----------- | ------------------------------------------------------------------ |
+| **Route**   | `#/collections`                                                    |
+| **Contenu** | Une liste de cartes collection, ou un message si la liste est vide |
+| **Actions** | Recherche (loupe) et Nouveau (plus) dans la barre d'action         |
+
+Chaque carte affiche : **Libellé** et **Badge nombre de séances** (ex. « 3 séances »).
+
+### Créer une collection
+
+|           |                                     |
+| --------- | ----------------------------------- |
+| **Route** | `#/collections/new`                 |
+| **Accès** | Bouton **+** dans la barre d'action |
+
+| Champ   | Type           | Obligatoire | Notes                                                          |
+| ------- | -------------- | ----------- | -------------------------------------------------------------- |
+| Libellé | Texte          | Oui         | Doit être unique parmi toutes les collections                  |
+| Séances | Liste ordonnée | Non         | Ajoutées depuis votre bibliothèque ; réordonnables par flèches |
+
+Une même séance ne peut apparaître qu'une fois dans une collection. Cliquez sur **Enregistrer** pour créer la collection.
+
+### Détail d'une collection
+
+|             |                                                  |
+| ----------- | ------------------------------------------------ |
+| **Route**   | `#/collections/:id`                              |
+| **Accès**   | Cliquer sur une carte collection dans la liste   |
+| **Actions** | Retour, Modifier (crayon), Supprimer (corbeille) |
+
+Affiche la liste ordonnée des séances. Les noms de séances renvoient à leur détail.
+
+### Modifier une collection
+
+|           |                                         |
+| --------- | --------------------------------------- |
+| **Route** | `#/collections/:id/edit`                |
+| **Accès** | Icône **crayon** dans la barre d'action |
+
+### Supprimer une collection
+
+Cliquez sur l'icône **corbeille** dans la barre d'action. En confirmant, la collection est supprimée définitivement (les séances elle-mêmes **ne sont pas** supprimées — seul le regroupement disparaît).
+
+---
+
+## Export / Import de données
+
+TrainUs peut exporter et importer vos données sous forme de fichiers JSON. Cela permet de partager des données entre appareils, de collaborer avec d'autres utilisateurs, ou de garder des sauvegardes structurées par type d'entité.
+
+### Exporter des données
+
+Plusieurs points d'export possibles :
+
+| Depuis                                            | Portée                                                                                                                            |
+| ------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------- |
+| **Liste** Exercice / Combo / Séance / Collection  | Tous les éléments de ce type, ou seulement ceux filtrés si une recherche est active (icône téléchargement dans la barre d'action) |
+| **Détail** Exercice / Combo / Séance / Collection | Un seul élément (icône téléchargement dans la barre d'action)                                                                     |
+| **Réglages → Exporter des données**               | N'importe quelle combinaison de types d'entité (boîte de filtres)                                                                 |
+
+Avant l'enregistrement, une boîte de dialogue permet de renommer le fichier — elle est préremplie avec un nom par défaut construit à partir du type d'entité et de la date (ex. `trainus-exercises-2026-05-26`, ou `trainus-full-2026-05-26` pour un export complet depuis les Réglages). L'extension `.json` est fixe et affichée à côté du champ de nom. Cliquez sur **Enregistrer** pour valider le nom (ou appuyez sur Entrée pour garder le nom par défaut), ou sur **Annuler** pour abandonner sans rien enregistrer.
+
+Exporter un combo, une séance ou une collection (depuis une liste, une vue détail, ou une sélection filtrée) embarque toujours les entités dont il dépend — exporter une séance inclut aussi ses combos et exercices, exporter une collection inclut aussi ses séances, combos et exercices — afin que le fichier puisse être importé seul sans référence manquante, même si vous n'avez sélectionné qu'un seul type d'entité dans la boîte de filtres des Réglages.
+
+### Importer des données
+
+Pour importer un fichier JSON précédemment exporté depuis TrainUs :
+
+1. Cliquez sur l'icône d'import sur une liste, ou sur **Importer des données** dans les Réglages.
+2. Sélectionnez le fichier `.json`.
+
+**Si le fichier vient de votre propre compte** (même utilisateur), TrainUs vous montre les conflits éventuels (éléments déjà existants avec le même identifiant, ou avec le même titre si un autre élément le porte déjà). Pour chaque conflit :
+
+- **Remplacer** : écrase l'élément existant par la version importée (en conservant son identifiant d'origine en cas de conflit de titre).
+- **Ignorer** : garde votre élément actuel. Si d'autres éléments du même fichier y faisaient référence (ex. un combo utilisant cet exercice), ils sont automatiquement redirigés vers votre élément existant.
+- **Tout remplacer** ou **Tout ignorer** pour traiter le lot en une seule fois.
+
+**Si le fichier vient d'un autre utilisateur**, on vous demande de choisir un court suffixe (ex. « JD »). Tous les titres importés reçoivent ce suffixe : « Pompes [JD] ». Si vous importez à nouveau depuis le même utilisateur externe, le suffixe existant est réutilisé automatiquement — et si le titre suffixé entre en conflit avec un élément déjà importé précédemment, le même choix Remplacer/Ignorer s'applique.
+
+Un écran de prévisualisation résume ce qui va être importé avant toute modification. Après l'import, un rapport indique combien d'éléments ont été ajoutés, mis à jour ou ignorés.
+
+### Gérer les suffixes d'import
+
+Après avoir importé des données d'autres utilisateurs, une section **Suffixes d'import** apparaît dans les Réglages. Vous pouvez :
+
+- **Modifier** un suffixe : le changement met à jour automatiquement tous les titres concernés, dans tous les types d'entité (exercices, combos, séances, collections).
+- **Supprimer** une entrée de suffixe (ne supprime pas les éléments déjà importés).
+
+---
+
+## Mode Exécution
+
+Le mode exécution permet de dérouler une séance étape par étape, en enregistrant les répétitions et le poids réellement utilisés.
+
+### Lancer une séance
+
+- Depuis la **liste des Séances** : bouton **lecture (▶)** sur n'importe quelle carte.
+- Depuis le **détail d'une séance** : bouton **lecture** dans la barre d'action.
+
+### Pendant l'exécution
+
+L'écran d'exécution affiche :
+
+1. **Barre de progression** — nombre d'étapes terminées sur le total.
+2. **Carte de l'étape en cours** — l'exercice en cours, avec des champs répétitions et poids modifiables.
+3. **Aperçu de l'étape suivante** — l'exercice à venir (titre, répétitions, contexte du combo si applicable).
+
+Pour les exercices asymétriques, un bouton **Côté** apparaît. Il permet d'alterner entre GAUCHE et DROITE.
+
+Cliquez sur **✓ Terminé** pour enregistrer l'étape en cours et passer à la suivante.
+
+### Détail de l'exercice pendant l'exécution
+
+Le titre de l'exercice dans la carte de l'étape en cours est cliquable. Cliquer dessus déplie un panneau de détail montrant la description, les images et les liens vidéo de l'exercice — pratique pour vérifier un point technique en plein effort.
+
+- **Cliquer sur le titre** → le panneau se déplie et le chronomètre (s'il tourne) se met en pause automatiquement.
+- **Cliquer à nouveau** → le panneau se replie et le chronomètre reprend.
+
+Si vous aviez déjà mis le chronomètre en pause manuellement avant de déplier le panneau, il reste en pause en le repliant — seuls les chronomètres mis en pause par le dépliage reprennent automatiquement.
+
+Le panneau se referme automatiquement quand vous passez à l'étape suivante.
+
+### Les combos en mode exécution
+
+Quand un élément de la séance est un combo :
+
+- Chaque exercice du combo est présenté comme sa propre étape, avec le nom du combo et le numéro du tour affichés.
+- Les tours s'enchaînent **automatiquement** — terminer le dernier exercice d'un tour passe directement au premier exercice du tour suivant, sans écran de pause.
+- Après le **dernier exercice du dernier tour**, un écran de fin de tours apparaît :
+  - **Continuer →** — passer à l'élément suivant de la séance (ou terminer la séance s'il n'en reste pas).
+  - **+ Un tour de plus** — ajouter un tour supplémentaire et continuer.
+
+| EMOM                                                           | AMRAP                                                                     |
+| -------------------------------------------------------------- | ------------------------------------------------------------------------- |
+| ![Combo EMOM en cours, chronomètre à 1 minute](combo-emom.png) | ![Combo AMRAP en cours, chronomètre en compte à rebours](combo-amrap.png) |
+
+| TABATA — phase de travail                                         | TABATA — phase de repos                                                     |
+| ----------------------------------------------------------------- | --------------------------------------------------------------------------- |
+| ![Combo TABATA, phase de travail en cours](combo-tabata-work.png) | ![Combo TABATA, écran de repos entre deux exercices](combo-tabata-rest.png) |
+
+**EMOM et AMRAP — champ « Durée (min) »** : quand vous ajoutez un combo EMOM ou AMRAP à une séance, le champ **Répétitions** est renommé **Durée (min)** pour clarifier son sens. Pour l'EMOM, c'est le nombre total de minutes : l'application divise par le nombre d'exercices du combo pour calculer le nombre de tours (chaque exercice occupe une tranche de 60 secondes). Pour l'AMRAP, la durée est la longueur du compte à rebours.
+
+### Signaux sonores
+
+TrainUs utilise de courts bips pour vous aider à garder le rythme sans regarder l'écran. Deux sons sont utilisés :
+
+- **bip** — une tonalité courte et douce (440 Hz) : un signal discret ou un repère de compte à rebours.
+- **BIP** — une tonalité plus longue et plus forte (880 Hz) : marque un événement important (changement de phase, fin du temps).
+
+| Type de minuteur | Quand                                                   | Son      |
+| ---------------- | ------------------------------------------------------- | -------- |
+| **EMOM**         | Toutes les 30 secondes restantes                        | bip      |
+| **EMOM**         | À 2 s et 1 s restantes                                  | bip      |
+| **EMOM**         | Fin du temps (passage automatique)                      | BIP      |
+| **AMRAP**        | À chaque minute écoulée (sauf la dernière)              | bip      |
+| **AMRAP**        | Exactement à la moitié de la durée totale               | BIP      |
+| **AMRAP**        | 30 s restantes dans la dernière minute                  | bip      |
+| **AMRAP**        | À 2 s et 1 s restantes                                  | bip, bip |
+| **AMRAP**        | Fin du temps                                            | BIP      |
+| **TABATA**       | Début de chaque phase de travail ou de repos            | BIP      |
+| **TABATA**       | À la moitié de chaque intervalle de travail ou de repos | bip      |
+| **TABATA**       | 2 s et 1 s avant la fin de chaque phase                 | bip, bip |
+
+Le motif **bip, bip, BIP** entendu à la fin de chaque intervalle est un compte à rebours à 3 temps régulièrement espacés (un bip par seconde) menant à la phase suivante.
+
+### Pré-remplissage depuis la dernière exécution
+
+Quand vous relancez une séance, les champs répétitions et poids sont pré-remplis avec vos valeurs de la dernière exécution de cette séance. Au premier lancement, les champs prennent les valeurs configurées sur chaque élément de la séance.
+
+### Quitter en cours de séance
+
+Le bouton **✕** permet de quitter à tout moment. Les étapes déjà terminées sont enregistrées dans l'historique ; les étapes non terminées sont omises. La séance apparaît dans l'historique comme une exécution partielle.
+
+---
+
+## Statistiques
+
+La page Statistiques est accessible via le lien **Statistiques** du menu.
+
+### Date de création de la base
+
+En haut de page : « Vous utilisez TrainUs depuis le [date] » — la date de votre premier lancement de l'application. Le format de date s'adapte à la langue choisie.
+
+### Filtre de période
+
+Quatre onglets permettent de cibler les graphiques et cartes de résumé sur une période donnée :
+
+| Onglet            | Période                               |
+| ----------------- | ------------------------------------- |
+| 7 jours           | Les 7 derniers jours                  |
+| 30 jours          | Les 30 derniers jours (par défaut)    |
+| 3 mois            | Les 3 derniers mois                   |
+| Tout l'historique | L'ensemble de l'historique enregistré |
+
+### Cartes de résumé
+
+| Carte              | Ce qu'elle montre                                                                                                     |
+| ------------------ | --------------------------------------------------------------------------------------------------------------------- |
+| Séances            | Séances exécutées dans la période sélectionnée                                                                        |
+| Exercices réalisés | Séries d'exercices individuelles terminées dans la période                                                            |
+| Jours consécutifs  | Jours calendaires consécutifs (jusqu'à aujourd'hui) avec au moins une séance ; toujours calculé sur tout l'historique |
+
+### Graphique de fréquence
+
+Un graphique en barres montrant le nombre de séances exécutées par semaine ou par mois. Utilisez le bouton **Par semaine / Par mois** pour changer le regroupement.
+
+### Graphique de volume
+
+Un graphique en barres montrant le volume total (répétitions × poids en kg) par exécution de séance, dans le temps. Seuls les exercices avec poids (poids > 0) contribuent au volume.
+
+### Graphique de progression
+
+Un graphique en courbes montrant l'évolution des répétitions et du poids maximal pour un exercice donné, dans le temps. Deux courbes sont tracées sur des axes Y indépendants — répétitions à gauche, poids à droite.
+
+1. Choisissez un exercice dans la liste déroulante.
+2. Seuls les exercices ayant au moins une série enregistrée apparaissent dans la liste.
+
+---
+
+## Réglages
+
+La page Réglages (`#/settings`) permet de configurer vos préférences, gérer votre identité, et sauvegarder ou restaurer vos données. Pour le détail des sections base de données et export/import JSON, voir aussi [Comprendre TrainUs]({{< relref "comprendre.fr.md" >}}) et les [Guides pratiques]({{< relref "guides-pratiques.fr.md" >}}).
+
+### Langue
+
+Choisissez votre langue préférée (English ou Français). Toute l'interface est mise à jour immédiatement. Votre choix est enregistré et appliqué au prochain lancement.
+
+### Nom d'utilisateur
+
+Entrez votre nom. La valeur est enregistrée quand vous quittez le champ. Un nom vide ou ne contenant que des espaces est refusé.
+
+### Identifiant utilisateur
+
+Votre identifiant unique, généré automatiquement au premier lancement. Lecture seule. Utilisé en interne pour identifier vos données lors de l'export/import.
+
+### Thème
+
+Basculez entre les thèmes **Clair** et **Sombre**. Appliqué immédiatement et enregistré pour les prochaines visites.
+
+### Volume sonore
+
+Un curseur règle le volume des bips et BIP utilisés pendant les combos minutés (EMOM, AMRAP, TABATA) — voir [Signaux sonores](#signaux-sonores). Le réglage est appliqué immédiatement et enregistré pour les prochaines séances. Cliquez sur **Tester** pour entendre les deux sons (bip puis BIP) au volume actuel.
+
+### Télécharger la base de données
+
+Cliquez sur **Télécharger la base de données** pour exporter une sauvegarde complète de vos données sous forme de fichier SQLite brut. Une boîte de dialogue vous invite à confirmer ou renommer le fichier avant l'enregistrement ; le nom par défaut est :
+
+```
+trainus-{version}-backup-AAAAMMJJ-HHhMMmSSs.sqlite3
+```
+
+L'horodatage utilise votre heure locale et est complété de zéros pour faciliter le tri. Ce fichier peut être restauré via la fonction Restaurer, ou inspecté avec un outil SQLite quelconque (ex. DB Browser for SQLite). Annuler la boîte de dialogue laisse l'état de votre sauvegarde inchangé — la même invite apparaît aussi pour la sauvegarde obligatoire de l'écran de mise à jour, et le bouton **Mettre à jour** reste désactivé jusqu'à ce que le fichier soit réellement enregistré.
+
+### Restaurer la base de données
+
+La fonction Restaurer remplace **toutes** vos données actuelles par le contenu d'un fichier de base de données précédemment téléchargé.
+
+**Étapes :**
+
+1. Cliquez sur **Restaurer la base de données** et choisissez un fichier `.sqlite3` ou `.db`.
+2. Une boîte de dialogue de confirmation vous prévient que toutes les données actuelles seront remplacées.
+3. Un indicateur de chargement apparaît pendant la restauration.
+4. Une carte de rapport affiche le résultat.
+
+**En cas de succès** : un en-tête vert, la liste des tables restaurées avec leur nombre de lignes, et une note optionnelle si le schéma a été adapté depuis une version plus ancienne. Les réglages (nom, langue, thème) sont mis à jour immédiatement, sans rechargement de page.
+
+**En cas d'échec**, le rapport affiche une erreur précise :
+
+| Erreur               | Signification                                               |
+| -------------------- | ----------------------------------------------------------- |
+| Fichier invalide     | Pas une base SQLite valide, ou fichier corrompu             |
+| Base incomplète      | Tables requises manquantes (pas un fichier TrainUs)         |
+| Version incompatible | Pas de chemin de migration depuis ce schéma                 |
+| Adaptation échouée   | La migration du schéma depuis une version ancienne a échoué |
+| Restauration échouée | Erreur pendant la copie des données                         |
+
+### Initialiser la base de données
+
+Supprime définitivement **toutes** vos données et réinitialise la base à son état initial.
+
+**Étapes :**
+
+1. Cliquez sur **Initialiser la base de données**.
+2. Cochez la case de confirmation : « Je comprends que cela supprimera définitivement toutes mes données et que cette action est irréversible. »
+3. Cliquez sur **Initialiser la base de données** pour confirmer.
+4. La page se recharge avec une base de données vierge.
+
+> **Attention :** cette action est irréversible. Utilisez **Télécharger la base de données** au préalable si vous voulez conserver vos données.
+
+### Rappel de sauvegarde
+
+TrainUs affiche un bouton d'alerte (⚠) dans la barre d'action quand votre dernière sauvegarde date de plus que l'intervalle configuré (7 jours par défaut), ou si vous n'avez jamais sauvegardé.
+
+- **Ce qu'il affiche** : le nombre de jours depuis votre dernière sauvegarde, ou « Pas encore de sauvegarde ».
+- **Cliquer sur le bouton** : vous amène aux Réglages, en faisant défiler jusqu'à la section base de données.
+- **Le rappel persiste** jusqu'à ce que vous sauvegardiez, ou que vous ajustiez l'intervalle pour que la dernière sauvegarde ne soit plus considérée comme ancienne.
+- **Période de grâce** : une base toute neuve (créée dans les 7 derniers jours, ou l'intervalle configuré) n'affiche pas le rappel immédiatement.
+
+### Mises à jour de l'application
+
+Les mises à jour de l'application sont automatiques et préservent vos données — vous n'avez jamais besoin d'exporter puis ré-importer quoi que ce soit lors de la sortie d'une nouvelle version de TrainUs.
+
+Si une mise à jour change la structure de la base de données, TrainUs affiche un écran de mise à jour unique au démarrage. Par sécurité, il vous demande d'abord de **télécharger une sauvegarde** de vos données ; le bouton **Mettre à jour** devient disponible une fois la sauvegarde enregistrée. La mise à jour s'exécute alors en quelques secondes et l'application continue avec toutes vos données en place. Si quoi que ce soit devait mal se passer, vos données restent inchangées et vous disposez de la sauvegarde que vous venez de télécharger.
+
+Le rappel de sauvegarde habituel reste votre filet de sécurité au quotidien.
+
+Dans la section base de données, vous pouvez aussi voir :
+
+- **Date de dernière sauvegarde** — quand vous avez téléchargé ou restauré une sauvegarde pour la dernière fois.
+- **Me le rappeler tous les N jours** — intervalle configurable (1 à 365, 7 par défaut).
+
+### Export / Import de données
+
+**Exporter des données** ouvre une boîte de filtres pour choisir les types d'entité à inclure. Vous pouvez exporter n'importe quelle combinaison d'exercices, combos, séances, collections et journaux d'exécution.
+
+**Importer des données** ouvre un sélecteur de fichier pour un `.json` précédemment exporté depuis TrainUs. Voir [Export / Import de données](#export--import-de-données) plus haut pour le détail du flux d'import et de la gestion des conflits.
+
+### Suffixes d'import
+
+Quand vous avez importé des données d'autres utilisateurs, cette section liste tous les suffixes enregistrés. Chaque entrée affiche le nom de l'utilisateur externe et son suffixe court. Vous pouvez modifier ou supprimer les entrées — voir [Gérer les suffixes d'import](#gérer-les-suffixes-dimport) plus haut.
+
+### Crédits
+
+Cliquez sur le bouton **Crédits** pour ouvrir la boîte de dialogue des crédits. Elle liste les ressources open source utilisées pour construire TrainUs :
+
+- **Mighty Force** (icône de l'application) — par Delapouite, sur [game-icons.net](https://game-icons.net), licence CC BY 3.0. game-icons.net est maintenu par Lorc, Delapouite & contributeurs.
+- **Bootstrap Icons** (icônes d'interface utilisées dans toute l'application) — sur [icons.getbootstrap.com](https://icons.getbootstrap.com), licence MIT.
+- **Bibliothèques tierces** — [Vue](https://vuejs.org), [Vue Router](https://router.vuejs.org), [Vite](https://vitejs.dev), [SQLite WASM](https://sqlite.org/wasm/), [Chart.js](https://www.chartjs.org), [vue-chartjs](https://vue-chartjs.org), [i18next](https://www.i18next.com), [i18next-vue](https://i18next.github.io/i18next-vue/), [Prettier](https://prettier.io), [vite-plugin-pwa](https://vite-pwa-org.netlify.app), [marked](https://marked.js.org), [DOMPurify](https://github.com/cure53/DOMPurify).
+- **Outils de test** — [Playwright](https://playwright.dev/python/), [pytest](https://pytest.org).
+
+### À propos de TrainUs
+
+Cliquez sur le bouton **À propos de TrainUs** pour ouvrir la boîte de dialogue À propos. Elle affiche :
+
+- **Version de l'application** — la version actuelle de TrainUs (ex. `1.0.0`).
+- **Version de la base** — la version actuelle du schéma de base de données.
+- **Créé par** — David Florance.
+- **Licence** — GNU AGPL v3.
+- **Liens** — liens vers le dépôt du projet et le site web.
+- **Note de copyright** — une courte mention de copyright et un résumé de la licence AGPL, affichés directement dans la boîte de dialogue.
+- **Voir la licence** — ouvre le texte complet de la licence GNU AGPL v3 dans une boîte de dialogue.
+
+---
+
+## Annexe : aide-mémoire Markdown
+
+Toutes les descriptions (exercices, combos, séances) acceptent un sous-ensemble de Markdown. Ce que vous tapez dans le champ est déjà ce que vous voyez, mais voici un rappel rapide :
+
+| Vous tapez             | Vous obtenez                        |
+| ---------------------- | ----------------------------------- |
+| `**gras**`             | **gras**                            |
+| `*italique*`           | _italique_                          |
+| `- élément`            | <ul><li>élément</li></ul>           |
+| `1. élément`           | <ol><li>élément</li></ol>           |
+| `` `code` ``           | `code`                              |
+| `[texte](https://...)` | [texte](https://www.ubuntu-fr.org/) |
diff --git a/website/hugo.toml b/website/hugo.toml
new file mode 100644
index 0000000..9c2055f
--- /dev/null
+++ b/website/hugo.toml
@@ -0,0 +1,86 @@
+baseURL = "https://kaivalya.eu/projects/trainUs"
+title = "TrainUs"
+defaultContentLanguage = "fr"
+defaultContentLanguageInSubdir = false
+enableRobotsTXT = true
+enableEmoji = false
+
+[build]
+  writeStats = false
+
+[pagination]
+  pagerSize = 10
+
+[params]
+  appUrl = "https://kaivalya.eu/projects/trainUs/app/snapshot-dev"
+  repoUrl = "https://kaivalya.eu/app-git/kaivalya/trainUs"
+  licenseUrl = "https://kaivalya.eu/app-git/kaivalya/trainUs/raw/branch/main/LICENSE.md"
+  personalSiteUrl = "https://kaivalya.eu"
+
+[languages]
+  [languages.fr]
+    languageName = "Français"
+    weight = 1
+    contentDir = "content"
+    [languages.fr.params]
+      tagline = "Application de fitness locale, multilingue et open source."
+      flag = "🇫🇷"
+
+    [[languages.fr.menus.main]]
+      name = "Documentation"
+      url = "/docs/"
+      weight = 10
+    [[languages.fr.menus.main]]
+      name = "Développeurs"
+      url = "/developers/"
+      weight = 15
+    [[languages.fr.menus.main]]
+      name = "Blog"
+      url = "/blog/"
+      weight = 20
+    [[languages.fr.menus.main]]
+      name = "Contact"
+      url = "/contact/"
+      weight = 30
+
+  [languages.en]
+    languageName = "English"
+    languageCode = "en"
+    weight = 2
+    contentDir = "content"
+    [languages.en.params]
+      tagline = "Local-first multilingual and open source fitness training app"
+      flag = "🇬🇧"
+
+    [[languages.en.menus.main]]
+      name = "Documentation"
+      url = "/en/docs/"
+      weight = 10
+    [[languages.en.menus.main]]
+      name = "Developers"
+      url = "/en/developers/"
+      weight = 15
+    [[languages.en.menus.main]]
+      name = "Blog"
+      url = "/en/blog/"
+      weight = 20
+    [[languages.en.menus.main]]
+      name = "Contact"
+      url = "/en/contact/"
+      weight = 30
+
+[markup]
+  [markup.goldmark]
+    [markup.goldmark.renderer]
+      unsafe = true
+  [markup.tableOfContents]
+    startLevel = 2
+    endLevel = 3
+    ordered = false
+  [markup.highlight]
+    style = "friendly"
+
+[outputs]
+  home = ["HTML", "RSS"]
+  section = ["HTML", "RSS"]
+  page = ["HTML"]
diff --git a/website/i18n/en.toml b/website/i18n/en.toml
new file mode 100644
index 0000000..036f032
--- /dev/null
+++ b/website/i18n/en.toml
@@ -0,0 +1,50 @@
+[toc]
+other = "Table of contents"
+
+[readMore]
+other = "Read more"
+
+[postedOn]
+other = "Posted on"
+
+[navLabel]
+other = "Main navigation"
+
+[footerRepo]
+other = "Source code"
+
+[footerPersonalSite]
+other = "Personal site"
+
+[heroOpenApp]
+other = "Open the app"
+
+[heroOpenAppComingSoon]
+other = "Coming soon"
+
+[heroReadDocs]
+other = "Read the docs"
+
+[featureLocalFirstTitle]
+other = "Local-first"
+
+[featureLocalFirstDesc]
+other = "Your data stays on your device. No account, no server, no leaks."
+
+[featureBilingualTitle]
+other = "Multilingual"
+
+[featureBilingualDesc]
+other = "Interface available in French, English, and Danish."
+
+[featurePwaTitle]
+other = "Web app"
+
+[featurePwaDesc]
+other = "Installable on your device, works offline."
+
+[featureShareTitle]
+other = "Share & export"
+
+[featureShareDesc]
+other = "Export your data and share it with friends, your coach, your students ..."
diff --git a/website/i18n/fr.toml b/website/i18n/fr.toml
new file mode 100644
index 0000000..a89ef8e
--- /dev/null
+++ b/website/i18n/fr.toml
@@ -0,0 +1,50 @@
+[toc]
+other = "Table des matières"
+
+[readMore]
+other = "Lire la suite"
+
+[postedOn]
+other = "Publié le"
+
+[navLabel]
+other = "Navigation principale"
+
+[footerRepo]
+other = "Code source"
+
+[footerPersonalSite]
+other = "Site personnel"
+
+[heroOpenApp]
+other = "Ouvrir l'application"
+
+[heroOpenAppComingSoon]
+other = "Bientôt disponible"
+
+[heroReadDocs]
+other = "Lire la documentation"
+
+[featureLocalFirstTitle]
+other = "Local d'abord"
+
+[featureLocalFirstDesc]
+other = "Vos données restent sur votre appareil. Aucun compte, aucun serveur, aucune fuite."
+
+[featureBilingualTitle]
+other = "Multilingue"
+
+[featureBilingualDesc]
+other = "Interface disponible en français, en anglais et en danois."
+
+[featurePwaTitle]
+other = "Application web"
+
+[featurePwaDesc]
+other = "Installable sur votre appareil, fonctionne hors ligne."
+
+[featureShareTitle]
+other = "Partage & export"
+
+[featureShareDesc]
+other = "Exportez vos données et partagez-les avec vos amis, votre coach, vos élèves ..."
diff --git a/website/layouts/_default/_markup/render-codeblock-mermaid.html b/website/layouts/_default/_markup/render-codeblock-mermaid.html
new file mode 100644
index 0000000..1d5e9b2
--- /dev/null
+++ b/website/layouts/_default/_markup/render-codeblock-mermaid.html
@@ -0,0 +1,2 @@
+<div class="mermaid">{{- .Inner -}}</div>
+{{ .Page.Store.Set "hasMermaid" true }}
diff --git a/website/layouts/_default/baseof.html b/website/layouts/_default/baseof.html
new file mode 100644
index 0000000..7ec8306
--- /dev/null
+++ b/website/layouts/_default/baseof.html
@@ -0,0 +1,11 @@
+<!doctype html>
+<html lang="{{ .Language.Lang }}">
+  <head>
+    {{- partial "head.html" . -}}
+  </head>
+  <body>
+    {{- partial "header.html" . -}}
+    <main id="main-content">{{- block "main" . }}{{- end }}</main>
+    {{- partial "footer.html" . -}} {{- partial "mermaid.html" . -}}
+  </body>
+</html>
diff --git a/website/layouts/_default/list.html b/website/layouts/_default/list.html
new file mode 100644
index 0000000..3e5e2fc
--- /dev/null
+++ b/website/layouts/_default/list.html
@@ -0,0 +1,25 @@
+{{ define "main" }}
+<div class="container list-wrap">
+  <div class="list-header">
+    <h1 class="list-title">{{ .Title }}</h1>
+    {{ with .Description }}<p class="list-description">{{ . }}</p>{{ end }}
+  </div>
+  {{ with .Content }}<div class="article-body">{{ . }}</div>{{ end }}
+  {{ if .Pages -}}
+  <ul class="post-list">
+    {{ range .Pages.ByDate.Reverse -}}
+    <li class="post-card">
+      <h2 class="post-card-title"><a href="{{ .RelPermalink }}">{{ .Title }}</a></h2>
+      {{ if not .Date.IsZero -}}
+      <p class="post-card-meta">
+        {{ i18n "postedOn" }} <time datetime="{{ .Date.Format "2006-01-02" }}">{{ .Date | time.Format ":date_long" }}</time>
+      </p>
+      {{- end }}
+      {{ with .Summary }}<p class="post-card-summary">{{ . }}</p>{{ end }}
+      <a class="read-more" href="{{ .RelPermalink }}">{{ i18n "readMore" }}</a>
+    </li>
+    {{- end }}
+  </ul>
+  {{- end }}
+</div>
+{{ end }}
diff --git a/website/layouts/_default/single.html b/website/layouts/_default/single.html
new file mode 100644
index 0000000..2eef580
--- /dev/null
+++ b/website/layouts/_default/single.html
@@ -0,0 +1,31 @@
+{{ define "main" }}
+<div class="container article-wrap">
+  <article>
+    <header class="article-header">
+      <h1 class="article-title">{{ .Title }}</h1>
+      {{ if not .Date.IsZero -}}
+      <p class="article-meta">
+        {{ i18n "postedOn" }} <time datetime="{{ .Date.Format "2006-01-02" }}">{{ .Date | time.Format ":date_long" }}</time>
+      </p>
+      {{- end }}
+    </header>
+    {{ if .TableOfContents -}}
+    <details class="toc toc-inline">
+      <summary>{{ i18n "toc" }}</summary>
+      {{ .TableOfContents }}
+    </details>
+    {{- end }}
+    <div class="article-body">
+      {{ .Content }}
+    </div>
+  </article>
+  {{ if .TableOfContents -}}
+  <aside class="toc-sidebar" aria-label="{{ i18n "toc" }}">
+    <div class="toc">
+      <p class="toc-sidebar-title">{{ i18n "toc" }}</p>
+      {{ .TableOfContents }}
+    </div>
+  </aside>
+  {{- end }}
+</div>
+{{ end }}
diff --git a/website/layouts/developers/list.html b/website/layouts/developers/list.html
new file mode 100644
index 0000000..479da21
--- /dev/null
+++ b/website/layouts/developers/list.html
@@ -0,0 +1 @@
+{{ define "main" }} {{ partial "doc-list.html" . }} {{ end }}
diff --git a/website/layouts/docs/list.html b/website/layouts/docs/list.html
new file mode 100644
index 0000000..479da21
--- /dev/null
+++ b/website/layouts/docs/list.html
@@ -0,0 +1 @@
+{{ define "main" }} {{ partial "doc-list.html" . }} {{ end }}
diff --git a/website/layouts/index.html b/website/layouts/index.html
new file mode 100644
index 0000000..382e8f0
--- /dev/null
+++ b/website/layouts/index.html
@@ -0,0 +1,54 @@
+{{ define "main" }}
+
+<section class="hero">
+  <div class="hero-inner">
+    <img class="hero-logo" src="{{ "logo.svg" | relURL }}" alt="TrainUs" width="96" height="96">
+    <h1 class="hero-title">TrainUs</h1>
+    <p class="hero-tagline">{{ .Site.Params.tagline }}</p>
+    <div class="hero-actions">
+      {{ if .Site.Params.appUrl -}}
+        <a href="{{ .Site.Params.appUrl }}" class="btn btn-primary">{{ i18n "heroOpenApp" }}</a>
+      {{- else -}}
+        <span class="btn btn-primary btn-disabled"
+              title="{{ i18n "heroOpenAppComingSoon" }}"
+              aria-disabled="true"
+              role="button">{{ i18n "heroOpenApp" }}</span>
+      {{- end }}
+      {{ with site.GetPage "/docs" }}<a href="{{ .RelPermalink }}" class="btn btn-secondary">{{ i18n "heroReadDocs" }}</a>{{ end }}
+    </div>
+  </div>
+</section>
+
+<section class="features">
+  <div class="container">
+    <div class="features-grid">
+
+      <div class="feature-card">
+        <div class="feature-icon" aria-hidden="true">🗄</div>
+        <h2 class="feature-title">{{ i18n "featureLocalFirstTitle" }}</h2>
+        <p class="feature-desc">{{ i18n "featureLocalFirstDesc" }}</p>
+      </div>
+
+      <div class="feature-card">
+        <div class="feature-icon" aria-hidden="true">👥</div>
+        <h2 class="feature-title">{{ i18n "featureShareTitle" }}</h2>
+        <p class="feature-desc">{{ i18n "featureShareDesc" }}</p>
+      </div>
+
+      <div class="feature-card">
+        <div class="feature-icon" aria-hidden="true">🌐</div>
+        <h2 class="feature-title">{{ i18n "featureBilingualTitle" }}</h2>
+        <p class="feature-desc">{{ i18n "featureBilingualDesc" }}</p>
+      </div>
+
+      <div class="feature-card">
+        <div class="feature-icon" aria-hidden="true">📱</div>
+        <h2 class="feature-title">{{ i18n "featurePwaTitle" }}</h2>
+        <p class="feature-desc">{{ i18n "featurePwaDesc" }}</p>
+      </div>
+
+    </div>
+  </div>
+</section>
+
+{{ end }}
diff --git a/website/layouts/partials/doc-list.html b/website/layouts/partials/doc-list.html
new file mode 100644
index 0000000..5e15e07
--- /dev/null
+++ b/website/layouts/partials/doc-list.html
@@ -0,0 +1,30 @@
+<div class="container list-wrap">
+  <div class="list-header">
+    <h1 class="list-title">{{ .Title }}</h1>
+    {{ with .Description }}
+    <p class="list-description">{{ . }}</p>
+    {{ end }}
+  </div>
+  {{ with .Content }}
+  <div class="article-body">{{ . }}</div>
+  {{ end }} {{ if .Pages -}}
+  <ul class="post-list">
+    {{ range .Pages.ByWeight -}}
+    <li class="post-card">
+      <h2 class="post-card-title"><a href="{{ .RelPermalink }}">{{ .Title }}</a></h2>
+      {{ with .Description }}
+      <p class="post-card-summary">{{ . }}</p>
+      {{ end }} {{ $permalink := .RelPermalink }} {{ $chapters := slice }} {{ with
+      .Fragments.Headings }}{{ $chapters = (index . 0).Headings }}{{ end }} {{ if $chapters }}
+      <ul class="post-card-chapters">
+        {{ range $chapters }}
+        <li><a href="{{ $permalink }}#{{ .ID }}">{{ .Title | safeHTML }}</a></li>
+        {{ end }}
+      </ul>
+      {{ end }}
+      <a class="read-more" href="{{ .RelPermalink }}">{{ i18n "readMore" }}</a>
+    </li>
+    {{- end }}
+  </ul>
+  {{- end }}
+</div>
diff --git a/website/layouts/partials/footer.html b/website/layouts/partials/footer.html
new file mode 100644
index 0000000..fbb63c7
--- /dev/null
+++ b/website/layouts/partials/footer.html
@@ -0,0 +1,11 @@
+<footer class="site-footer">
+  <div class="container footer-inner">
+    <span>© {{ now.Format "2006" }} David Florance</span>
+    <span class="footer-sep">·</span>
+    <a href="{{ .Site.Params.licenseUrl }}" rel="license">AGPL-3.0</a>
+    <span class="footer-sep">·</span>
+    <a href="{{ .Site.Params.repoUrl }}">{{ i18n "footerRepo" }}</a>
+    <span class="footer-sep">·</span>
+    <a href="{{ .Site.Params.personalSiteUrl }}">{{ i18n "footerPersonalSite" }}</a>
+  </div>
+</footer>
diff --git a/website/layouts/partials/head.html b/website/layouts/partials/head.html
new file mode 100644
index 0000000..d8b639c
--- /dev/null
+++ b/website/layouts/partials/head.html
@@ -0,0 +1,19 @@
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<title>{{ if .IsHome }}{{ .Site.Title }}{{ else }}{{ .Title }} — {{ .Site.Title }}{{ end }}</title>
+<meta name="description" content="{{ with .Description }}{{ . }}{{ else }}{{ with .Site.Params.tagline }}{{ . }}{{ end }}{{ end }}">
+
+{{ range .AllTranslations -}}
+<link rel="alternate" hreflang="{{ .Language.Lang }}" href="{{ .Permalink }}">
+{{ end -}}
+<link rel="alternate" hreflang="x-default" href="{{ .Site.Home.Permalink }}">
+
+{{ range .AlternativeOutputFormats -}}
+<link rel="{{ .Rel }}" type="{{ .MediaType.Type }}" href="{{ .Permalink }}" title="{{ $.Site.Title }}">
+{{ end -}}
+
+{{ with resources.Get "css/main.css" | fingerprint -}}
+<link rel="stylesheet" href="{{ .RelPermalink }}">
+{{- end }}
+
+<link rel="icon" href="{{ "logo.svg" | relURL }}" type="image/svg+xml">
diff --git a/website/layouts/partials/header.html b/website/layouts/partials/header.html
new file mode 100644
index 0000000..9f8b6bd
--- /dev/null
+++ b/website/layouts/partials/header.html
@@ -0,0 +1,15 @@
+<header class="site-header">
+  <div class="container header-inner">
+    <a class="site-brand" href="{{ .Site.Home.RelPermalink }}">
+      <img src="{{ "logo.svg" | relURL }}" alt="" width="32" height="32" aria-hidden="true">
+      <span>{{ .Site.Title }}</span>
+    </a>
+    <nav class="site-nav" aria-label="{{ i18n "navLabel" }}">
+      {{- range .Site.Menus.main -}}
+        {{- $active := strings.HasPrefix $.RelPermalink (.URL | relURL) -}}
+        <a class="nav-link{{ if $active }} active{{ end }}" href="{{ .URL | relURL }}">{{ .Name }}</a>
+      {{- end -}}
+    </nav>
+    {{ partial "lang-switcher.html" . }}
+  </div>
+</header>
diff --git a/website/layouts/partials/lang-switcher.html b/website/layouts/partials/lang-switcher.html
new file mode 100644
index 0000000..9afdf8d
--- /dev/null
+++ b/website/layouts/partials/lang-switcher.html
@@ -0,0 +1,27 @@
+{{- $translatedLangs := slice -}} {{- range .AllTranslations -}} {{- $translatedLangs =
+$translatedLangs | append .Language.Lang -}} {{- end -}}
+<div class="lang-switcher">
+  {{- range .AllTranslations -}} {{- $flag := .Language.Params.flag | default .Language.Lang -}} {{-
+  if eq .Language.Lang $.Language.Lang -}}
+  <span class="lang-active" aria-current="true" title="{{ .Language.LanguageName }}"
+    >{{ $flag }}</span
+  >
+  {{- else -}}
+  <a
+    href="{{ .RelPermalink }}"
+    hreflang="{{ .Language.Lang }}"
+    lang="{{ .Language.Lang }}"
+    title="{{ .Language.LanguageName }}"
+    >{{ $flag }}</a
+  >
+  {{- end -}} {{- end -}} {{- range site.Home.AllTranslations -}} {{- if not (in $translatedLangs
+  .Language.Lang) -}} {{- $flag := .Language.Params.flag | default .Language.Lang -}}
+  <a
+    href="{{ .RelPermalink }}"
+    hreflang="{{ .Language.Lang }}"
+    lang="{{ .Language.Lang }}"
+    title="{{ .Language.LanguageName }}"
+    >{{ $flag }}</a
+  >
+  {{- end -}} {{- end -}}
+</div>
diff --git a/website/layouts/partials/mermaid.html b/website/layouts/partials/mermaid.html
new file mode 100644
index 0000000..e38f933
--- /dev/null
+++ b/website/layouts/partials/mermaid.html
@@ -0,0 +1,6 @@
+{{ if .Store.Get "hasMermaid" -}}
+<script type="module">
+  import mermaid from 'https://cdn.jsdelivr.net/npm/mermaid@11/dist/mermaid.esm.min.mjs'
+  mermaid.initialize({ startOnLoad: true, theme: 'neutral' })
+</script>
+{{- end }}
diff --git a/website/static/logo.svg b/website/static/logo.svg
new file mode 100644
index 0000000..9812483
--- /dev/null
+++ b/website/static/logo.svg
@@ -0,0 +1,10 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
+  <defs>
+    <linearGradient id="bg" x1="0%" y1="0%" x2="100%" y2="100%">
+      <stop offset="0%" stop-color="#1E7FC0"/>
+      <stop offset="100%" stop-color="#12A892"/>
+    </linearGradient>
+  </defs>
+  <rect width="512" height="512" rx="112" fill="url(#bg)"/>
+  <path d="m256 28-32 128c-32-16-64-48-96-96 0 48 0 96 32 128-32 17-64 0-96-32 0 32 0 80 48 112-32 16-64 0-80-32 0 48 16 96 48 128-16 16-48 0-64-16 0 64 48 112 112 144h76.8l16.7-68.6-17.2-86.1-97.9 5s20.3-75.2 34.9-103.7c5-9.6 7.2-18 20-18.3 11.3 0 20.4 9.8 20.4 21.9 0 12-9.1 21.8-20.4 21.8-2.3 0-4.6-.5-6.6-1.3l-5.1 46.8c29.6-8.9 56.9-18.8 84-30.9 0-.1-.1-.2-.1-.3-6.2-8.8-10.4-21.5-10.4-35.7 0-14.1 4.1-26.8 10.4-35.7 6.1-8.9 14.1-13.7 22.5-13.7 8.5 0 16.5 4.8 22.6 13.7 6.2 8.9 10.2 21.6 10.2 35.7 0 14.2-4 26.9-10.2 35.7-.1.3-.5.7-.6.9 27.3 12.1 56.1 20.6 84.3 30.3l-5-46.8c-2.2.8-4.3 1.3-6.7 1.3-11.2 0-20.3-9.8-20.3-21.8 0-12.1 9.1-21.9 20.3-21.9 12.8.3 15.2 8.7 20 18.3 14.8 28.5 35 103.7 35 103.7l-97.9-5-17.2 86.1 16.7 68.6H384c64-32 112-80 112-144-16 16-48 32-64 16 32-32 48-80 48-128-16 32-48 48-80 32 48-32 48-80 48-112-32 32-64 48-96 32 32-32 32-80 32-128-32 48-64 80-96 96z" fill="#fff" fill-opacity="0.92"/>
+</svg>