zeus-css 1.0.2 → 1.0.3

package/CHANGELOG.md

@@ -6,10 +6,8 @@ documented in [`API.md`](API.md).
 
 ## [Unreleased]
 
-Working toward the `1.0.0` tag — not yet published (no npm release, no git
-tag exists as of this entry). [`API.md`](API.md) documents the intended
-public API surface; semver will become binding once `1.0.0` is actually
-published, not before.
+Published to npm as `zeus-css`. [`API.md`](API.md) documents the public API
+surface this changelog's semver contract is now binding against.
 
 ### Removed (since first written)
 - **Dark mode**, entirely — `$zeus-dark-mode-strategy` and

package/README.md

@@ -18,29 +18,33 @@ import 'zeus-css/dist/zeus.css';
 ```
 
 ### 2. Configure Your Custom Theme (Optional)
-Generate the configuration file by running the init command in your project root:
+Generate the configuration files by running the init command in your project root:
 
 ```bash
 npx zeus-css init
 ```
 
-This will create a `zeus.config.scss` in your project. You can override colors, spacing, fonts, and more using OKLCH:
+This creates three files: `zeus.config.scss` (structural settings — breakpoints, feature toggles), `zeus.customize.scss` (design tokens — colors, spacing, typography), and a generated `zeus.scss` bridge that wires your overrides into the framework. Override colors and other tokens in `zeus.customize.scss`, using OKLCH:
 
 ```scss
-// zeus.config.scss
+// zeus.customize.scss
 $zeus-colors: (
   "primary": oklch(57.9% 0.232 259.6),
   "secondary": oklch(74.7% 0.174 60.6)
 ) !default;
+```
+
+Then import your local bridge instead of the package directly:
 
-@forward "zeus-css/scss/zeus.scss";
+```scss
+@use "./zeus.scss" as *;
 ```
 
 ### 3. Use CSS Variables in CSS Modules
-Thanks to the framework's token generation, you can natively use the fluid CSS variables everywhere:
+Thanks to the framework's token generation, you can natively use the fluid CSS variables everywhere. If you ran `zeus-css init` (step 2), import your local bridge (`./zeus.scss`); otherwise import the package directly:
 
 ```scss
-@use "zeus-css/scss/zeus.scss" as *;
+@use "zeus-css/scss/zeus.scss" as *; // or "./zeus.scss" if you ran init
 
 .card {
   padding: var(--space-md) var(--space-lg);
@@ -54,6 +58,8 @@ Thanks to the framework's token generation, you can natively use the fluid CSS v
 }
 ```
 
+> **Note:** Bundlers (Next.js, Vite, webpack `sass-loader`) resolve `zeus-css/...` imports automatically. Compiling with the plain `sass` CLI instead requires `--load-path=node_modules`.
+
 ## ⚠️ Optimizing for Production (Crucial)
 Zeus CSS ships with thousands of utility classes to give you absolute freedom during development. For production builds, you **must** use PurgeCSS to remove unused selectors and keep your CSS payload tiny.
 

package/package.json

@@ -1,9 +1,10 @@
 {
   "name": "zeus-css",
-  "version": "1.0.2",
+  "version": "1.0.3",
   "description": "⚡ A Premium, Zero-Emission, Fluid-Scaling CSS Framework based on Sass SCSS Engine",
   "author": "Stavros Lazaris",
   "license": "MIT",
+  "homepage": "https://www.npmjs.com/package/zeus-css",
   "main": "./dist/zeus.css",
   "style": "./dist/zeus.css",
   "bin": {