Skip to content
ThomasgsnPublic

About

A lightweight macOS menu bar notes app with Markdown support, tags, and local-first storage. Built with Tauri, Vue 3 & TypeScript.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

TopNotes

Bloc-notes pour la barre des menus macOS : une fenêtre toujours au premier plan, des notes en Markdown, des étiquettes, l'épinglage, l'archive et la corbeille. Interface en français, anglais, italien, espagnol et allemand.

  • ⌥⌘N affiche ou masque TopNotes depuis n'importe quelle application (liste complète des raccourcis : ⌘/ dans l'app).
  • Tri par date de modification, de création ou par titre (menu à côté du titre de la liste).
  • « Annuler » après chaque suppression ; les notes restent 30 jours dans la corbeille avant d'être supprimées.
  • ⌘+clic ouvre un lien.
  • Export JSON ou Markdown et import JSON dans Réglages › Données.

Construit avec Tauri 2 (Rust), Vue 3, TypeScript et l'éditeur TipTap.

Données

Tout reste en local, sans compte ni synchronisation.

Élément Emplacement
Notes, étiquettes et réglages ~/Library/Application Support/com.ths.topnotes/topnotes.json
Sauvegardes quotidiennes (7 dernières) ~/Library/Application Support/com.ths.topnotes/backups/topnotes-AAAA-MM-JJ.json
Fichier illisible mis de côté ~/Library/Application Support/com.ths.topnotes/topnotes.corrupt-<horodatage>.json
  • Chaque modification est enregistrée automatiquement (~0,3 s après la dernière frappe), de façon atomique : fichier temporaire, fsync, puis renommage.
  • Avant la première écriture de chaque jour (UTC), l'état précédent est copié dans backups/.
  • Si le fichier vient d'une version plus récente de TopNotes, l'app l'explique et n'écrit rien.
  • Pour restaurer une sauvegarde : quitter TopNotes, remplacer topnotes.json par la copie voulue, relancer.
  • Les exports (Réglages › Données) vont dans un nouveau dossier ~/Downloads/TopNotes AAAA-MM-JJ HH-MM/. L'import JSON ajoute des notes sans rien remplacer.

En mode navigateur (npm run dev sans Tauri), les données vont dans le localStorage de la page.

Développement

Prérequis : Node 24 (voir .nvmrc), Rust stable et les prérequis Tauri pour macOS.

npm install
npm run tauri dev
Script Rôle
npm run dev Interface seule dans le navigateur (http://localhost:1420)
npm run tauri dev Application native avec rechargement à chaud
npm run tauri build Application macOS (.app / .dmg)
npm test Tests front (node --test, jsdom)
npm run test:rust Tests de la persistance Rust
npm run lint ESLint, Stylelint et Prettier
npm run typecheck vue-tsc --noEmit

Attention : npm run tauri dev utilise le même dossier de données que l'application installée. Pour tester sans toucher à vos notes, lancez le binaire avec un HOME temporaire :

HOME=$(mktemp -d) src-tauri/target/debug/topnotes

Structure

src/
  main.ts              démarrage : charge les données puis monte l'app
  persistence.ts       lecture/écriture (Tauri ou localStorage), migrations
  exchange.ts          export JSON/Markdown, lecture des imports
  stores/notes.ts      notes, filtres, recherche, étiquettes, sauvegarde auto
  stores/settings.ts   langue, premier plan, lancement à la connexion
  editor/              extensions TipTap, Markdown, liens, raccourcis
  components/          panneaux (navigation, liste, éditeur) et dialogues
  *Messages.ts, i18n.ts  traductions
src-tauri/src/
  lib.rs               barre des menus, fenêtre, instance unique, raccourci global
  export.rs            écriture des exports dans Téléchargements
  persistence.rs       fichier JSON atomique, sauvegardes, protection des données
tests/                 tests node:test

About

A lightweight macOS menu bar notes app with Markdown support, tags, and local-first storage. Built with Tauri, Vue 3 & TypeScript.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages