minimaz-cli 0.1.0 → 0.1.2

package/LICENSE

@@ -1,7 +1,7 @@
-Copyright (c) 2025 Hans Zeller (info@zellerindustries.com)
-
-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.
-
+Copyright (c) 2025 Hans Zeller (info@zellerindustries.com)
+
+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

@@ -1,107 +1,107 @@
-# Minimaz ⚡
-
-**Minimaz** is a minimal, zero-dependency static site builder and project initializer focused on speed, simplicity, and clean output.
-
-## 🚀 Features
-
-* 📁 Initialize projects from global templates
-* 🧩 Save, list, and delete custom templates
-* 📝 Supports HTML, CSS, JS, and TypeScript (.ts → .js)
-* 🧹 Minifies HTML, CSS, JS, and TS (compiled & minified)
-* ⚙️ Configurable with a `minimaz.config.json` file
-* ➕ Supports concatenation of additional scripts and styles
-* 🪄 Optional path replacements for asset links
-* 🪶 Lightweight and fast — ideal for small static or utility projects
-* 🔥 Usable with `minimaz` or alias `mz`
-* 🆕 Display version with `minimaz version`
-
-## 📦 Installation
-
-Run directly with `npx` without global install:
-
-```bash
-npx minimaz init my-site
-cd my-site
-npx minimaz build
-npx minimaz version
-```
-
-Or using the alias:
-
-```bash
-npx mz init my-site
-npx mz build
-npx mz version
-```
-
-## 📁 Project Structure
-
-```txt
-my-site/
-├── src/               # HTML, CSS, JS, TS files
-├── public/            # Static assets (images, fonts, etc.)
-├── dist/              # Output folder (generated)
-├── minimaz.config.json
-└── ...
-```
-
-## ⚙️ Configuration
-
-Customize your build using a `minimaz.config.json` file:
-
-```json
-{
-  "src": "src",
-  "dist": "dist",
-  "public": "public",
-  "minify": {
-    "html": true,
-    "css": true,
-    "js": true,
-    "ts": true
-  },
-  "replace": {
-    "../public/": "public/"
-  },
-  "styles": [
-    "style.css",
-    "theme.css"
-  ],
-  "scripts": [
-    "lib.js",
-    "script.js"
-  ]
-}
-```
-
-* `styles` (optional): array of `.css` files to concatenate and minify into a single `style.css`
-* `scripts` (optional): array of `.js` files to concatenate and minify into a single `script.js`
-* If omitted, fallback defaults are `style.css` and `script.js`
-
-## 🛠 Commands
-
-```bash
-minimaz init <project-name>       # Create a new project using global templates
-minimaz build                     # Build and minify the site (uses config or defaults)
-minimaz template <path>           # Save a new template from specified path (or current dir)
-minimaz template -l               # List available templates
-minimaz template -d <name>        # Delete a saved template
-minimaz help                      # Show help message
-minimaz version                   # Display Minimaz version
-```
-
-*All commands also work with the alias `mz`.*
-
-## 📂 Templates
-
-Minimaz supports global templates stored in:
-
-```bash
-~/.minimaz/templates
-```
-
-Use them to quickly initialize consistent projects across environments.
-
-## 📄 License
-
+# Minimaz ⚡
+
+**Minimaz** is a minimal, zero-dependency static site builder and project initializer focused on speed, simplicity, and clean output.
+
+## 🚀 Features
+
+* 📁 Initialize projects from global templates
+* 🧩 Save, list, and delete custom templates
+* 📝 Supports HTML, CSS, JS, and TypeScript (.ts → .js)
+* 🧹 Minifies HTML, CSS, JS, and TS (compiled & minified)
+* ⚙️ Configurable with a `minimaz.config.json` file
+* ➕ Supports concatenation of additional scripts and styles
+* 🪄 Optional path replacements for asset links
+* 🪶 Lightweight and fast — ideal for small static or utility projects
+* 🔥 Usable with `minimaz` or alias `mz`
+* 🆕 Display version with `minimaz version`
+
+## 📦 Installation
+
+Run directly with `npx` without global install:
+
+```bash
+npx minimaz init my-site
+cd my-site
+npx minimaz build
+npx minimaz version
+```
+
+Or using the alias:
+
+```bash
+npx mz init my-site
+npx mz build
+npx mz version
+```
+
+## 📁 Project Structure
+
+```txt
+my-site/
+├── src/               # HTML, CSS, JS, TS files
+├── public/            # Static assets (images, fonts, etc.)
+├── dist/              # Output folder (generated)
+├── minimaz.config.json
+└── ...
+```
+
+## ⚙️ Configuration
+
+Customize your build using a `minimaz.config.json` file:
+
+```json
+{
+  "src": "src",
+  "dist": "dist",
+  "public": "public",
+  "minify": {
+    "html": true,
+    "css": true,
+    "js": true,
+    "ts": true
+  },
+  "replace": {
+    "../public/": "public/"
+  },
+  "styles": [
+    "style.css",
+    "theme.css"
+  ],
+  "scripts": [
+    "lib.js",
+    "script.js"
+  ]
+}
+```
+
+* `styles` (optional): array of `.css` files to concatenate and minify into a single `style.css`
+* `scripts` (optional): array of `.js` files to concatenate and minify into a single `script.js`
+* If omitted, fallback defaults are `style.css` and `script.js`
+
+## 🛠 Commands
+
+```bash
+minimaz init <project-name>       # Create a new project using global templates
+minimaz build                     # Build and minify the site (uses config or defaults)
+minimaz template <path>           # Save a new template from specified path (or current dir)
+minimaz template -l               # List available templates
+minimaz template -d <name>        # Delete a saved template
+minimaz help                      # Show help message
+minimaz version                   # Display Minimaz version
+```
+
+*All commands also work with the alias `mz`.*
+
+## 📂 Templates
+
+Minimaz supports global templates stored in:
+
+```bash
+~/.minimaz/templates
+```
+
+Use them to quickly initialize consistent projects across environments.
+
+## 📄 License
+
 MIT

package/{dist/bin → bin}/cli.js

@@ -1,2 +1,2 @@
 #!/usr/bin/env node
-import{fileURLToPath as n}from"url";import{dirname as r,join as s}from"path";import m from"fs-extra";import{build as p}from"../src/commands/build.js";import{init as c}from"../src/commands/init.js";import{help as l}from"../src/commands/help.js";import{template as d}from"../src/commands/template.js";import{log as a}from"../src/utils/logService.js";import{parseArgs as f}from"../src/utils/functions.js";const g=n(import.meta.url),u=r(g),v=s(u,"../package.json"),h=await m.readJson(v),y=h.version;async function _(){const e=f(process.argv.slice(2)),i=(e._[0]||"").toLowerCase(),o={init:async()=>{await c(e._[1]||"minimaz-project",{template:e.template||e.t||"default"})},build:async()=>p(),help:()=>l(),template:async()=>{await d(e._[1],{list:e.l||e.list,delete:e.d||e.delete,update:e.u||e.update})},version:()=>console.log(y),i:()=>o.init(),b:()=>o.build(),h:()=>o.help(),t:()=>o.template()};try{o[i]?await o[i]():(a("error",`Unknown command '${i}'. Use 'minimaz help' to see available commands.`),o.help())}catch(t){a("error",t instanceof Error?process.env.DEBUG?t.stack??t.message:t.message:String(t)),process.exit(1)}}_();
+import{fileURLToPath as n}from"url";import{dirname as r,join as s}from"path";import m from"fs-extra";import{build as p}from"../src/commands/build.js";import{init as c}from"../src/commands/init.js";import{help as l}from"../src/commands/help.js";import{template as d}from"../src/commands/template.js";import{log as a}from"../src/utils/logService.js";import{parseArgs as f}from"../src/utils/functions.js";const g=n(import.meta.url),v=r(g),u=s(v,"../package.json"),h=await m.readJson(u),y=h.version;async function _(){const e=f(process.argv.slice(2)),i=(e._[0]||"").toLowerCase(),o={init:async()=>{await c(e._[1]||"minimaz-project",{template:e.template||e.t||"default"})},build:async()=>p(),help:()=>l(),template:async()=>{await d(e._[1],{list:e.l||e.list,delete:e.d||e.delete,update:e.u||e.update})},version:()=>console.log(y),i:()=>o.init(),b:()=>o.build(),h:()=>o.help(),t:()=>o.template(),v:()=>o.version()};try{o[i]?await o[i]():(a("error",`Unknown command '${i}'. Use 'minimaz help' to see available commands.`),o.help())}catch(t){a("error",t instanceof Error?process.env.DEBUG?t.stack??t.message:t.message:String(t)),process.exit(1)}}_();

package/package.json

@@ -1,57 +1,42 @@
-{
-  "name": "minimaz-cli",
-  "version": "0.1.0",
-  "description": "Minimal project initializer and builder CLI",
-  "author": "MrZeller",
-  "license": "MIT",
-  "type": "module",
-  "files": [
-    "bin/",
-    "src/",
-    "LICENSE",
-    "README.md",
-    "package.json"
-  ],
-  "scripts": {
-    "dev": "node --loader ts-node/esm bin/cli.ts",
-    "build": "node builder.js",
-    "postinstall:dev": "node --loader ts-node/esm ./src/utils/postInstall.ts",
-    "postinstall:prod": "node ./dist/src/utils/postInstall.js"
-  },
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/zeller-dev/minimaz-cli.git"
-  },
-  "bin": {
-    "minimaz": "./dist/bin/cli.js",
-    "mz": "./dist/bin/cli.js"
-  },
-  "keywords": [
-    "cli",
-    "minimal",
-    "build",
-    "init",
-    "project",
-    "starter"
-  ],
-  "homepage": "https://github.com/zeller-dev/minimaz-cli#readme",
-  "bugs": {
-    "url": "https://github.com/zeller-dev/minimaz-cli/issues"
-  },
-  "dependencies": {
-    "clean-css": "^5.3.3",
-    "fs-extra": "^11.3.0",
-    "html-minifier-terser": "^7.2.0",
-    "terser": "^5.44.0"
-  },
-  "devDependencies": {
-    "@types/clean-css": "^4.2.11",
-    "@types/fs-extra": "^11.0.4",
-    "@types/html-minifier-terser": "^7.0.2",
-    "@types/node": "^24.7.2",
-    "esbuild": "^0.25.10",
-    "ts-node": "^10.9.2",
-    "typescript": "^5.9.3"
-  },
-  "postinstall": "node ./dist/src/utils/postInstall.js"
-}
+{
+  "name": "minimaz-cli",
+  "version": "0.1.2",
+  "description": "Minimal project initializer and builder CLI",
+  "author": "MrZeller",
+  "license": "MIT",
+  "type": "module",
+  "files": [
+    "bin",
+    "src",
+    "LICENSE",
+    "README.md",
+    "package.json"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/zeller-dev/minimaz-cli.git"
+  },
+  "keywords": [
+    "cli",
+    "minimal",
+    "build",
+    "init",
+    "project",
+    "starter"
+  ],
+  "homepage": "https://github.com/zeller-dev/minimaz-cli#readme",
+  "bugs": {
+    "url": "https://github.com/zeller-dev/minimaz-cli/issues"
+  },
+  "dependencies": {
+    "clean-css": "^5.3.3",
+    "fs-extra": "^11.3.0",
+    "html-minifier-terser": "^7.2.0",
+    "terser": "^5.44.0"
+  },
+  "postinstall": "node ./dist/src/utils/postInstall.js",
+  "bin": {
+    "minimaz": "dist/bin/cli.js",
+    "mz": "dist/bin/cli.js"
+  }
+}

package/src/commands/build.js

@@ -0,0 +1 @@
+import s from"fs-extra";import r from"path";import F from"clean-css";import{minify as $}from"html-minifier-terser";import{minify as b}from"terser";import{loadConfig as k}from"../utils/loadConfig.js";import{log as a}from"../utils/logService.js";import{applyReplacements as h,getFile as g}from"../utils/functions.js";async function H(){try{const t=await k(),l=r.resolve(process.cwd(),t.dist||"dist");await s.remove(l),await s.ensureDir(l);async function j(f,m){const w=r.resolve(process.cwd(),f),S=r.join(l,m);if(!await s.pathExists(w)){a("warn",`Folder not found: ${f}`);return}const p=[],u=[];async function y(i,n){await s.ensureDir(n);for(const e of await s.readdir(i)){const c=r.join(i,e),d=r.join(n,e),v=await s.stat(c),C=r.extname(e).toLowerCase();if(v.isDirectory()){await y(c,d);continue}try{switch(C){case".html":{let o=await g(c,t.replace);t.minify?.html&&(o=await $(o,{collapseWhitespace:!0,removeComments:!0,minifyJS:t.minify?.ts,minifyCSS:t.minify?.css})),await s.outputFile(d,o);break}case".css":{const o=await g(c,t.replace);p.push(o);break}case".js":{const o=await g(c,t.replace);u.push(o);break}default:await s.copy(c,d);break}}catch(o){a("error",`Failed to process file: ${c} - ${o.message}`)}}}if(await y(w,S),f===t.src)try{if(t.styles?.length)for(const i of t.styles){const n=r.resolve(process.cwd(),i);if(await s.pathExists(n)){let e=await s.readFile(n,"utf-8");e=h(e,t.replace),p.push(e)}else a("warn",`Style file not found: ${i}`)}if(t.scripts?.length)for(const i of t.scripts){const n=r.resolve(process.cwd(),i);if(await s.pathExists(n)){let e=await s.readFile(n,"utf-8");e=h(e,t.replace),u.push(e)}else a("warn",`Script file not found: ${i}`)}if(p.length>0){let i=p.join("");t.minify?.css&&(i=new F().minify(i).styles),await s.outputFile(r.join(l,"style.css"),i)}if(u.length>0){let i=u.join("");t.minify?.js&&(i=(await b(i)).code??""),i&&await s.outputFile(r.join(l,"script.js"),i)}}catch(i){a("error",`Failed to merge CSS/JS: ${i.message}`)}a("success",`Processed folder: ${f} -> /${m}`)}if(t.folders&&Object.keys(t.folders).length>0)for(const[f,m]of Object.entries(t.folders))await j(f,m);else a("warn","No folders defined in config. Nothing to build.");a("success",`Build completed. Output saved in /${t.dist}`)}catch(t){a("error",`Build failed: ${t.message}`)}}export{H as build};

package/src/commands/help.js

@@ -0,0 +1,2 @@
+function t(){console.log(["Usage:","","	minimaz init | i <project-name>",'		Create a new project (default: "minimaz-site")',"		Options:",'			--template | -t <template-name>	Use a global template (default: "default")',"","	minimaz build | b","		Build and minify files into the dist folder","","	minimaz template | t [path]","		Save current folder as a template (no path = current folder)","		Options:","			--list | -l	List available global templates","			--delete | -d <template-name>	Delete a global template","","	minimaz help | h","		Show this help message"].join(`
+`))}export{t as help};

package/src/commands/init.js

@@ -0,0 +1 @@
+import t from"fs-extra";import i from"path";import g from"os";import{log as n}from"../utils/logService.js";import{createGlobalDir as p}from"../utils/functions.js";async function j(s,o={}){const e=i.join(g.homedir(),".minimaz");await t.pathExists(e)||(n("info",`Global folder '${e}' not found. Creating...`),await p());const a=i.join(e,"templates",o.template||"default"),m=i.resolve(process.cwd(),s);if(!await t.pathExists(a))throw new Error(`Template '${o.template}' not found.`);try{await t.copy(a,m);const r=i.join(a,"..","gitignore"),c=i.join(m,".gitignore");await t.pathExists(r)&&(await t.copy(r,c),n("info",".gitignore added to project.")),n("success",`Project '${s}' created using template '${o.template}'.`)}catch(r){throw new Error(`Failed to create project: ${r.message}`)}}export{j as init};

package/src/commands/template.js

@@ -0,0 +1 @@
+import o from"fs-extra";import w from"os";import n from"path";import{log as a}from"../utils/logService.js";import{askQuestion as c,listTemplates as m,getGlobalNodeModulesPath as f}from"../utils/functions.js";async function j(s,e={}){const t=n.join(w.homedir(),".minimaz","templates"),r=e.delete||e.d,i=e.update||e.u;if(r)return await g(t,r);if(e.list||e.l)return await m(t);if(i!==void 0)return typeof i=="string"&&i.trim()?await u(t,i.trim()):await p(t);await y(t,s)}async function u(s,e){const t=n.resolve(process.cwd()),r=n.join(s,e);if(!await o.pathExists(r))throw new Error(`Template '${e}' not found in ~/.minimaz/templates`);const i=await c(`\u2753 Update template '${e}' with current directory? (Y/N) `);if(i!=="y"&&i!==""){a("info","Update cancelled.");return}try{await o.copy(t,r,{overwrite:!0}),a("success",`Template '${e}' updated from current directory.`)}catch(d){throw new Error(`Failed to update '${e}': ${d.message}`)}}async function p(s){const e=n.join(f(),"src","templates");if(!await o.pathExists(e))throw new Error("'node_modules/minimaz/src/templates' not found.");const t=await o.readdir(e),r=await c("\u26A0\uFE0F Update local templates overwriting them with defaults? (Y/N): ");if(r!=="y"&&r!==""){a("info","Update cancelled.");return}try{for(const i of t){const d=n.join(e,i),l=n.join(s,i);await o.copy(d,l,{overwrite:!0}),a("success",`Updated '${i}'`)}a("info","\u2728 All templates and files updated successfully.")}catch(i){throw new Error(`Update failed: ${i.message}`)}}async function g(s,e){if(!e)throw new Error("No template name specified to delete.");const t=n.join(s,e);if(!await o.pathExists(t))throw new Error(`Template not found: ${e}`);if((await c(`\u2753 Confirm delete '${e}'? (Y/N) `)).toLowerCase()!=="y"){a("info","Delete cancelled.");return}try{await o.remove(t),a("success",`Template '${e}' deleted.`)}catch(i){throw new Error(`Delete error: ${i.message}`)}}async function y(s,e){let t=e?n.resolve(process.cwd(),e):process.cwd();if(!await o.pathExists(t)){a("warn",`Path not found: ${t}`);const r=(await c("\u2753 Use current directory instead? (Y/N):	")).trim().toLowerCase();if(r!=="y"&&r!=="")throw new Error("Operation cancelled.");t=process.cwd()}try{await o.ensureDir(s);const r=n.join(s,n.basename(t));await o.copy(t,r),a("success",`Template saved to ${r}`)}catch(r){throw new Error(`Failed to save template: ${r.message}`)}}export{j as template};

package/src/templates/default/minimaz.config.json

@@ -1,26 +1,26 @@
-{
-    "src": "src",
-    "dist": "dist",
-    "public": "public",
-    "minify": {
-        "html": true,
-        "css": true,
-        "js": true,
-        "ts": true
-    },
-    "replace": {
-        "../public/": "public/"
-    },
-    "styles": [
-        "style.css",
-        "style-2.css"
-    ],
-    "scripts": [
-        "script.js",
-        "script-2.js"
-    ],
-    "folders": {
-        "src": "",
-        "public": "public"
-    }
+{
+    "src": "src",
+    "dist": "dist",
+    "public": "public",
+    "minify": {
+        "html": true,
+        "css": true,
+        "js": true,
+        "ts": true
+    },
+    "replace": {
+        "../public/": "public/"
+    },
+    "styles": [
+        "style.css",
+        "style-2.css"
+    ],
+    "scripts": [
+        "script.js",
+        "script-2.js"
+    ],
+    "folders": {
+        "src": "",
+        "public": "public"
+    }
 }

package/src/templates/default/src/index.html

@@ -1,80 +1,80 @@
-<!DOCTYPE html>
-<html lang="en">
-<head>
-  <meta charset="UTF-8" />
-  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-  <title>Welcome to Minimaz</title>
-  <link rel="stylesheet" href="style.css" />
-  <link rel="icon" href="../public/favicon.ico" type="image/x-icon" />
-</head>
-<body>
-  <header>
-    <nav>
-      <a class="btn active" href="#">Home</a>
-      <a class="btn" href="pages/about.html">About</a>
-      <a class="btn" href="https://github.com/zeller-dev/minimaz" target="_blank">GitHub</a>
-    </nav>
-  </header>
-
-  <main class="container">
-    <h1>🚀 Welcome to Minimaz</h1>
-    <p><strong>Minimaz</strong> is a minimal static site builder designed for speed and simplicity. It helps you:</p>
-    <ul>
-      <li>💡 Organize your files with a simple structure</li>
-      <li>⚙️ Automatically build and minify HTML, CSS, JS, and TS</li>
-      <li>🔄 Customize file inclusion order using <code>minimaz.config.json</code></li>
-    </ul>
-
-    <h2>🔧 Getting Started</h2>
-    <p>Install and use Minimaz with the following commands:</p>
-    <pre><code># 🔨 Initialize a new project
-npx minimaz init my-site
-
-# 🏗️ Build the site
-npx minimaz build
-
-# 📦 Save template or list/delete existing ones
-npx minimaz template &lt;path&gt; [--list|-l] [--delete|-d]
-
-# 💬 Show help guide
-npx minimaz help</code></pre>
-
-    <h2>📁 Project Structure</h2>
-    <pre><code>my-site/
-├── src/                  # Source files (HTML, CSS, JS, TS)
-├── public/               # Static assets (images, fonts, etc.)
-├── dist/                 # Output directory (auto-generated)
-└── minimaz.config.json   # Configuration file</code></pre>
-
-    <h2>⚙️ Configuration</h2>
-    <pre><code>{
-  "src": "src",
-  "dist": "dist",
-  "public": "public",
-  "minify": { "html": true, "css": true, "js": true, "ts": true },
-  "replace": { "../public/": "public/" },
-  "styles": [ "reset.css", "style.css", "theme.css" ],
-  "scripts": [ "libs/jquery.js", "utils.js", "script.js" ]
-}</code></pre>
-
-    <h2>📤 Production</h2>
-    <p>The final output will be generated in the <code>dist/</code> folder, ready for deployment.</p>
-
-    <h2>❓ Available Commands</h2>
-    <ul>
-      <li><code>init</code> / <code>i</code> – Initialize a new project</li>
-      <li><code>build</code> / <code>b</code> – Build and minify the project</li>
-      <li><code>help</code> / <code>h</code> – Show the help message</li>
-      <li><code>template</code> / <code>t</code> – Manage templates (with <code>--list</code> and <code>--delete</code> options)</li>
-    </ul>
-
-    <p>You're ready to build fast and clean static websites. Happy coding! 🛠️</p>
-  </main>
-
-  <footer>
-    <p>&copy; 2025 Minimaz. All rights reserved.</p>
-  </footer>
-
-  <script src="script.js"></script>
-</body>
-</html>
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8" />
+  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+  <title>Welcome to Minimaz</title>
+  <link rel="stylesheet" href="style.css" />
+  <link rel="icon" href="../public/favicon.ico" type="image/x-icon" />
+</head>
+<body>
+  <header>
+    <nav>
+      <a class="btn active" href="#">Home</a>
+      <a class="btn" href="pages/about.html">About</a>
+      <a class="btn" href="https://github.com/zeller-dev/minimaz" target="_blank">GitHub</a>
+    </nav>
+  </header>
+
+  <main class="container">
+    <h1>🚀 Welcome to Minimaz</h1>
+    <p><strong>Minimaz</strong> is a minimal static site builder designed for speed and simplicity. It helps you:</p>
+    <ul>
+      <li>💡 Organize your files with a simple structure</li>
+      <li>⚙️ Automatically build and minify HTML, CSS, JS, and TS</li>
+      <li>🔄 Customize file inclusion order using <code>minimaz.config.json</code></li>
+    </ul>
+
+    <h2>🔧 Getting Started</h2>
+    <p>Install and use Minimaz with the following commands:</p>
+    <pre><code># 🔨 Initialize a new project
+npx minimaz init my-site
+
+# 🏗️ Build the site
+npx minimaz build
+
+# 📦 Save template or list/delete existing ones
+npx minimaz template &lt;path&gt; [--list|-l] [--delete|-d]
+
+# 💬 Show help guide
+npx minimaz help</code></pre>
+
+    <h2>📁 Project Structure</h2>
+    <pre><code>my-site/
+├── src/                  # Source files (HTML, CSS, JS, TS)
+├── public/               # Static assets (images, fonts, etc.)
+├── dist/                 # Output directory (auto-generated)
+└── minimaz.config.json   # Configuration file</code></pre>
+
+    <h2>⚙️ Configuration</h2>
+    <pre><code>{
+  "src": "src",
+  "dist": "dist",
+  "public": "public",
+  "minify": { "html": true, "css": true, "js": true, "ts": true },
+  "replace": { "../public/": "public/" },
+  "styles": [ "reset.css", "style.css", "theme.css" ],
+  "scripts": [ "libs/jquery.js", "utils.js", "script.js" ]
+}</code></pre>
+
+    <h2>📤 Production</h2>
+    <p>The final output will be generated in the <code>dist/</code> folder, ready for deployment.</p>
+
+    <h2>❓ Available Commands</h2>
+    <ul>
+      <li><code>init</code> / <code>i</code> – Initialize a new project</li>
+      <li><code>build</code> / <code>b</code> – Build and minify the project</li>
+      <li><code>help</code> / <code>h</code> – Show the help message</li>
+      <li><code>template</code> / <code>t</code> – Manage templates (with <code>--list</code> and <code>--delete</code> options)</li>
+    </ul>
+
+    <p>You're ready to build fast and clean static websites. Happy coding! 🛠️</p>
+  </main>
+
+  <footer>
+    <p>&copy; 2025 Minimaz. All rights reserved.</p>
+  </footer>
+
+  <script src="script.js"></script>
+</body>
+</html>