How to Walk the Rivers

A traveler's guide to reading and writing branching stories

The Basics

River Walks is a home for branching stories. Every story is made of chapters, and every chapter holds pages. At the end of a page, the author leaves you choices — each one carries you to a different page, so the tale you read is shaped by the path you walk.

Stories
A complete work — with a title, description, and cover. Stories can be private drafts or public for everyone.
Chapters
Numbered groupings that keep a long story organized. Each chapter collects a handful of pages.
Pages & Choices
A single scene of prose. Choices at the bottom link pages together into a branching web.

Reading a Story

Step 1

Find a story

Head to Stories in the navigation bar. You'll see your own stories and public stories shared by other authors. Open one that catches your eye.

Step 2

Start here

On a story's page, look for the Start Here box marked with a compass. Those are the story's entry pages — the beginnings of the journey. Pages with a small compass icon in the grid are entrances too.

Step 3

Make choices

Read the page — the words unfurl as you watch (tap the text to reveal it all at once). When the text finishes, choice buttons appear. Pick one to turn to the next page. There is rarely a single right path; wandering is the point.

Step 4

Unlock hidden pages

Some pages stay hidden until you've read the pages that lead to them. If a story looks incomplete, keep exploring — new pages reveal themselves in the story grid as you earn them.

Step 5

Keep your place

Pages you've read are marked Read and the story tracks your progress with a bar at the top. Use the bookmark button on any page to pin it, and Continue Reading to jump back to where you left off.

Step 6

Leave a comment

Every page has a comments section at the bottom. Tell the author what the walk was like — they can see and reply on each page.

Writing Your Own

Step 1

Create a story

Click New Story from the Stories page. Give it a title, a description, and (optionally) a cover and background image. Stories start as private drafts — only you can see them until you make them public.

Step 2

Add chapters and pages

From your story's page, add a chapter, then add pages to it. A page holds the prose for one scene — write it with the built-in editor, which supports bold, italics, underline, colored ink, headings, lists, quotes, and text alignment. Drag the editor's lower-right corner to make the writing area taller. Your writing is backed up in your browser as you type, so a closed tab won't lose it. Pages can also carry their own thumbnail and background image — upload one straight from your device or paste an image URL — plus an ambient audio link to set the mood.

Step 3

Link pages with choices

When editing a page, add next links — each one is a labeled choice button pointing at another page. Mark at least one page as an entry page (the compass) so readers know where to begin.

Step 4

Gate pages behind progress

A page can require other pages to be read first. Readers won't see it in the story grid until they've walked the required path — good for secrets, endings, and slow reveals. Keep unfinished pages as Draft and they stay invisible to readers.

Step 5

See the whole web

Open the graph view from your story page to see every page and choice as a map. It's the easiest way to spot dead ends and orphaned branches.

Step 6

Test it like a reader

Use Test View to experience the story exactly as a reader would — drafts hidden, locked pages locked. You can mark everything unread and replay the whole walk from the start.

Step 7

Publish and watch

When it's ready, edit the story and make it public. The analytics view shows how readers move through your pages and which choices they take. The edit story page also has an Export button that downloads the whole story — chapters, pages, and choices — as a JSON file for safekeeping.

Signs Along the Way

Compass

An entry page — a place where the story begins.

Bookmark

A page you've pinned to find again later.

Read

Read badge

You've visited this page; it dims in the grid so new paths stand out.

Draft

Draft badge

Only authors see this — the page or story is hidden from readers.

Pencil

Edit — appears on stories and pages you own.

Fading pages

Newly revealed pages shimmer into the grid one by one as you unlock them.

Ready to Walk?

The river is patient, and the frost keeps its secrets. Begin with someone else's story, or start telling your own.