[{"data":1,"prerenderedAt":759},["ShallowReactive",2],{"navigation_docs":3,"-setup-troubleshooting":217,"-setup-troubleshooting-surround":754},[4,25,41,84,126,165,201],{"title":5,"icon":6,"path":7,"stem":8,"children":9,"page":24},"Overview","i-lucide-house","\u002Fgetting-started","1.getting-started",[10,14,19],{"title":11,"path":12,"stem":13,"icon":6},"Introduction","\u002Fgetting-started\u002Fintroduction","1.getting-started\u002F2.introduction",{"title":15,"path":16,"stem":17,"icon":18},"Installation","\u002Fgetting-started\u002Finstallation","1.getting-started\u002F3.installation","i-lucide-download",{"title":20,"path":21,"stem":22,"icon":23},"Project structure","\u002Fgetting-started\u002Fproject-structure","1.getting-started\u002F4.project-structure","i-lucide-folder-tree",false,{"title":26,"icon":27,"path":28,"stem":29,"children":30,"page":24},"Architecture","i-lucide-cpu","\u002Farchitecture","3.architecture",[31,36],{"title":32,"path":33,"stem":34,"icon":35},"Core, themes, and apps","\u002Farchitecture\u002Foverview","3.architecture\u002F1.overview","i-lucide-layers",{"title":37,"path":38,"stem":39,"icon":40},"Kits and extension modules","\u002Farchitecture\u002Fkits","3.architecture\u002F3.kits","i-lucide-puzzle",{"title":42,"icon":43,"path":44,"stem":45,"children":46,"page":24},"Apps","i-lucide-app-window","\u002Fapps","4.apps",[47,51,55,60,64,69,74,79],{"title":5,"path":48,"stem":49,"icon":50},"\u002Fapps\u002Foverview","4.apps\u002F1.overview","i-lucide-info",{"title":52,"path":53,"stem":54,"icon":23},"Package layout","\u002Fapps\u002Fpackage-layout","4.apps\u002F2.package-layout",{"title":56,"path":57,"stem":58,"icon":59},"Create from scratch","\u002Fapps\u002Fcreate-from-scratch","4.apps\u002F3.create-from-scratch","i-lucide-list-checks",{"title":61,"path":62,"stem":63,"icon":40},"Module and runtime","\u002Fapps\u002Fmodule-and-runtime","4.apps\u002F4.module-and-runtime",{"title":65,"path":66,"stem":67,"icon":68},"Plugins","\u002Fapps\u002Fplugins","4.apps\u002F5.plugins","i-lucide-plug",{"title":70,"path":71,"stem":72,"icon":73},"Windows and commands","\u002Fapps\u002Fwindows-and-commands","4.apps\u002F6.windows-and-commands","i-lucide-layout-panel-top",{"title":75,"path":76,"stem":77,"icon":78},"Playground","\u002Fapps\u002Fplayground","4.apps\u002F7.playground","i-lucide-flask-conical",{"title":80,"path":81,"stem":82,"icon":83},"Build and publish","\u002Fapps\u002Fbuild-and-publish","4.apps\u002F8.build-and-publish","i-lucide-package",{"title":85,"icon":86,"path":87,"stem":88,"children":89,"page":24},"Themes","i-lucide-palette","\u002Fthemes","5.themes",[90,93,98,102,106,111,116,121],{"title":5,"path":91,"stem":92,"icon":50},"\u002Fthemes\u002Foverview","5.themes\u002F1.overview",{"title":94,"path":95,"stem":96,"icon":97},"Theme anatomy","\u002Fthemes\u002Ftheme-anatomy","5.themes\u002F2.theme-anatomy","i-lucide-component",{"title":99,"path":100,"stem":101},"Create From Scratch","\u002Fthemes\u002Fcreate-from-scratch","5.themes\u002F3.create-from-scratch",{"title":103,"path":104,"stem":105,"icon":68},"Theme plugins","\u002Fthemes\u002Fplugins","5.themes\u002F4.plugins",{"title":107,"path":108,"stem":109,"icon":110},"Styling and Tailwind","\u002Fthemes\u002Fstyling-and-tailwind","5.themes\u002F5.styling-and-tailwind","i-lucide-brush",{"title":112,"path":113,"stem":114,"icon":115},"Pages and boot flow","\u002Fthemes\u002Fpages-and-boot-flow","5.themes\u002F6.pages-and-boot-flow","i-lucide-power",{"title":117,"path":118,"stem":119,"icon":120},"Theme and optional modules","\u002Fthemes\u002Ftheme-and-optional-modules","5.themes\u002F7.theme-and-optional-modules","i-lucide-link",{"title":122,"path":123,"stem":124,"icon":125},"Window chrome and nav buttons","\u002Fthemes\u002Fwindow-chrome-and-nav-buttons","5.themes\u002F8.window-chrome-and-nav-buttons","i-lucide-square-mouse-pointer",{"title":127,"icon":128,"path":129,"stem":130,"children":131,"page":24},"Client & CLI","i-lucide-terminal","\u002Fsetup","6.setup",[132,136,141,146,151,156,161],{"title":133,"path":134,"stem":135,"icon":128},"desktop CLI","\u002Fsetup\u002Fdesktop-cli","6.setup\u002F1.desktop-cli",{"title":137,"path":138,"stem":139,"icon":140},"Package linking","\u002Fsetup\u002Fpackage-linking","6.setup\u002F2.package-linking","i-lucide-link-2",{"title":142,"path":143,"stem":144,"icon":145},"Monorepo and workspace","\u002Fsetup\u002Fmonorepo-workspace","6.setup\u002F3.monorepo-workspace","i-lucide-blocks",{"title":147,"path":148,"stem":149,"icon":150},"desktop.config.ts","\u002Fsetup\u002Fdesktop-config","6.setup\u002F4.desktop-config","i-lucide-file-code",{"title":152,"path":153,"stem":154,"icon":155},"Migrate themes, apps, and modules (3.3.2)","\u002Fsetup\u002Fmigrate-packages-3.3.2","6.setup\u002F5.migrate-packages-3.3.2","i-lucide-arrow-right-left",{"title":157,"path":158,"stem":159,"icon":160},"Migrate themes, apps, and modules (3.4)","\u002Fsetup\u002Fmigrate-packages-3.4","6.setup\u002F6.migrate-packages-3.4","i-lucide-arrow-up-right",{"title":162,"path":163,"stem":164},"Troubleshooting","\u002Fsetup\u002Ftroubleshooting","6.setup\u002F7.troubleshooting",{"title":166,"icon":167,"path":168,"stem":169,"children":170,"page":24},"Internals","i-lucide-book-open","\u002Finternals","7.internals",[171,176,181,186,191,196],{"title":172,"path":173,"stem":174,"icon":175},"Boot sequence","\u002Finternals\u002Fboot-sequence","7.internals\u002F1.boot-sequence","i-lucide-list-ordered",{"title":177,"path":178,"stem":179,"icon":180},"Stores and composables","\u002Finternals\u002Fstores-and-composables","7.internals\u002F2.stores-and-composables","i-lucide-database",{"title":182,"path":183,"stem":184,"icon":185},"Core components","\u002Finternals\u002Fcore-components","7.internals\u002F3.core-components","i-lucide-layout-grid",{"title":187,"path":188,"stem":189,"icon":190},"Dialog provider","\u002Finternals\u002Fdialog-provider","7.internals\u002F4.dialog-provider","i-lucide-message-square",{"title":192,"path":193,"stem":194,"icon":195},"Kernel contract","\u002Finternals\u002Fkernel-contract","7.internals\u002F5.kernel-contract","i-lucide-shield-check",{"title":197,"path":198,"stem":199,"icon":200},"Shell identity","\u002Finternals\u002Fshell-identity","7.internals\u002F6.shell-identity","i-lucide-user",{"title":202,"icon":203,"path":204,"stem":205,"children":206,"page":24},"Reference","i-lucide-book-marked","\u002Freference","8.reference",[207,212],{"title":208,"path":209,"stem":210,"icon":211},"Glossary","\u002Freference\u002Fglossary","8.reference\u002F1.glossary","i-lucide-book-a",{"title":213,"path":214,"stem":215,"icon":216},"Ecosystem","\u002Freference\u002Fuseful-links","8.reference\u002F2.useful-links","i-lucide-external-link",{"id":218,"title":162,"body":219,"description":320,"extension":748,"links":749,"meta":750,"navigation":751,"path":163,"seo":752,"stem":164,"__hash__":753},"docs\u002F6.setup\u002F7.troubleshooting.md",{"type":220,"value":221,"toc":731},"minimark",[222,225,230,234,242,265,291,309,314,361,369,375,407,413,437,454,459,479,485,489,522,526,559,563,587,594,626,630,656,660,700,706,727],[223,224],"hr",{},[226,227,229],"h2",{"id":228},"title-troubleshooting","title: Troubleshooting",[231,232,233],"p",{},"description: Checklist when install, boot, or module development fails.\nnavigation:\nicon: i-lucide-circle-help",[226,235,237,238],{"id":236},"nx-enoent-playgroundnuxttsconfigjson","Nx: ENOENT ",[239,240,241],"code",{},"playground\u002F.nuxt\u002Ftsconfig.json",[231,243,244,248,249,252,253,256,257,260,261,264],{},[245,246,247],"strong",{},"Symptom:"," ",[239,250,251],{},"pnpm run dev"," fails with ",[239,254,255],{},"Failed to process project graph"," and ",[239,258,259],{},"@nx\u002Fjs\u002Ftypescript"," cannot open ",[239,262,263],{},"…\u002Fplayground\u002F.nuxt\u002Ftsconfig.json",".",[231,266,267,270,271,274,275,278,279,282,283,286,287,290],{},[245,268,269],{},"Cause:"," Module\u002Ftheme playgrounds extend ",[239,272,273],{},".\u002F.nuxt\u002Ftsconfig.json",", which exists only after ",[239,276,277],{},"nuxt prepare"," (",[239,280,281],{},"dev:prepare","). Root ",[239,284,285],{},"postinstall"," runs ",[239,288,289],{},"prepare:stubs"," only, not every playground.",[231,292,293,296,297,300,301,304,305,308],{},[245,294,295],{},"Fix (desktop dev):"," The client ",[239,298,299],{},"nx.json"," excludes ",[239,302,303],{},"**\u002Fplayground\u002F**"," from the TypeScript plugin — run ",[239,306,307],{},"nx reset"," after pulling that change.",[231,310,311],{},[245,312,313],{},"Fix (work on a module playground):",[315,316,321],"pre",{"className":317,"code":318,"language":319,"meta":320,"style":320},"language-bash shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","pnpm --filter @owdproject\u002Fmodule-fs run dev:prepare\n# or: pnpm run prepare:modules\nnx reset\n","bash","",[239,322,323,345,352],{"__ignoreMap":320},[324,325,328,332,336,339,342],"span",{"class":326,"line":327},"line",1,[324,329,331],{"class":330},"sBMFI","pnpm",[324,333,335],{"class":334},"sfazB"," --filter",[324,337,338],{"class":334}," @owdproject\u002Fmodule-fs",[324,340,341],{"class":334}," run",[324,343,344],{"class":334}," dev:prepare\n",[324,346,348],{"class":326,"line":347},2,[324,349,351],{"class":350},"sHwdD","# or: pnpm run prepare:modules\n",[324,353,355,358],{"class":326,"line":354},3,[324,356,357],{"class":330},"nx",[324,359,360],{"class":334}," reset\n",[231,362,363,364,366,367,264],{},"Then ",[239,365,251],{}," (desktop) or the package’s own ",[239,368,251],{},[226,370,372,374],{"id":371},"desktopconfigts-not-found",[239,373,147],{}," not found",[376,377,378,394,404],"ul",{},[379,380,381,382,385,386,389,390,393],"li",{},"The file must live in the same ",[245,383,384],{},"root"," Nuxt uses as ",[239,387,388],{},"**rootDir","** (usually ",[239,391,392],{},"**desktop\u002F**",").",[379,395,396,397,400,401,264],{},"Legacy name ",[239,398,399],{},"**owd.config.ts**"," still works — prefer renaming to ",[239,402,403],{},"**desktop.config.ts**",[379,405,406],{},"Fix syntax errors: core throws with path and remediation text.",[226,408,410],{"id":409},"err_pnpm_workspace_pkg_not_found",[239,411,412],{},"ERR_PNPM_WORKSPACE_PKG_NOT_FOUND",[231,414,415,248,417,420,421,424,425,428,429,432,433,436],{},[245,416,269],{},[239,418,419],{},"**package.json**"," declares ",[239,422,423],{},"**\"some-pkg\": \"workspace:*\"**"," but that package is ",[245,426,427],{},"not"," in the pnpm workspace (no folder under ",[239,430,431],{},"packages\u002F*",", ",[239,434,435],{},"themes\u002F*",", etc.).",[231,438,439,248,442,445,446,449,450,453],{},[245,440,441],{},"Common case:",[239,443,444],{},"**@owdproject\u002Fmodule-fs**"," or ",[239,447,448],{},"**@owdproject\u002Fmodule-persistence**"," with ",[239,451,452],{},"**workspace:***"," after those modules were removed from the client monorepo.",[231,455,456],{},[245,457,458],{},"Fix:",[460,461,462,469,476],"ol",{},[379,463,464,465,468],{},"Replace with npm semver: ",[239,466,467],{},"**\"@owdproject\u002Fmodule-fs\": \"^3.4.0\"**",", or",[379,470,471,472,475],{},"Run ",[239,473,474],{},"**desktop add module-fs --dev**"," to clone into the workspace, or",[379,477,478],{},"Remove the dependency if the feature is optional.",[231,480,481,482,264],{},"Full guide: ",[483,484,137],"a",{"href":138},[226,486,488],{"id":487},"app-missing-from-launcher","App missing from launcher",[376,490,491,498,508],{},[379,492,493,494,497],{},"Listed under ",[239,495,496],{},"**desktop.config.ts** → ","apps**`?",[379,499,500,501,256,504,507],{},"Dependency in ",[239,502,503],{},"**desktop\u002Fpackage.json**",[239,505,506],{},"**pnpm install**"," run?",[379,509,510,511,514,515,445,518,521],{},"For packages with ",[239,512,513],{},"**dist\u002F**",", run ",[239,516,517],{},"**pnpm run dev:prepare**",[239,519,520],{},"**prepare:stubs**","?",[226,523,525],{"id":524},"explorer-filesystem-does-nothing","Explorer \u002F filesystem does nothing",[376,527,528,537,544],{},[379,529,530,531,533,534,536],{},"Is ",[239,532,444],{}," in ",[239,535,496],{},"modules**`?",[379,538,539,540,543],{},"Does the theme install ",[239,541,542],{},"**@owdproject\u002Fkit-primevue**"," when filesystem features are needed?",[379,545,546,547,550,551,278,553,556,557,264],{},"Explorer ",[245,548,549],{},"UI state"," lives in ",[239,552,444],{},[239,554,555],{},"useExplorerStore","), and UI components live in ",[239,558,542],{},[226,560,562],{"id":561},"tailwind-classes-not-applied-in-a-module","Tailwind classes not applied in a module",[376,564,565,584],{},[379,566,567,568,571,572,575,576,579,580,583],{},"Call ",[239,569,570],{},"**registerTailwindPath**"," (imported from ",[239,573,574],{},"**@owdproject\u002Fkit-tailwind\u002Fkit\u002FregisterTailwindPath**",") in ",[239,577,578],{},"**module.ts**"," with globs covering your ",[239,581,582],{},"**.vue**"," files.",[379,585,586],{},"Restart the dev server after adding paths.",[226,588,590,593],{"id":589},"defuoverride-or-dialog-import-errors",[239,591,592],{},"defuOverride"," or dialog import errors",[376,595,596,609],{},[379,597,598,601,602,604,605,608],{},[239,599,600],{},"**defu**"," v6 exports ",[239,603,600],{}," only — use ",[239,606,607],{},"**defu(newConfig, existing)**"," for overrides (left wins).",[379,610,611,612,614,615,432,618,621,622,625],{},"Dialog contract is handled by ",[239,613,542],{},": ",[239,616,617],{},"**useDesktopDialogs**",[239,619,620],{},"**DESKTOP_DIALOG_PROVIDER_KEY**",". Themes install ",[239,623,624],{},"**kit-primevue**"," which registers the provider.",[226,627,629],{"id":628},"two-git-repos-on-one-folder","Two Git repos on one folder",[376,631,632],{},[379,633,634,635,638,639,642,643,432,646,649,650,653,654,264],{},"Nested ",[239,636,637],{},"**.git**"," under ",[239,640,641],{},"**themes\u002Fmy-theme**"," is expected when using gitignored clones. Pick one workflow: ",[245,644,645],{},"monorepo workspace clone",[245,647,648],{},"standalone repo + npm peers",", or ",[245,651,652],{},"git URL"," dependency — see ",[483,655,137],{"href":138},[226,657,659],{"id":658},"version-skew","Version skew",[376,661,662,694],{},[379,663,664,665,668,669,672,673,676,677,680,681,684,685,688,689,533,692,393],{},"Align ",[239,666,667],{},"**peerDependencies**"," on ",[239,670,671],{},"**@owdproject\u002Fcore**"," (^",[245,674,675],{},"3.4.0"," with current kernel). Mismatches surface as missing exports (",[239,678,679],{},"**CoreDesktop**"," renamed to ",[239,682,683],{},"**DesktopCore**"," in 3.3) or store moves (",[239,686,687],{},"**useDesktopExplorerStore**"," → ",[239,690,691],{},"**useExplorerStore**",[239,693,444],{},[379,695,471,696,699],{},[239,697,698],{},"**desktop validate .**"," in theme\u002Fapp repos before publish.",[226,701,703,705],{"id":702},"preparestubs-filters-missing-packages",[239,704,289],{}," filters missing packages",[376,707,708],{},[379,709,710,711,713,714,432,717,432,720,723,724,726],{},"Root ",[239,712,520],{}," targets ",[239,715,716],{},"**extend\u002Fpackages\u002F***",[239,718,719],{},"**apps\u002F***",[239,721,722],{},"**themes\u002F***",". If a script still references removed paths, update ",[239,725,419],{}," scripts at the repo root.",[728,729,730],"style",{},"html pre.shiki code .sBMFI, html code.shiki .sBMFI{--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B}html pre.shiki code .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}html pre.shiki code .sHwdD, html code.shiki .sHwdD{--shiki-light:#90A4AE;--shiki-light-font-style:italic;--shiki-default:#546E7A;--shiki-default-font-style:italic;--shiki-dark:#676E95;--shiki-dark-font-style:italic}html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}",{"title":320,"searchDepth":347,"depth":347,"links":732},[733,734,736,738,739,740,741,742,744,745,746],{"id":228,"depth":347,"text":229},{"id":236,"depth":347,"text":735},"Nx: ENOENT playground\u002F.nuxt\u002Ftsconfig.json",{"id":371,"depth":347,"text":737},"desktop.config.ts not found",{"id":409,"depth":347,"text":412},{"id":487,"depth":347,"text":488},{"id":524,"depth":347,"text":525},{"id":561,"depth":347,"text":562},{"id":589,"depth":347,"text":743},"defuOverride or dialog import errors",{"id":628,"depth":347,"text":629},{"id":658,"depth":347,"text":659},{"id":702,"depth":347,"text":747},"prepare:stubs filters missing packages","md",null,{},true,{"description":320},"kC8YKDeE-Jw0H17Dwhce7dV8-iR8f9sDMCDNh5g6DvM",[755,757],{"title":157,"path":158,"stem":159,"description":756,"icon":160,"children":-1},"Upgrade checklist for OWD Core 3.4 (PrimeVue extraction, Kit-PrimeVue, module-fs, and store ID renames).",{"title":172,"path":173,"stem":174,"description":758,"icon":175,"children":-1},"Order of operations when @owdproject\u002Fcore loads.",1782171656867]