@designa8/vibedesign-supabase-deepseek-176b 0.0.0-stage → 0.0.1

package/README.md

@@ -1,3 +1,40 @@
-# Temporary Holding Version
+# @designa8/vibedesign-supabase-deepseek-176b
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Complete design system generated by Atoms Design, version **0.0.1**.
+Tokens, atoms, molecules, organisms, and templates — import from the package root;
+never hardcode visual values in consumer code.
+
+## Install
+
+```bash
+npm install @designa8/vibedesign-supabase-deepseek-176b
+```
+
+## Imports
+
+```ts
+import { Button, Input } from "@designa8/vibedesign-supabase-deepseek-176b";
+```
+
+The CSS (design tokens, Tailwind utilities, and the design system font loaded
+from Google Fonts) is bundled into the package entry point and injected
+automatically by your bundler — no separate CSS import needed.
+
+## Global CSS compatibility
+
+The package's utility classes (spacing, colours, border-radius, etc.) are
+compiled as **unlayered** CSS rules. They therefore beat standard resets such
+as `* { margin: 0; padding: 0; box-sizing: border-box }` by normal specificity
+(class selector `0-1-0` > universal selector `0-0-0`). No special setup is
+needed for a typical Vite / Create-React-App / Next.js project.
+
+The one exception is the **body font**. The design system injects
+`body { font-family: var(--font-body) }` inside `@layer base`, which any
+unlayered `body { font-family: ... }` rule in your own CSS will override.
+Remove that override, or replace it with the design system variable:
+
+```css
+body {
+  font-family: var(--font-body); /* use the design system's configured font */
+}
+```