Skip to main content
The repository is an npm workspaces monorepo with two packages: astro-app (the Astro frontend) and studio (Sanity Studio). Shared tooling — Playwright, semantic-release, GitHub Actions — lives at the repo root.

​
Full directory tree

astro-shadcn-sanity/
├── astro-app/                        # Astro frontend (SSG + selective SSR)
│   ├── astro.config.mjs              # output: 'static', Tailwind, Sanity, Cloudflare adapter
│   ├── components.json               # shadcn CLI config pointing to @fulldev registry
│   ├── package.json                  # astro-app workspace package
│   └── src/
│       ├── components/
│       │   ├── ui/                   # fulldev/ui primitives (button, badge, section, etc.)
│       │   ├── blocks/               # fulldev/ui template block variants (100+)
│       │   │   └── custom/           # Custom CMS-connected blocks (23)
│       │   ├── portal/               # React-hydrated portal components (8)
│       │   ├── block-registry.ts     # Auto-discovers all blocks via import.meta.glob()
│       │   ├── BlockRenderer.astro   # Dispatches block._type → component + spread props
│       │   ├── BlockWrapper.astro    # Applies spacing, background, maxWidth from blockBaseFields
│       │   ├── Header.astro          # Site header (site settings driven)
│       │   ├── Footer.astro          # Site footer (site settings driven)
│       │   └── Breadcrumb.astro      # Auto-generated breadcrumbs
│       ├── layouts/
│       │   └── BaseLayout.astro      # Root HTML shell: head, header, footer, slot
│       ├── lib/
│       │   ├── sanity.ts             # Sanity client, all GROQ queries, block resolvers
│       │   ├── types.ts              # Generated TypeScript types (do not edit manually)
│       │   ├── drizzle-schema.ts     # D1 auth database schema (Drizzle ORM)
│       │   ├── image.ts              # urlFor() image URL builder
│       │   └── utils.ts             # cn() and other shared utilities
│       ├── pages/
│       │   ├── index.astro           # Home page (SSG)
│       │   ├── [...slug].astro       # CMS-driven pages (SSG)
│       │   ├── sponsors/             # Sponsor listing + detail (SSG)
│       │   ├── projects/             # Project listing + detail (SSG)
│       │   ├── events/               # Event listing + detail (SSG)
│       │   ├── portal/               # Authenticated portal pages (SSR)
│       │   ├── student/              # Student dashboard (SSR)
│       │   ├── auth/                 # Auth entry page (SSR)
│       │   └── api/                  # API endpoints (SSR)
│       └── styles/
│           └── global.css            # @import "tailwindcss" + theme tokens + CSS variables
├── studio/                           # Sanity Studio (CMS)
│   ├── package.json                  # studio workspace package
│   └── src/
│       └── schemaTypes/
│           ├── blocks/               # Block object schemas (one file per block)
│           ├── documents/            # Document schemas: page, sponsor, project, etc.
│           │   ├── page.ts
│           │   ├── site-settings.ts
│           │   ├── sponsor.ts
│           │   ├── project.ts
│           │   ├── testimonial.ts
│           │   ├── event.ts
│           │   └── submission.ts
│           ├── objects/              # Shared objects: seo, button, link, portableText, etc.
│           ├── helpers/
│           │   └── defineBlock.ts    # Factory helper — adds shared base fields to every block
│           └── index.ts             # Exports all schema types; registers documents + blocks
├── tests/                            # Playwright E2E test suite
│   ├── e2e/                          # Full browser tests (14 files × 5 browsers)
│   └── integration/                  # Schema + module import tests (22 files)
├── .github/workflows/                # GitHub Actions
│   ├── ci.yml                        # PR checks: unit tests + Lighthouse CI
│   ├── release.yml                   # semantic-release on main
│   ├── sync-preview.yml              # Auto-sync preview ← main after release
│   ├── deploy-storybook.yml          # Storybook → GitHub Pages
│   └── enforce-preview-only.yml      # Blocks direct pushes to main from non-preview
├── docs/                             # Developer guides and architecture docs
├── package.json                      # Root workspace: dev script, test scripts, Playwright
├── playwright.config.ts              # 5 browser projects + axe-core a11y config
├── .releaserc.json                   # semantic-release: version bump + changelog + sync
└── CHANGELOG.md                      # Auto-generated by semantic-release (do not edit)

​
Key directories

astro-app/src/components/blocks/custom/

23 CMS-connected custom blocks. Each is an .astro file that imports from ui/ primitives and receives flat spread props matching the Sanity block schema. Auto-discovered by block-registry.ts — no manual registration.

astro-app/src/components/ui/

fulldev/ui primitives installed via the shadcn CLI (npx shadcn@latest add @fulldev/{name}). These are owned copies — not installed as npm dependencies — so they can be modified freely.

studio/src/schemaTypes/

All Sanity schemas. Documents define top-level content types. Blocks define page builder sections. Objects are shared field groups. The defineBlock helper merges block-base fields (spacing, background, maxWidth) into every block automatically.

astro-app/src/lib/sanity.ts

Single source of truth for all GROQ queries. Uses defineQuery() for type safety. Contains the Sanity client config and block resolver functions that hydrate display-mode blocks (e.g., resolveBlockSponsors()).

astro-app/src/pages/portal/

All pages here export export const prerender = false. The Cloudflare Worker runs auth middleware before each handler. Astro.locals.user carries the validated session.

tests/

Playwright config at repo root runs E2E tests across 5 browser/device projects (Chromium, Firefox, WebKit, Pixel 7, iPhone 14). Integration tests validate schema correctness without a browser.

​
Key files

FilePurpose
astro-app/src/components/block-registry.tsUses import.meta.glob() to auto-discover every .astro file in blocks/ and blocks/custom/. Maps filename (camelCased) to component. No manual registration needed.
astro-app/src/components/BlockRenderer.astroAccepts a block prop, looks it up in the registry, and renders <Component {...block} />. Single dispatch for all 130+ block types.
astro-app/src/components/BlockWrapper.astroWraps every block in a <section> with backgroundVariant, spacing, and maxWidth classes from block-base fields.
astro-app/src/lib/sanity.tsSanity client (CDN vs live), all defineQuery() GROQ queries, and block resolver functions.
studio/src/schemaTypes/helpers/defineBlock.tsMerges shared block-base fields into every block schema. Keeps block definitions DRY.
astro-app/astro.config.mjsSets output: 'static', registers @astrojs/cloudflare, @sanity/astro, @tailwindcss/vite, and @astrojs/react. Reads multi-site env vars.
.releaserc.jsonsemantic-release config: conventional commits → version bump → CHANGELOG → GitHub Release → preview sync → Discord.
playwright.config.tsDefines 5 browser projects, axe-core a11y plugin, and base URL for E2E tests.

Build docs developers (and LLMs) love

Get started for freeTalk to us