egdev-design-system

mcp
Security Audit
Fail
Health Warn
  • License — License: MIT
  • Description — Repository has a description
  • Active repo — Last push 0 days ago
  • Low visibility — Only 6 GitHub stars
Code Fail
  • rm -rf — Recursive force deletion command in .github/workflows/code-safety.yml
  • fs module — File system access in .github/workflows/code-safety.yml
  • process.env — Environment variable access in .github/workflows/issue-lifecycle.yml
  • fs module — File system access in .github/workflows/issue-lifecycle.yml
  • exec() — Shell command execution in .storybook/color-inventory.tsx
Permissions Pass
  • Permissions — No dangerous permissions requested

No AI report is available for this listing yet.

SUMMARY

EGDEV design system: design tokens, React components on Radix UI, web effects, an offline MCP server and the egdev-ds CLI, shipped as local tarballs.

README.md

English Español

egdev-design-system banner

Stars
Issues
License

egdev-design-system

EGDEV Foundation in code: the design system shared by egdev.es and every egdev tool (Mando, Cadencia, egdev-live, Criterio, media-tool and Quorb).

What is it

A pnpm monorepo with six packages: design tokens, React components built on Radix UI, web effect layers, a generated design-system description, an offline MCP server over that description, and egdev-ds, the CLI that installs, upgrades and checks the design system in a consumer app. Products receive it as versioned local tarballs, without a registry.

  • Foundation: React + Radix UI for behavior, token-backed CSS for appearance.
  • Design: decided in Claude Design (the EGDEV Foundation artifact) and handed over here.
  • Methodology: atomic design with primitives, inherited from the Stack & Flow Design System.
Package Version Role
@egdev/tokens 0.5.1 Tokens: a single CSS source, native CSS output and a Tailwind v4 theme.
@egdev/ui 0.3.2 Components on Radix UI: primitives, atoms, molecules, organisms and templates.
@egdev/effects 0.2.2 Web effect layers (particles, 3D isotype) on canvas and three.js.
@egdev/system 0.4.2 Data-only design-system.json describing an exact tokens/ui/effects set, plus the system.md and artboard check CLIs.
@egdev/mcp 0.4.2 Offline, read-only MCP server over the @egdev/system artifact.
@egdev/cli 0.1.1 egdev-ds: installs, upgrades and checks the design system in a consumer app.

Stack

React
TypeScript
Radix UI
Tailwind CSS
Storybook
Vite
Vitest
Biome
MCP
Node.js
pnpm

Quick start

Use it in an app

Apps install the six packages as tarballs from one pnpm release:pack run, using egdev-ds (@egdev/cli). The full guide, prerequisites (Node.js 24, pnpm or npm, Vite or Next.js) and a manual fallback are in docs/distribution/install.md.

# In this repository: build the release set into release/ (tarballs + release.json)
pnpm release:pack

# First run, from a design system checkout:
node <ds-repo>/packages/cli/bin/egdev-ds.mjs init <project>

# Then, from the app (npx egdev-ds … or pnpm exec egdev-ds …):
egdev-ds upgrade <project> --dry-run    # plan plus the changelog of every package
egdev-ds upgrade <project>              # move the whole set to a newer release
egdev-ds upgrade <project> --add cli    # also vendor a package the app lacks
egdev-ds doctor <project>               # check the vendored install, CSS imports and MCP wiring
egdev-ds status <project> --json        # read-only report of the vendored state

The approved CLI design is docs/distribution/egdev-ds-cli.md; the flag reference is packages/cli/README.md.

Work on the design system

Requires Node.js 24 and pnpm 10.34.6 (packageManager).

pnpm install
pnpm tokens        # compile native CSS from the theme.css source
pnpm storybook     # http://127.0.0.1:6006
pnpm test          # full Vitest suite; at most two workers by default
pnpm typecheck
pnpm build

Scripts

Command What it does
pnpm storybook Compiles tokens and starts Storybook on port 6006.
pnpm test Runs the Vitest suite with two workers.
pnpm typecheck Type-checks the root and every package.
pnpm lint Runs Biome checks (pnpm format applies fixes).
pnpm build Builds every package.
pnpm tokens Compiles tokens.css from theme.css.
pnpm test:tokens Compiles and checks the source, aliases and parity.
pnpm release:pack Builds the workspace and writes the release tarballs and release.json to release/.
pnpm test:cli Runs the egdev-ds tests.
pnpm test:cli:consumer Runs egdev-ds end to end (npm + Vite, pnpm + Next.js).
pnpm artifact Builds the @egdev/system design-system artifact.
pnpm system:docs Regenerates system.md.
pnpm props:check Validates the prop naming registry.

pnpm test uses a two-worker default budget, including when the unchanged pre-push hook invokes it. Test selection, assertions and timeouts are unchanged; watch and coverage commands retain their existing behavior.

CI (.github/workflows/build-and-test.yml) runs two jobs: Verify (lint, prop naming, typecheck, build, unit, CLI, token and package tests) and egdev-ds end to end.

Architecture

  • Architecture (Spanish): packages, levels, Radix and styles.
  • Material (Spanish): surfaces, light edge, shadows, wells and overlays (Material v2).
  • Cataloging (Spanish): reuse, variant or new component, and at which level.
  • Catalog (Spanish): every EGDEV Foundation component with its level, package and Radix base.
  • Decisions (Spanish): copy of the EGDEV Foundation decision log.
  • Handover plan (Spanish): the historical phase order.

Contributing

Planned work follows ODD. The active roadmap index is issue #491 (website backlog). Read CONTRIBUTING.md before starting.

Agents: AGENTS.md summarizes the rules; the detailed flows live in skills/.

Resources

License

MIT. Third-party notices are in THIRD_PARTY_NOTICES.md.

Contact

Web
YouTube
Twitch
X
LinkedIn
Instagram
GitHub
Discord
Gmail


⭐ If you find this project useful, consider giving it a star on GitHub ⭐

Reviews (0)

No results found