@beknurakhmed/webforge-cli 0.1.0 → 0.1.2

package/README.md

@@ -1,212 +1,226 @@
-# webforge-cli
-
-Interactive CLI to generate production-ready website project templates. Pick your template, framework, styling, state management, and coding paradigm — get a fully configured project in seconds.
-
-## Quick Start
-
-```bash
-npx webforge-cli
-```
-
-Or install globally:
-
-```bash
-npm install -g webforge-cli
-webforge-cli
-```
-
-You can also pass the project name directly:
-
-```bash
-npx webforge-cli my-app
-```
-
-## How It Works
-
-The CLI walks you through an interactive wizard:
-
-```
-1. Project name         →  my-awesome-app
-2. Template type        →  Landing Page / E-commerce / CRM / Dashboard / Blog / Portfolio
-3. Framework            →  React / Vue / Angular / Vanilla / Next.js / Nuxt
-4. Coding paradigm      →  Functional / SOLID OOP
-5. Styling solution     →  Tailwind CSS / SCSS / CSS Modules / Material UI / ...
-6. State management     →  Redux / Zustand / MobX / Pinia / NgRx / RxJS / None
-7. Extra tools          →  TypeScript / ESLint / Prettier
-```
-
-After you answer, webforge generates a ready-to-run project:
-
-```bash
-cd my-awesome-app
-npm install
-npm run dev
-```
-
-## Template Types
-
-| Template | Description |
-|----------|-------------|
-| **Landing Page** | Marketing page with hero, features, CTA, footer |
-| **E-commerce** | Product grid, shopping cart, product cards |
-| **CRM** | Contacts table, stats cards, filters, sidebar |
-| **Dashboard** | KPI cards, charts, data tables, sidebar navigation |
-| **Blog** | Post list, categories sidebar, newsletter signup |
-| **Portfolio** | Hero intro, project grid, skills, contact form |
-
-## Frameworks
-
-| Framework | Build Tool | Version |
-|-----------|-----------|---------|
-| **React** | Vite | React 19 |
-| **Vue** | Vite | Vue 3.5 |
-| **Angular** | Angular CLI | Angular 19 |
-| **Vanilla** | Vite | Plain TS/JS |
-| **Next.js** | Next.js | v15 |
-| **Nuxt** | Nuxt | v3 |
-
-## Styling Options
-
-| Styling | Works with |
-|---------|-----------|
-| **Tailwind CSS** | React, Vue, Angular, Vanilla, Next.js, Nuxt |
-| **SCSS** | React, Vue, Angular, Vanilla, Next.js, Nuxt |
-| **CSS Modules** | React, Vue, Vanilla, Next.js, Nuxt |
-| **Styled Components** | React, Next.js |
-| **Material UI** | React, Next.js |
-| **Chakra UI** | React, Next.js |
-| **Ant Design** | React, Vue, Next.js |
-| **Angular Material** | Angular |
-
-## State Management
-
-| Library | Works with |
-|---------|-----------|
-| **Redux Toolkit** | React, Next.js |
-| **Zustand** | React, Next.js |
-| **MobX** | React, Next.js |
-| **Pinia** | Vue, Nuxt |
-| **RxJS** | Angular |
-| **NgRx** | Angular |
-
-## Coding Paradigm
-
-Choose between two coding styles for your generated project:
-
-- **Functional** — React hooks, Vue composables, Angular signals, pure functions
-- **SOLID OOP** — Class components, services, dependency injection, OOP patterns
-
-## Examples
-
-### React + Landing Page + Tailwind
-
-```bash
-npx webforge-cli
-# → my-landing
-# → Landing Page
-# → React
-# → Functional
-# → Tailwind CSS
-# → None
-# → TypeScript, ESLint, Prettier
-```
-
-### Vue + E-commerce + SCSS + Pinia
-
-```bash
-npx webforge-cli
-# → my-store
-# → E-commerce
-# → Vue
-# → Functional
-# → SCSS
-# → Pinia
-# → TypeScript
-```
-
-### Angular + Dashboard + Angular Material + NgRx
-
-```bash
-npx webforge-cli
-# → admin-panel
-# → Dashboard
-# → Angular
-# → SOLID OOP
-# → Angular Material
-# → NgRx
-# → TypeScript, ESLint
-```
-
-## Project Structure (Generated)
-
-Example for React + Landing Page:
-
-```
-my-landing/
-├── public/
-│   └── vite.svg
-├── src/
-│   ├── components/
-│   │   ├── Hero.tsx
-│   │   ├── Features.tsx
-│   │   ├── CTA.tsx
-│   │   └── Footer.tsx
-│   ├── App.tsx
-│   ├── App.css
-│   ├── main.tsx
-│   └── index.css
-├── index.html
-├── package.json
-├── vite.config.ts
-├── tailwind.config.js      (if Tailwind selected)
-├── eslint.config.js        (if ESLint selected)
-├── .prettierrc             (if Prettier selected)
-├── .gitignore
-└── README.md
-```
-
-## Architecture
-
-webforge-cli uses a **layered overlay system** to generate projects:
-
-```
-Layer 1: Framework base       (React/Vue/Angular/Vanilla/Next.js/Nuxt)
-Layer 2: Template overlay     (Landing/E-commerce/CRM/Dashboard/Blog/Portfolio)
-Layer 3: Paradigm variant     (Functional/OOP)
-Layer 4: Styling config       (Tailwind/SCSS/Material UI/...)
-Layer 5: State management     (Redux/Zustand/Pinia/...)
-Layer 6: Extras               (ESLint/Prettier)
-```
-
-Each layer copies files on top of the previous one. Dependencies are merged into `package.json` automatically.
-
-## Requirements
-
-- Node.js >= 18.0.0
-
-## Development
-
-```bash
-git clone https://github.com/beknurakhmed/webforge-cli.git
-cd webforge-cli
-npm install
-npm run build
-node dist/index.js
-```
-
-### Scripts
-
-| Script | Description |
-|--------|-------------|
-| `npm run build` | Build CLI with tsup |
-| `npm run dev` | Watch mode build |
-| `npm run start` | Run the CLI |
-| `npm run typecheck` | TypeScript type checking |
-
-## Contributing
-
-Contributions are welcome! Feel free to open issues or submit pull requests at [github.com/beknurakhmed/webforge-cli](https://github.com/beknurakhmed/webforge-cli).
-
-## License
-
-MIT - [Beknur](https://github.com/beknurakhmed)
+# @beknurakhmed/webforge-cli
+
+[![npm version](https://img.shields.io/npm/v/@beknurakhmed/webforge-cli.svg)](https://www.npmjs.com/package/@beknurakhmed/webforge-cli)
+[![license](https://img.shields.io/npm/l/@beknurakhmed/webforge-cli.svg)](https://github.com/beknurakhmed/webforge-cli/blob/main/LICENSE)
+[![node](https://img.shields.io/node/v/@beknurakhmed/webforge-cli.svg)](https://nodejs.org)
+
+Interactive CLI to generate production-ready website project templates. Pick your template, framework, styling, state management, and coding paradigm — get a fully configured project in seconds.
+
+## Quick Start
+
+```bash
+npx @beknurakhmed/webforge-cli
+```
+
+Or install globally:
+
+```bash
+npm install -g @beknurakhmed/webforge-cli
+webforge-cli
+```
+
+You can also pass the project name directly:
+
+```bash
+npx @beknurakhmed/webforge-cli my-app
+```
+
+## How It Works
+
+The CLI walks you through an interactive wizard:
+
+```
+┌  webforge-cli  — project template generator
+│
+◆  Project name:         →  my-awesome-app
+◆  Select a template:    →  Landing Page / E-commerce / CRM / Dashboard / Blog / Portfolio
+◆  Select a framework:   →  React / Vue / Angular / Vanilla / Next.js / Nuxt
+◆  Coding paradigm:      →  Functional / SOLID OOP
+◆  Styling solution:     →  Tailwind CSS / SCSS / CSS Modules / Material UI / ...
+◆  State management:     →  Redux / Zustand / MobX / Pinia / NgRx / RxJS / None
+◆  Extra tools:          →  TypeScript / ESLint / Prettier
+│
+◇  Project generated successfully!
+│
+│  Next steps:
+│  cd my-awesome-app
+│  npm install
+│  npm run dev
+│
+└  Happy coding!
+```
+
+## Template Types
+
+| Template | Description |
+|----------|-------------|
+| **Landing Page** | Marketing page with hero, features, CTA, footer |
+| **E-commerce** | Product grid, shopping cart, product cards |
+| **CRM** | Contacts table, stats cards, filters, sidebar |
+| **Dashboard** | KPI cards, charts, data tables, sidebar navigation |
+| **Blog** | Post list, categories sidebar, newsletter signup |
+| **Portfolio** | Hero intro, project grid, skills, contact form |
+
+## Frameworks
+
+| Framework | Build Tool | Version |
+|-----------|-----------|---------|
+| **React** | Vite | React 19 |
+| **Vue** | Vite | Vue 3.5 |
+| **Angular** | Angular CLI | Angular 19 |
+| **Vanilla** | Vite | Plain TS/JS |
+| **Next.js** | Next.js | v15 |
+| **Nuxt** | Nuxt | v3 |
+
+## Styling Options
+
+| Styling | Works with |
+|---------|-----------|
+| **Tailwind CSS** | React, Vue, Angular, Vanilla, Next.js, Nuxt |
+| **SCSS** | React, Vue, Angular, Vanilla, Next.js, Nuxt |
+| **CSS Modules** | React, Vue, Vanilla, Next.js, Nuxt |
+| **Styled Components** | React, Next.js |
+| **Material UI** | React, Next.js |
+| **Chakra UI** | React, Next.js |
+| **Ant Design** | React, Vue, Next.js |
+| **Angular Material** | Angular |
+
+## State Management
+
+| Library | Works with |
+|---------|-----------|
+| **Redux Toolkit** | React, Next.js |
+| **Zustand** | React, Next.js |
+| **MobX** | React, Next.js |
+| **Pinia** | Vue, Nuxt |
+| **RxJS** | Angular |
+| **NgRx** | Angular |
+
+## Coding Paradigm
+
+Choose between two coding styles for your generated project:
+
+- **Functional** — React hooks, Vue composables, Angular signals, pure functions
+- **SOLID OOP** — Class components, services, dependency injection, OOP patterns
+
+## Examples
+
+### React + Landing Page + Tailwind
+
+```bash
+npx @beknurakhmed/webforge-cli
+# → my-landing
+# → Landing Page
+# → React
+# → Functional
+# → Tailwind CSS
+# → None
+# → TypeScript, ESLint, Prettier
+```
+
+### Vue + E-commerce + SCSS + Pinia
+
+```bash
+npx @beknurakhmed/webforge-cli
+# → my-store
+# → E-commerce
+# → Vue
+# → Functional
+# → SCSS
+# → Pinia
+# → TypeScript
+```
+
+### Angular + Dashboard + Angular Material + NgRx
+
+```bash
+npx @beknurakhmed/webforge-cli
+# → admin-panel
+# → Dashboard
+# → Angular
+# → SOLID OOP
+# → Angular Material
+# → NgRx
+# → TypeScript, ESLint
+```
+
+## Project Structure (Generated)
+
+Example for React + Landing Page:
+
+```
+my-landing/
+├── public/
+│   └── vite.svg
+├── src/
+│   ├── components/
+│   │   ├── Hero.tsx
+│   │   ├── Features.tsx
+│   │   ├── CTA.tsx
+│   │   └── Footer.tsx
+│   ├── App.tsx
+│   ├── App.css
+│   ├── main.tsx
+│   └── index.css
+├── index.html
+├── package.json
+├── vite.config.ts
+├── tailwind.config.js      (if Tailwind selected)
+├── eslint.config.js        (if ESLint selected)
+├── .prettierrc             (if Prettier selected)
+├── .gitignore
+└── README.md
+```
+
+## Architecture
+
+webforge-cli uses a **layered overlay system** to generate projects:
+
+```
+Layer 1: Framework base       (React/Vue/Angular/Vanilla/Next.js/Nuxt)
+Layer 2: Template overlay     (Landing/E-commerce/CRM/Dashboard/Blog/Portfolio)
+Layer 3: Paradigm variant     (Functional/OOP)
+Layer 4: Styling config       (Tailwind/SCSS/Material UI/...)
+Layer 5: State management     (Redux/Zustand/Pinia/...)
+Layer 6: Extras               (ESLint/Prettier)
+```
+
+Each layer copies files on top of the previous one. Dependencies are merged into `package.json` automatically.
+
+## Requirements
+
+- Node.js >= 18.0.0
+
+## Development
+
+```bash
+git clone https://github.com/beknurakhmed/webforge-cli.git
+cd webforge-cli
+npm install
+npm run build
+node dist/index.js
+```
+
+### Scripts
+
+| Script | Description |
+|--------|-------------|
+| `npm run build` | Build CLI with tsup |
+| `npm run dev` | Watch mode build |
+| `npm run start` | Run the CLI |
+| `npm run typecheck` | TypeScript type checking |
+
+## Contributing
+
+Contributions are welcome! See [CONTRIBUTING.md](CONTRIBUTING.md) for Git Flow branching strategy and guidelines.
+
+## Author
+
+**Beknur** — Frontend Developer & Software Engineer
+
+- GitHub: [@beknurakhmed](https://github.com/beknurakhmed)
+- npm: [@beknurakhmed](https://www.npmjs.com/~beknurakhmed)
+
+## License
+
+MIT

package/package.json

@@ -1,63 +1,63 @@
-{
-  "name": "@beknurakhmed/webforge-cli",
-  "version": "0.1.0",
-  "description": "Interactive CLI to generate website project templates — landing pages, e-commerce, CRM, dashboards, blogs, portfolios with React, Vue, Angular, Next.js, Nuxt and more",
-  "type": "module",
-  "bin": {
-    "webforge-cli": "./dist/index.js"
-  },
-  "files": [
-    "dist",
-    "templates"
-  ],
-  "scripts": {
-    "build": "tsup",
-    "dev": "tsup --watch",
-    "start": "node dist/index.js",
-    "typecheck": "tsc --noEmit",
-    "prepublishOnly": "npm run build"
-  },
-  "keywords": [
-    "cli",
-    "scaffold",
-    "template",
-    "generator",
-    "react",
-    "vue",
-    "angular",
-    "nextjs",
-    "nuxt",
-    "vite",
-    "tailwind",
-    "landing-page",
-    "ecommerce",
-    "dashboard",
-    "crm",
-    "blog",
-    "portfolio"
-  ],
-  "author": "Beknur <https://github.com/beknurakhmed>",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/beknurakhmed/webforge-cli.git"
-  },
-  "homepage": "https://github.com/beknurakhmed/webforge-cli#readme",
-  "bugs": {
-    "url": "https://github.com/beknurakhmed/webforge-cli/issues"
-  },
-  "license": "MIT",
-  "engines": {
-    "node": ">=18.0.0"
-  },
-  "dependencies": {
-    "@clack/prompts": "^1.0.1",
-    "fs-extra": "^11.3.3",
-    "picocolors": "^1.1.1"
-  },
-  "devDependencies": {
-    "@types/fs-extra": "^11.0.4",
-    "@types/node": "^25.3.0",
-    "tsup": "^8.5.1",
-    "typescript": "^5.9.3"
-  }
-}
+{
+  "name": "@beknurakhmed/webforge-cli",
+  "version": "0.1.2",
+  "description": "Interactive CLI to generate website project templates — landing pages, e-commerce, CRM, dashboards, blogs, portfolios with React, Vue, Angular, Next.js, Nuxt and more",
+  "type": "module",
+  "bin": {
+    "webforge-cli": "./dist/index.js"
+  },
+  "files": [
+    "dist",
+    "templates"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "start": "node dist/index.js",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "cli",
+    "scaffold",
+    "template",
+    "generator",
+    "react",
+    "vue",
+    "angular",
+    "nextjs",
+    "nuxt",
+    "vite",
+    "tailwind",
+    "landing-page",
+    "ecommerce",
+    "dashboard",
+    "crm",
+    "blog",
+    "portfolio"
+  ],
+  "author": "Beknur <https://github.com/beknurakhmed>",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/beknurakhmed/webforge-cli.git"
+  },
+  "homepage": "https://github.com/beknurakhmed/webforge-cli#readme",
+  "bugs": {
+    "url": "https://github.com/beknurakhmed/webforge-cli/issues"
+  },
+  "license": "MIT",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "@clack/prompts": "^1.0.1",
+    "fs-extra": "^11.3.3",
+    "picocolors": "^1.1.1"
+  },
+  "devDependencies": {
+    "@types/fs-extra": "^11.0.4",
+    "@types/node": "^25.3.0",
+    "tsup": "^8.5.1",
+    "typescript": "^5.9.3"
+  }
+}

package/templates/extras/typescript/deps.json

@@ -0,0 +1,6 @@
+{
+  "devDependencies": {
+    "typescript": "^5.6.0",
+    "@types/node": "^22.0.0"
+  }
+}

package/templates/extras/typescript/react/tsconfig.json

@@ -0,0 +1,21 @@
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "useDefineForClassFields": true,
+    "lib": ["ES2020", "DOM", "DOM.Iterable"],
+    "module": "ESNext",
+    "skipLibCheck": true,
+    "moduleResolution": "bundler",
+    "allowImportingTsExtensions": true,
+    "isolatedModules": true,
+    "moduleDetection": "force",
+    "noEmit": true,
+    "jsx": "react-jsx",
+    "strict": true,
+    "noUnusedLocals": true,
+    "noUnusedParameters": true,
+    "noFallthroughCasesInSwitch": true,
+    "noUncheckedSideEffectImports": true
+  },
+  "include": ["src"]
+}

package/templates/extras/typescript/vanilla/tsconfig.json

@@ -0,0 +1,19 @@
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "useDefineForClassFields": true,
+    "module": "ESNext",
+    "lib": ["ES2020", "DOM", "DOM.Iterable"],
+    "skipLibCheck": true,
+    "moduleResolution": "bundler",
+    "allowImportingTsExtensions": true,
+    "isolatedModules": true,
+    "moduleDetection": "force",
+    "noEmit": true,
+    "strict": true,
+    "noUnusedLocals": true,
+    "noUnusedParameters": true,
+    "noFallthroughCasesInSwitch": true
+  },
+  "include": ["src"]
+}

package/templates/extras/typescript/vue/tsconfig.json

@@ -0,0 +1,20 @@
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "useDefineForClassFields": true,
+    "module": "ESNext",
+    "lib": ["ES2020", "DOM", "DOM.Iterable"],
+    "skipLibCheck": true,
+    "moduleResolution": "bundler",
+    "allowImportingTsExtensions": true,
+    "isolatedModules": true,
+    "moduleDetection": "force",
+    "noEmit": true,
+    "jsx": "preserve",
+    "strict": true,
+    "noUnusedLocals": true,
+    "noUnusedParameters": true,
+    "noFallthroughCasesInSwitch": true
+  },
+  "include": ["src/**/*.ts", "src/**/*.tsx", "src/**/*.vue"]
+}