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.
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.
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.
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".
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.
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.
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.
| Tool | What it does |
|---|---|
| Pen | A clean ink line. Pick the thickness. |
| Pencil | A softer, slightly wider stroke. |
| Highlighter | A wide, see-through stroke for marking. |
| Eraser | Removes ink wherever you drag it. |
| Lasso | Circle around ink to move or delete it. |
| Laser | A 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.
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.
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.
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
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.
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.
Quick reference
| Where | Action |
|---|---|
| A page | Pinch to zoom |
| A page | Double-tap to zoom in or out |
| A page | Squeeze your Pencil to open the tools palette |
| A page | Draw a line or circle, then hold still to straighten or round it |
| The Library | Tap the floating + at bottom-right to add a note, folder, or import |
| The Library | Long-press a card to select several at once |
| The Library | Tap a folder to open it |
| The sidebar | Swipe an open note to close it |