add readme images

Hunter
Wednesday, October 7th, 2026 at 9:59 PM

.gitignore+1 
readme.md+36-13
resources/images/breakdown.gifnew
resources/images/complete.gifnew
resources/images/multi_select.gifnew
resources/images/reorganize.gifnew
resources/images/screenshot.gif  
resources/images/themes.gifnew

.gitignore
1  tests/
2 +readme-gifs/
readme.md
 1  # 🪆 matryoshka
 2  
   -<a href="https://hunterirving.github.io/matryoshka/"><img src="resources/images/screenshot.gif" width="700px"></a><br>
   -
 3  turn mountains into molehills (then molehills into anthills) with <b>matryoshka</b>,<br>
 4  the nested todo list that breaks complex tasks into manageable subtasks.
 5  
 6 +<p align="center">
 7 +	<a href="https://hunterirving.github.io/matryoshka/"><img src="resources/images/screenshot.gif" width="400px"></a>
 8 +</p>
 9 +
10  <i><b>try it now <a href="https://hunterirving.github.io/matryoshka/">in your browser</a>!</b></i> (physical keyboard required).
11  
12  ### key features

18  ### quickstart
19  1. press the `Return` / `Enter` key to add subtasks to the root "todo" task
20  2. give each new subtask a meaningful name
   -3. use `Shift + ➡️` to navigate into a subtask
   -4. use `Shift + ⬅️` to return to the enclosing parent task
21 +3. use `Shift + ➡︎` to navigate into a subtask
22 +4. use `Shift + ⬅︎` to return to the enclosing parent task
23  5. use `Shift + Enter` to quickly mark tasks as complete or incomplete
24  
25  ## controls
26  
27  ### navigation
   -- `⬆️/⬇️` move between tasks at the same level
   -- `Shift + ➡️` navigate into a subtask
   -- `Shift + ⬅️` return to the enclosing parent task
28 +- `⬆︎/⬇︎` move between tasks at the same level
29 +- `Shift + ➡︎` navigate into a subtask
30 +- `Shift + ⬅︎` return to the enclosing parent task
31 +
32 +<p align="center">
33 +	<img src="resources/images/breakdown.gif" width="400px">
34 +</p>
35  
36  ### task management
37  - `Enter` add a new task
   -- `⬇️` (on last subtask) add a new task at the bottom of the list
38 +- `⬇︎` (on last subtask) add a new task at the bottom of the list
39  - `Backspace` (when task text is empty) delete selected task(s) and their subtasks
40  - `Shift + Enter` toggle selected task(s) completion status
41 +
42 +<p align="center">
43 +	<img src="resources/images/complete.gif" width="400px">
44 +</p>
45 +
46  - `⌘ + C` copy selected task(s) and their subtasks
47  - `⌘ + X` cut selected task(s) and their subtasks
48  - `⌘ + V` paste copied task(s) and their subtasks

50  - `⌘ + Shift + Z` redo
51  
52  ### reorganization
   -- `Shift + ⬆️/⬇️` reposition selected task(s) within their current level
   -- `⌘ + ⬆️/⬇️` push selected task(s) into the task above or below
   -- `⌘ + ⬅️` pull selected task(s) out one level (to the level of their parent)
53 +- `Shift + ⬆︎/⬇︎` reposition selected task(s) within their current level
54 +- `⌘ + ⬆︎/⬇︎` push selected task(s) into the task above or below
55 +- `⌘ + ⬅︎` pull selected task(s) out one level (to the level of their parent)
56  - hold `Shift` with any `⌘` command (push/pull) to simultaneously navigate to the task(s)' new position
57  
58 +<p align="center">
59 +	<img src="resources/images/reorganize.gif" width="400px">
60 +</p>
61 +
62  ### multi-select
   -- `Option + ⬆️/⬇️` extend or contract the selection to include adjacent tasks
   -- `⬆️/⬇️` (without modifier) clear the selection and resume single-task navigation
63 +- `Option + ⬆︎/⬇︎` extend or contract the selection to include adjacent tasks
64 +- `⬆︎/⬇︎` (without modifier) clear the selection and resume single-task navigation
65 +
66 +<p align="center">
67 +	<img src="resources/images/multi_select.gif" width="400px">
68 +</p>
69  
70  ### theming
71  - press `F2` to cycle through available themes (`Shift + F2` to cycle in reverse)
72  
73 +<p align="center">
74 +	<img src="resources/images/themes.gif" width="400px">
75 +</p>
76 +
77  ## data persistence
78  your task tree is automatically saved to your browser's local storage after each edit. this ensures your tasks will persist even if you close the browser or refresh the page.
79  
resources/images/breakdown.gif
Binary files differ.
resources/images/complete.gif
Binary files differ.
resources/images/multi_select.gif
Binary files differ.
resources/images/reorganize.gif
Binary files differ.
resources/images/screenshot.gif
Binary files differ.
resources/images/themes.gif
Binary files differ.