Documentation

How kagaj works.

A short walk through everything you can do. Nothing here is required reading. kagaj is meant to be the kind of app you can figure out by tapping. For the why behind it, read about the project.

01Getting started

Getting started

Open kagaj on your iPad and tap the floating + button at the bottom-right. A small popover opens with New note, New folder, and Import file. That's it. There's no account to make, nothing to sign in to, no settings to flip. Pick up your Apple Pencil and start drawing.

Everything you create stays on your iPad. You can use kagaj offline, on the bus, on a plane, anywhere.

02Library

Library

The Library is where every note lives. It's a grid of cards. Notes look like little ruled pages. Folders look like cardstock tabs.

  • Tap a note to open it. Tap a folder to look inside.
  • Folders can hold notes and other folders, as deep as you want.
  • Search finds folders and note titles.
  • Pin the notes and folders you come back to most.
  • Long-press any card to enter Select mode. Pick several at once to move or delete them together.
  • You can bring in plain text and PDFs from Files. PDF pages are kept as backgrounds so you can write and draw on top of them.
Tip

If you close a note without writing anything, kagaj quietly throws it away. If you wrote something but never gave it a title, it gets a clean default name like Note 4 so your library doesn't fill up with "Untitled".

03Pages

Pages

A note is a stack of pages. Each page is the size of a letter sheet, and you can pick whether it's ruled or plain. Pages flow top to bottom, the way a real notebook does.

  • Tap above or below a page to add a new one.
  • Pinch with two fingers to zoom in. Double-tap to snap back.
  • Each page shows where it sits in the note (page 2 of 5, for example) and has a small button to remove it.
  • Tap Share to send the whole note as a PDF. Your ink comes along.
Tip

Draw a line or a circle and hold your Pencil still for about a second. kagaj will quietly straighten the line or round out the circle for you. On Apple Pencil Pro you'll feel a small haptic tap when it snaps.

Want to focus? Tap the fullscreen button to hide everything but the page.

04Tools

Tools

The tools palette is a small floating bar at the bottom of a note. It's where you pick what your Pencil does. kagaj is a hand-written notebook, so there's no text tool. Typed text already lives in plenty of other apps. This one is for ink.

ToolWhat it does
PenA clean ink line. Pick the thickness.
PencilA softer, slightly wider stroke.
HighlighterA wide, see-through stroke for marking.
EraserRemoves ink wherever you drag it.
LassoCircle around ink to move or delete it.
LaserA glowing dot that follows your Pencil tip without leaving any ink. Great for pointing at things while you talk.

Six colours to pick from: black, red, blue, mango green, amber, plum. The pen, pencil, highlighter, and eraser each have a size slider so you can dial the stroke up or down. The palette gives a tiny haptic tap when you switch.

Size3.0
pen4.2px

To open the palette quickly: squeeze your Apple Pencil Pro, or double-tap the side of a Pencil 2. Or just tap the tools chip in the toolbar.

05Apple Pencil

Apple Pencil

kagaj is designed around the Pencil. Your Pencil is for writing and drawing. Your finger is for everything else: scrolling the page, pinching to zoom, tapping buttons. The two never get confused.

Tip

Try the laser tool. The dot follows your Pencil tip but stays a little to the side, so your hand never covers it. The harder you tilt the Pencil, the further the dot floats. Move your cursor across the demo below to see how it feels.

move your cursor across this page

06Your notes

Your notes

Your notes live on your iPad. Nothing leaves your device unless you choose to share a PDF. There's no account, no cloud sync, no servers in the middle.

kagaj saves as you write. You don't need to think about it. If you close the app or your iPad runs out of battery, everything is already there when you come back.

Tip

If you ever need a copy of a note, use the share button to export it as a PDF and send it wherever you'd like.

07Quick reference

Quick reference

WhereAction
A pagePinch to zoom
A pageDouble-tap to zoom in or out
A pageSqueeze your Pencil to open the tools palette
A pageDraw a line or circle, then hold still to straighten or round it
The LibraryTap the floating + at bottom-right to add a note, folder, or import
The LibraryLong-press a card to select several at once
The LibraryTap a folder to open it
The sidebarSwipe an open note to close it