Skip to content

Repository files navigation

NOTEKEEPER

A quiet desk for your notes and plans

Quick to-dos, long-form writing, and big-picture planning, organized in folders.
It runs in your browser and keeps everything on your device.

React 19 TypeScript Vite 8

Notekeeper showing a folder's Focus view: a sidebar of colored folders, tag filters, and a grid of pastel cards

What is Notekeeper?

Notekeeper is a personal notes and planning app for people who want their to-dos, writing, and goals in one calm place, without the weight of a project-management tool.

Everything lives in folders. Each folder has three views of the same work: Focus for small things that need attention soon, Notebooks for longer writing, and Canvas for mapping out plans visually. There's no account and no server; your notes are saved in your browser.

Features

Focus

Short cards for the things that need you soon. Each card has a due date, tags, a priority, a checklist that drives its progress ring, and a pastel color you choose. Filter by tag, sort by due date or priority, and mark cards done to move them out of the way.

An open card with a due date, priority, tags, a checklist, and a linked notebook

Notebooks

Longer notes live in notebooks, with headings, checklists, quotes, code blocks, links, and images. Changes save as you type, and cards can link to the notebooks they relate to.

The notebook editor with a formatting toolbar, a checklist, a bulleted list, and a quote

Canvas

An open canvas for planning. Add sticky notes, group them into sections like Now, Next, and Later, and draw connectors between them. Sections carry their notes when you move them, connectors follow along, and undo works for everything.

A planning canvas with Now, Next, and Later columns of sticky notes

Around all three: nested folders you can drag into order, search across everything, Today / Recent / Pinned views, keyboard shortcuts, and light and dark themes that follow your system.

How it works

01
Make a folder for each area of your work or life.
Nest them, color them, and drag them into order.

↓

02
Capture small things as cards in Focus and longer thinking in Notebooks.
Link cards to the notes they belong to.

↓

03
Plan on the Canvas.
Lay goals out by week, month, and year, and connect them.

Everything is saved to your browser's localStorage as you go. Use Settings → Export to download a JSON backup and Import to restore one. Clearing your browser's site data deletes your notes, so export first.

Getting started

You'll need Node.js 20.19+ or 22.12+.

git clone https://github.com/Harshul1484/Notekeeper.git
cd Notekeeper
npm install
npm run dev

Open http://localhost:5173. The app starts with a short Getting started tour and a few empty templates; Settings → Sample data restores them at any time.

Keyboard shortcuts

  • N — new card, notebook, or sticky note in the current tab
  • / — search
  • Esc — close the open card, menu, or notebook
  • On the canvas: Space + drag to pan, Ctrl/⌘ + scroll to zoom, Ctrl/⌘ + Z to undo (add Shift to redo), Backspace to delete, and V S T F A to switch tools

Development

npm run dev        # start the dev server
npm run build      # typecheck and build to dist/
npm run preview    # serve the production build
npm run typecheck  # run TypeScript only

Built with React 19, TypeScript, Vite, Tailwind CSS 4, Zustand, TipTap, react-day-picker, Radix UI, and Remix Icon.

src/
  components/   UI by area: layout, folder, focus, notebooks, canvas, ui
  store/        app data and UI state (Zustand), persisted to localStorage
  data/seed.ts  sample content for first launch
  index.css     design tokens for the light and dark themes

About

A quiet notes and planning app: cards for what's due, notebooks for longer writing, and a canvas for mapping out goals. Runs in the browser and keeps your notes on your device.

Resources

Contributing

Stars

1 star

Watchers

1 watching

Forks

Releases

Packages

Used by

Contributors

Languages