release: v0.3.0

Author: techninja

.github/workflows/release.yml

@@ -47,7 +47,7 @@ jobs:
           echo "EOF" >> "$GITHUB_OUTPUT"
 
       - name: Create GitHub Release
-        uses: softprops/action-gh-release@v2
+        uses: softprops/action-gh-release@v3
         with:
           body: |
             ## Changes

CHANGELOG.md

@@ -6,6 +6,11 @@ Format based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 
 ## [Unreleased]
 
+## [0.3.0] - 2026-04-03
+
+- Initial release
+
+
 ## [0.2.21] - 2026-04-03
 
 - Logo and vscode colors

lib/init.js

@@ -3,7 +3,7 @@
  * @module lib/init
  */
 
-import { existsSync, readFileSync } from 'node:fs';
+import { copyFileSync, existsSync, readFileSync } from 'node:fs';
 import { basename, resolve } from 'node:path';
 import { copyTemplates } from './copy.js';
 import { writePackageJson } from './package-gen.js';
@@ -67,7 +67,15 @@ export async function init(pkgRoot, opts = {}) {
   await copyTemplates(templateDir, mode, dest, vars);
   await writePackageJson(dest, vars, existingPkg);
 
+  // Copy .env → .env.local for immediate editing
+  const envPath = resolve(dest, '.env');
+  const localPath = resolve(dest, '.env.local');
+  if (existsSync(envPath) && !existsSync(localPath)) {
+    copyFileSync(envPath, localPath);
+    console.log('  ✓ .env.local (edit this, .env has defaults)');
+  }
+
   console.log(`\n✅ Project scaffolded at ${dest}`);
   console.log('   npm install');
-  console.log(mode === 'fullstack' ? '   npm run dev\n' : '   npx serve public\n');
+  console.log('   npm run dev\n');
 }

lib/package-gen.js

@@ -18,7 +18,7 @@ export async function writePackageJson(dest, vars, existing) {
 
   const specScripts = {
     start: 'node src/server.js',
-    dev: 'node --watch --env-file=.env src/server.js',
+    dev: 'node --watch --env-file=.env --env-file=.env.local src/server.js',
     postinstall: 'node scripts/setup.js',
     test: 'node scripts/test.js',
     spec: 'clearstack',

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@techninja/clearstack",
-  "version": "0.2.21",
+  "version": "0.3.0",
   "type": "module",
   "description": "A no-build web component framework specification — scaffold, validate, and evolve spec-compliant projects",
   "bin": {
@@ -18,7 +18,7 @@
   },
   "scripts": {
     "start": "node src/server.js",
-    "dev": "node --watch --env-file=.env src/server.js",
+    "dev": "node --watch --env-file=.env --env-file=.env.local src/server.js",
     "setup": "node scripts/vendor-deps.js && node scripts/build-icons.js",
     "test": "node --test tests/*.test.js src/utils/*.test.js src/store/*.test.js",
     "spec": "node --env-file=.env scripts/spec.js",