[{"data":1,"prerenderedAt":609},["ShallowReactive",2],{"docs-navigation":3,"docs-\u002Fstart\u002Fthe-workbench":254,"surround-\u002Fstart\u002Fthe-workbench":606},[4,33,86,114,173,212,231],{"title":5,"path":6,"stem":7,"children":8},"Start","\u002Fstart","1.start",[9,13,18,23,28],{"title":10,"path":6,"stem":11,"description":12},"Start here","1.start\u002Findex","What Desifex is, and how to get an application of your own running.",{"title":14,"path":15,"stem":16,"description":17},"What Desifex is","\u002Fstart\u002Fwhat-desifex-is","1.start\u002F1.what-desifex-is","An application factory where conversation is the interface — and the handful of things it deliberately will not do.",{"title":19,"path":20,"stem":21,"description":22},"Your first application","\u002Fstart\u002Fyour-first-application","1.start\u002F2.your-first-application","From a sentence to something running, in about twenty minutes, with nothing to install.",{"title":24,"path":25,"stem":26,"description":27},"The workbench","\u002Fstart\u002Fthe-workbench","1.start\u002F3.the-workbench","A tour of the screen you will spend your time on — the conversation, the six tabs, and the menu.",{"title":29,"path":30,"stem":31,"description":32},"What to expect","\u002Fstart\u002Fwhat-to-expect","1.start\u002F4.what-to-expect","How long things take, what a good working rhythm looks like, and the parts that genuinely go wrong.",{"title":34,"path":35,"stem":36,"children":37},"Building","\u002Fbuilding","2.building",[38,41,46,51,56,61,66,71,76,81],{"title":34,"path":35,"stem":39,"description":40},"2.building\u002Findex","Getting what you actually wanted out of the conversation.",{"title":42,"path":43,"stem":44,"description":45},"Describing what you need","\u002Fbuilding\u002Fdescribing-what-you-need","2.building\u002F1.describing-what-you-need","How to phrase a request so that what comes back is what you meant.",{"title":47,"path":48,"stem":49,"description":50},"Watching a build","\u002Fbuilding\u002Fwatching-a-build","2.building\u002F2.watching-a-build","What the steps mean, what is happening underneath, and why you are not shown a log.",{"title":52,"path":53,"stem":54,"description":55},"Changing your mind","\u002Fbuilding\u002Fchanging-your-mind","2.building\u002F3.changing-your-mind","Interrupting a build, correcting a misunderstanding, and undoing something you asked for.",{"title":57,"path":58,"stem":59,"description":60},"When a build fails","\u002Fbuilding\u002Fwhen-a-build-fails","2.building\u002F4.when-a-build-fails","What a failure actually means, what to try, and when to ask us.",{"title":62,"path":63,"stem":64,"description":65},"Showing it a file","\u002Fbuilding\u002Fshowing-it-files","2.building\u002F5.showing-it-files","Attaching a screenshot, a spreadsheet or a document to the conversation — often faster than describing it.",{"title":67,"path":68,"stem":69,"description":70},"Choosing a design system","\u002Fbuilding\u002Fchoosing-a-design-system","2.building\u002F6.choosing-a-design-system","What a design system decides, how to pick one, and what changing it later does.",{"title":72,"path":73,"stem":74,"description":75},"Asking for settings","\u002Fbuilding\u002Fasking-for-settings","2.building\u002F7.asking-for-settings","The conversation reaches the whole platform — addresses, icons, redirects, users, integrations and shipping. If you do not know where a setting is, ask.",{"title":77,"path":78,"stem":79,"description":80},"When it asks you","\u002Fbuilding\u002Fwhen-it-asks-you","2.building\u002F8.when-it-asks-you","Some decisions arrive as a screen rather than a message — a table to correct, a list to choose from — and the build waits for your answer.",{"title":82,"path":83,"stem":84,"description":85},"Starting from what you have","\u002Fbuilding\u002Fstarting-from-what-you-have","2.building\u002F9.starting-from-what-you-have","A spreadsheet, a document, a picture or a page of your own site — attached, read, and built from.",{"title":87,"path":88,"stem":89,"children":90},"Shipping","\u002Fshipping","3.shipping",[91,94,99,104,109],{"title":87,"path":88,"stem":92,"description":93},"3.shipping\u002Findex","Getting what you built in front of people, and getting back to an earlier version.",{"title":95,"path":96,"stem":97,"description":98},"Versions","\u002Fshipping\u002Fversions","3.shipping\u002F1.versions","Every build is kept, named after what was asked for, and can be compared and restored.",{"title":100,"path":101,"stem":102,"description":103},"Environments","\u002Fshipping\u002Fenvironments","3.shipping\u002F2.environments","Preview, test and live — what each one is, who can reach it, and why their data is separate.",{"title":105,"path":106,"stem":107,"description":108},"Deploying","\u002Fshipping\u002Fdeploying","3.shipping\u002F3.deploying","Putting a version into test or live, what happens while it deploys, and what happens if it fails.",{"title":110,"path":111,"stem":112,"description":113},"Going back","\u002Fshipping\u002Fgoing-back","3.shipping\u002F4.going-back","Restoring an earlier version when a change turned out to be wrong.",{"title":115,"path":116,"stem":117,"children":118},"Running","\u002Frunning","4.running",[119,123,128,133,138,143,148,153,158,163,168],{"title":120,"path":116,"stem":121,"description":122},"Running it","4.running\u002Findex","Everything in Settings — addresses, access, people, files, integrations and what crawlers are told.",{"title":124,"path":125,"stem":126,"description":127},"Addresses and domains","\u002Frunning\u002Faddresses-and-domains","4.running\u002F01.addresses-and-domains","The address an application gets, and how to put it on a domain you own.",{"title":129,"path":130,"stem":131,"description":132},"Who can reach it","\u002Frunning\u002Fwho-can-reach-it","4.running\u002F02.who-can-reach-it","Open, behind one shared password, or accounts — and why the choice is enforced in front of the application.",{"title":134,"path":135,"stem":136,"description":137},"People who sign in","\u002Frunning\u002Fpeople-who-sign-in","4.running\u002F03.people-who-sign-in","The workspace's user directory — adding the people who use your applications, which ones each may open, what you can keep about them, and two-step sign-in.",{"title":139,"path":140,"stem":141,"description":142},"Published files","\u002Frunning\u002Fpublished-files","4.running\u002F04.published-files","Documents your application hands to its users — a price list, a brochure, a form — with a stable address and no build to change them.",{"title":144,"path":145,"stem":146,"description":147},"Integrations","\u002Frunning\u002Fintegrations","4.running\u002F05.integrations","Email, SMS and Google — connected once, used by the application without it ever holding a credential.",{"title":149,"path":150,"stem":151,"description":152},"Appearance","\u002Frunning\u002Fappearance","4.running\u002F06.appearance","The browser tab, the icon, what a link looks like when somebody pastes it, and adding it to a phone's home screen.",{"title":154,"path":155,"stem":156,"description":157},"Redirects and search engines","\u002Frunning\u002Fredirects-and-search-engines","4.running\u002F07.redirects-and-search-engines","Old addresses that still get visited, and what crawlers are told about each environment.",{"title":159,"path":160,"stem":161,"description":162},"Configuration values","\u002Frunning\u002Fconfiguration-values","4.running\u002F08.configuration-values","Named values the application needs but must not contain — API keys, account numbers, thresholds.",{"title":164,"path":165,"stem":166,"description":167},"Your data","\u002Frunning\u002Fyour-data","4.running\u002F09.your-data","The Data tab — reading, correcting, adding to and clearing out what your application has stored, one environment at a time.",{"title":169,"path":170,"stem":171,"description":172},"Visitors","\u002Frunning\u002Fvisitors","4.running\u002F10.visitors","Who is using the application, counted without identifying anybody and with nothing to set up.",{"title":174,"path":175,"stem":176,"children":177},"Workspace","\u002Fworkspace","5.workspace",[178,182,187,192,197,202,207],{"title":179,"path":175,"stem":180,"description":181},"Your workspace","5.workspace\u002Findex","What every application in it shares — the domain, the design systems, the people, the user directory and, if you want it, one set of records — and how to be in more than one.",{"title":183,"path":184,"stem":185,"description":186},"People and roles","\u002Fworkspace\u002Fpeople-and-roles","5.workspace\u002F1.people-and-roles","Three roles, what each can do, how they apply to the builder as well as to the buttons, and why they belong to a workspace rather than to an account.",{"title":188,"path":189,"stem":190,"description":191},"More than one workspace","\u002Fworkspace\u002Fmore-than-one-workspace","5.workspace\u002F2.more-than-one-workspace","Belonging to several, switching between them, the role you hold in each, and why nothing crosses over.",{"title":193,"path":194,"stem":195,"description":196},"Organising applications","\u002Fworkspace\u002Ffolders-and-organising","5.workspace\u002F3.folders-and-organising","Folders on the dashboard, and how to keep a growing list navigable.",{"title":198,"path":199,"stem":200,"description":201},"Your own design systems","\u002Fworkspace\u002Fyour-own-design-systems","5.workspace\u002F4.your-own-design-systems","Authoring a design system for your brand, or a client's, by importing guidelines, a website or a Figma library.",{"title":203,"path":204,"stem":205,"description":206},"Your profile","\u002Fworkspace\u002Fyour-profile","5.workspace\u002F5.your-profile","Your name, your password, your picture, and the theme.",{"title":208,"path":209,"stem":210,"description":211},"Where records live","\u002Fworkspace\u002Fwhere-records-live","5.workspace\u002F6.where-records-live","One store per environment, one across an application's environments, or one the whole workspace shares — what each costs you, and how to change it.",{"title":213,"path":214,"stem":215,"children":216},"Developers","\u002Fdevelopers","6.developers",[217,221,226],{"title":218,"path":214,"stem":219,"description":220},"For developers","6.developers\u002Findex","What is actually generated, and what to do when you inherit one.",{"title":222,"path":223,"stem":224,"description":225},"What gets built","\u002Fdevelopers\u002Fwhat-gets-built","6.developers\u002F1.what-gets-built","The stack, the shape of the repository, and the parts the platform provides rather than the application.",{"title":227,"path":228,"stem":229,"description":230},"Taking one over","\u002Fdevelopers\u002Ftaking-it-over","6.developers\u002F2.taking-it-over","For the developer who has just been handed an application built here.",{"title":232,"path":233,"stem":234,"children":235},"Reference","\u002Freference","7.reference",[236,239,244,249],{"title":232,"path":233,"stem":237,"description":238},"7.reference\u002Findex","Terms, limits, and what to do when something specific has gone wrong.",{"title":240,"path":241,"stem":242,"description":243},"Glossary","\u002Freference\u002Fglossary","7.reference\u002F1.glossary","Every term this documentation uses, in one place.",{"title":245,"path":246,"stem":247,"description":248},"Limits","\u002Freference\u002Flimits","7.reference\u002F2.limits","The boundaries that are real, so you do not discover them at an inconvenient moment.",{"title":250,"path":251,"stem":252,"description":253},"Troubleshooting","\u002Freference\u002Ftroubleshooting","7.reference\u002F3.troubleshooting","Specific symptoms, and what each one usually means.",{"id":255,"title":24,"body":256,"description":27,"extension":599,"hidden":600,"meta":601,"navTitle":602,"navigation":603,"path":25,"seo":604,"stem":26,"__hash__":605},"docs\u002F1.start\u002F3.the-workbench.md",{"type":257,"value":258,"toc":584},"minimark",[259,263,268,283,290,298,304,308,311,325,328,336,340,345,349,356,361,364,369,373,378,382,385,474,479,507,511,514,566,570,581],[260,261,262],"p",{},"One screen per application, split in two: the conversation on the left, the\napplication and everything about it on the right.",[264,265,267],"h2",{"id":266},"the-conversation","The conversation",[260,269,270,271,275,276,279,280,282],{},"Where you ask for things. Type and press ",[272,273,274],"kbd",{},"Enter","; ",[272,277,278],{},"Shift"," +\n",[272,281,274],{}," makes a new line.",[260,284,285,286,289],{},"Attachments go in the same place — a screenshot of the report somebody wants,\nthe spreadsheet the data comes from, a PDF of the form being replaced. See\n",[287,288,62],"a",{"href":63},".",[260,291,292,293,297],{},"While a build is running the send button becomes ",[294,295,296],"strong",{},"Stop",". Stopping does not\nthrow the work away: whatever was finished is committed and saved as a version,\nand you can carry on from there.",[260,299,300,303],{},[294,301,302],{},"The splitter between the two halves is draggable."," Directing a build wants a\nwide conversation; checking what was built wants the whole screen for the\napplication. You can close the conversation entirely. The width is remembered,\nper person.",[264,305,307],{"id":306},"preview","Preview",[260,309,310],{},"The application, running, as it stands right now. This is the working copy —\nevery build changes it, and only your team can reach it.",[260,312,313,314,317,318,317,321,324],{},"Above it: ",[294,315,316],{},"Phone",", ",[294,319,320],{},"Tablet",[294,322,323],{},"Desktop",", and a size you type in. Narrow\nsizes render at their true pixel width and are scaled to fit, so what you see is\nwhat a phone would show rather than a desktop layout squeezed. There is also a\nbutton to open it in its own tab, and one to reload it.",[264,326,95],{"id":327},"versions",[260,329,330,331,333,334,289],{},"Every build, newest first, and the three environments across the top: preview,\ntest and live. This is where things get shipped, and where you go back to an\nearlier build. See ",[287,332,95],{"href":96}," and\n",[287,335,105],{"href":106},[264,337,339],{"id":338},"your-answer","Your answer",[260,341,342,343,289],{},"Not always there. It appears at the front of the strip when the builder has a\ndecision that is genuinely yours — a table to correct, a list to choose from —\nand the build waits on it. See ",[287,344,77],{"href":78},[264,346,348],{"id":347},"data","Data",[260,350,351,352,355],{},"What the application has actually stored — the bookings that came in, what\nsomebody typed into the form, the test records still sitting on ",[294,353,354],{},"Live"," the\nweek before launch. Tables down the left, records across the screen, and one\ncontrol deciding which environment you are reading.",[260,357,358,359,289],{},"You can search it, filter it, correct a record, add one, take one out and\ndownload the lot as a spreadsheet. See ",[287,360,164],{"href":165},[264,362,169],{"id":363},"visitors",[260,365,366,367,289],{},"Who is using the deployed application: visitors today, visitors and pages over\na period, a daily average, a chart by day, and the most-opened pages —\nseparately for test and live. Nothing to set up. See\n",[287,368,169],{"href":170},[264,370,372],{"id":371},"files","Files",[260,374,375,376,289],{},"Files the application publishes — a price list, a brochure, a form. These belong\nto the business rather than to the code: they need no build to change, they keep\ntheir address when you replace them, and they work before anything has been\ndeployed. See ",[287,377,139],{"href":140},[264,379,381],{"id":380},"settings","Settings",[260,383,384],{},"Nine sections, covering everything about the application that is not a\nconversation:",[386,387,388,401],"table",{},[389,390,391],"thead",{},[392,393,394,398],"tr",{},[395,396,397],"th",{},"Section",[395,399,400],{},"What is in it",[402,403,404,413,420,428,436,444,451,459,466],"tbody",{},[392,405,406,410],{},[407,408,409],"td",{},"General",[407,411,412],{},"Its name, and what it is built on",[392,414,415,417],{},[407,416,149],{},[407,418,419],{},"The browser tab, the icon, link previews, home-screen installation",[392,421,422,425],{},[407,423,424],{},"Domain",[407,426,427],{},"The platform address, and a domain of your own per environment",[392,429,430,433],{},[407,431,432],{},"Redirects",[407,434,435],{},"Old addresses that still get visited",[392,437,438,441],{},[407,439,440],{},"Configuration",[407,442,443],{},"Named values the application needs but must not contain",[392,445,446,448],{},[407,447,144],{},[407,449,450],{},"Email, SMS and Google",[392,452,453,456],{},[407,454,455],{},"Access",[407,457,458],{},"Whether anyone can reach it, one password does, or people sign in",[392,460,461,463],{},[407,462,348],{},[407,464,465],{},"Where its records live — its own, or one the workspace shares",[392,467,468,471],{},[407,469,470],{},"Search engines",[407,472,473],{},"What crawlers are told, per environment",[260,475,476,477,289],{},"Each has its own page in ",[287,478,120],{"href":116},[480,481,483],"note",{"type":482},"tip",[260,484,485,486,317,494,317,497,500,501,504,505,289],{},"Everything in Settings can also be asked for in the conversation — ",[487,488,489,490],"em",{},"put it on\n",[491,492,493],"code",{},"proposals.acme.com",[487,495,496],{},"turn on the shared password",[487,498,499],{},"add Anna as a user",". The\nbuilder does it with ",[294,502,503],{},"your"," permissions, not its own, so it can only do what\nyou could have done yourself. See\n",[287,506,72],{"href":73},[264,508,510],{"id":509},"the-application-menu","The application menu",[260,512,513],{},"Top right, behind the application's name:",[515,516,517,524,528,534,542,548,554,560],"ul",{},[518,519,520,523],"li",{},[294,521,522],{},"Stop \u002F Start application"," — the preview's container. Stopping it frees the\nmachine; starting it takes a few seconds.",[518,525,526],{},[294,527,381],{},[518,529,530,533],{},[294,531,532],{},"Browse its data"," — the Data tab.",[518,535,536,539,540,289],{},[294,537,538],{},"Change how it looks…"," — a different design system, and what this one\nin particular should look like, in your own words. See\n",[287,541,67],{"href":68},[518,543,544,547],{},[294,545,546],{},"Restyle to design system"," — appears when the design system has moved on\nsince this application was built.",[518,549,550,553],{},[294,551,552],{},"Update to latest components"," — brings in the current version of the shared\ninterface pieces.",[518,555,556,559],{},[294,557,558],{},"Download source"," — the whole repository as a zip. Workspace owners only.",[518,561,562,565],{},[294,563,564],{},"Delete application"," — permanent, with its data.",[264,567,569],{"id":568},"on-a-phone","On a phone",[260,571,572,573,576,577,580],{},"There is no room for a split, so the conversation and the application are a\nchoice rather than a layout: one control in the header switches between ",[294,574,575],{},"Chat","\nand ",[294,578,579],{},"App",", and the tab strip scrolls.",[260,582,583],{},"Nothing is desktop-only. You can put a version live, connect a domain and test\nan integration from a phone — which is where you are when a customer tells you\nsomething is wrong.",{"title":585,"searchDepth":586,"depth":586,"links":587},"",3,[588,590,591,592,593,594,595,596,597,598],{"id":266,"depth":589,"text":267},2,{"id":306,"depth":589,"text":307},{"id":327,"depth":589,"text":95},{"id":338,"depth":589,"text":339},{"id":347,"depth":589,"text":348},{"id":363,"depth":589,"text":169},{"id":371,"depth":589,"text":372},{"id":380,"depth":589,"text":381},{"id":509,"depth":589,"text":510},{"id":568,"depth":589,"text":569},"md",false,{},null,true,{"title":24,"description":27},"9drxNg4qXmaiJplMl6JVL19Q7l76Jyu7UN5z_CU3cH8",[607,608],{"title":19,"path":20,"stem":21,"description":22,"children":-1},{"title":29,"path":30,"stem":31,"description":32,"children":-1},1790202296893]