@economic/taco-docs

Design-system knowledge files for the e-conomic design system — component, foundation, and UI pattern documentation as plain Markdown.

These files are the source-verified "brain" of the design system: structured guidance on how each component, foundation, and pattern should be used, written for humans and AI tools alike. They are not a rendered docs site — they are the content other formats are generated from.

Install

npm install @economic/taco-docs

Contents

| Folder | What's in it | | -------------- | ------------------------------------------------------------------------------------------------------------- | | components/ | Per-component knowledge files (e.g. toast.md) — usage guidance, behaviour, accessibility, known limitations | | foundations/ | Design foundations (color, spacing, typography, etc.) | | patterns/ | UI patterns — how components combine to solve recurring problems |

Each file follows a consistent schema, leading with usage guidance.

Usage

The files are Markdown. Read them directly, feed them to an AI tool, or render them however you like. From a Node consumer they resolve under the package root:

import { readFileSync } from 'node:fs';
import { createRequire } from 'node:module';

const require = createRequire(import.meta.url);
const dir = require.resolve('@economic/taco-docs/package.json').replace(/package\.json$/, '');
const toast = readFileSync(`${dir}components/toast.md`, 'utf8');

License

MIT