@enya-learning/nova 0.4.3 → 0.6.0

package/README.md

@@ -51,39 +51,28 @@ Import order matters — `@enya-learning/nova/styles` must come before
 > **Note:** The `@source` path is relative to your CSS file. Adjust it based on
 > your project structure.
 
-### Global CSS (optional)
-
-Nova ships a `globals.css` for base resets and font loading:
-
-```css
-@import "@enya-learning/nova/globals.css";
-```
-
 ## Styles architecture
 
-Nova's CSS is split across four files with distinct responsibilities:
+Nova's CSS is split across two files with distinct responsibilities:
 
-| File               | Role                                                                                                                                                                                                                        |
-| ------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `nova-binding.css` | Registers the raw palette into Tailwind's `@theme` — every `nova-*` colour stop and utilities like `--ease-bounce`. This is what makes `bg-nova-sky-500` work as a class.                                                   |
-| `theme-nova.css`   | Semantic tokens — maps palette stops to _meaning_ (`--color-nova-brand`, `--color-nova-success`, `--text-color-nova-subtle`, etc.) with `light-dark()` for automatic light/dark switching.                                  |
-| `nova.css`         | The bridge to shadcn — remaps shadcn's generic variables (`--primary`, `--background`, `--destructive`, etc.) onto nova semantic tokens so shadcn components pick up nova colours without modification.                     |
-| `globals.css`      | App entry point — imports Tailwind, fonts, shadcn base, and `nova.css`. Also sets `@theme inline` to wire shadcn colour vars into Tailwind's class system, defines the `dark` variant, and applies base body/border styles. |
+| File               | Role                                                                                                                                                                                                                      |
+| ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `nova-binding.css` | Registers the raw palette into Tailwind's `@theme` — every colour stop and utilities like `--ease-bounce`. This is what makes `bg-sky-500` work as a class.                                                               |
+| `nova.css`         | The single entry point — boots Tailwind, loads fonts, imports nova-binding, defines the semantic tokens (`--color-primary`, `--color-success`, etc. via `light-dark()`), the `dark` variant, and base body/border styles. |
 
 **Import chain:**
 
 ```
-globals.css → nova.css → nova-binding.css → theme-nova.css
+nova.css → nova-binding.css
 ```
 
 **Where to make changes:**
 
 - Adding a new colour stop → `nova-binding.css`
-- Adding or changing what a colour _means_ (e.g. a new `nova-brand-subtle`
-  surface) → `theme-nova.css`
+- Adding or changing what a colour _means_ (e.g. a new `brand-subtle` surface) →
+  `nova.css`'s semantic `@theme` block
 - Swapping which palette scale powers a semantic role (e.g. changing the brand
   variant) → `nova-binding.css` brand alias block
-- Mapping a new shadcn variable to nova → `nova.css`
 
 ---