There are two ways to change an app and both are supported: edit the .cordango.yaml files
directly, or apply semantic operations. Both assemble into the same model,
so pick whichever is convenient. Neither one is more correct than the other.Hand-editing suits a small, known change. Semantic operations suit structural change, and anything
an agent is driving.
Find the file first
cordango inspect --app support # what this app holdscordango inspect entities/ticket --app support # one aggregate
The directory layout is a convention for people. What makes a file an entity is the entity: key on
its first line, not the folder it sits in.
This answers from the build you have installed, so it can’t disagree with what your CLI will accept.
Don’t go reading the App Definition schema. See The schema for why.
Then check the change
cordango check --app support
No model, no database, no network. It’s free, and it reports against the file and line you wrote
instead of a path into a compiled document. Run it constantly.
Format afterwards
cordango fmt
Canonical key order and quoting for every .cordango.yaml file. Run it after hand-editing so the
next diff shows a change in meaning instead of a change in whitespace.
Four rules
One aggregate per change. A diff touching one entity is a diff somebody can review. A diff
touching nine is a diff that gets approved without being read.Keys are stable. You can’t rename an entity or field key, because nothing rewrites the
references to it. Add the new one and remove the old one, deliberately, as two decisions.
There’s no rename. A key you choose today is a key you live with, or migrate away from by hand.
Spend a moment on it.
Never edit .cordango/. The dotted directory is build output. Changes there vanish on the next
cordango build, and they were never the source of anything.Check before you declare. Companies, people and calendar events already exist as
core apps. Reference them.
Bringing in an existing definition
cordango import ./app.definition.json --app support
That turns an App Definition into source files you can edit. It’s the way in for an app that was
built before the workspace existed, or one produced somewhere else.
Diagnosing a workspace
cordango doctor
This finds problems that aren’t source errors: an app registered in cordango.yaml whose directory
is missing, a stale credential, a layout that doesn’t add up. cordango check asks whether the app
is right. doctor asks whether the workspace is.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Cordango","description":"Build complete business applications from a definition you own.","colors":{"primary":"#1D4ED8","light":"#3B6BF0","dark":"#1D4ED8"},"logo":{"light":"https://mintcdn.com/cordango/Fb6tWISooksDFX10/logo-light.png?fit=max\u0026auto=format\u0026n=Fb6tWISooksDFX10\u0026q=85\u0026s=95a8ad3ae8faf04b6053814a2a2fcea0","dark":"https://mintcdn.com/cordango/Fb6tWISooksDFX10/logo-dark.png?fit=max\u0026auto=format\u0026n=Fb6tWISooksDFX10\u0026q=85\u0026s=5f58c21c2b6c3b5b2cbc7bdc7027a397","href":"https://cordango.com"},"favicon":"https://mintcdn.com/cordango/rEsfB4Nx_N_Ej8W4/favicon.svg?fit=max\u0026auto=format\u0026n=rEsfB4Nx_N_Ej8W4\u0026q=85\u0026s=93e401d727f79eb83c91478d606797eb","navbar":{"links":[{"href":"https://cordango.com","label":"Homepage"},{"href":"https://github.com/cordango/cordango","label":"GitHub"}]},"footer":{"socials":{"website":"https://cordango.com","github":"https://github.com/cordango"}},"seo":{"metatags":{"canonical":"https://docs.cordango.com"}},"integrations":{"ga4":{"measurementId":"G-SCPVJ9QFG6"}},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"cordango","hasAudioNarration":false,"actualSubdomain":"cordango","customDomains":["docs.cordango.com"],"gitSource":{"type":"github","owner":"cordango","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6ac28fd732cf889e79145ac6","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"default","tag":"Documentation","count":23},{"language":"default","tag":"Concepts","count":9},{"language":"default","tag":"CLI","count":8},{"language":"default","tag":"API reference","count":6},{"language":"default","tag":"Guides","count":6},{"language":"default","tag":"MCP","count":6},{"language":"default","tag":"Quickstart with an AI agent","count":5},{"language":"default","tag":"Get started","count":2},{"language":"default","tag":"Security","count":1}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"site-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"control","enabled":true,"payload":{"type":"string","value":"control"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[]}
{"page":{"pagePath":"guides/authoring","slug":"/guides/authoring","pageMetadata":{"title":"Editing an app","description":"Changing semantic source by hand.","href":"/guides/authoring"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Changing semantic source by hand.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,..._provideComponents(),...props.components},{CodeBlock,Heading,Warning}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`There are two ways to change an app and both are supported: edit the `,_jsx(_components.code,{children:`.cordango.yaml`}),` files\ndirectly, or apply `,_jsx(_components.a,{href:`/guides/semantic-ops`,children:`semantic operations`}),`. Both assemble into the same model,\nso pick whichever is convenient. Neither one is more correct than the other.`]}),`\n`,_jsx(_components.p,{children:`Hand-editing suits a small, known change. Semantic operations suit structural change, and anything\nan agent is driving.`}),`\n`,_jsx(Heading,{level:`2`,id:`find-the-file-first`,children:`Find the file first`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`2`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`2`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`cordango`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` inspect`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --app`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` support`}),_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:` # what this app holds`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`cordango`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` inspect`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` entities/ticket`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --app`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` support`}),_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:` # one aggregate`})]}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`The directory layout is a convention for people. What makes a file an entity is the `,_jsx(_components.code,{children:`entity:`}),` key on\nits first line, not the folder it sits in.`]}),`\n`,_jsx(Heading,{level:`2`,id:`check-what-you-may-write`,children:`Check what you may write`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`2`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`2`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`cordango`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` vocabulary`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` field`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`cordango`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` vocabulary`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` block`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` table`})]}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`This answers from the build you have installed, so it can’t disagree with what your CLI will accept.\nDon’t go reading the App Definition schema. See `,_jsx(_components.a,{href:`/concepts/schema`,children:`The schema`}),` for why.`]}),`\n`,_jsx(Heading,{level:`2`,id:`then-check-the-change`,children:`Then check the change`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`cordango`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` check`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --app`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` support`})]}),`\n`]})})}),`\n`,_jsx(_components.p,{children:`No model, no database, no network. It’s free, and it reports against the file and line you wrote\ninstead of a path into a compiled document. Run it constantly.`}),`\n`,_jsx(Heading,{level:`2`,id:`format-afterwards`,children:`Format afterwards`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`cordango`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` fmt`})]}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`Canonical key order and quoting for every `,_jsx(_components.code,{children:`.cordango.yaml`}),` file. Run it after hand-editing so the\nnext diff shows a change in meaning instead of a change in whitespace.`]}),`\n`,_jsx(Heading,{level:`2`,id:`four-rules`,children:`Four rules`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`One aggregate per change.`}),` A diff touching one entity is a diff somebody can review. A diff\ntouching nine is a diff that gets approved without being read.`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Keys are stable.`}),` You can’t rename an entity or field key, because nothing rewrites the\nreferences to it. Add the new one and remove the old one, deliberately, as two decisions.`]}),`\n`,_jsx(Warning,{children:_jsx(_components.p,{children:`There’s no rename. A key you choose today is a key you live with, or migrate away from by hand.\nSpend a moment on it.`})}),`\n`,_jsxs(_components.p,{children:[_jsxs(_components.strong,{children:[`Never edit `,_jsx(_components.code,{children:`.cordango/`}),`.`]}),` The dotted directory is build output. Changes there vanish on the next\n`,_jsx(_components.code,{children:`cordango build`}),`, and they were never the source of anything.`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Check before you declare.`}),` Companies, people and calendar events already exist as\n`,_jsx(_components.a,{href:`/concepts/core-apps`,children:`core apps`}),`. Reference them.`]}),`\n`,_jsx(Heading,{level:`2`,id:`bringing-in-an-existing-definition`,children:`Bringing in an existing definition`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`cordango`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` import`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` ./app.definition.json`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --app`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` support`})]}),`\n`]})})}),`\n`,_jsx(_components.p,{children:`That turns an App Definition into source files you can edit. It’s the way in for an app that was\nbuilt before the workspace existed, or one produced somewhere else.`}),`\n`,_jsx(Heading,{level:`2`,id:`diagnosing-a-workspace`,children:`Diagnosing a workspace`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`cordango`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` doctor`})]}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`This finds problems that aren’t source errors: an app registered in `,_jsx(_components.code,{children:`cordango.yaml`}),` whose directory\nis missing, a stale credential, a layout that doesn’t add up. `,_jsx(_components.code,{children:`cordango check`}),` asks whether the app\nis right. `,_jsx(_components.code,{children:`doctor`}),` asks whether the workspace is.`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Editing an app","description":"Changing semantic source by hand.","href":"/guides/authoring"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Find the file first","slug":"find-the-file-first","depth":2,"children":[]},{"title":"Check what you may write","slug":"check-what-you-may-write","depth":2,"children":[]},{"title":"Then check the change","slug":"then-check-the-change","depth":2,"children":[]},{"title":"Format afterwards","slug":"format-afterwards","depth":2,"children":[]},{"title":"Four rules","slug":"four-rules","depth":2,"children":[]},{"title":"Bringing in an existing definition","slug":"bringing-in-an-existing-definition","depth":2,"children":[]},{"title":"Diagnosing a workspace","slug":"diagnosing-a-workspace","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"cordango","siteName":"Cordango","title":"Editing an app - Cordango","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-08-23T20:47:12.977Z","originalFileLocation":"guides/authoring.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Changing semantic source by hand.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Cordango\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/cordango/Vl8DMyR37v-tD5rv/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/cordango/Vl8DMyR37v-tD5rv/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/cordango/Vl8DMyR37v-tD5rv/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/cordango/Vl8DMyR37v-tD5rv/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/cordango/Vl8DMyR37v-tD5rv/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/cordango/Vl8DMyR37v-tD5rv/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/cordango/Vl8DMyR37v-tD5rv/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/cordango/Vl8DMyR37v-tD5rv/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/cordango/Vl8DMyR37v-tD5rv/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Editing an app - Cordango\">\u003cmeta data-mint-head property=\"og:description\" content=\"Changing semantic source by hand.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Cordango\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.cordango.com/guides/authoring\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://cordango.mintlify.site/_mintlify/api/og/v2?division=Guides\u0026amp;title=Editing+an+app\u0026amp;description=Changing+semantic+source+by+hand.\u0026amp;theme=726d7292d81e7ed559f5aead\u0026amp;signature=27d7eb854999c05fcbac3e8f6ce1defe3477040215c8bdf248293a35e718c8ca\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Editing an app - Cordango\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Changing semantic source by hand.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://cordango.mintlify.site/_mintlify/api/og/v2?division=Guides\u0026amp;title=Editing+an+app\u0026amp;description=Changing+semantic+source+by+hand.\u0026amp;theme=726d7292d81e7ed559f5aead\u0026amp;signature=27d7eb854999c05fcbac3e8f6ce1defe3477040215c8bdf248293a35e718c8ca\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/cordango/Vl8DMyR37v-tD5rv/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Cordango\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#1D4ED8\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.cordango.com/guides/authoring\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/guides/authoring.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.cordango.com/#organization\",\"name\":\"Cordango\",\"url\":\"https://docs.cordango.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/cordango/Fb6tWISooksDFX10/logo-light.png?fit=max\u0026auto=format\u0026n=Fb6tWISooksDFX10\u0026q=85\u0026s=95a8ad3ae8faf04b6053814a2a2fcea0\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.cordango.com#website\",\"name\":\"Cordango\",\"url\":\"https://docs.cordango.com\",\"publisher\":{\"@id\":\"https://docs.cordango.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.cordango.com/guides/authoring#webpage\",\"url\":\"https://docs.cordango.com/guides/authoring\",\"name\":\"Editing an app\",\"description\":\"Changing semantic source by hand.\",\"dateModified\":\"2026-08-23T20:47:12.977Z\",\"isPartOf\":{\"@id\":\"https://docs.cordango.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.cordango.com/guides/authoring#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.cordango.com/guides/authoring#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Cordango\",\"item\":\"https://docs.cordango.com\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Editing an app\",\"item\":\"https://docs.cordango.com/guides/authoring\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.cordango.com/guides/authoring#article\",\"headline\":\"Editing an app\",\"name\":\"Editing an app\",\"description\":\"Changing semantic source by hand.\",\"url\":\"https://docs.cordango.com/guides/authoring\",\"mainEntityOfPage\":{\"@id\":\"https://docs.cordango.com/guides/authoring#webpage\"},\"dateModified\":\"2026-08-23T20:47:12.977Z\",\"publisher\":{\"@id\":\"https://docs.cordango.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.cordango.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Cordango\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Cordango\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/guides/authoring.md","siteName":"Cordango","nav":{"global":null,"tabs":[{"tab":"Documentation","groups":[{"group":"Get started","icon":"rocket","pages":[{"title":"Cordango","href":""},{"title":"Quickstart","href":"/quickstart"}]},{"group":"Quickstart with an AI agent","icon":"sparkles","pages":[{"title":"Building with an agent","href":"/ai/overview"},{"title":"Claude Code","href":"/ai/claude"},{"title":"Codex","href":"/ai/codex"},{"title":"Cursor","href":"/ai/cursor"},{"title":"GLM","href":"/ai/glm"}]},{"group":"Concepts","icon":"diagram-project","pages":[{"title":"Overview","href":"/concepts"},{"title":"Semantic source","href":"/concepts/semantic-source"},{"title":"The App Definition","href":"/concepts/app-definition"},{"title":"App Contract","href":"/concepts/app-contract"},{"title":"The schema","href":"/concepts/schema"},{"title":"Targets","href":"/concepts/targets"},{"title":"Core apps","href":"/concepts/core-apps"},{"title":"Apps working together","href":"/concepts/cross-app"},{"title":"Forms","description":"What a create dialog asks, and the forms people design inside an app.","href":"/concepts/forms"}]},{"group":"Guides","icon":"book-open","pages":[{"title":"Editing an app","href":"/guides/authoring"},{"title":"Semantic operations","description":"Structural change through cordango apply.","href":"/guides/semantic-ops"},{"title":"Roles and access","href":"/guides/roles"},{"title":"Custom code","href":"/guides/custom-code"},{"title":"Validating and CI","href":"/guides/validation"},{"title":"Deploying a generated app","href":"/guides/deploying"}]},{"group":"Security","icon":"shield","pages":[{"title":"Security \u0026 privacy","href":"/security"}]}]},{"tab":"CLI","pages":[{"title":"CLI","href":"/cli/install"}]},{"tab":"API reference","pages":[{"title":"API reference","href":"/api-reference/introduction"}]},{"tab":"MCP","pages":[{"title":"MCP","href":"/mcp/overview"}]}]},"basePath":"","title":"Editing an app - Cordango","deploymentId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","buildId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","dynamics":[],"chunks":[]}