[{"_1":2,"_1182":-5,"_1183":-5},"loaderData",{"_3":4,"_12":13},"root",{"_5":6,"_7":6,"_8":9,"_10":11},"isProd",true,"enableStats","domain","hyper.media","siteHost","ui-with-state-machines.hyper.media","routes/$",{"_14":15,"_1124":1125},"json",{"_16":17,"_18":19,"_20":21,"_22":-5,"_23":-5,"_24":25,"_26":-5,"_27":28,"_460":6,"_38":461,"_471":-5,"_472":473,"_1115":1116,"_1117":25,"_10":934,"_1118":934,"_1119":1120,"_1121":1122},"prefersLanguages",[],"viewTerm","activity","panelParam","activity/citations","openComment","accountUid","isInspect",false,"inspectTab","document",{"_29":30,"_435":300,"_436":437,"_438":439,"_440":441,"_442":443,"_444":445,"_446":447,"_451":452,"_453":41,"_454":455,"_458":459},"content",[31,70,115,143,192,236,286,320,348,369],{"_32":33,"_34":35},"children",[],"block",{"_36":37,"_38":39,"_40":41,"_42":43,"_44":45,"_68":69,"_59":60},"type","Paragraph","id","Yl2K_LSQ","revision","bafy2bzacebkqzb64fcvmh5ovzsectjkvnjnz5zplcytarmy2gcuwsu3w7yba2","attributes",{},"annotations",[46,61],{"_36":47,"_48":49,"_53":54,"_42":58,"_59":60},"Bold","starts",[50,51,52],162,170,182,"ends",[55,56,57],168,176,193,{},"link","",{"_36":62,"_48":63,"_53":65,"_42":67,"_59":60},"Italic",[64],417,[66],428,{},"text","State machines can sound intimidating at first — all those diagrams and boxes and arrows. But at the heart of it, they’re built on three incredibly simple ideas: states, events, and transitions. If you've ever handled a button click or shown a loading spinner, you've already worked with them. This week, we're going to demystify how these pieces fit together and why they can make your UI logic feel like it finally makes sense.",{"_32":71,"_34":107},[72,79,86,93,100],{"_32":73,"_34":74},[],{"_36":37,"_38":75,"_40":41,"_42":76,"_44":77,"_68":78,"_59":60},"nMfdZKTf",{},[],"In the last issue, we looked at why state machines are a better way to model UI logic. This week, we’re breaking down the three concepts that power every state machine:",{"_32":80,"_34":81},[],{"_36":37,"_38":82,"_40":41,"_42":83,"_44":84,"_68":85,"_59":60},"Iu1orm1x",{},[],"States – the different modes your UI can be in",{"_32":87,"_34":88},[],{"_36":37,"_38":89,"_40":41,"_42":90,"_44":91,"_68":92,"_59":60},"xQUYl6x3",{},[],"Events – the things that happen to trigger change",{"_32":94,"_34":95},[],{"_36":37,"_38":96,"_40":41,"_42":97,"_44":98,"_68":99,"_59":60},"UiCxB73G",{},[],"Transitions – how you move from one state to another",{"_32":101,"_34":102},[],{"_36":37,"_38":103,"_40":41,"_42":104,"_44":105,"_68":106,"_59":60},"vl4dgcB0",{},[],"Once you understand these, even the most complex flows start to feel… obvious.",{"_36":108,"_38":109,"_40":41,"_42":110,"_44":113,"_68":114,"_59":60},"Heading","ovQKELVh",{"_111":112},"childrenType","Group",[],"✨ Intro: The Foundation of Every State Machine",{"_32":116,"_34":138},[117,124,131],{"_32":118,"_34":119},[],{"_36":37,"_38":120,"_40":41,"_42":121,"_44":122,"_68":123,"_59":60},"U1dHAH7O",{},[],"A state is just a label for a condition your UI is in.",{"_32":125,"_34":126},[],{"_36":37,"_38":127,"_40":41,"_42":128,"_44":129,"_68":130,"_59":60},"0SKJ-5Bd",{},[],"🔁 Example: A toggle switch has two states: active and inactive. A form might have: idle, validating, submitting, success, error.",{"_32":132,"_34":133},[],{"_36":37,"_38":134,"_40":41,"_42":135,"_44":136,"_68":137,"_59":60},"rHbGcoNi",{},[],"You define them up front — and your component can only be in one of them at a time.",{"_36":108,"_38":139,"_40":41,"_42":140,"_44":141,"_68":142,"_59":60},"QDNDq9wF",{"_111":112},[],"🧠 What Is a State?",{"_32":144,"_34":187},[145,152,159,166,173,180],{"_32":146,"_34":147},[],{"_36":37,"_38":148,"_40":41,"_42":149,"_44":150,"_68":151,"_59":60},"idyPSZrg",{},[],"An event is something that happens — usually triggered by the user or the system.",{"_32":153,"_34":154},[],{"_36":37,"_38":155,"_40":41,"_42":156,"_44":157,"_68":158,"_59":60},"BUv71qfw",{},[],"👇 Examples:",{"_32":160,"_34":161},[],{"_36":37,"_38":162,"_40":41,"_42":163,"_44":164,"_68":165,"_59":60},"Cc6_Mkj0",{},[],"A click → TOGGLE",{"_32":167,"_34":168},[],{"_36":37,"_38":169,"_40":41,"_42":170,"_44":171,"_68":172,"_59":60},"fSrsl3Fs",{},[],"A form submission → SUBMIT",{"_32":174,"_34":175},[],{"_36":37,"_38":176,"_40":41,"_42":177,"_44":178,"_68":179,"_59":60},"Wno7ieql",{},[],"An API call fails → FAILURE",{"_32":181,"_34":182},[],{"_36":37,"_38":183,"_40":41,"_42":184,"_44":185,"_68":186,"_59":60},"rb8tuU7y",{},[],"Events don’t do anything on their own — they ask the machine to change.",{"_36":108,"_38":188,"_40":41,"_42":189,"_44":190,"_68":191,"_59":60},"DAaz8SPf",{"_111":112},[],"⚡ What Is an Event?",{"_32":193,"_34":231},[194,201,208],{"_32":195,"_34":196},[],{"_36":37,"_38":197,"_40":41,"_42":198,"_44":199,"_68":200,"_59":60},"IR301vuL",{},[],"A transition is how the machine changes from one state to another in response to an event.",{"_32":202,"_34":203},[],{"_36":37,"_38":204,"_40":41,"_42":205,"_44":206,"_68":207,"_59":60},"uatRUWoJ",{},[],"Think of it as: \"When I'm in [this state] and [this event] happens, move to [that state].\"",{"_32":209,"_34":226},[210,220],{"_32":211,"_34":212},[],{"_36":213,"_38":214,"_40":41,"_42":215,"_44":218,"_68":219,"_59":60},"Code","hTH4qlLt",{"_216":217},"language","typescript",[],"createMachine({\n initial: 'idle',\n states: {\n idle: {\n on: { SUBMIT: 'submitting' }\n },\n submitting: {\n on: {\n SUCCESS: 'success',\n FAILURE: 'error'\n }\n },\n success: {},\n error: {}\n }\n});",{"_32":221,"_34":222},[],{"_36":37,"_38":223,"_40":41,"_42":224,"_44":225,"_68":60,"_59":60},"gGVdQRWe",{},[],{"_36":37,"_38":227,"_40":41,"_42":228,"_44":229,"_68":230,"_59":60},"loO-Xd4j",{"_111":112},[],"In XState, it looks like this:",{"_36":108,"_38":232,"_40":41,"_42":233,"_44":234,"_68":235,"_59":60},"rCYytQHq",{"_111":112},[],"🔄 What Is a Transition?",{"_32":237,"_34":281},[238,245,252,267,274],{"_32":239,"_34":240},[],{"_36":37,"_38":241,"_40":41,"_42":242,"_44":243,"_68":244,"_59":60},"BozreRL2",{},[],"Because you define states and transitions explicitly, you avoid:",{"_32":246,"_34":247},[],{"_36":37,"_38":248,"_40":41,"_42":249,"_44":250,"_68":251,"_59":60},"qUQLFu2K",{},[],"Ambiguous conditions",{"_32":253,"_34":254},[],{"_36":37,"_38":255,"_40":41,"_42":256,"_44":257,"_68":266,"_59":60},"CzebmtN5",{},[258],{"_36":213,"_48":259,"_53":262,"_42":265,"_59":60},[260,261],27,40,[263,264],36,47,{},"Invalid combinations (e.g. isLoading && isError)",{"_32":268,"_34":269},[],{"_36":37,"_38":270,"_40":41,"_42":271,"_44":272,"_68":273,"_59":60},"Tx1DpbI7",{},[],"“Where am I in the flow?” type bugs",{"_32":275,"_34":276},[],{"_36":37,"_38":277,"_40":41,"_42":278,"_44":279,"_68":280,"_59":60},"9r7snjTE",{},[],"The machine won’t allow transitions that aren’t defined. That’s safety by design.",{"_36":108,"_38":282,"_40":41,"_42":283,"_44":284,"_68":285,"_59":60},"wVj4RLs9",{"_111":112},[],"🧪 Why This Structure Is Powerful",{"_32":287,"_34":315},[288,295,308],{"_32":289,"_34":290},[],{"_36":37,"_38":291,"_40":41,"_42":292,"_44":293,"_68":294,"_59":60},"RFFrDPZ_",{},[],"Here’s that form state machine as a diagram:",{"_32":296,"_34":297},[],{"_36":298,"_38":299,"_40":300,"_42":301,"_44":306,"_68":60,"_59":307},"Button","zGkNsRNw","bafy2bzacedazyemw5mvbfvvecvh7xlbfqvioyvxtwo6kmgvwapznbbxcycd56",{"_111":112,"_302":303,"_304":305},"name","👉 Open in Stately.ai","alignment","center",[],"https://stately.ai/registry/editor/a3732429-1a6a-4304-81dc-7344199eb5c2?mode=Simulate&machineId=36c1ed61-65d0-40a0-a8a9-aac1bcc79275",{"_32":309,"_34":310},[],{"_36":37,"_38":311,"_40":41,"_42":312,"_44":313,"_68":314,"_59":60},"mhjwuw_5",{},[],"Diagrams like this aren’t just pretty — they’re living documentation of how your app behaves.",{"_36":108,"_38":316,"_40":41,"_42":317,"_44":318,"_68":319,"_59":60},"JqHCmjLs",{"_111":112},[],"Visualize It",{"_32":321,"_34":343},[322,329,336],{"_32":323,"_34":324},[],{"_36":37,"_38":325,"_40":41,"_42":326,"_44":327,"_68":328,"_59":60},"A5V14JbG",{},[],"Instead of exposing a bunch of props or handlers, you can think of your UI machine as exposing one clean interface:",{"_32":330,"_34":331},[],{"_36":213,"_38":332,"_40":41,"_42":333,"_44":334,"_68":335,"_59":60},"-gD34P1J",{"_216":217},[],"send({ type: 'SUBMIT' });",{"_32":337,"_34":338},[],{"_36":37,"_38":339,"_40":41,"_42":340,"_44":341,"_68":342,"_59":60},"G5zl8WVl",{},[],"That’s it. Consumers of your component don’t care about your internal logic — they just send events and get predictable behavior.",{"_36":108,"_38":344,"_40":41,"_42":345,"_44":346,"_68":347,"_59":60},"nTqWAYZK",{"_111":112},[],"🧠 Pro Tip: Events Are the API of Your Component",{"_32":349,"_34":364},[350,357],{"_32":351,"_34":352},[],{"_36":37,"_38":353,"_40":41,"_42":354,"_44":355,"_68":356,"_59":60},"CrXa47YA",{},[],"In the next issue, we’ll get hands-on: ✅ Setting up XState in a React project ✅ Using useMachine ✅ Connecting state to your UI",{"_32":358,"_34":359},[],{"_36":37,"_38":360,"_40":41,"_42":361,"_44":362,"_68":363,"_59":60},"daDU7UWi",{},[],"We’ll build a real machine and hook it into a real component.",{"_36":108,"_38":365,"_40":41,"_42":366,"_44":367,"_68":368,"_59":60},"IXvDGYZn",{"_111":112},[],"Coming Up Next: Modeling UI with XState",{"_32":370,"_34":430},[371,400,415,422],{"_32":372,"_34":394},[373,380,387],{"_32":374,"_34":375},[],{"_36":37,"_38":376,"_40":41,"_42":377,"_44":378,"_68":379,"_59":60},"FOjdob1O",{},[],"What are the possible states?",{"_32":381,"_34":382},[],{"_36":37,"_38":383,"_40":41,"_42":384,"_44":385,"_68":386,"_59":60},"xugADqhu",{},[],"What events can happen?",{"_32":388,"_34":389},[],{"_36":37,"_38":390,"_40":41,"_42":391,"_44":392,"_68":393,"_59":60},"D0O2B5Dg",{},[],"How do you transition from one to another?",{"_36":37,"_38":395,"_40":41,"_42":396,"_44":398,"_68":399,"_59":60},"MOh7AMCQ",{"_111":397},"Unordered",[],"Pick a small UI in your app (a toggle, button, form, etc) and answer:",{"_32":401,"_34":402},[],{"_36":37,"_38":403,"_40":41,"_42":404,"_44":405,"_68":414,"_59":60},"IlbNtUNc",{},[406],{"_36":407,"_48":408,"_53":410,"_42":412,"_59":413},"Link",[409],33,[411],43,{},"https://stately.ai/","Try modeling it on paper — or in Stately.ai",{"_32":416,"_34":417},[],{"_36":37,"_38":418,"_40":41,"_42":419,"_44":420,"_68":421,"_59":60},"EzmaXgis",{},[],"Reply to this with your flow — I’d love to feature a few in future issues!",{"_32":423,"_34":424},[],{"_36":37,"_38":425,"_40":426,"_42":427,"_44":428,"_68":429,"_59":60},"rqDQ3P-0","bafy2bzaceasflmgw6yafc3mygkufwzsrzcjoh5vbpczy532qvitkfsli3icns",{},[],"Until next time,\nHoracio",{"_36":108,"_38":431,"_40":41,"_42":432,"_44":433,"_68":434,"_59":60},"FKkiCW0n",{"_111":112},[],"💡 Try This","version","account","z6MkhBiheioCs7btwVLUcnSCcFPdhTGGHSHpR4SHTyAobUUp","authors",[437],"path","/content/states-events-and-transitions-demystified","createTime","2025-04-06T22:59:47.219Z","updateTime","2026-03-25T09:56:21.353Z","metadata",{"_302":448,"_449":450},"States, Events, and Transitions, Demystified","cover","ipfs://bafybeibu6gd4vij4zi7rpjhgp7au3bhjqf6yumgb35gof4wjusq3sfm2nu","detachedBlocks",{},"genesis","generationInfo",{"_453":41,"_456":457},"generation","1743980387218","visibility","PUBLIC","isLatest",{"_440":462,"_435":300,"_464":25,"_465":437,"_38":466,"_467":-5,"_468":-5,"_469":-5,"_470":-5},[29,463],"states-events-and-transitions-demystified","latest","uid","hm://z6MkhBiheioCs7btwVLUcnSCcFPdhTGGHSHpR4SHTyAobUUp/content/states-events-and-transitions-demystified","blockRef","blockRange","hostname","scheme","siteHomeIcon","dehydratedState",{"_474":475,"_476":477},"mutations",[],"queries",[478,773,945,1009,1014,1030,1103],{"_479":480,"_768":769,"_771":772},"state",{"_481":482,"_752":753,"_754":755,"_756":-5,"_757":758,"_759":758,"_760":758,"_761":-5,"_762":-5,"_763":25,"_764":765,"_766":767},"data",{"_36":27,"_27":483,"_38":750},{"_29":484,"_435":300,"_436":437,"_438":746,"_440":441,"_442":443,"_444":445,"_446":747,"_451":748,"_453":41,"_454":749,"_458":459},[485,498,528,548,583,613,647,667,687,702],{"_32":486,"_34":487},[],{"_36":37,"_38":39,"_40":41,"_42":488,"_44":489,"_68":69,"_59":60},{},[490,494],{"_36":47,"_48":491,"_53":492,"_42":493,"_59":60},[50,51,52],[55,56,57],{},{"_36":62,"_48":495,"_53":496,"_42":497,"_59":60},[64],[66],{},{"_32":499,"_34":525},[500,505,510,515,520],{"_32":501,"_34":502},[],{"_36":37,"_38":75,"_40":41,"_42":503,"_44":504,"_68":78,"_59":60},{},[],{"_32":506,"_34":507},[],{"_36":37,"_38":82,"_40":41,"_42":508,"_44":509,"_68":85,"_59":60},{},[],{"_32":511,"_34":512},[],{"_36":37,"_38":89,"_40":41,"_42":513,"_44":514,"_68":92,"_59":60},{},[],{"_32":516,"_34":517},[],{"_36":37,"_38":96,"_40":41,"_42":518,"_44":519,"_68":99,"_59":60},{},[],{"_32":521,"_34":522},[],{"_36":37,"_38":103,"_40":41,"_42":523,"_44":524,"_68":106,"_59":60},{},[],{"_36":108,"_38":109,"_40":41,"_42":526,"_44":527,"_68":114,"_59":60},{"_111":112},[],{"_32":529,"_34":545},[530,535,540],{"_32":531,"_34":532},[],{"_36":37,"_38":120,"_40":41,"_42":533,"_44":534,"_68":123,"_59":60},{},[],{"_32":536,"_34":537},[],{"_36":37,"_38":127,"_40":41,"_42":538,"_44":539,"_68":130,"_59":60},{},[],{"_32":541,"_34":542},[],{"_36":37,"_38":134,"_40":41,"_42":543,"_44":544,"_68":137,"_59":60},{},[],{"_36":108,"_38":139,"_40":41,"_42":546,"_44":547,"_68":142,"_59":60},{"_111":112},[],{"_32":549,"_34":580},[550,555,560,565,570,575],{"_32":551,"_34":552},[],{"_36":37,"_38":148,"_40":41,"_42":553,"_44":554,"_68":151,"_59":60},{},[],{"_32":556,"_34":557},[],{"_36":37,"_38":155,"_40":41,"_42":558,"_44":559,"_68":158,"_59":60},{},[],{"_32":561,"_34":562},[],{"_36":37,"_38":162,"_40":41,"_42":563,"_44":564,"_68":165,"_59":60},{},[],{"_32":566,"_34":567},[],{"_36":37,"_38":169,"_40":41,"_42":568,"_44":569,"_68":172,"_59":60},{},[],{"_32":571,"_34":572},[],{"_36":37,"_38":176,"_40":41,"_42":573,"_44":574,"_68":179,"_59":60},{},[],{"_32":576,"_34":577},[],{"_36":37,"_38":183,"_40":41,"_42":578,"_44":579,"_68":186,"_59":60},{},[],{"_36":108,"_38":188,"_40":41,"_42":581,"_44":582,"_68":191,"_59":60},{"_111":112},[],{"_32":584,"_34":610},[585,590,595],{"_32":586,"_34":587},[],{"_36":37,"_38":197,"_40":41,"_42":588,"_44":589,"_68":200,"_59":60},{},[],{"_32":591,"_34":592},[],{"_36":37,"_38":204,"_40":41,"_42":593,"_44":594,"_68":207,"_59":60},{},[],{"_32":596,"_34":607},[597,602],{"_32":598,"_34":599},[],{"_36":213,"_38":214,"_40":41,"_42":600,"_44":601,"_68":219,"_59":60},{"_216":217},[],{"_32":603,"_34":604},[],{"_36":37,"_38":223,"_40":41,"_42":605,"_44":606,"_68":60,"_59":60},{},[],{"_36":37,"_38":227,"_40":41,"_42":608,"_44":609,"_68":230,"_59":60},{"_111":112},[],{"_36":108,"_38":232,"_40":41,"_42":611,"_44":612,"_68":235,"_59":60},{"_111":112},[],{"_32":614,"_34":644},[615,620,625,634,639],{"_32":616,"_34":617},[],{"_36":37,"_38":241,"_40":41,"_42":618,"_44":619,"_68":244,"_59":60},{},[],{"_32":621,"_34":622},[],{"_36":37,"_38":248,"_40":41,"_42":623,"_44":624,"_68":251,"_59":60},{},[],{"_32":626,"_34":627},[],{"_36":37,"_38":255,"_40":41,"_42":628,"_44":629,"_68":266,"_59":60},{},[630],{"_36":213,"_48":631,"_53":632,"_42":633,"_59":60},[260,261],[263,264],{},{"_32":635,"_34":636},[],{"_36":37,"_38":270,"_40":41,"_42":637,"_44":638,"_68":273,"_59":60},{},[],{"_32":640,"_34":641},[],{"_36":37,"_38":277,"_40":41,"_42":642,"_44":643,"_68":280,"_59":60},{},[],{"_36":108,"_38":282,"_40":41,"_42":645,"_44":646,"_68":285,"_59":60},{"_111":112},[],{"_32":648,"_34":664},[649,654,659],{"_32":650,"_34":651},[],{"_36":37,"_38":291,"_40":41,"_42":652,"_44":653,"_68":294,"_59":60},{},[],{"_32":655,"_34":656},[],{"_36":298,"_38":299,"_40":300,"_42":657,"_44":658,"_68":60,"_59":307},{"_111":112,"_302":303,"_304":305},[],{"_32":660,"_34":661},[],{"_36":37,"_38":311,"_40":41,"_42":662,"_44":663,"_68":314,"_59":60},{},[],{"_36":108,"_38":316,"_40":41,"_42":665,"_44":666,"_68":319,"_59":60},{"_111":112},[],{"_32":668,"_34":684},[669,674,679],{"_32":670,"_34":671},[],{"_36":37,"_38":325,"_40":41,"_42":672,"_44":673,"_68":328,"_59":60},{},[],{"_32":675,"_34":676},[],{"_36":213,"_38":332,"_40":41,"_42":677,"_44":678,"_68":335,"_59":60},{"_216":217},[],{"_32":680,"_34":681},[],{"_36":37,"_38":339,"_40":41,"_42":682,"_44":683,"_68":342,"_59":60},{},[],{"_36":108,"_38":344,"_40":41,"_42":685,"_44":686,"_68":347,"_59":60},{"_111":112},[],{"_32":688,"_34":699},[689,694],{"_32":690,"_34":691},[],{"_36":37,"_38":353,"_40":41,"_42":692,"_44":693,"_68":356,"_59":60},{},[],{"_32":695,"_34":696},[],{"_36":37,"_38":360,"_40":41,"_42":697,"_44":698,"_68":363,"_59":60},{},[],{"_36":108,"_38":365,"_40":41,"_42":700,"_44":701,"_68":368,"_59":60},{"_111":112},[],{"_32":703,"_34":743},[704,724,733,738],{"_32":705,"_34":721},[706,711,716],{"_32":707,"_34":708},[],{"_36":37,"_38":376,"_40":41,"_42":709,"_44":710,"_68":379,"_59":60},{},[],{"_32":712,"_34":713},[],{"_36":37,"_38":383,"_40":41,"_42":714,"_44":715,"_68":386,"_59":60},{},[],{"_32":717,"_34":718},[],{"_36":37,"_38":390,"_40":41,"_42":719,"_44":720,"_68":393,"_59":60},{},[],{"_36":37,"_38":395,"_40":41,"_42":722,"_44":723,"_68":399,"_59":60},{"_111":397},[],{"_32":725,"_34":726},[],{"_36":37,"_38":403,"_40":41,"_42":727,"_44":728,"_68":414,"_59":60},{},[729],{"_36":407,"_48":730,"_53":731,"_42":732,"_59":413},[409],[411],{},{"_32":734,"_34":735},[],{"_36":37,"_38":418,"_40":41,"_42":736,"_44":737,"_68":421,"_59":60},{},[],{"_32":739,"_34":740},[],{"_36":37,"_38":425,"_40":426,"_42":741,"_44":742,"_68":429,"_59":60},{},[],{"_36":108,"_38":431,"_40":41,"_42":744,"_44":745,"_68":434,"_59":60},{"_111":112},[],[437],{"_302":448,"_449":450},{},{"_453":41,"_456":457},{"_38":466,"_465":437,"_440":751,"_435":300,"_467":-5,"_468":-5,"_469":-5,"_470":-5,"_464":25},[29,463],"dataUpdateCount",1,"dataUpdatedAt",1780977304700,"error","errorUpdateCount",0,"errorUpdatedAt","fetchFailureCount","fetchFailureReason","fetchMeta","isInvalidated","status","success","fetchStatus","idle","queryKey",[770,466,300,25],"ENTITY","queryHash","[\"ENTITY\",\"hm://z6MkhBiheioCs7btwVLUcnSCcFPdhTGGHSHpR4SHTyAobUUp/content/states-events-and-transitions-demystified\",\"bafy2bzacedazyemw5mvbfvvecvh7xlbfqvioyvxtwo6kmgvwapznbbxcycd56\",false]",{"_479":774,"_768":943,"_771":944},{"_481":775,"_752":753,"_754":942,"_756":-5,"_757":758,"_759":758,"_760":758,"_761":-5,"_762":-5,"_763":25,"_764":765,"_766":767},{"_36":27,"_27":776,"_38":939},{"_29":777,"_435":927,"_436":437,"_438":928,"_440":60,"_442":929,"_444":930,"_446":931,"_451":935,"_453":936,"_454":937,"_458":459},[778,786,798,811,818,866,886,894],{"_32":779,"_34":780},[],{"_36":108,"_38":781,"_40":782,"_42":783,"_44":784,"_68":785,"_59":60},"YS5-lwb-","bafy2bzacedo2fapga62cenj2wqdo7fnnbwssy3ohyonmse3l74fds24nqx4r6",{},[],"Modeling UI with State Machines should be the norm.",{"_32":787,"_34":788},[],{"_36":37,"_38":789,"_40":782,"_42":790,"_44":791,"_68":797,"_59":60},"HIUNgDv3",{},[792],{"_36":47,"_48":793,"_53":794,"_42":796,"_59":60},[758],[795],79,{},"A practical guide to building better interfaces with XState, React & TypeScript",{"_32":799,"_34":800},[],{"_36":37,"_38":801,"_40":782,"_42":802,"_44":803,"_68":810,"_59":60},"RH2vgIqw",{},[804],{"_36":213,"_48":805,"_53":807,"_42":809,"_59":60},[806],132,[808],141,{},"Modern UI development is full of invisible complexity: async flows, conflicting states, edge cases, and fragile logic spread across useEffects and booleans.",{"_32":812,"_34":813},[],{"_36":37,"_38":814,"_40":782,"_42":815,"_44":816,"_68":817,"_59":60},"1i3NXohu",{},[],"This series is about doing it differently.",{"_32":819,"_34":855},[820,827,834,841,848],{"_32":821,"_34":822},[],{"_36":37,"_38":823,"_40":782,"_42":824,"_44":825,"_68":826,"_59":60},"cP0mEJaa",{},[],"Easier to understand",{"_32":828,"_34":829},[],{"_36":37,"_38":830,"_40":782,"_42":831,"_44":832,"_68":833,"_59":60},"mUUMMN68",{},[],"Safer to extend",{"_32":835,"_34":836},[],{"_36":37,"_38":837,"_40":782,"_42":838,"_44":839,"_68":840,"_59":60},"xkA4h4Fv",{},[],"Visually predictable",{"_32":842,"_34":843},[],{"_36":37,"_38":844,"_40":782,"_42":845,"_44":846,"_68":847,"_59":60},"1AW5Zc7P",{},[],"Naturally testable",{"_32":849,"_34":850},[],{"_36":37,"_38":851,"_40":782,"_42":852,"_44":853,"_68":854,"_59":60},"mISZl3dK",{},[],"Easy to Maintain and Refactor",{"_36":37,"_38":856,"_40":782,"_42":857,"_44":858,"_68":865,"_59":60},"mZU_BNzy",{"_111":397},[859],{"_36":47,"_48":860,"_53":862,"_42":864,"_59":60},[861],34,[863],64,{},"By modeling your UI behavior with state machines and statecharts, you can write code that’s:",{"_32":867,"_34":868},[],{"_36":37,"_38":869,"_40":782,"_42":870,"_44":871,"_68":885,"_59":60},"dT3b7j6V",{},[872],{"_36":47,"_48":873,"_53":878,"_42":884,"_59":60},[874,875,876,877,55],100,134,142,149,[879,880,881,882,883],116,140,147,160,179,{},"Through weekly posts, hands-on code examples, and short video breakdowns, you’ll learn how to build state-driven UIs using tools like XState, React, TypeScript and even Vanilla JS — from the fundamentals to real-world patterns like forms, modals, async data, and more.",{"_32":887,"_34":888},[],{"_36":37,"_38":889,"_40":890,"_42":891,"_44":892,"_68":893,"_59":60},"-dfXsmmY","bafy2bzacedzht25ysz76cqbnx7vjw7ry62rde3ewqjdscea3ruhurpw7xqt7g",{},[],"Whether you’re just curious about state machines or want to build your next app with them from the ground up, this is your guide to building interfaces that don't fall apart.",{"_32":895,"_34":922},[896],{"_32":897,"_34":898},[],{"_36":899,"_38":900,"_40":782,"_42":901,"_44":921,"_68":60,"_59":60},"Query","XMasrKG1",{"_902":903,"_904":905,"_906":907,"_920":25},"columnCount",3,"style","List","query",{"_908":909,"_914":915},"includes",[910],{"_911":437,"_440":29,"_912":913},"space","mode","Children","sort",[916],{"_917":25,"_918":919},"reverse","term","UpdateTime","banner",[],{"_36":108,"_38":923,"_40":782,"_42":924,"_44":925,"_68":926,"_59":60},"JuhiSEfW",{"_111":112},[],"Posts","bafy2bzacecwxx5llylg2hzhhcsf4r3dzvtr22wwk6wnw4qklwcvdp6jxln2ni",[437],"1970-01-01T00:00:00Z","2025-04-24T21:23:24.377Z",{"_302":932,"_933":934},"UI with State Machines","siteUrl","https://ui-with-state-machines.hyper.media",{},"bafy2bzacecztctsdsles75mugrpzhgspjvfnf7atqvn5cmqqbccz4grooldak",{"_453":936,"_456":938},"0",{"_38":940,"_465":437,"_440":941,"_435":-5,"_467":-5,"_468":-5,"_469":-5,"_470":-5,"_464":6},"hm://z6MkhBiheioCs7btwVLUcnSCcFPdhTGGHSHpR4SHTyAobUUp",[],1780977304694,[770,940,-5,6],"[\"ENTITY\",\"hm://z6MkhBiheioCs7btwVLUcnSCcFPdhTGGHSHpR4SHTyAobUUp\",null,true]",{"_479":946,"_768":1006,"_771":1008},{"_481":947,"_752":753,"_754":1005,"_756":-5,"_757":758,"_759":758,"_760":758,"_761":-5,"_762":-5,"_763":25,"_764":765,"_766":767},[948,983],{"_36":27,"_38":949,"_440":953,"_438":954,"_442":955,"_444":960,"_963":964,"_453":965,"_435":952,"_966":967,"_970":971,"_454":978,"_980":-5,"_446":981,"_458":459},{"_38":950,"_465":437,"_440":951,"_435":952,"_467":-5,"_468":-5,"_469":-5,"_470":-5,"_464":6},"hm://z6MkhBiheioCs7btwVLUcnSCcFPdhTGGHSHpR4SHTyAobUUp/content",[29],"bafy2bzacecso2o7bwea36sevjo45wf2phruj5jcoomebikt7btumd3xpcrax2",[29],[437],{"_956":957,"_958":959},"seconds","1743456714","nanos",453000000,{"_956":961,"_958":962},"1776378355",213000000,"sortTime","2025-03-31T21:31:54.453Z","bafy2bzacecefqjbssb4ej2oc4wbspy3cvuuadbabfzxrzls56zqiissf6inw4","breadcrumbs",[968],{"_302":932,"_440":60,"_969":25},"isMissing","activitySummary",{"_972":-5,"_973":60,"_974":758,"_975":976,"_977":6},"latestCommentTime","latestCommentId","commentCount","latestChangeTime",{"_956":961,"_958":962},"isUnread",{"_453":965,"_456":979},"1743456714453","redirectInfo",{"_302":982},"Content",{"_36":27,"_38":984,"_440":989,"_438":990,"_442":991,"_444":992,"_963":995,"_453":996,"_435":988,"_966":997,"_970":999,"_454":1001,"_980":-5,"_446":1003,"_458":459},{"_38":985,"_465":437,"_440":986,"_435":988,"_467":-5,"_468":-5,"_469":-5,"_470":-5,"_464":6},"hm://z6MkhBiheioCs7btwVLUcnSCcFPdhTGGHSHpR4SHTyAobUUp/home",[987],"home","bafyreicyjsg763rk6qtlns2wkpxn7uhhqc4t7c5ytd7ll7cd4ev42rgq5u",[987],[437],{"_956":938,"_958":758},{"_956":993,"_958":994},"1776190620",425000000,"1970-01-01T00:00:00.000Z","bafyreihqedcuddy2wuyh6dm6cy7pc5yhkdmq4bto7dzbz2bu3v5jsqud2y",[998],{"_302":932,"_440":60,"_969":25},{"_972":-5,"_973":60,"_974":758,"_975":1000,"_977":6},{"_956":993,"_958":994},{"_453":996,"_456":1002},"1776190620425",{"_302":1004},"Home",1780977304693,[1007,940,913],"DOC_LIST_DIRECTORY","[\"DOC_LIST_DIRECTORY\",\"hm://z6MkhBiheioCs7btwVLUcnSCcFPdhTGGHSHpR4SHTyAobUUp\",\"Children\"]",{"_479":1010,"_768":1012,"_771":1013},{"_481":1011,"_752":753,"_754":1005,"_756":-5,"_757":758,"_759":758,"_760":758,"_761":-5,"_762":-5,"_763":25,"_764":765,"_766":767},[],[1007,466,913],"[\"DOC_LIST_DIRECTORY\",\"hm://z6MkhBiheioCs7btwVLUcnSCcFPdhTGGHSHpR4SHTyAobUUp/content/states-events-and-transitions-demystified\",\"Children\"]",{"_479":1015,"_768":1027,"_771":1029},{"_481":1016,"_752":753,"_754":1026,"_756":-5,"_757":758,"_759":758,"_760":758,"_761":-5,"_762":-5,"_763":25,"_764":765,"_766":767},{"_1017":753,"_1018":753,"_1019":1020,"_32":758,"_1021":1022,"_1024":1025},"citations","comments","changes",4,"authorUids",[437,1023],"z6Mkfm8befyW32tingJymhfqjX6nhLwoBkQxdSmqg9DnqmiH","blocks",{},1780977304765,[1028,466],"DOCUMENT_INTERACTION_SUMMARY","[\"DOCUMENT_INTERACTION_SUMMARY\",\"hm://z6MkhBiheioCs7btwVLUcnSCcFPdhTGGHSHpR4SHTyAobUUp/content/states-events-and-transitions-demystified\"]",{"_479":1031,"_768":1101,"_771":1102},{"_481":1032,"_752":753,"_754":1100,"_756":-5,"_757":758,"_759":758,"_760":758,"_761":-5,"_762":-5,"_763":25,"_764":765,"_766":767},{"_36":27,"_27":1033,"_38":1098},{"_29":1034,"_435":952,"_436":437,"_438":1092,"_440":1093,"_442":964,"_444":1094,"_446":1095,"_451":1096,"_453":965,"_454":1097,"_458":459},[1035,1062,1069,1077,1085],{"_32":1036,"_34":1056},[1037,1048],{"_32":1038,"_34":1039},[],{"_36":1040,"_38":1041,"_40":1042,"_42":1043,"_44":1046,"_68":60,"_59":1047},"Embed","I01RCHLp","bafy2bzacedffkd4rdzzkikyjdm23zb2evqbqhnwklr5nxlcaod7pynmzj75um",{"_1044":1045},"view","Card",[],"hm://z6MkhBiheioCs7btwVLUcnSCcFPdhTGGHSHpR4SHTyAobUUp/content/you-are-writing-ui-state-wrong?v=bafy2bzacecxbssfu6tsgckkty6krdldbq232rib3mvbbxhfhi745pqg4m7zsg&l",{"_32":1049,"_34":1050},[],{"_36":1040,"_38":1051,"_40":1052,"_42":1053,"_44":1054,"_68":60,"_59":1055},"TbDjWW-e","bafy2bzaced2hqcefph7tgklninzu5dcebzjmxq67dmjn7puloiksgwttj6gig",{"_1044":1045},[],"hm://z6MkhBiheioCs7btwVLUcnSCcFPdhTGGHSHpR4SHTyAobUUp/content/states-events-and-transitions-demystified?v=bafy2bzaceasflmgw6yafc3mygkufwzsrzcjoh5vbpczy532qvitkfsli3icns&l",{"_36":108,"_38":1057,"_40":1058,"_42":1059,"_44":1060,"_68":1061,"_59":60},"SpGu0tBK","bafy2bzaceblppdcojdh2aj4zbh6aax7c6a6ynzvetc2elfxbi44o2mxwvc5go",{"_111":112},[],"English",{"_32":1063,"_34":1064},[],{"_36":108,"_38":1065,"_40":1058,"_42":1066,"_44":1067,"_68":1068,"_59":60},"nvxL-VgX",{},[],"Spanish",{"_32":1070,"_34":1071},[],{"_36":1040,"_38":1072,"_40":1073,"_42":1074,"_44":1075,"_68":60,"_59":1076},"XG17WIWR","bafy2bzacebsxm4y2fsik3g3ovk5kx4kri56g32o6r7dszvekaqugfrqbmhmx6",{"_1044":1045},[],"hm://z6MkhBiheioCs7btwVLUcnSCcFPdhTGGHSHpR4SHTyAobUUp/content/you-are-writing-ui-state-wrong/estas-gestionando-el-estado-de-tus-interfaces-mal?v=bafy2bzacedeehy4mmf4hniuuxqoww54eacrhpypjtzu5qotzkgrq2bm6lfmqm&l",{"_32":1078,"_34":1079},[],{"_36":1040,"_38":1080,"_40":1081,"_42":1082,"_44":1083,"_68":60,"_59":1084},"LsgymWG9uV","bafy2bzacedonvbcc5bzwy2j5r7wnwgaco4rcrpyo5g6zqdugpfbdejp5oodeg",{"_1044":1045},[],"hm://z6MkhBiheioCs7btwVLUcnSCcFPdhTGGHSHpR4SHTyAobUUp/content/estados-eventos-y-transiciones-desmitificados",{"_32":1086,"_34":1087},[],{"_36":1040,"_38":1088,"_40":952,"_42":1089,"_44":1090,"_68":60,"_59":1091},"dyEQC00biY",{"_1044":1045},[],"hm://z6MkhBiheioCs7btwVLUcnSCcFPdhTGGHSHpR4SHTyAobUUp/content/why-state-machines-are-a-game-changer-for-ui-development",[437],"/content","2026-04-16T22:25:55.213Z",{"_302":982},{},{"_453":965,"_456":979},{"_38":950,"_465":437,"_440":1099,"_435":-5,"_467":-5,"_468":-5,"_469":-5,"_470":-5},[29],1780977304702,[770,950,-5,25],"[\"ENTITY\",\"hm://z6MkhBiheioCs7btwVLUcnSCcFPdhTGGHSHpR4SHTyAobUUp/content\",null,false]",{"_479":1104,"_768":1112,"_771":1114},{"_481":1105,"_752":753,"_754":1111,"_756":-5,"_757":758,"_759":758,"_760":758,"_761":-5,"_762":-5,"_763":25,"_764":765,"_766":767},{"_36":436,"_38":1106,"_446":1108},{"_435":927,"_465":437,"_38":940,"_440":1107,"_467":-5,"_468":-5,"_469":-5,"_470":-5},[],{"_302":932,"_933":934,"_1109":-5,"_1110":-5},"icon","summary",1780977304768,[1113,437],"ACCOUNT","[\"ACCOUNT\",\"z6MkhBiheioCs7btwVLUcnSCcFPdhTGGHSHpR4SHTyAobUUp\"]","ssrContentHTML","

State machines can sound intimidating at first — all those diagrams and boxes and arrows. But at the heart of it, they’re built on three incredibly simple ideas: states, events, and transitions. If you've ever handled a button click or shown a loading spinner, you've already worked with them. This week, we're going to demystify how these pieces fit together and why they can make your UI logic feel like it finally makes sense.

✨ Intro: The Foundation of Every State Machine

In the last issue, we looked at why state machines are a better way to model UI logic. This week, we’re breaking down the three concepts that power every state machine:

States – the different modes your UI can be in

Events – the things that happen to trigger change

Transitions – how you move from one state to another

Once you understand these, even the most complex flows start to feel… obvious.

🧠 What Is a State?

A state is just a label for a condition your UI is in.

🔁 Example: A toggle switch has two states: active and inactive. A form might have: idle, validating, submitting, success, error.

You define them up front — and your component can only be in one of them at a time.

⚡ What Is an Event?

An event is something that happens — usually triggered by the user or the system.

👇 Examples:

A click → TOGGLE

A form submission → SUBMIT

An API call fails → FAILURE

Events don’t do anything on their own — they ask the machine to change.

🔄 What Is a Transition?

A transition is how the machine changes from one state to another in response to an event.

Think of it as: "When I'm in [this state] and [this event] happens, move to [that state]."

In XState, it looks like this:

createMachine({\n  initial: 'idle',\n  states: {\n    idle: {\n      on: { SUBMIT: 'submitting' }\n    },\n    submitting: {\n      on: {\n        SUCCESS: 'success',\n        FAILURE: 'error'\n      }\n    },\n    success: {},\n    error: {}\n  }\n});

🧪 Why This Structure Is Powerful

Because you define states and transitions explicitly, you avoid:

Ambiguous conditions

Invalid combinations (e.g. isLoading && isError)

“Where am I in the flow?” type bugs

The machine won’t allow transitions that aren’t defined. That’s safety by design.

Visualize It

Here’s that form state machine as a diagram:

Button

Diagrams like this aren’t just pretty — they’re living documentation of how your app behaves.

🧠 Pro Tip: Events Are the API of Your Component

Instead of exposing a bunch of props or handlers, you can think of your UI machine as exposing one clean interface:

send({ type: 'SUBMIT' });

That’s it. Consumers of your component don’t care about your internal logic — they just send events and get predictable behavior.

Coming Up Next: Modeling UI with XState

In the next issue, we’ll get hands-on: ✅ Setting up XState in a React project ✅ Using useMachine ✅ Connecting state to your UI

We’ll build a real machine and hook it into a real component.

💡 Try This

Pick a small UI in your app (a toggle, button, form, etc) and answer:

What are the possible states?
What events can happen?
How do you transition from one to another?

Try modeling it on paper — or in Stately.ai

Reply to this with your flow — I’d love to feature a few in future issues!

Until next time,\nHoracio

","enableWebSigning","origin","homeMetadata",{"_302":932,"_933":934},"originHomeId",{"_465":437,"_38":940,"_440":1123,"_435":-5,"_467":-5,"_468":-5,"_469":-5,"_470":-5},[],"meta",{"_1126":1127,"_1175":1176},"values",{"_1128":1129,"_1131":1132,"_1133":1134,"_1135":1136,"_1138":1139,"_1140":1141,"_1142":1143,"_1145":1146,"_1147":1148,"_1149":1150,"_1151":1152,"_1153":1154,"_1155":1156,"_1157":1158,"_1159":1160,"_1161":1162,"_1163":1164,"_1165":1166,"_1167":1168,"_1169":1170,"_1171":1172,"_1173":1174},"document.generationInfo.generation",[1130],"bigint","dehydratedState.queries.0.state.data.document.generationInfo.generation",[1130],"dehydratedState.queries.1.state.data.document.generationInfo.generation",[1130],"dehydratedState.queries.1.queryKey.2",[1137],"undefined","dehydratedState.queries.2.state.data.0.createTime.seconds",[1130],"dehydratedState.queries.2.state.data.0.updateTime.seconds",[1130],"dehydratedState.queries.2.state.data.0.sortTime",[1144],"Date","dehydratedState.queries.2.state.data.0.activitySummary.latestCommentTime",[1137],"dehydratedState.queries.2.state.data.0.activitySummary.latestChangeTime.seconds",[1130],"dehydratedState.queries.2.state.data.0.generationInfo.generation",[1130],"dehydratedState.queries.2.state.data.0.redirectInfo",[1137],"dehydratedState.queries.2.state.data.1.createTime.seconds",[1130],"dehydratedState.queries.2.state.data.1.updateTime.seconds",[1130],"dehydratedState.queries.2.state.data.1.sortTime",[1144],"dehydratedState.queries.2.state.data.1.activitySummary.latestCommentTime",[1137],"dehydratedState.queries.2.state.data.1.activitySummary.latestChangeTime.seconds",[1130],"dehydratedState.queries.2.state.data.1.generationInfo.generation",[1130],"dehydratedState.queries.2.state.data.1.redirectInfo",[1137],"dehydratedState.queries.5.state.data.document.generationInfo.generation",[1130],"dehydratedState.queries.5.queryKey.2",[1137],"dehydratedState.queries.6.state.data.metadata.icon",[1137],"dehydratedState.queries.6.state.data.metadata.summary",[1137],"referentialEqualities",{"_1128":1177,"_1133":1178,"_1140":1179,"_1149":1180,"_1155":1181},[1131],[1153],[1147],[1167],[1161],"actionData","errors"]