revealui-architecture-guide

Document RevealUI monorepo structure with pnpm workspaces and Turborepo.

4|Updated Jan 3, 2026
One-click install
npx skills add https://github.com/RevealUIStudio/revealui --skill revealui-architecture-guide
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: revealui-architecture-guide
Source: https://github.com/RevealUIStudio/revealui/tree/main/.revealui/skills/revealui-architecture-guide
Command: npx skills add https://github.com/RevealUIStudio/revealui --skill revealui-architecture-guide

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Onboarding new engineers to the RevealUI monorepo is time-consuming without a clear map of apps, packages, and tooling. This guide consolidates structure and decisions to accelerate understanding and collaboration.

Core Features & Use Cases

  • Monorepo layout and tooling (pnpm workspaces, Turborepo) are documented to guide build and deployment.
  • Role definitions for core packages (@revealui/core, @revealui/db, @revealui/auth, @revealui/ui) and how they interact across apps (cms, dashboard).
  • Best practices for cross-package imports, dependency management, and development workflows.

Quick Start

Review the top-level apps and packages to orient yourself and begin exploring the codebase.

Frequently Asked Questions about revealui-architecture-guide

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I navigate a pnpm monorepo structure during developer onboarding?

Navigate a pnpm monorepo by reviewing the top-level apps and packages directories to orient yourself. This structure documents workspace boundaries, build tooling, and cross-package dependency rules to accelerate codebase understanding.

What is the best way to organize packages and apps in a Turborepo workspace?

Organize a Turborepo workspace by defining clear roles for core packages like @revealui/core and @revealui/ui, and mapping their interactions across apps like the dashboard. This separation streamlines build orchestration and cross-package imports.

How do cross-package dependencies work in a pnpm workspace?

Cross-package dependencies in a pnpm workspace are managed through established import rules and dependency management best practices. Defining how packages like @revealui/auth and @revealui/db interact ensures consistent development workflows.

Do I need Turborepo and pnpm workspaces to manage a monorepo for multiple apps?

Turborepo and pnpm workspaces are required to manage this monorepo architecture. They provide the necessary tooling for workspace configuration, build orchestration, and deployment across the cms and dashboard applications.

What are the limitations of managing cross-package imports in a monorepo?

Limitations of managing cross-package imports include potential boundary violations and dependency cycles. Adhering to documented dependency rules and package role definitions prevents architectural drift and maintains build stability.

Can I use this monorepo architecture guide to plan deployments for a dashboard and cms?

You can use this architecture guide to plan deployments for the dashboard and cms. It documents the monorepo layout, tooling, and package interactions required to execute build and deployment workflows effectively.