{ "id": "3.2", "title": "Information architecture", "department": "Design", "department_slug": "design", "direction": null, "branded": false, "status": "generated", "owner": "Param", "last_verified": "2026-10-26", "holds": "Six addresses, tabs, the shape, decisions", "urls": { "html": "https://handbook.joinsquareup.com/design/information-architecture", "markdown": "https://handbook.joinsquareup.com/design/information-architecture.md", "json": "https://handbook.joinsquareup.com/design/information-architecture.json" }, "other_directions": [], "tldr": { "headline": "Six addresses cover the whole product, from Today to Make it", "points": [ { "icon": "map", "text": "Three tabs on the phone bottom bar, Settings behind your picture, Make it as the studio." }, { "icon": "box", "text": "Jam v2, the Deck, the Library and the bell are removed, not hidden." }, { "icon": "link", "text": "Hand it off offers Me, My team, My agency or freelancer, and our team." }, { "icon": "check", "text": "Old brief links keep answering and redirect to the one brief page." }, { "icon": "warn", "text": "Removing Jam v2's own brief is the one core change, done in its own step." } ], "stat": { "value": "526", "label": "Unused CSS classes to remove" }, "decide": null, "mood": "building" }, "sources": [ "brand-directions/_shared/ia.md" ], "open_questions": [], "parts": { "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\n\n```\nTop bar brand mark or brand switcher character corner your picture: Settings\nTabs Today Work Your store\n phone: bottom bar of three desktop: left rail of three, Settings at its foot\n\nToday greeting with the character corner\n Need your yes yes or no questions, count on the tab\n story rings 24 hour stories, Your week recap on Monday\n This week's picks five, ranked, each a closed card\n See everything the rest of the ideas, ranked\n caught up the character signs off\n\nA pick the draft and Versions\n Why this three sourced lines, then the full plan\n Where to post\n bottom bar Make it\n\nMake it the thing left on desktop, top on phone\n the chat right on desktop, below on phone\n tools add a photo or file, talk, film board, teleprompter\n bottom bar Hand it off\nHand it off Who is shipping this Me, My team, My agency or freelancer, The ShopOS team\nBrief page outside the app, no login the brief, the files, copy all, its status\n\nWork New since you looked replies, updates, briefs that moved\n Ideas | In the works | Handed off Later: Scheduled, Live, How it went\n Start something new\n\nYour store store health three meters, one fix line each\n What customers say themes, counts, mood\n What rivals run rival cards, long running ads\n What AI search says answers that name you, gaps\n What changed price, stock, new products, reviews\n The plan the whole plan for your store, grouped by get found, get chosen, get them back\n\nSettings What we know about you facts, house rules, tell us something, share your brand sheet\n Which of these do you handle\n Team invite, roles, admin hand over\n Connections read only connections and their state\n Notifications and sound\n Account theme, start again, ask us to delete your data, sign out\n```\n\nSix addresses: Today, Work, Your store, Settings, a pick, Make it. The Brief page and the sign in pages live outside the app.\n\n### Decisions on everything the model did not yet cover\n\n| Gap from the surface map | Decision | Where it lives | Status | Change type |\n|---|---|---|---|---|\n| 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 |\n| 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 |\n| 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 |\n| 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 |\n| 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 |\n| 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 |\n| 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 |\n| 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 |\n| 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 |\n| 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 |\n| Film board, teleprompter, talk on every box | Tools inside Make it for videos and for talking instead of typing | Make it | Today | Restyle |\n| The waiting game | A long wait add on behind its own switch, off by default | Make it wait | Today, off | Add on |\n| 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 |\n| Email settings and jam mute | Notifications and sound: one switch per kind, and Mute this on any Make it | Settings | Today | Recompose |\n| Connector life after connect | One status chip per connection: Connected, Needs you, Expiring, Stale, Read only. Expiry emails restyled | Settings, Connections | Today | Restyle |\n| 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 |\n| 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 |\n| The bell and notification panel | The bell goes. New since you looked heads Work. Every notification opens exactly its thing | Work | Today | Recompose |\n| Sound on by default | Off on a first visit, one switch in Settings | Settings | Today | Restyle |\n| 526 CSS classes never named in code | Remove after a run time check | none | Next | Restyle |\n\n### Flows across the screens\n\n| Flow | Screens |\n|---|---|\n| First week | f1, f2, f4, f7, t1 with the first win bar, p1, m1, h1, h2, t5 |\n| Monday | e1, t1, t2, p1, m1, h1, h2, t5 |\n| A specialist picks up their part | t4 filtered, p1, m1, h1 |\n| The person who ships it | h3, then Open it in Make it as a guest, m1 |\n| An approver | t2, Yes, done |\n| Agency with several brands | x3 Later, t1 per brand |\n| Connect a tool | s5, the connect sheet, back to s5 |\n| Something goes wrong | f5, m5, x1, x2 |\n| The cap | f6 |\n\n### Rules the kit enforces\n\n- 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.\n- Status words everywhere: Idea, In the works, Handed off. Handed off sub lines: Received, In progress, Needs something from you, Delivered.\n- Card budgets from product-model.md section 10 on every card in every screen.\n- 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.\n- Sample store everywhere: the sample candle store with Monsoon candle, Chai spice candle and Jasmine night candle. Every screen frame carries the Sample label.\n\n### What the shipped product does not have\n\nThe 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.\n\n| Removed from the product | Why | What replaces it | What stays underneath |\n|---|---|---|---|\n| 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 |\n| The jam pane on the card page | A third making space | Make it | The jam chat and its data |\n| The card page, desktop drawer and full page | Repeats the open pick | The open pick | Card data |\n| The Deck | Repeats Today by area | See everything with an area filter, and Work | Card data |\n| The Library, Saved and the Jams list | Repeat Work | Work | Saved and jam data |\n| The queue view and the greeting tiles | Repeat Need your yes | Need your yes on Today | What counts as a yes |\n| The notification bell and panel | Repeats Work | New since you looked, in Work | Notifications, which deep link |\n| 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 |\n| Heard, the watch page, Rivals and Products as separate pages | Repeat Your store | Your store sections | What the reader collects |\n| 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 |\n| The floating round button and New jam | Repeat Make it | Start something new, in Work | none |\n| 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 |\n| The Pro carousel, plan sheet, logo stickers and measuring blocks | Not part of v0 | none | Data stays where it is |\n| 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 |\n\nRemoving 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.\n\n[src: 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." } }