How can we help?
Guides and answers for everything in visualOS — from your first note to the way your files live on disk.
Getting Started
New here? Start with these.
What visualOS is, how the canvas works, and the one setup step that makes your data truly yours — all in a few short reads.
What is visualOS?
An infinite canvas for notes, images, documents and to-dos — local-first, offline, and saved as real files you own.
Read articleQuick start: your first five minutes
From an empty canvas to your first notes, folder and to-do list — a five-minute hands-on tour.
Read articleThe interface at a glance
Toolbar, top bar, breadcrumbs, zoom controls and the save indicator — what every part of the screen does.
Read articleConnect a folder (do this first)
One minute of setup turns your canvas into real files on your disk — and unlocks sync, backups and version history.
Read articlevisualOS on iPhone, iPad & Mac
The native app is the full canvas — not a cut-down list. Touch gestures, Apple Pencil, and sync through your own iCloud folder.
Read articleBrowsers & requirements
Which browsers support the full experience, what works everywhere, and why folder access needs Chrome, Edge or Brave — in Brave after one setting.
Read articleThe interactive welcome tour
A two-minute guided start on your first launch, with an empty board or an example board — and how to bring it back anytime from Settings.
Read articleYour Files & Sync
Your data is a folder you can open.
How visualOS stores everything, what each file in your folder means, how devices stay in sync — with practical checks for cloud delivery and recovery.
How visualOS stores your data
Local work, shared files and recovery history have distinct roles.
Read articleWhat’s inside your folder: canvas-data.json & board.json
The workspace file, readable board files and hidden version snapshots explained.
Read articleWhere are my notes stored?
Notes live inside board.json, documents are .md files, images are image files — and without a connected folder, everything is in browser storage.
Read articleSync across devices with iCloud Drive
One shared folder, mixed devices and updates that arrive through your own cloud.
Read articleKeep your cloud folder available offline
Reduce placeholder delays with iCloud, Dropbox and Google Drive settings.
Read articleVersion history & restoring earlier states
Restore automatic snapshots of your workspace, and know the limits of media recovery.
Read articleBackups: export & import
One click exports your entire workspace — every folder, element and image — into a single file you can store anywhere or import elsewhere.
Read articleWhen two devices edit at once (conflicts & merging)
How visualOS combines edits from two devices and keeps both versions when they collide.
Read articleAdd files straight into the folder (New Items)
Drop images or PDFs into a board’s folder in Finder or the Files app — visualOS notices and offers them for placement on the canvas.
Read articleiPhone photos (HEIC) are converted automatically
Drop .heic photos straight from your iPhone — visualOS converts them to JPG on import and keeps the untouched original in a hidden .originals/ folder.
Read articleEditing your files outside visualOS (and AI agents)
Edit images, PDFs and other files in place; documents and board.json are written by visualOS. Great for reading, search and AI agents.
Read articleDisconnecting, moving or renaming your folder
What happens when you disconnect, how to move your folder somewhere else, and why a moved folder just needs reconnecting.
Read articleElements & Tools
Everything you can put on the canvas.
Fifteen kinds of building blocks — from sticky notes to magnetic arrows. Each article covers creating, editing and the tricks you’d otherwise find months later.
Notes
The workhorse: colored cards with rich text that grow as you type. Colors, font sizes, lists and auto-detected links.
Read articleText
Frameless text directly on the canvas — for headings, labels and annotations. Same rich editing as notes, no card behind it.
Read articleFolders (boards in boards)
The organizing principle of visualOS: every folder opens into its own canvas — and is a real folder on your disk.
Read articleImages
Drop, paste or upload images; crop to aspect ratios, frame, round or flip them, remove the background, add captions and links, and view full-screen in the lightbox.
Read articleTo-do lists
Interactive checklists right on the canvas: chain tasks with Enter, sub-tasks with Tab, reorder by drag, bold/italic inline, and optional auto-cleanup.
Read articleTables
Freeform-style grids of rich-text cells: rows grow with their text, drag grid lines to size columns, colour cells, pick a border style.
Read articleMindmaps
Brainstorm from a central topic outwards: Tab and Enter add nodes as fast as you type, three layouts, folding, styling per branch, notes on any node.
Read articleFrames
A page of a set size on the canvas — A4, a 1:1 post, a 9:16 story or a 16:9 slide. Lay anything out on it, then export it as PNG, JPG or PDF, or print it, at the format’s full resolution.
Read articleGrids
A title with cards under it, on a grid of square modules: stack them into a column or set them side by side as a bento layout. Cards grow with their text and move as one block.
Read articleDocuments
Long-form writing in a focused editor — headings, highlights, links and lists — stored as real Markdown files in your folder.
Read articleLinks & rich previews
Paste any URL to get a link card — YouTube, Spotify, X and friends unfurl into rich preview cards with thumbnail and title.
Read articleShapes
Twelve shapes from rectangle to speech bubble — with fill, border color and thickness, rotation, and drag-to-size creation.
Read articleArrows & connectors
Magnetic arrows that snap to elements, stay attached when things move, bend into curves, and take any end caps.
Read articleDrawing & Apple Pencil
Freehand sketching with pressure, smoothing and palm rejection — every stroke becomes a normal element you can move and scale.
Read articlePDFs, videos & other files
Drop PDFs, videos, Word, Excel, text and ZIP files onto the canvas — file cards with previews, players and real files on disk.
Read articleCanvas & Navigation
Move like you think.
Panning, zooming, selecting, arranging, finding — the moves that turn an endless canvas into a place where nothing gets lost.
Moving around: pan & zoom
Scroll, pinch, Space-drag; zoom from 4% overview to 600% detail — and Fit all to frame everything in one keystroke.
Read articleSelecting & moving elements
Click, Shift-click, marquee, select-all — and the touch logic that makes sure you never move something by accident.
Read articleSnapping & alignment guides
Red guide lines appear as edges and centers align — and the element clicks into place. Hold Cmd/Ctrl to place freely.
Read articleGrouping, locking & rotating
Groups move as one, locks make backgrounds untouchable, rotation adds life — with snapping at the right angles.
Read articleCopy, paste & duplicate
Copy works across folders and even across windows; paste lands at your cursor; Cmd/Ctrl+D is the fastest way to repeat yourself.
Read articleFolders in folders: nesting & breadcrumbs
Infinite depth, a breadcrumb trail that always knows where you are, and browser-back that walks up the tree.
Read articleSearch everywhere
Cmd/Ctrl+F searches every folder at once — notes, tasks, documents, links, captions — and jumps you straight to the hit.
Read articleUndo, redo & the deletion safety net
Undo everything, redo anything — and deleted folders (files included) can be brought back whole for several minutes.
Read articleWorkspaces
Fully separate canvases with their own folders — one for you, one for the studio, one for that shared iCloud folder.
Read articleExport your canvas: PNG, JPG, PDF or print
Save a selection, the current view or the whole canvas as PNG, JPG or PDF, or print it — in the quality you need.
Read articleKeyboard shortcuts: the complete list
Every shortcut in visualOS on one page — tools, editing, navigation, zoom and text formatting.
Read articleSettings & Customization
Make it yours.
Grid, background, shadows, language, input behavior — small dials that shape how the canvas feels.
Canvas settings: grid, background, shadows & padding
Toggle the grid, pick any background color (dark ones included), and tune element shadows and padding to taste.
Read articleLanguage & input mode
English or German, automatic by default — and an input switch that decides whether dragging on empty canvas selects or pans.
Read articleSettings reference: every option explained
A map of the whole Settings dialog — three tabs, what lives where, and links to the deep dives.
Read articleTroubleshooting & FAQ
When something looks wrong.
Symptom-first fixes for the questions we actually get — plus the honest answers on offline, privacy and pricing.
Files could not yet be written to the folder
Check unavailable originals, folder access and storage without confusing local saving with cloud upload.
Read articleChanges don’t show up on another device
Check local saving, cloud delivery and receiving-device availability separately.
Read articleMy canvas looks empty or data seems missing
Check the workspace and folder while preserving remaining local copies.
Read articleSync messages explained
Understand local saving, folder confirmation, pending files and recovery messages.
Read articleDoes visualOS work offline?
Edit available content offline; cloud-only files and transfers may need a connection.
Read articlePrivacy: who can see my data?
Short answer: you. No account, no visualOS server, no analytics on your content — and sync runs through your own cloud.
Read articleWhat’s free, what’s paid?
The browser app is fully free — no caps, no account. The native iPhone/iPad/Mac app is a one-time purchase, no subscription.
Read article