Cycles
Design · c2

Layer Separation & Project Identity

archivedcross-repo — www.qpoint.iocreated February 2026· last activity 2026-09-11

Why

The styleguide was serving three roles: distributable design system, brand knowledge base, and showcase website. The isSite conditional config pattern was accidental complexity signaling these roles wanted to be separate.

Objective

Split the Nuxt Layer out of the styleguide into its own repo (q-nuxt-layer/), making the styleguide an honest consumer of its own design system.

What Was Done

  • Created q-nuxt-layer/ repo with shared components, composables, CSS, and tokens
  • Removed all isSite conditional logic — layer config is now unconditional (~25 lines)
  • Rewrote styleguide's nuxt.config.ts to a standard Nuxt app with extends
  • Renamed package from @qpoint-io/design to @qpoint-io/q-nuxt-layer
  • Updated all consumer references

Outcome

Two repos with clear identities:

  • q-nuxt-layer/ — Distributable Nuxt Layer (@qpoint-io/q-nuxt-layer v0.2.0). 19 files, 8.7 KB packed.
  • styleguide/ — Brand knowledge base, MCP server, and showcase site. Consumes the layer like any other project.

Qpoint Brand Style Guide