Sanity × Nuxt UI
Docs

Project structure

Where everything lives in the two apps.
apps/├─ studio/      Sanity Studio└─ web/         Nuxt sitedocs/           these guides, imported into the Docs collection

Studio (apps/studio)

schemaTypes/├─ documents/   page, collection, entry, author, settings├─ objects/     link, seo, blockContent, table, pageBuilder, codeGroup, featureItem├─ blocks/      one file per page-builder block└─ shared/      field helpers (icon, image, orientation, code, languages)presentation/   where each document appears on the site (Presentation tool)scripts/├─ seed.ts      example content├─ docs.ts      Markdown guides → Docs collection└─ lib/         Markdown → Portable Text converter, docs importerstructure.ts    the Studio menusanity.config.ts

Site (apps/web)

app/├─ pages/[...slug].vue      resolves every URL: page, collection or entry├─ app.vue                  header, footer, languages, site-wide SEO├─ components/│  ├─ blocks/               Block*.vue, one per block│  ├─ PageBlocks.vue        block registry│  ├─ CollectionView.vue    collection list page│  ├─ EntryList.vue         blog, cards, gallery and docs layouts│  ├─ EntryView.vue         entry page (docs sidebar, TOC, related entries)│  ├─ PortableText.vue      rich text renderer│  ├─ CodeBlock.vue         code blocks with Shiki│  ├─ LanguageSwitcher.vue  Nuxt UI LocaleSelect│  ├─ SiteSearch.vue        search palette│  └─ OgImage/              generated social image├─ composables/             usePageSeo, useSanityImage, useSiteLanguage├─ utils/                   queries.ts (GROQ), language, labels, links, toc└─ assets/css/main.css      theme and motion utilitiesmodules/ui-locales.ts       lazy Nuxt UI localesserver/├─ api/highlight.post.ts    syntax highlighting├─ api/__sitemap__/urls.ts  sitemap entries from Sanity└─ preview/                 preview routes that skip the Vercel cacheprerender-routes.ts         every URL, for hybrid and static buildssanity.types.ts             generated by pnpm typegennuxt.config.ts

How a request is served

  1. Every URL hits app/pages/[...slug].vue.
  2. The language prefix, if any, is taken off the path (/id/blog/post → language id, path blog/post).
  3. ROUTE_QUERY looks for a page, a collection and an entry matching the path in one request.
  4. The page renders PageBlocks, CollectionView or EntryView; a miss is a 404.

Header, footer and settings come from SETTINGS_QUERY in app.vue, which runs before the page.

Installation

Set up the template locally, connect it to a Sanity project and add the example content.

Content model

The document types, how URLs map to them, and why entries are generic.