Answer
Tomorrow's product has six addresses: Today, Work, Your store, Settings, a pick and Make it.
Today
Not applicable to a generated document: it is rewritten from its sources on every build.
Tomorrow
The shape
Top bar brand mark or brand switcher character corner your picture: Settings
Tabs Today Work Your store
phone: bottom bar of three desktop: left rail of three, Settings at its foot
Today greeting with the character corner
Need your yes yes or no questions, count on the tab
story rings 24 hour stories, Your week recap on Monday
This week's picks five, ranked, each a closed card
See everything the rest of the ideas, ranked
caught up the character signs off
A pick the draft and Versions
Why this three sourced lines, then the full plan
Where to post
bottom bar Make it
Make it the thing left on desktop, top on phone
the chat right on desktop, below on phone
tools add a photo or file, talk, film board, teleprompter
bottom bar Hand it off
Hand it off Who is shipping this Me, My team, My agency or freelancer, The ShopOS team
Brief page outside the app, no login the brief, the files, copy all, its status
Work New since you looked replies, updates, briefs that moved
Ideas | In the works | Handed off Later: Scheduled, Live, How it went
Start something new
Your store store health three meters, one fix line each
What customers say themes, counts, mood
What rivals run rival cards, long running ads
What AI search says answers that name you, gaps
What changed price, stock, new products, reviews
The plan the whole plan for your store, grouped by get found, get chosen, get them back
Settings What we know about you facts, house rules, tell us something, share your brand sheet
Which of these do you handle
Team invite, roles, admin hand over
Connections read only connections and their state
Notifications and sound
Account theme, start again, ask us to delete your data, sign out
Six addresses: Today, Work, Your store, Settings, a pick, Make it. The Brief page and the sign in pages live outside the app.
Decisions on everything the model did not yet cover
| Gap from the surface map | Decision | Where it lives | Status | Change type |
|---|---|---|---|---|
| Slack works both ways | Slack is a place your team already is. Hand it off, My team, offers Post to Slack when Slack is connected. Replies in the Slack thread show in the chat of Make it. The weekly Slack post becomes the Monday drop post | Hand it off, Make it chat | Today | Restyle |
| The Slack make button starts a paid make with no confirm | Remove the make button from Slack messages, so making always starts in Make it with the one confirm sheet | Slack | Next | Change core risk, listed |
| A public brand book with files for AI tools | It is the brand sheet you own, and it already exists. Share your brand sheet, in What we know about you, opens the public page and its files. AI search links to it as the fix for AI answer gaps | Settings, Your store | Today | Recompose |
| Brief status after hand off | Handed off cards carry one sub line: Received, In progress, Needs something from you, Delivered. Needs something from you also appears in Need your yes | Work, Need your yes | Today, moved by the ShopOS team | Restyle |
| The Shopify app start screen | Same screen as Paste your store, with the store already filled in and the same read time words. The half an hour line goes after a check | First run | Today | Restyle |
| Delete my data is an email draft | Say what it is: Ask us to delete your data. It sends us a request and the Dummy tag stays until deletion is real | Settings, Account | Today as a request, real deletion Later | Restyle |
| Guests of one jam | The Brief page has Open it in Make it. A guest signs in and lands in that one Make it only, with chat, edits and drafts, and none of share, approve, assign or discard | Brief page, Make it | Today | Restyle |
| Store health rings and the recap ring | Health becomes three meters at the top of Your store, never called rings. The recap becomes the Your week story on Monday | Your store, Today | Today | Restyle |
| The Signals column, the only Email and WhatsApp surface | Customer groups to reach become picks in the Email and WhatsApp area. They show on Today when they rank, and filtered in See everything | Today | Today | Recompose |
| Copy and open | It is how you ship it yourself. Hand it off, Me, copies the words and opens the exact place to post | Hand it off | Today | Restyle |
| Film board, teleprompter, talk on every box | Tools inside Make it for videos and for talking instead of typing | Make it | Today | Restyle |
| The waiting game | A long wait add on behind its own switch, off by default | Make it wait | Today, off | Add on |
| Admin roles, hand over, domain auto join | Team rows with one role chip each: Admin, Member, Invited. Hand over is a row action | Settings, Team | Today | Recompose |
| Email settings and jam mute | Notifications and sound: one switch per kind, and Mute this on any Make it | Settings | Today | Recompose |
| Connector life after connect | One status chip per connection: Connected, Needs you, Expiring, Stale, Read only. Expiry emails restyled | Settings, Connections | Today | Restyle |
| Play PDFs with all caps headings and the old lockup | The full plan page has Download as PDF, restyled to the kit with sentence case | The plan | Today | Restyle |
| The plays list with Updates, a Build tab and spend | Founders see The plan in Your store. Build and spend are Staff only | Your store, Staff | Today | Recompose |
| The bell and notification panel | The bell goes. New since you looked heads Work. Every notification opens exactly its thing | Work | Today | Recompose |
| Sound on by default | Off on a first visit, one switch in Settings | Settings | Today | Restyle |
| 526 CSS classes never named in code | Remove after a run time check | none | Next | Restyle |
Flows across the screens
| Flow | Screens |
|---|---|
| First week | f1, f2, f4, f7, t1 with the first win bar, p1, m1, h1, h2, t5 |
| Monday | e1, t1, t2, p1, m1, h1, h2, t5 |
| A specialist picks up their part | t4 filtered, p1, m1, h1 |
| The person who ships it | h3, then Open it in Make it as a guest, m1 |
| An approver | t2, Yes, done |
| Agency with several brands | x3 Later, t1 per brand |
| Connect a tool | s5, the connect sheet, back to s5 |
| Something goes wrong | f5, m5, x1, x2 |
| The cap | f6 |
Rules the kit enforces
- One top bar, one tab set, one bottom bar, one sheet, one menu, one toast, one empty state, one error state, four button kinds: main, quiet, link, icon.
- Status words everywhere: Idea, In the works, Handed off. Handed off sub lines: Received, In progress, Needs something from you, Delivered.
- Card budgets from product-model.md section 10 on every card in every screen.
- The brand's own pictures carry the colour. The skin's hero colour is for the character, the main button and focus, never for cards.
- Sample store everywhere: the sample candle store with Monsoon candle, Chai spice candle and Jasmine night candle. Every screen frame carries the Sample label.
What the shipped product does not have
The owner's call: the product that goes out has no jam pane, no Jam v2 and no repeated surfaces. They are removed, not hidden. Only one of each thing exists.
| Removed from the product | Why | What replaces it | What stays underneath |
|---|---|---|---|
| Jam v2, the address switch that opens it and its boards, spark, finish sheet and history pill | A second making space | Make it, the one studio | The making engines it calls, which Make it already uses |
| The jam pane on the card page | A third making space | Make it | The jam chat and its data |
| The card page, desktop drawer and full page | Repeats the open pick | The open pick | Card data |
| The Deck | Repeats Today by area | See everything with an area filter, and Work | Card data |
| The Library, Saved and the Jams list | Repeat Work | Work | Saved and jam data |
| The queue view and the greeting tiles | Repeat Need your yes | Need your yes on Today | What counts as a yes |
| The notification bell and panel | Repeats Work | New since you looked, in Work | Notifications, which deep link |
| What we learned, its six sub pages, the fact sheet, rules and lessons pages | Repeat each other | What we know about you | The memory and the facts |
| Heard, the watch page, Rivals and Products as separate pages | Repeat Your store | Your store sections | What the reader collects |
| The setup steps, the check page under a clock, the ready overlay, the swipe tuner, the questions offer, the welcome card | Repeat first run | Paste, sign in, reading with three questions, the reveal | The confirm call and the answers |
| The floating round button and New jam | Repeat Make it | Start something new, in Work | none |
| Viewing as and the seat picker | Repeat Which of these do you handle | Which of these do you handle | The seat field, mapped, a risk to check |
| The Pro carousel, plan sheet, logo stickers and measuring blocks | Not part of v0 | none | Data stays where it is |
| Four brief formats and four share link shapes | Repeats | One brief page | Old links keep answering and redirect to the one brief page, so nothing anyone already shared breaks |
Removing a screen is Recompose. Removing Jam v2's own brief and status and keeping one brief format is the one Change core item, so it is listed as a risk and done in its own step, with old links redirected first. Everything the surface map marks Unlinked but kept in code is read here as Removed.
brand-directions/_shared/ia.md
How we do it
Generated by handbook/tools/gen.mjs on every build. Change the source, never this file.
Numbers
Not applicable to a generated document: it is rewritten from its sources on every build.
Open
Not applicable to a generated document: it is rewritten from its sources on every build.