What cordango new writes, and what belongs in git.
acme/ cordango.yaml the workspace: its name, and the apps it holds apps/ support/ *.cordango.yaml semantic source, one file per aggregate custom/ this app's own code, when it has any generated/ support/ the generated application, one directory per app. Not committed. .cordango/ build output. Not committed. README.md CLAUDE.md AGENTS.md .gitignore .gitattributes
The source files
Semantic source lives in .cordango.yaml files, one per aggregate: an entity, a lifecycle, a role,
a screen. They’re the source of truth, and they’re meant to be read, reviewed and diffed.Editing them directly is fine. They describe what a thing is, not how it runs.
cordango fmt
fmt rewrites every .cordango.yaml file in canonical form, so a diff shows a change in meaning
instead of a change in whitespace or key order.
The build directories
Two, and neither is committed. cordango new writes a .gitignore that already excludes both..cordango/ with the leading dot holds the definition artifacts — the compiled App Definition and
its manifest. cordango build regenerates it.generated/ holds the applications themselves, one directory per app, so a workspace with support
and billing in it builds to generated/support/ and generated/billing/. There is no --out:
where the output goes is not a decision anybody has to make twice. It’s ordinary source code and
it’s reproducible from the apps/ directory beside it, which is why it stays out of git — and
moving a directory out of the workspace is how an application leaves.
Agent instructions
cordango new writes CLAUDE.md and AGENTS.md with the same generated text. Two conventions, two
filenames. Both get written because a workspace that taught two agents different rules would end up
with source only one of them could maintain.They teach the workflow rather than the schema. An agent arrives knowing how to find out:
cordango inspect # the apps in this workspacecordango inspect --app support # one appcordango inspect entities/ticket --app support # one aggregatecordango vocabulary # the words, and what existscordango vocabulary field # a field's properties and its typescordango vocabulary block calendar # what a calendar block accepts
That’s on purpose. Everything specific is one cordango inspect away, which keeps the instructions
from growing back into a copy of the whole schema.
Every command accepts --json. cordango help --json is how an agent discovers the command
surface without a human pasting a README into its context.
{"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":"cli/workspace","slug":"/cli/workspace","pageMetadata":{"title":"Workspace layout","description":"What cordango new writes, and what belongs in git.","href":"/cli/workspace"},"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: \"What cordango new writes, and what belongs in git.\"\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={code:`code`,p:`p`,pre:`pre`,span:`span`,..._provideComponents(),...props.components},{CodeBlock,Heading,Tip}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Tip)_missingMdxReference(`Tip`,true);return _jsxs(_Fragment,{children:[_jsx(CodeBlock,{numberOfLines:`15`,language:`text`,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:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`15`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`acme/`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` cordango.yaml the workspace: its name, and the apps it holds`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` apps/`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` support/`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` *.cordango.yaml semantic source, one file per aggregate`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` custom/ this app's own code, when it has any`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` generated/`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` support/ the generated application, one directory per app. Not committed.`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` .cordango/ build output. Not committed.`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` README.md`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` CLAUDE.md`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` AGENTS.md`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` .gitignore`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` .gitattributes`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),`\n`,_jsx(Heading,{level:`2`,id:`the-source-files`,children:`The source files`}),`\n`,_jsxs(_components.p,{children:[`Semantic source lives in `,_jsx(_components.code,{children:`.cordango.yaml`}),` files, one per aggregate: an entity, a lifecycle, a role,\na screen. They’re the source of truth, and they’re meant to be read, reviewed and diffed.`]}),`\n`,_jsx(_components.p,{children:`Editing them directly is fine. They describe what a thing is, not how it runs.`}),`\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:[_jsx(_components.code,{children:`fmt`}),` rewrites every `,_jsx(_components.code,{children:`.cordango.yaml`}),` file in canonical form, so a diff shows a change in meaning\ninstead of a change in whitespace or key order.`]}),`\n`,_jsx(Heading,{level:`2`,id:`the-build-directories`,children:`The build directories`}),`\n`,_jsxs(_components.p,{children:[`Two, and neither is committed. `,_jsx(_components.code,{children:`cordango new`}),` writes a `,_jsx(_components.code,{children:`.gitignore`}),` that already excludes both.`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`.cordango/`}),` with the leading dot holds the definition artifacts — the compiled App Definition and\nits manifest. `,_jsx(_components.code,{children:`cordango build`}),` regenerates it.`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`generated/`}),` holds the applications themselves, one directory per app, so a workspace with `,_jsx(_components.code,{children:`support`}),`\nand `,_jsx(_components.code,{children:`billing`}),` in it builds to `,_jsx(_components.code,{children:`generated/support/`}),` and `,_jsx(_components.code,{children:`generated/billing/`}),`. There is no `,_jsx(_components.code,{children:`--out`}),`:\nwhere the output goes is not a decision anybody has to make twice. It’s ordinary source code and\nit’s reproducible from the `,_jsx(_components.code,{children:`apps/`}),` directory beside it, which is why it stays out of git — and\nmoving a directory out of the workspace is how an application leaves.`]}),`\n`,_jsx(Heading,{level:`2`,id:`agent-instructions`,children:`Agent instructions`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`cordango new`}),` writes `,_jsx(_components.code,{children:`CLAUDE.md`}),` and `,_jsx(_components.code,{children:`AGENTS.md`}),` with the same generated text. Two conventions, two\nfilenames. Both get written because a workspace that taught two agents different rules would end up\nwith source only one of them could maintain.`]}),`\n`,_jsx(_components.p,{children:`They teach the workflow rather than the schema. An agent arrives knowing how to find out:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`6`,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:`6`,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:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:` # the apps in this workspace`})]}),`\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:`#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 app`})]}),`\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`,_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:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:` # the words, and what exists`})]}),`\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:` field`}),_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:` # a field's properties and its types`})]}),`\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:` calendar`}),_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:` # what a calendar block accepts`})]}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`That’s on purpose. Everything specific is one `,_jsx(_components.code,{children:`cordango inspect`}),` away, which keeps the instructions\nfrom growing back into a copy of the whole schema.`]}),`\n`,_jsx(Tip,{children:_jsxs(_components.p,{children:[`Every command accepts `,_jsx(_components.code,{children:`--json`}),`. `,_jsx(_components.code,{children:`cordango help --json`}),` is how an agent discovers the command\nsurface without a human pasting a README into its context.`]})})]})}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":"Workspace layout","description":"What cordango new writes, and what belongs in git.","href":"/cli/workspace"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"The source files","slug":"the-source-files","depth":2,"children":[]},{"title":"The build directories","slug":"the-build-directories","depth":2,"children":[]},{"title":"Agent instructions","slug":"agent-instructions","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"cordango","siteName":"Cordango","title":"Workspace layout - Cordango","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-09-12T18:15:15.760Z","originalFileLocation":"cli/workspace.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=\"What cordango new writes, and what belongs in git.\">\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=\"Workspace layout - Cordango\">\u003cmeta data-mint-head property=\"og:description\" content=\"What cordango new writes, and what belongs in git.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Cordango\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.cordango.com/cli/workspace\">\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=CLI\u0026amp;title=Workspace+layout\u0026amp;description=What+cordango+new+writes%2C+and+what+belongs+in+git.\u0026amp;theme=726d7292d81e7ed559f5aead\u0026amp;signature=1f7da9edc4c02c275e274cf7b115edb3c030fdb55fd2c981d183236b3dafd40a\">\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=\"Workspace layout - Cordango\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"What cordango new writes, and what belongs in git.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://cordango.mintlify.site/_mintlify/api/og/v2?division=CLI\u0026amp;title=Workspace+layout\u0026amp;description=What+cordango+new+writes%2C+and+what+belongs+in+git.\u0026amp;theme=726d7292d81e7ed559f5aead\u0026amp;signature=1f7da9edc4c02c275e274cf7b115edb3c030fdb55fd2c981d183236b3dafd40a\">\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/cli/workspace\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/cli/workspace.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/cli/workspace#webpage\",\"url\":\"https://docs.cordango.com/cli/workspace\",\"name\":\"Workspace layout\",\"description\":\"What cordango new writes, and what belongs in git.\",\"dateModified\":\"2026-09-12T18:15:15.760Z\",\"isPartOf\":{\"@id\":\"https://docs.cordango.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.cordango.com/cli/workspace#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.cordango.com/cli/workspace#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"CLI\",\"item\":\"https://docs.cordango.com/cli/install\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Workspace layout\",\"item\":\"https://docs.cordango.com/cli/workspace\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.cordango.com/cli/workspace#article\",\"headline\":\"Workspace layout\",\"name\":\"Workspace layout\",\"description\":\"What cordango new writes, and what belongs in git.\",\"url\":\"https://docs.cordango.com/cli/workspace\",\"mainEntityOfPage\":{\"@id\":\"https://docs.cordango.com/cli/workspace#webpage\"},\"dateModified\":\"2026-09-12T18:15:15.760Z\",\"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":"/cli/workspace.md","siteName":"Cordango","nav":{"global":null,"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":""}]},{"tab":"CLI","groups":[{"group":"CLI","pages":[{"title":"Install","href":"/cli/install"},{"title":"Command reference","description":"Every cordango command in this build.","href":"/cli/commands"},{"title":"Workspace layout","href":"/cli/workspace"},{"title":"Publishing","description":"Connect a workspace to a Cordango instance and make an app live.","href":"/cli/publish"}]}]},{"tab":"API reference","pages":[{"title":"API reference","href":"/api-reference/introduction"}]},{"tab":"MCP","pages":[{"title":"MCP","href":"/mcp/overview"}]}]},"basePath":"","title":"Workspace layout - Cordango","deploymentId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","buildId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","dynamics":[],"chunks":[]}