zeus-css 1.0.3 → 1.0.4

package/README.md

@@ -17,34 +17,30 @@ Import the pre-compiled global foundation (Reset, Variable pipeline, utility cla
 import 'zeus-css/dist/zeus.css';
 ```
 
-### 2. Configure Your Custom Theme (Optional)
-Generate the configuration files by running the init command in your project root:
+### 2. Generate Your Local Config
+Run the init command in your project root (you'll see a reminder for this after `npm install` too):
 
 ```bash
 npx zeus-css init
 ```
 
-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:
+This creates `zeus.config.scss` and `zeus.customize.scss` directly in your project — not buried in `node_modules` — so you can edit them like any other file. Skip this step only if you're happy with the default theme as-is. Override colors, spacing, fonts, and more using OKLCH:
 
 ```scss
-// zeus.customize.scss
+// zeus.config.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:
 
-```scss
-@use "./zeus.scss" as *;
+@forward "zeus-css/scss/zeus.scss";
 ```
 
 ### 3. Use CSS Variables in CSS Modules
-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:
+Thanks to the framework's token generation, you can natively use the fluid CSS variables everywhere:
 
 ```scss
-@use "zeus-css/scss/zeus.scss" as *; // or "./zeus.scss" if you ran init
+@use "zeus-css/scss/zeus.scss" as *;
 
 .card {
   padding: var(--space-md) var(--space-lg);
@@ -58,8 +54,6 @@ 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/bin/postinstall.js

@@ -0,0 +1,13 @@
+#!/usr/bin/env node
+try {
+  if (process.env.CI) {
+    process.exit(0);
+  }
+  console.log('');
+  console.log('⚡ Zeus CSS installed.');
+  console.log('   Run `npx zeus-css init` to get local zeus.config.scss / zeus.customize.scss files you can edit.');
+  console.log('   (Skip this if you only want the default theme via zeus-css/dist/zeus.css.)');
+  console.log('');
+} catch (e) {
+  // Never fail an install just because the reminder couldn't print.
+}

package/dist/zeus.css

@@ -8454,5 +8454,3 @@
   }
 }
 /* Zeus CSS v1.0.0 */
-
-/*# sourceMappingURL=zeus.css.map */