Atlas
Atlas reads and writes your world as plain JSON files, in a folder on your own machine or in your browser’s own storage. The folder is the world, and nothing is locked away.
| URL | atlas.onlyworlds.com |
| Type | Local-first web application (any modern browser; a folder on your drive needs Chrome, Edge or Brave) |
| Changelog | atlas.onlyworlds.com/changelog |
Features
Section titled “Features”- Build and Browse. Every element type in an editor driven by the standard. Link fields are pickers, and every element lists what links to it. Home shows a world’s charter, its guide and its domains first, each a link, and they stay out of the element list, the counts, Search and Charts, so the world reads as its story; a world’s charter is the newest one marked as its charter, and its owner or a co-builder sees Mark as this world’s charter on an unmarked one’s page (since 1.101.0).
- Write. Books, chapters and scenes (you set the tier names). Names in your prose become links with a click, and the find bar can link every match at once. The words stay yours.
- Web. Any element’s connections as a small graph, including everything that links to it. An element waiting for review or hidden on OnlyWorlds gets a dotted ring and the word beside its name (since 1.95.0). The Lens choice reads the Web through any lens in your world: it shows what the lens keeps and says how many it keeps and why the rest were left out, and Keep a lens on (an element’s name) saves one of that element and what links to it or from it (since 1.105.0).
- Map. Your own map images, nested maps, pins for any element, and zones drawn as areas or lines. Zones can be coloured by kind (rivers blue, roads dashed), and the style is saved with the world. A map shows its zones and pins as of any date in the world’s calendar: a zone by its own dates, a pin by its element’s (a Character from its birth on, an Event from its start to its end). Anything undated always shows. Since 1.53.0 a map can be drawn from its own zones: Map style on the map’s page (Plain, Ink on parchment, Modern atlas, Hatched) draws each zone whose subtype names a kind (Landmass, Sea, Lake, Range, Forest, Marsh, Desert, Territory, River, Road (or Route, Path), Wall, Border, Coast; any case) as that kind: coasts with their shore, ranges hatched, rivers cut at the coast, names along the lines. A subtype written
Class: kind(Border: treaty line) is tried by its halves, the part before the colon first. Your zones are never changed, Plain brings the usual look back, and over a map’s picture the zones take the style’s lines and names but cover nothing. The style is saved on the Map asatlas_map_styleand syncs. Trace on the drawing strip turns a drag into a few points. - Chart. Place elements on a time axis by their dates, on your world’s own calendar. Charts can be saved and added to published pages.
- Knowledge. Track who knows what, per character or circle, and see the world as one of them knows it.
- Calendars. Custom calendars as a display layer over world time. Since 1.93.0 Atlas reads the calendar profile’s version 2, so Gregorian leap years (every 4, not every 100, yet every 400) and calendars with no year 0 read exact, and the calendar builder keeps the keys it does not draw.
- On a phone. Built for a bigger screen, Atlas holds together on a phone: a top bar with a More menu, finger-sized buttons, each field’s name above its value. On a touch screen help and the tour speak in taps, Writing has a Find button, the sidebar has Hide types, and the chart zooms with two fingers, pans with one, and re-dates a tapped dot by sliding it. A map’s drawing tools are finger-sized too, and inside a submap the way back up keeps its own row and the whole name of where it goes (since 1.92.0).
- Local-first. Worlds are folders of plain JSON files you own, in a folder on your drive or in your browser, and Atlas works offline.
- One file. Download the whole world as a single .zip (elements, pages, notes, charts and images), without the OnlyWorlds link and its key, and without the record of which member and which tool last wrote each element, which a JSON export leaves out too (since 1.108.1). Atlas opens it on any browser as a world of its own, and opens a world file another tool saved as
.owworldthe same way; under any other name but.jsonit opens by what it holds (since 1.88.3). A world file of a world already in Atlas can open beside it as a copy to read, never changed and never online, named in your list with the day the file was made when the file says one, so last week’s world sits next to today’s (since 1.90.0). A world folder or file whoseworld.jsonsayswritable: false, as a snapshot does, opens view only (since 1.90.0). - Sync. Link a world to onlyworlds.com to push and pull. The folder stays the source of truth. Signed out, Make online and New world on OnlyWorlds start with Sign in with OnlyWorlds: onlyworlds.com asks once whether Atlas may sign in as you, and you come back where you were, signed in, and the world is made on your account (since 1.87.0; your email or username and password still work, since 1.54.0). Atlas keeps a token for this browser, listed on your account page where you can take it back, never your password. Forget and Forget everything take that token back on onlyworlds.com too, and say whether it was confirmed; a token you pasted in yourself is never revoked (since 1.93.0). Signing in again revokes the token Atlas made before, once the new one is kept (since 1.94.0). Download a world from OnlyWorlds takes a world’s API key and PIN, downloads a full copy and keeps the two in sync; a mistyped PIN is called a wrong PIN, not a wrong key (since 1.55.1). Open in Atlas on a world’s page on onlyworlds.com opens it here: signed in, Atlas asks once and opens the world, or the copy you already have; signed out, it asks you to sign in first. An element, a knowledge entry or a page an agent changed last carries a quiet mark after its name (Knowledge and Pages since 1.58.0); point at it or tap it to read who. A person’s change carries none, and your own edit takes it away. In a world on OnlyWorlds, the foot of an element’s page says where it was last changed (in Atlas, in Lantern, on onlyworlds.com, in code or with an AI) and the tools before that, each with its time; it names tools, never people (since 1.107.0). If onlyworlds.com stops taking a linked world’s key, Sync says why (revoked, unknown, a read key, a wrong PIN), and Settings → This world takes a new key in place; signed in, Atlas makes one itself for a world on your account’s list, unless you are a guest there. The folder and the edits waiting to sync stay. In a world someone shared with you, Atlas sends a change to the world’s own details, such as its description, whole. onlyworlds.com takes those details from the owner, and since 2026-10-24 from a co-builder too, all but the owner’s Character, which Atlas never sends. When it refuses them, as it does for a contributor or a guest, Atlas sends the world’s now on its own (since 1.53.3), keeps the rest of the change in your copy, says so once, and tries again when you change those details again (since 1.53.2). When others can change a world with you (people you invited, or an agent with a seat), Atlas holds an element changed both in your copy and online, marks it ⚠ and lets you choose which version stays, instead of letting your copy replace their newer words; a shared world also pulls the latest changes when it opens, and Settings → This world shows the rule and can turn it off (since 1.59.0). Working alone, nothing changes. If the owner makes you a guest, your copy keeps everything you had and Atlas says so once: what you no longer see online stays as it is and stops syncing, your changes to it stay in your copy, and a bigger role later brings those elements back into sync; Settings → This world names your role and how many elements are kept (since 1.60.0). An element a world hides shows to you with the word Hidden, in a world on your disk or in this browser too (since 1.86.0), and a published page leaves it out. Making a world online sends it hidden; when you own the world or build it with its owner, marking an element hidden after it went online hides it on OnlyWorlds as well, before your edit is sent (since 1.88.0), and taking the mark out of a file never shows it again there: unhide it on onlyworlds.com. When the owner hides an element from you, it leaves your copy without asking, unless you changed it here: then your change stays in your copy and stops syncing, your own elements keep their links to it, and it comes back when the owner shows it again (since 1.61.0). Sharing is forward-only. A page keeps its layout on the computer that built it and OnlyWorlds holds its text: opened anywhere else (a shared world, your own on a second device), the page shows that text, and adding to it there keeps it (since 1.57.2).
- Files. In an online world, an element’s page has a Files section (since 1.56.0): add a pdf, a text file or a world’s own bundle, up to 25 MB each, with a label that says what it is for. Each file shows who added it and when, and an agent’s is marked. Download fetches it fresh; Remove takes it off OnlyWorlds for everyone. The header shows how much of the world’s 250 MB is used. Files live on OnlyWorlds only, never in your copy of the world or its world file. The rules behind it: Files.
- Import and Export. Import and export the same world file onlyworlds.com exports. A world folder written by another tool opens in place; an element file in it that is damaged or has no id is left on disk as it is, and the element list says how many cannot be read and names them, so fixing one brings its element back (since 1.89.0). A world file with a damaged entry is refused, never half read (since 1.88.2). Before you have a world, Other ways in → Bring in a file, notes or JSON opens the Data room: a world file opens as it is, and OnlyWorlds JSON, such as the JSON an AI assistant makes from your notes, is reviewed first, then Create world makes a world from it (since 1.103.0).
- Sharing. Publish read-only pages of your world to send to anyone. Needs an account; each world can have 20 published pages at a time. The owner of a linked world invites people from Settings → This world → Invite someone: signed in to your account, Atlas makes the link (a contributor; a player, who needs no account and reads in Lantern as one Character, picked or new, since 1.55.0; or a player with an account; each works once, for 7 days) with Copy and a QR code. Seeing and taking back links stays on the world’s page on onlyworlds.com, and signed out the button opens that page at Access (since 1.55.2, also when the site asks you to sign in first). An invite link opened in Atlas joins you with your own OnlyWorlds account; a player’s link opens the world to read as its Character, with no account and no PIN (since 1.55.0). A link to open a world works once: if the download is cancelled, closed or cut off by a reload, the world stays in your list as not downloaded yet, and selecting it downloads it with nothing more spent; or remove it (since 1.91.0). A player link for a whole table (A table of players) says how many places are left and lists the Characters you may pick, taken ones greyed; pick one and the world opens as that Character, and a link with no list asks your name and makes one (since 1.63.0). Playing a Character, you also see what your Character points to, one step out: what you only know of shows its name, picture and description, says so, and is never changed or sent back (since 1.64.0). A message whose sender or recipient your key may not see says “someone you cannot see”, never who or how many (since 1.106.0). A link made for an AI agent asks first, and says it joins as a seat its maker answers for, not as you (since 1.62.1). If your account has no PIN yet, the world opens to read, with a line on where to set one. A world you can only view (a read key, or a player’s link) offers nothing it would refuse (since 1.57.0): element pages show their values plainly, Writing and Knowledge open as text to read, pages open as their visitors see them, maps and charts move and zoom with nothing to drag into place, and no + appears. Search, Find, opening and your own view settings work as before.
- Light and Dark. Both themes across the whole app.
Getting started
Section titled “Getting started”No signup is needed to start. The first screen leads with Create a world, and under it Explore, which opens Moppetopia, the public demo world, as an editable copy in your browser that never syncs back (later, Settings → Explore Moppetopia opens it again). Below them, Watch how it works is the guided tour, and Other ways in opens a world folder you have, downloads a world from OnlyWorlds, views a shared world, opens a world file or brings in notes or JSON. Signed in (Settings → OnlyWorlds: Sign in with OnlyWorlds, where onlyworlds.com asks once whether Atlas may sign in as you, since 1.87.0; your email or username and password still work, and pasting an account token still works under “I have an account token”), your worlds on onlyworlds.com, your own and those shared with you, are listed under the doors, and one click opens one.
Where a world lives: on Chrome, Edge and Brave a new world asks whether it goes in a folder on your drive, where your AI and other tools can work on it, or in the browser, and a browser world can be moved to a folder later. On Firefox and Safari a world lives in the browser, and that is a full home.
A new world’s Home asks for its first story, one question at a time (since 1.120.0, in this order since 1.121.0): the story’s name and text, then who it is about, what happens to them (an event that lists that character among its characters), where it happened, and whether they are still there. Each answer becomes a box joined to the one before; a step can wait (Skip for now), and a filled box opens in place to edit. Once the world holds more than this first story and its parts, Home shows Picture and Strand as tabs. On Strand every filled box says where it goes next: the story to the writing room, an event with a year to the timeline, a location to the map, a character to their page. On Picture the story and its parts stand first, in the same places every time (since 1.121.0). A world kept only in the browser asks for a copy once that story is whole (since 1.120.2).
To sync with onlyworlds.com, see onlyworlds.com for accounts and keys.
