@refai.code/vite-boost 0.1.0 → 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Refai.Code
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,66 @@
+# @refai.code/vite-boost
+
+CLI tool to supercharge **Vite Vanilla JavaScript** projects.
+
+---
+
+## 🚀 What it does
+`vite-boost` helps you quickly scaffold and enhance a **Vite Vanilla JS** project with a clean architecture and optional features.
+
+### It can:
+- Create a clean project structure:
+  - `router/`, `pages/`, `components/`, `services/`, `utils/`, `styles/`
+- Optionally add:
+  - 🎨 TailwindCSS
+  - 📡 Axios (Fetch is default)
+  - 📱 PWA support
+  - 🗄️ JSON Server (`db.json` + dev scripts)
+
+---
+
+## 📦 Requirements
+- Node.js **>= 18**
+- A **Vite Vanilla JavaScript** project
+  (must contain: `package.json`, `index.html`, `src/`)
+
+> ❌ Not intended for React or TypeScript templates.
+
+---
+
+## ▶️ Usage (recommended)
+
+Inside your Vite project folder:
+
+```bash
+npm i -D @refai.code/vite-boost
+npx vite-boost
+```
+## ▶️ Run without installing
+
+```bash
+npx @refai.code/vite-boost
+```
+
+## 🏃 After running
+
+### Start dev server:
+
+```bash
+npm run dev
+```
+### If you enabled JSON Server:
+```bash
+npm run dev:full
+```
+
+## ⚠️ Important Notes
+
+- This tool targets Vanilla JavaScript only
+- Some files under src/ may be overwritten
+- Existing files are backed up before modification when possible
+- Safe to re-run (will not blindly duplicate router code)
+
+## 🧑‍💻 Author
+
+Created by **Refai.Code**
+CLI & tooling for modern Vite projects

package/bin/vite-boost

@@ -11,54 +11,216 @@ set -u
 # - Real JSON Server Auth (Users save to db.json)
 # - Concurrent Run (Vite + JSON Server)
 
-echo "\n🚀 \033[1;36mVite Boost: Refai.Code Final Edition\033[0m\n"
+# Handle exit vs return safely
+terminate() {
+  local code="${1:-0}"
+  # Check if we are being sourced
+  if [[ "$ZSH_EVAL_CONTEXT" == "toplevel" || "$ZSH_EVAL_CONTEXT" == "shfunc" ]]; then
+     return "$code" 2>/dev/null || exit "$code"
+  else
+     exit "$code"
+  fi
+}
+
+die()  { print -P "%F{red}❌ $*%f" >&2; terminate 1; }
+warn() { print -P "%F{yellow}⚠️  $*%f" >&2; }
+ok()   { print -P "%F{green}✅ $*%f"; }
+
+VERSION="0.1.0"
+
+# -----------------------------
+# Help / Version
+# -----------------------------
+if [[ "${1:-}" == "--help" || "${1:-}" == "-h" ]]; then
+  cat <<'EOF'
+vite-boost (Refai.Code)
+
+Usage:
+  npx vite-boost
+  npx vite-boost --help
+  npx vite-boost --version
+
+Notes:
+- Run inside a Vite Vanilla JS project folder (package.json, index.html, src/)
+EOF
+  terminate 0
+fi
+
+if [[ "${1:-}" == "--version" || "${1:-}" == "-v" ]]; then
+  print "vite-boost v${VERSION}"
+  terminate 0
+fi
+
+print ""
+print "🚀 \033[1;36mVite Boost: Refai.Code Final Edition\033[0m"
+print ""
 
+# -----------------------------
+# Validation: Must be in a Vite project folder
+# -----------------------------
 # --- Validation: Check if it's a Vite project ---
-if [ ! -f "package.json" ]; then
-  echo "❌ Error: package.json not found. Are you in the right directory?"
-  return 1
+if [[ ! -f package.json ]]; then
+  print -u2 "❌ Error: package.json not found. Are you in the right directory?"
+  terminate 1
 fi
 
-# Check if Vite is in dependencies or devDependencies
-if ! grep -q '"vite"' package.json; then
-  echo "⚠️  Warning: Vite not found in package.json."
-  if read -q "choice?This doesn't look like a Vite project. Continue anyway? (y/N) "; then
+if ! grep -q '"vite"' package.json 2>/dev/null; then
+  print -u2 "⚠️  Warning: Vite not found in package.json."
+  if ! read -k 1 "choice?This doesn't look like a Vite project. Continue anyway? (y/N) "; then
     echo ""
-  else
-    echo "\n❌ Setup cancelled."
-    return 1
+    print -u2 "❌ Setup cancelled."
+    terminate 1
   fi
+  echo ""
 fi
-
-echo "✅ Detected Vite project. Proceeding...\n"
+ok "Proceeding..."
+print ""
 
 # --- 1. Interactive Prompts ---
 ask() {
-  if read -q "choice?📦 Install $1? (y/N) "; then
-    echo "\n  ✅ Selected $1"
+  print -n "📦 Install $1? (y/N) "
+  read -k 1 choice
+  echo ""
+  if [[ "$choice" == [Yy] ]]; then
+    print "  ✅ Selected $1"
     eval "$2=true"
   else
-    echo "\n  ❌ Skipped $1"
+    print "  ❌ Skipped $1"
     eval "$2=false"
   fi
-  echo ""
+  print ""
 }
 
 # Helper: Check file overwrite
+# returns: 0 always (never trips set -e)
+# sets global var: OVERWRITE_OK=true/false
 check_overwrite() {
-  local file=$1
-  if [ -f "$file" ]; then
-    if read -q "choice?⚠️  $file already exists. Overwrite? (y/N) "; then
-      echo ""
+  local file="$1"
+  if [[ -f "$file" ]]; then
+    print -n "⚠️  $file already exists. Overwrite? (y/N) "
+    read -k 1 choice
+    echo ""
+    if [[ "$choice" == [Yy] ]]; then
       return 0  # Yes, overwrite
     else
-      echo "\n  ⏭️  Skipped $file"
+      print "  ⏭️  Skipped $file"
       return 1  # No, skip
     fi
   fi
-  return 0  # File doesn't exist, proceed
+  return 0
+}
+
+# write file with preview diff + choices
+write_file() {
+  local file="$1"
+  local tmp dir
+  tmp="$(mktemp)"
+
+  cat > "$tmp"
+
+  dir="$(dirname -- "$file")"
+  mkdir -p "$dir"
+
+  # if file doesn't exist, optionally still ask
+  if [[ ! -f "$file" ]]; then
+    if [[ "${ALWAYS_CONFIRM_OVERWRITE:-false}" == "true" ]]; then
+      if [[ "$choice" == [Nn] ]]; then
+        rm -f "$tmp"
+        warn "Skipped $file"
+        return 0 # Continue script
+      fi
+    fi
+    mv "$tmp" "$file"
+    ok "Created $file"
+    return 0
+  fi
+
+  # same content => do nothing
+  if cmp -s "$tmp" "$file" 2>/dev/null; then
+    rm -f "$tmp"
+    ok "Unchanged $file"
+    return 0
+  fi
+
+  while true; do
+    print -n "⚠️  ${file} exists. [y] overwrite / [n] skip / [d] diff (n): "
+    local ans; IFS= read -r ans
+    ans="${ans:l}"
+    case "$ans" in
+      y|yes)
+        mv "$tmp" "$file"
+        ok "Overwritten $file"
+        return 0
+        ;;
+      d|diff)
+        if command -v git >/dev/null 2>&1; then
+          git --no-pager diff --no-index -- "$file" "$tmp" || true
+        else
+          diff -u -- "$file" "$tmp" || true
+        fi
+        ;;
+      ""|n|no)
+        rm -f "$tmp"
+        warn "Skipped $file"
+        return 0 # Continue script
+        ;;
+      *)
+        warn "Choose y / n / d"
+        ;;
+    esac
+  done
 }
+upsert_block() {
+  local file="$1"
+  local start="$2"
+  local end="$3"
+  local tmp
+  tmp="$(mktemp)"
+
+  # Read stdin into tmp (the new block content)
+  cat > "$tmp"
+
+  # If file doesn't exist, just write it
+  if [[ ! -f "$file" ]]; then
+    mkdir -p "${file:h}"
+    cat "$tmp" > "$file"
+    rm -f "$tmp"
+    return 0
+  fi
+
+  # If markers exist, replace block
+  if grep -qF "$start" "$file" && grep -qF "$end" "$file"; then
+    # keep everything before start + new block + everything after end
+    awk -v s="$start" -v e="$end" '
+      BEGIN{in=0}
+      index($0,s){print; in=1; next}
+      index($0,e){in=0; print; next}
+      in==0{print}
+    ' "$file" > "${file}.tmp"
+
+    # Insert new content between markers
+    awk -v s="$start" -v e="$end" '
+      {print}
+      index($0,s){
+        while ((getline line < "'"$tmp"'") > 0) print line
+        close("'"$tmp"'")
+      }
+    ' "${file}.tmp" > "$file"
+
+    rm -f "${file}.tmp" "$tmp"
+  else
+    # markers not found => append safely once
+    cat >> "$file" <<EOF
 
+$start
+EOF
+    cat "$tmp" >> "$file"
+    cat >> "$file" <<EOF
+$end
+EOF
+    rm -f "$tmp"
+  fi
+}
 # Defaults
 tail=false
 expr=false
@@ -77,13 +239,14 @@ ask "JSON Server (Real Database & Auth)" json
 # ==========================================
 # 🛠️ Architecture Setup
 # ==========================================
-echo "\n📁 Creating project structure..."
+print ""
+print "📁 Creating project structure..."
 mkdir -p src/{components,pages,router,styles,services,utils,assets}
 
 # -----------------------------
 # 1. Utilities
 # -----------------------------
-echo "\n🔧 Generating utility files..."
+print "\n🔧 Generating utility files..."
 if check_overwrite "src/utils/helpers.js"; then
   cat > src/utils/helpers.js <<'EOF'
 export const sanitize = (str) => {
@@ -379,7 +542,7 @@ EOF
 # -----------------------------
 # 4. Styles (Glass, Spinner, Cards)
 # -----------------------------
-cat > src/styles/main.css <<'EOF'
+write_file "src/styles/main.css" <<'EOF'
 :root {
   --primary: #4f46e5;
   --bg: linear-gradient(135deg, #f5f7fa 0%, #c3cfe2 100%);
@@ -1097,20 +1260,20 @@ EOF
 # -----------------------------
 # 7. Main Entry Point
 # -----------------------------
-# Smart handling: Append to existing main.js instead of replacing
-if [ -f "src/main.js" ]; then
-  echo "\n⚠️  src/main.js already exists."
-  if read -q "choice?Do you want to append router code to it? (y/N) "; then
-    echo "\n✅ Appending router logic to existing main.js..."
-
-    # Backup first
-    cp src/main.js src/main.js.backup
-    echo "📦 Backup created: src/main.js.backup"
-
-    # Append router imports and setup
-    cat >> src/main.js <<'EOF'
+START_MARK='// ===== Refai.Code Router Setup (Auto-generated) ====='
+END_MARK='// ===== End Refai.Code Router Setup ====='
+
+router_block() {
+  local pwa_import=""
+  local pwa_init=""
+  if [[ "$pwa" == "true" ]]; then
+    pwa_import="import { registerPWA } from './pwa/register.js';"
+    pwa_init="registerPWA();"
+  fi
 
-// ===== Refai.Code Router Setup (Auto-generated) =====
+  cat <<EOF
+import './styles/main.css';
+$pwa_import
 import { LiteRouter } from './router/LiteRouter.js';
 import { Layout } from './components/Layout.js';
 import { Navbar } from './components/Navbar.js';
@@ -1137,47 +1300,76 @@ authState.subscribe(() => {
   if (el) el.innerHTML = Navbar();
 });
 
-const app = new LiteRouter(routes, '#app');
-app.init();
+$pwa_init
+new LiteRouter(routes, '#app').init();
 EOF
-  else
-    echo "\n⏭️  Skipped modifying main.js"
-  fi
-else
-  # File doesn't exist, create new one
-  cat > src/main.js <<'EOF'
-import './styles/main.css';
-import { LiteRouter } from './router/LiteRouter.js';
-import { Layout } from './components/Layout.js';
-import { Navbar } from './components/Navbar.js';
-import { authState } from './services/auth.js';
+}
 
-import { HomePage } from './pages/HomePage.js';
-import { ProductsPage } from './pages/ProductsPage.js';
-import { ProductDetailsPage } from './pages/ProductDetailsPage.js';
-import { LoginPage } from './pages/LoginPage.js';
-import { SignupPage } from './pages/SignupPage.js';
+ensure_main_js() {
+  mkdir -p src
+
+  local block_content
+  block_content=$(router_block)
+
+  if [[ -f "src/main.js" ]]; then
+    # Case 1: Markers already exist => Replace content between them
+    if grep -qF "$START_MARK" src/main.js && grep -qF "$END_MARK" src/main.js; then
+      print -n "⚠️  Refai router block found in main.js. Update it? (y/N) "
+      read -k 1 choice; echo ""
+      if [[ "$choice" == [Yy] ]]; then
+        # Use awk to replace block
+        awk -v s="$START_MARK" -v e="$END_MARK" -v r="$block_content" '
+          BEGIN {p=1}
+          $0 == s {print s; print r; p=0}
+          $0 == e {p=1; print e; next}
+          p {print}
+        ' src/main.js > src/main.js.tmp && mv src/main.js.tmp src/main.js
+        ok "Updated router block in main.js"
+      fi
+      return 0
+    fi
 
-const routes = [
-  { path: '/', component: HomePage, layout: Layout, title: 'Home | Refai.Code' },
-  { path: '/products', component: ProductsPage, layout: Layout, title: 'Products' },
-  { path: '/products/:id', component: ProductDetailsPage, layout: Layout, title: 'Details' },
-  { path: '/login', component: LoginPage, layout: Layout, title: 'Login' },
-  { path: '/logout', component: () => { authState.logout(); return '<div></div>'; } },
-  { path: '/signup', component: SignupPage, layout: Layout, title: 'Signup' },
-  { path: '*', component: () => '<h1 class="container">404</h1>', layout: Layout }
-];
+    # Case 2: No markers, but Refai code (LiteRouter) detected => Wrap it with markers or replace
+    if grep -q "LiteRouter" src/main.js; then
+      print -n "⚠️  LiteRouter detected but no markers found. Replace entire main.js to fix structure? (y/N) "
+      read -k 1 choice; echo ""
+      if [[ "$choice" == [Yy] ]]; then
+        cp src/main.js "src/main.js.backup.$(date +%Y%m%d-%H%M%S)"
+        {
+          echo "$START_MARK"
+          echo "$block_content"
+          echo "$END_MARK"
+        } > src/main.js
+        ok "Replaced main.js with structured Refai block."
+      fi
+      return 0
+    fi
 
-// Subscribe Navbar to Auth Changes
-authState.subscribe(() => {
-  const el = document.getElementById('nav-mount');
-  if (el) el.innerHTML = Navbar();
-});
+    # Case 3: Completely foreign file => Append block with markers
+    print -n "⚠️  src/main.js exists. Append Refai router block at the end? (y/N) "
+    read -k 1 choice; echo ""
+    if [[ "$choice" == [Yy] ]]; then
+      cp src/main.js "src/main.js.backup.$(date +%Y%m%d-%H%M%S)"
+      {
+        echo -e "\n$START_MARK"
+        echo "$block_content"
+        echo "$END_MARK"
+      } >> src/main.js
+      ok "Appended Refai block to main.js"
+    fi
+  else
+    # File doesn't exist => Create new one WITH markers
+    echo "📝 Creating new src/main.js..."
+    {
+      echo "$START_MARK"
+      echo "$block_content"
+      echo "$END_MARK"
+    } > src/main.js
+    ok "Created src/main.js with markers."
+  fi
+}
 
-const app = new LiteRouter(routes, '#app');
-app.init();
-EOF
-fi
+ensure_main_js
 
 # -----------------------------
 # 8. Dependency & Concurrent
@@ -1230,12 +1422,10 @@ if [ "$tail" = true ]; then
   $PM install -D tailwindcss postcss autoprefixer
 
   # Initialize tailwind config
-  if [ "$PM" = "pnpm" ]; then
-    pnpm exec tailwindcss init -p
-  elif [ "$PM" = "yarn" ]; then
-    yarn tailwindcss init -p
+  if [[ -f "node_modules/.bin/tailwindcss" ]]; then
+    ./node_modules/.bin/tailwindcss init -p
   else
-    npx -y tailwindcss init -p
+    npx -y --package tailwindcss tailwindcss init -p
   fi
 
   cat > src/styles/tailwind.css <<EOF
@@ -1263,11 +1453,132 @@ if [ "$json" = true ]; then
 fi
 
 # PWA Setup
+# -----------------------------
+# PWA Setup (FULL)
+# -----------------------------
 if [ "$pwa" = true ]; then
   echo "📱 Setting up PWA..."
+
+  # Install plugin
   $PM install -D vite-plugin-pwa
   installed_packages+=("Vite PWA Plugin")
-  cat > vite.config.js <<EOF
+
+  # Ensure public/ exists
+  mkdir -p public
+
+  # 1) Generate real PNG icons (no external deps)
+  # Creates:
+  # - public/pwa-192x192.png
+  # - public/pwa-512x512.png
+  # - public/apple-touch-icon.png
+  node - <<'NODE'
+const fs = require('fs');
+const zlib = require('zlib');
+
+function crc32(buf) {
+  let c = ~0;
+  for (let i = 0; i < buf.length; i++) {
+    c ^= buf[i];
+    for (let k = 0; k < 8; k++) c = (c >>> 1) ^ (0xEDB88320 & (-(c & 1)));
+  }
+  return (~c) >>> 0;
+}
+function chunk(type, data) {
+  const t = Buffer.from(type, 'ascii');
+  const len = Buffer.alloc(4);
+  len.writeUInt32BE(data.length, 0);
+  const crc = Buffer.alloc(4);
+  crc.writeUInt32BE(crc32(Buffer.concat([t, data])), 0);
+  return Buffer.concat([len, t, data, crc]);
+}
+function makePng(size, outPath) {
+  const width = size, height = size;
+  const raw = Buffer.alloc(width * height * 4);
+
+  const bg = { r: 0x4f, g: 0x46, b: 0xe5, a: 0xff }; // #4f46e5
+  const fg = { r: 0xff, g: 0xff, b: 0xff, a: 0xff }; // white
+
+  const badgeSize = Math.floor(size * 0.46);
+  const badgeStart = Math.floor((size - badgeSize) / 2);
+  const badgeEnd = badgeStart + badgeSize;
+
+  for (let y = 0; y < height; y++) {
+    for (let x = 0; x < width; x++) {
+      const i = (y * width + x) * 4;
+      let c = bg;
+      if (x >= badgeStart && x < badgeEnd && y >= badgeStart && y < badgeEnd) c = fg;
+      raw[i+0] = c.r; raw[i+1] = c.g; raw[i+2] = c.b; raw[i+3] = c.a;
+    }
+  }
+
+  const stride = width * 4;
+  const scan = Buffer.alloc((stride + 1) * height);
+  for (let y = 0; y < height; y++) {
+    scan[y * (stride + 1)] = 0; // filter 0
+    raw.copy(scan, y * (stride + 1) + 1, y * stride, (y + 1) * stride);
+  }
+
+  const signature = Buffer.from([0x89,0x50,0x4E,0x47,0x0D,0x0A,0x1A,0x0A]);
+  const ihdr = Buffer.alloc(13);
+  ihdr.writeUInt32BE(width, 0);
+  ihdr.writeUInt32BE(height, 4);
+  ihdr[8] = 8;  // bit depth
+  ihdr[9] = 6;  // color type RGBA
+  ihdr[10] = 0; // compression
+  ihdr[11] = 0; // filter
+  ihdr[12] = 0; // interlace
+
+  const idatData = zlib.deflateSync(scan, { level: 9 });
+  const png = Buffer.concat([
+    signature,
+    chunk('IHDR', ihdr),
+    chunk('IDAT', idatData),
+    chunk('IEND', Buffer.alloc(0)),
+  ]);
+
+  fs.writeFileSync(outPath, png);
+}
+
+fs.mkdirSync('public', { recursive: true });
+makePng(192, 'public/pwa-192x192.png');
+makePng(512, 'public/pwa-512x512.png');
+makePng(180, 'public/apple-touch-icon.png');
+console.log('✅ PWA icons generated: 192, 512, 180');
+NODE
+
+  # 2) Write manifest.webmanifest
+  cat > public/manifest.webmanifest <<'EOF'
+{
+  "name": "Refai App",
+  "short_name": "Refai",
+  "description": "Vite PWA powered by Refai.Code",
+  "start_url": "/",
+  "scope": "/",
+  "display": "standalone",
+  "background_color": "#ffffff",
+  "theme_color": "#4f46e5",
+  "icons": [
+    { "src": "/pwa-192x192.png", "sizes": "192x192", "type": "image/png" },
+    { "src": "/pwa-512x512.png", "sizes": "512x512", "type": "image/png" },
+    { "src": "/pwa-512x512.png", "sizes": "512x512", "type": "image/png", "purpose": "any maskable" }
+  ]
+}
+EOF
+
+  # 3) Ensure index.html links the manifest + theme color + apple touch icon
+  if [ -f index.html ]; then
+    # Add manifest link if missing
+    if ! grep -q 'manifest\.webmanifest' index.html; then
+      # insert before </head> using | as delimiter to avoid hex code # conflict
+      perl -0777 -i -pe 's|</head>|  <link rel="manifest" href="/manifest.webmanifest">\n  <meta name="theme-color" content="#4f46e5">\n  <link rel="apple-touch-icon" href="/apple-touch-icon.png">\n</head>|s' index.html
+      echo "✅ Updated index.html (manifest + theme-color + apple-touch-icon)"
+    else
+      echo "✅ index.html already has manifest link"
+    fi
+  fi
+
+  # 4) Create/overwrite vite.config.js with correct PWA config
+  cat > vite.config.js <<'EOF'
 import { defineConfig } from 'vite';
 import path from 'path';
 import { VitePWA } from 'vite-plugin-pwa';
@@ -1275,11 +1586,64 @@ import { VitePWA } from 'vite-plugin-pwa';
 export default defineConfig({
   resolve: { alias: { '@': path.resolve(__dirname, './src') } },
   plugins: [
-    VitePWA({ registerType: 'autoUpdate' }),
+    VitePWA({
+      registerType: 'autoUpdate',
+      injectRegister: 'auto',
+      devOptions: {
+        enabled: true,
+        type: 'module'
+      },
+      workbox: {
+        globPatterns: ['**/*.{js,css,html,ico,png,svg,webmanifest}']
+      },
+      includeAssets: [
+        'apple-touch-icon.png',
+        'pwa-192x192.png',
+        'pwa-512x512.png'
+      ],
+      manifest: {
+        name: 'Refai App',
+        short_name: 'Refai',
+        description: 'Vite PWA powered by Refai.Code',
+        start_url: '/',
+        scope: '/',
+        display: 'standalone',
+        background_color: '#ffffff',
+        theme_color: '#4f46e5',
+        icons: [
+          { src: 'pwa-192x192.png', sizes: '192x192', type: 'image/png' },
+          { src: 'pwa-512x512.png', sizes: '512x512', type: 'image/png' },
+          { src: 'pwa-512x512.png', sizes: '512x512', type: 'image/png', purpose: 'any maskable' }
+        ]
+      }
+    })
   ]
 });
 EOF
+
+  # 5) Add a small SW hook file (optional but useful) + include it from main.js
+  # We'll create src/pwa/register.js and then import it from src/main.js (if main.js exists)
+  mkdir -p src/pwa
+
+  cat > src/pwa/register.js <<'EOF'
+export function registerPWA() {
+  // vite-plugin-pwa with injectRegister:'auto' registers automatically.
+  // This file is just a safe place to add UX hooks (optional).
+  if ('serviceWorker' in navigator) {
+    // Optional: listen for SW updates
+    navigator.serviceWorker.addEventListener('controllerchange', () => {
+      // SW updated and controlling the page
+      console.log('[PWA] controller changed');
+    });
+  }
+}
+EOF
+
+  # Note: PWA registration is now handled inside the main.js router block for consistency
+  installed_packages+=("PWA (manifest + icons + SW)")
+
 else
+  # If PWA not selected, keep normal vite.config.js
   cat > vite.config.js <<EOF
 import { defineConfig } from 'vite';
 import path from 'path';
@@ -1289,25 +1653,24 @@ export default defineConfig({
 });
 EOF
 fi
-
 # -----------------------------
 # Final Summary
 # -----------------------------
-echo "\n✅ \033[1;32m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\033[0m"
-echo "\n🎉 \033[1;32mSetup Complete!\033[0m Created by Refai.Code\n"
+print "\n✅ \033[1;32m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\033[0m"
+print "\n🎉 \033[1;32mSetup Complete!\033[0m Created by Refai.Code\n"
 
 if [ ${#installed_packages[@]} -gt 0 ]; then
-  echo "📦 \033[1;36mInstalled Packages:\033[0m"
+  print "📦 \033[1;36mInstalled Packages:\033[0m"
   for pkg in "${installed_packages[@]}"; do
-    echo "   ✓ $pkg"
+    print "   ✓ $pkg"
   done
-  echo ""
+  print ""
 fi
 
-echo "🚀 \033[1;33mNext Steps:\033[0m"
-echo "   1. Run \033[1m$PM run dev\033[0m to start Vite dev server"
+print "🚀 \033[1;33mNext Steps:\033[0m"
+print "   1. Run \033[1m$PM run dev\033[0m to start Vite dev server"
 if [ "$json" = true ]; then
-  echo "   2. Run \033[1m$PM run dev:full\033[0m to start Vite + JSON Server together"
-  echo "   3. Or run \033[1mnpx json-server db.json --port 3000\033[0m in a separate terminal"
+  print "   2. Run \033[1m$PM run dev:full\033[0m to start Vite + JSON Server together"
+  print "   3. Or run \033[1mnpx json-server db.json --port 3000\033[0m in a separate terminal"
 fi
-echo "\n✅ \033[1;32m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\033[0m\n"
+print "\n✅ \033[1;32m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\033[0m\n"

package/package.json

@@ -1,16 +1,34 @@
 {
   "name": "@refai.code/vite-boost",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Vite Vanilla JS booster script (optional Tailwind/Axios/PWA/JSON-server)",
   "license": "MIT",
   "private": false,
+  "homepage": "https://github.com/David-refai/vite-boost",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/David-refai/vite-boost.git"
+  },
   "bin": {
     "vite-boost": "bin/vite-boost"
   },
   "files": [
-    "bin"
+    "bin",
+    "README.md",
+    "LICENSE"
   ],
   "engines": {
     "node": ">=18"
-  }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "vite",
+    "cli",
+    "pwa",
+    "tailwind",
+    "json-server",
+    "scaffold"
+  ]
 }