The problem
A student who heard about Kwark from a friend opens kwark.space on her phone between classes. Until November 2026 she met a four-slide introduction: a welcome, a philosophy, the story of the name. The button to start was on the last slide. In the first ten seconds nothing said what Kwark does.
Then the worse moments. Someone with no account imported a film, opened it, reloaded, and met the sign-in page; choosing Continue as Guest dropped them on Home, not on their page. For a first-time writer that reads as “my work is gone”. The project page ran a stopwatch, “Session time”, at a person who had only opened their film. And an earlier sign-in reloaded the whole page, after which a dialog appeared.
The first minutes decide whether a nervous writer ever writes here. The mission says the way to begin must be obvious and one step away.
Kwark’s answer
One frame, not a slideshow (Decision 0035)
On an empty Home, one frame (pages/Project/components/FirstFrame.tsx):
- One sentence: “Write your film. The rest follows from the page.” The last noun cycles through what follows: the breakdown, the shot list, the schedule, the call sheet.
- One line under it: “The script you write here becomes its breakdown, shot list, schedule and call sheet. Nothing is typed twice.”
- The journey in five steps, each showing a real piece of the sample film and claiming only what the app does today:
- Script: “EXT. RAO FARM, VIDARBHA – DAWN”
- Breakdown: “Props, cast & places tagged on the page”
- Shots: “Scene 1 setups · Establishing at Rao Farm”
- Schedule: “12 shooting days, laid out by the hour”
- Call sheet: “Day 1 call sheet, issued as Rev 1”
- One button: Start a new story, and the line “No account needed. Your story is kept on this device until you sign in.”
- Quiet secondary routes: Open the sample film, Import a shared project.
The philosophy and the story of the name stay on the About page (/info). The founder chose this layout (“the path of a film”) from three mock-ups; the others (the sample film as the front door, and a blank page with the cursor waiting) are recorded with why they lost. The words are the mock-up’s; the founder chose the idea, not yet every word.
Agreed, not built (part 2): each step opens a pop-up holding the real screen, loaded with the sample film, read-only. The sample ships inside the app (no account, no network), is never listed among the visitor’s projects, never synced and never adopted on sign-in. When the visitor starts to change something, Kwark asks them to create their own project.
No account to begin
A visitor starts as a guest. Importing a film without an account makes them a guest too (Decision 0034). Guest work lives on the device and is adopted into the account the first time they sign in. Home marks a guest’s story Only on this device.
Sign-in opens in place and returns you (Decisions 0010, 0034)
- Sign-in navigates inside the app; it never reloads the page, and keeps a marker so guest work is adopted (Decision 0010).
- After sign-in or Continue as Guest, the app returns to the page that asked, if it is a page of this app (
returnPathinutils/signIn.ts).
Nothing counts the newcomer
- The session stopwatch and its code are gone from the project page (Decision 0034).
- There is no automatic tour offer (removed in Decision 0015). Take the tour stays in Help for anyone who wants it.
- No streaks, goals or “complete your profile” (Decisions 0001, 0008).
- “Where you left off” uses the names on the cards (Shots & Boards, Director’s Book, Look Book…), never internal names like “Creative lock”.
A returning writer is a different person
The founder’s words for the returning writer, tired after a ten-hour shift: they should see something and say “yes, I need to write today”, and on closing be “content with the work they have done, and excited for the next day”. That is a separate decision from the first frame. Today, a returning writer’s tap on a story opens Project home, or Where I left off if they chose it (Decision 0018), and Continue writing goes straight to where work stopped.
Anatomy
| Part | Means |
|---|---|
| Headline | What Kwark is, in one sentence |
| Line | The promise: one script, nothing typed twice |
| Five steps, in order | What one script becomes; screenplay type marks a line of script |
| One filled button | The one way to begin |
| Small line | No account, and where the work is kept |
| Secondary links | The sample film; importing a shared project |
Rules
- Must show what Kwark does and the one way to begin in the first frame, on a 375px phone, without scrolling.
- Must let a visitor start without an account, and say where the work is kept.
- Must return a person to the page that asked after sign-in or Continue as Guest.
- Must claim only what the app does today on the first frame.
- Never show a slideshow, a splash screen, a philosophy or the story of the name before the way to begin.
- Never start a tour automatically, or time, count or score the first session.
- Never reload the page on sign-in.
- Never list the sample film among the visitor’s own projects or let it sync.
- Always keep one primary button on the first frame.
- Always use real pieces of the sample film, not generic illustrations.
Edge cases
- A visitor arrives by a shared link. They see who invited them, as what, before signing in; a link to someone else’s project still asks who they are.
- A guest clears their browser. Guest work is on the device; the first frame’s line says so up front, and the account panel offers Backup.
- The visitor is 13 to 17. Kwark serves students from 13. Age and consent steps belong in sign-up, written plainly (“Please complete the 13+ eligibility check and acknowledgements first.”), never as a wall before the first frame.
- Shared via WhatsApp or LinkedIn. The app page carries the same description and picture as
/info, so a link preview says what Kwark is (Decision 0034). - An empty Home that is not a first visit (all stories deleted). Show the ordinary empty library (“Every story starts somewhere.”), not the first frame’s promise again.
Phone and desktop
The first frame is one screen at 375 wide: the headline breaks after “The {word}”, the five steps stack as compact rows, the button is 44px and full width, nothing is under 12px. On desktop the five steps sit in one row and the headline is display size; hovering a step highlights it and pauses the cycling word. The Home toolbar around the frame (search, filters, import) is still shown for a visitor with no projects today; that is an open item, not the pattern.
Writing
- “Write your film. The rest follows from the page.”
- “The script you write here becomes its breakdown, shot list, schedule and call sheet. Nothing is typed twice.”
- Start a new story · Open the sample film · Import a shared project
- “No account needed. Your story is kept on this device until you sign in.”
- Shared stories: “When a director, producer, or co-writer invites you to a project, their production workspace arrives here automatically under their banner.”
Accessibility
- The frame is a section labelled by its headline. The cycling word is in the heading’s text once, not announced on every change; it stops under reduced motion.
- The five steps are a list in reading order; each is a link only when part 2 makes it open something.
- The primary button is the first focus stop after the heading.
“Write your film. The rest follows from the page.” and Start a new story in the first frame.
Four slides about the founder’s philosophy and the name, with Start on the last.
After Continue as Guest, the visitor lands back on the film they imported.
After Continue as Guest, the visitor lands on an empty Home and thinks their film is gone.
Demo
The shot list follows from the page.
- Script
- Breakdown
- Shots
- Schedule
- Call sheet
<div class="kw-card" style="width:100%;max-width:360px;display:grid;gap:12px">
<strong style="font:600 var(--k-fs-head)/1.2 var(--k-font-display)">Write your film.<br><span style="color:var(--k-text-2)">The shot list follows from the page.</span></strong>
<span class="kw-meta">The script you write here becomes its breakdown, shot list, schedule and call sheet. Nothing is typed twice.</span>
<ol style="margin:0;padding:0;list-style:none;display:grid;gap:6px">
<li class="kw-row" style="border:1px solid var(--k-line)"><span class="kw-row__title">Script</span><span class="kw-row__meta" style="font-family:var(--k-font-screenplay)">EXT. RAO FARM – DAWN</span></li>
<li class="kw-row" style="border:1px solid var(--k-line)"><span class="kw-row__title">Breakdown</span><span class="kw-row__meta">Props, cast & places</span></li>
<li class="kw-row" style="border:1px solid var(--k-accent)"><span class="kw-row__title">Shots</span><span class="kw-row__meta">Scene 1 setups</span></li>
<li class="kw-row" style="border:1px solid var(--k-line)"><span class="kw-row__title">Schedule</span><span class="kw-row__meta">12 shooting days</span></li>
<li class="kw-row" style="border:1px solid var(--k-line)"><span class="kw-row__title">Call sheet</span><span class="kw-row__meta">Day 1, Rev 1</span></li>
</ol>
<button class="kw-button kw-button--primary kw-button--lg" type="button" style="width:100%">Start a new story</button>
<span class="kw-meta">No account needed. Your story is kept on this device until you sign in.</span>
<a class="kw-link" href="#">Open the sample film</a>
</div>
Related
Onboarding without teaching, Empty states, Navigation, Button, Saving and sync.
AI readiness test
Task. Build part 2 of the first frame: each step opens the sample film’s real screen.
Give the agent. This page, Decision 0035, Decision 0034, Sharing and roles.
Constraint. No account and no network needed to look.
A reliable answer
- Opens the real module in look-only mode from a sample shipped in the app
- Never lists, syncs or adopts the sample
- Starting to edit asks to create their own project and creates one as Start a new story does
- Keeps one primary button and works at 375 wide
- Claims only what the screens do today