Documentation

Version 0.1 · mise à jour le 11 octobre 2026

Accès anticipé. Cette documentation décrit la version 0.1 pour Windows. Des détails peuvent changer d'une version à l'autre. Nouveau ? Commence par Comment ça marche.

Vue d'ensemble

RETRO-DECK MD-1 est un carnet de travail local pour Windows. Il tient en trois gestes : planifier sa journée (trois tâches maximum), se concentrer sur une seule chose, retenir ce que l'on apprend grâce à des fiches de révision. Tout fonctionne hors ligne, sans compte, et tes notes sont de simples fichiers .md.

Où sont tes données

Au premier lancement, l'application crée un dossier RETRO-DECK dans tes Documents :

Dossier	Contenu
`notes/`	Tes notes et ton journal, en Markdown (`.md`).
`cards/`	Une fiche de révision par fichier `.md`.
`data/`	Le plan du jour, les niveaux d'énergie, les statistiques (JSON).

Tu peux ouvrir, copier, sauvegarder ces fichiers avec n'importe quel autre outil. Si l'application disparaît, tes fichiers restent lisibles.

Aujourd'hui et planifier

Trois tâches par jour, pas plus. C'est un choix de conception : une liste courte se termine.
L'accueil te propose une seule prochaine action, avec un bouton pour lancer le focus.
L'assistant « Planifier ma journée » : tu indiques ton énergie (1 à 5), tu écris tes priorités en marquant chacune dur ou léger, et l'application propose un ordre. Énergie haute : le plus dur d'abord. Énergie basse : le léger d'abord.
Si tu as écrit une « première chose pour demain » lors du bilan du soir, elle t'est proposée le matin.

Niveau d'énergie

Un tap de 1 à 5, matin, midi ou soir. L'application calcule, uniquement sur ton ordinateur, ta meilleure période de la journée une fois assez de relevés enregistrés. C'est un ressenti que tu déclares : aucun capteur, aucune donnée de santé, aucun diagnostic. Les relevés sont dans data/energy.json.

Mode focus

Une tâche, un minuteur (15, 25, 50 ou 90 minutes, réglable). Pendant que tu travailles ailleurs dans l'application, un petit compteur reste visible dans le menu. Les minutes terminées alimentent ton bilan du soir.

Écrire

Éditeur plein écran, sobre, avec sauvegarde automatique. La liste des notes est un tiroir (bouton ▤ ou Ctrl+Maj+B).
Gabarits : journal du jour, bloqué/débloqué, revue de semaine, cours (Cornell), fiche de lecture, réunion.
Ouvrir n'importe quel fichier .md : bouton « ouvrir un fichier », bouton « ouvrir un dossier » pour le parcourir, ou glisser un fichier dans la fenêtre. Les fichiers récents sont retenus. Les fichiers .md, .markdown et .txt (5 Mo maximum) sont acceptés.
Mode lecture (Ctrl+E) : titres, cases à cocher, citations, code.
Une barre de commandes façon nano rappelle les raccourcis en bas de l'écran (voir « Raccourcis »).

Fiches de révision

Sélectionne du texte dans une note, Ctrl+J : il devient une fiche. La question est pré-remplie avec le titre au-dessus.
Révision espacée en trois notes : revoir (demain), bien, facile. Les intervalles s'allongent à chaque succès (principe SM-2 simplifié).
Importer tes propres .md comme fiches : par fichiers ou par dossier entier (liste à cocher). Un fichier qui commence par # Question garde sa question ; sinon le nom du fichier sert de question. Les doublons sont ignorés et tes originaux ne sont jamais modifiés.
La bibliothèque liste toutes les fiches, avec un filtre et l'accès au dossier.

Format d'un fichier de fiche (lisible et modifiable à la main) :

---
ease: 2.50
interval: 3
reps: 2
due: 2026-10-15
---
# Pourquoi SameSite=None est-il rejeté ?
Il doit aussi avoir l'attribut Secure (HTTPS).

L'en-tête entre --- est facultatif : sans lui, la fiche est nouvelle et à voir aujourd'hui.

Vidage et bilan du soir

Vidage de tête : écris tout, sans trier. Ensuite chaque ligne devient une tâche, une note (notes/vrac.md), une idée (notes/idees.md) ou part à la poubelle.
Bilan du soir (60 secondes) : tes chiffres du jour, une victoire, un blocage, la première chose pour demain. Il est enregistré dans notes/bilan-AAAA-MM-JJ.md.

Navigation et réglages

L'accueil affiche huit icônes. Une croix directionnelle en bas (et les flèches du clavier) déplace la sélection ; OK ouvre ; dans une section, ◄ et ► passent à la section voisine et ⌂ ramène à l'accueil.
Le menu se replie en bande d'icônes (Ctrl+B) pour laisser toute la place à l'écriture.
L'engrenage ouvre les réglages : thème (papier ou encre), taille du texte, largeur de la page, durée de focus par défaut.

Raccourcis

Touche	Action
`Ctrl`+`O`	Enregistrer
`Ctrl`+`X`	Fermer la note (ou couper si du texte est sélectionné)
`Ctrl`+`K` / `Ctrl`+`U`	Couper la ligne / coller la ligne coupée
`Ctrl`+`W`	Chercher (Entrée : suivant)
`Ctrl`+`L`	Aller à la ligne n°
`Ctrl`+`R`	Insérer un fichier à la position du curseur
`Ctrl`+`G`	Aide de l'éditeur
`Ctrl`+`E`	Basculer lecture / écriture
`Ctrl`+`J`	Créer une fiche depuis la sélection
`Ctrl`+`N`	Nouvelle note vide
`Ctrl`+`B` / `Ctrl`+`Maj`+`B`	Replier le menu / ouvrir la liste des notes
`Alt`+flèches	Croix directionnelle depuis un champ de saisie

Ctrl+C et Ctrl+V restent le copier-coller du système.

Ce que l'application ne fait pas

Pas de synchronisation, pas de compte, pas de version mobile.
Aucune IA, aucun accès à tes mails ou calendriers.
Pas de notifications, pas de séries à ne pas casser, pas de récompenses artificielles.
Windows uniquement pour l'instant ; macOS et Linux sont envisagés sans date.

Documentation

Version 0.1 · updated October 11, 2026

Early access. This documentation describes version 0.1 for Windows. Details may change from one version to the next. New here? Start with How it works.

Overview

RETRO-DECK MD-1 is a local work notebook for Windows. It comes down to three moves: plan your day (three tasks at most), focus on one thing, remember what you learn through revision cards. Everything works offline, without an account, and your notes are plain .md files.

Where your data lives

On first launch the app creates a RETRO-DECK folder in your Documents:

Folder	Content
`notes/`	Your notes and journal, in Markdown (`.md`).
`cards/`	One revision card per `.md` file.
`data/`	Today's plan, energy levels, statistics (JSON).

You can open, copy and back up these files with any other tool. If the app disappears, your files stay readable.

Today and planning

Three tasks a day, no more. It is a design choice: a short list gets finished.
The home screen suggests a single next action, with a button to start focus.
The “Plan my day” assistant: you give your energy (1 to 5), write your priorities and mark each one hard or light, and the app suggests an order. High energy: the hardest first. Low energy: the light first.
If you wrote a “first thing for tomorrow” in the evening review, it is offered in the morning.

Energy level

One tap from 1 to 5, morning, noon or evening. The app works out your best period of the day, only on your computer, once enough readings are saved. It is a feeling you report yourself: no sensor, no health data, no diagnosis. Readings are stored in data/energy.json.

Focus mode

One task, one timer (15, 25, 50 or 90 minutes, adjustable). While you work elsewhere in the app, a small counter stays visible in the menu. Completed minutes feed your evening review.

Writing

A full-screen, plain editor with autosave. The note list is a drawer (▤ button or Ctrl+Shift+B).
Templates: daily journal, stuck/solved, weekly review, lecture notes (Cornell), reading notes, meeting.
Open any .md file: “open a file” button, “open a folder” button to browse it, or drag a file into the window. Recent files are remembered. .md, .markdown and .txt files (5 MB maximum) are accepted.
Reading mode (Ctrl+E): headings, checkboxes, quotes, code.
A nano-style command bar reminds you of the shortcuts at the bottom of the screen (see “Shortcuts”).

Revision cards

Select text in a note, Ctrl+J: it becomes a card. The question is pre-filled with the heading above.
Spaced repetition with three grades: again (tomorrow), good, easy. Intervals grow after each success (simplified SM-2).
Import your own .md files as cards: by files or a whole folder (checklist). A file starting with # Question keeps its question; otherwise the file name becomes the question. Duplicates are skipped and your originals are never modified.
The library lists all cards, with a filter and access to the folder.

Card file format (readable and editable by hand):

---
ease: 2.50
interval: 3
reps: 2
due: 2026-10-15
---
# Why is SameSite=None rejected?
It must also have the Secure attribute (HTTPS).

The header between --- is optional: without it, the card is new and due today.

Brain dump and evening review

Brain dump: write everything, without sorting. Then each line becomes a task, a note (notes/vrac.md), an idea (notes/idees.md) or goes to the bin.
Evening review (60 seconds): your numbers for the day, one win, one blocker, the first thing for tomorrow. It is saved to notes/bilan-YYYY-MM-DD.md.

Navigation and settings

The home screen shows eight icons. A directional pad at the bottom (and the keyboard arrows) moves the selection; OK opens; inside a section, ◄ and ► go to the neighbouring section and ⌂ returns home.
The menu folds into an icon strip (Ctrl+B) to leave all the room to writing.
The gear opens settings: theme (paper or ink), text size, page width, default focus duration.

Shortcuts

Key	Action
`Ctrl`+`O`	Save
`Ctrl`+`X`	Close the note (or cut when text is selected)
`Ctrl`+`K` / `Ctrl`+`U`	Cut the line / paste the cut line
`Ctrl`+`W`	Search (Enter: next)
`Ctrl`+`L`	Go to line number
`Ctrl`+`R`	Insert a file at the cursor
`Ctrl`+`G`	Editor help
`Ctrl`+`E`	Toggle reading / writing
`Ctrl`+`J`	Create a card from the selection
`Ctrl`+`N`	New empty note
`Ctrl`+`B` / `Ctrl`+`Shift`+`B`	Fold the menu / open the note list
`Alt`+arrows	Directional pad from an input field

Ctrl+C and Ctrl+V remain the system copy and paste.

What the app does not do

No sync, no account, no mobile version.
No AI, no access to your email or calendars.
No notifications, no streaks to keep alive, no artificial rewards.
Windows only for now; macOS and Linux are considered, with no date.