@supunkalharajayasinghe/project-cli 1.3.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Supun Kalhara Jayasinghe
+
+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,380 @@
+# ts-cli-tool
+
+An intent-based TypeScript project scaffolder for generating production-shaped Next.js starter projects. Generated projects feature premium, light-themed starter layouts (v1.3.0 - Premium Blueprint Starters) with customized styles, responsive cards, interactive state indicators, built-in `lucide-react` icons, and central documentation links.
+
+Instead of only asking low-level setup questions, `ts-cli-tool` asks what kind of project you want to build, creates an official Next.js base project, and then applies a tailored blueprint structure.
+
+## What it does
+
+`ts-cli-tool` helps generate practical starter projects from developer intent.
+
+Current supported blueprints:
+
+- Website
+- Full-stack Product
+- AI App
+
+The CLI flow:
+
+```txt
+project-cli create
+↓
+Project name
+↓
+Choose project blueprint
+↓
+Choose blueprint-specific shape
+↓
+Choose relevant modules
+↓
+Create Next.js base project
+↓
+Apply custom blueprint files
+↓
+Apply optional feature modules
+↓
+Optionally install dependencies
+↓
+Print next steps
+```
+
+## Why this exists
+
+Traditional project scaffolding usually starts with framework configuration.
+
+This tool starts with project intent.
+
+For example, instead of only creating a blank Next.js app, the CLI can generate:
+
+- A multi-page website with pages, layout components, contact form placeholder, and SEO files
+- A full-stack product starter with dashboard structure, API route placeholders, Prisma/PostgreSQL, Redis, Docker, and GitHub Actions
+- An AI app starter with chat UI, API route placeholder, AI configuration, and optional persistence modules
+
+## Installation
+
+### Global install (recommended)
+
+```bash
+npm install -g @supunkalharajayasinghe/project-cli
+project-cli create
+```
+
+### Run without installing
+
+```bash
+npx @supunkalharajayasinghe/project-cli create
+```
+
+### From source (for contributors)
+
+```bash
+git clone https://github.com/SupunKalharaJayasinghe/ts-cli-tool.git
+cd ts-cli-tool
+npm install
+npm run build
+npm link
+project-cli create
+```
+
+## Commands
+
+### `project-cli greet <name>`
+
+Prints a test greeting.
+
+```bash
+project-cli greet Supun
+```
+
+### `project-cli create`
+
+Starts the project scaffolding flow.
+
+```bash
+project-cli create
+```
+
+## Blueprint: Website
+
+Use this for public-facing websites.
+
+Examples:
+
+- Landing page
+- Portfolio
+- Business website
+- Documentation-style website
+
+Website options include:
+
+- One-page landing page
+- Multi-page website
+- Selected sections
+- Selected pages
+- SEO starter files
+- Contact form placeholder
+- GitHub Actions CI
+- Optional Docker files
+
+Example generated structure:
+
+```txt
+src/
+├── app/
+│   ├── page.tsx
+│   ├── about/page.tsx
+│   ├── services/page.tsx
+│   ├── contact/page.tsx
+│   ├── layout.tsx
+│   ├── robots.ts
+│   └── sitemap.ts
+├── components/
+│   ├── forms/
+│   │   └── ContactForm.tsx
+│   ├── layout/
+│   │   ├── Navbar.tsx
+│   │   └── Footer.tsx
+│   └── sections/
+├── lib/
+│   └── site-config.ts
+└── types/
+```
+
+## Blueprint: Full-stack Product
+
+Use this for production-style apps with backend logic.
+
+Examples:
+
+- SaaS starter
+- Dashboard app
+- Admin-style app
+- Custom full-stack product
+
+Full-stack options include:
+
+- SaaS starter
+- Dashboard with database
+- Custom full-stack app
+- Prisma + PostgreSQL
+- Redis
+- Docker files
+- GitHub Actions CI
+- Environment example file
+
+Example generated structure:
+
+```txt
+src/
+├── app/
+│   ├── page.tsx
+│   ├── dashboard/
+│   │   └── page.tsx
+│   ├── api/
+│   │   └── health/
+│   │       └── route.ts
+│   └── layout.tsx
+├── components/
+│   └── dashboard/
+├── lib/
+│   ├── db.ts
+│   ├── env.ts
+│   ├── redis.ts
+│   └── utils.ts
+├── server/
+│   ├── actions/
+│   └── services/
+└── types/
+
+prisma/
+└── schema.prisma
+
+.env.example
+Dockerfile
+docker-compose.yml
+.github/workflows/ci.yml
+```
+
+## Blueprint: AI App
+
+Use this for AI-first applications.
+
+Examples:
+
+- Chat app
+- AI assistant
+- Content generator
+
+AI options include:
+
+- Chat app
+- AI assistant
+- Content generator
+- AI API route placeholder
+- Chat UI components
+- AI config helper
+- Optional database support
+- Optional Redis support
+- GitHub Actions CI
+
+Example generated structure:
+
+```txt
+src/
+├── app/
+│   ├── page.tsx
+│   ├── api/
+│   │   └── chat/
+│   │       └── route.ts
+│   └── layout.tsx
+├── components/
+│   └── chat/
+│       ├── Chat.tsx
+│       ├── ChatInput.tsx
+│       └── MessageList.tsx
+├── lib/
+│   └── ai.ts
+└── types/
+    └── ai.ts
+```
+
+## Feature modules
+
+The scaffolder can apply optional modules based on the selected blueprint.
+
+### Prisma + PostgreSQL
+
+Adds:
+
+```txt
+prisma/schema.prisma
+src/lib/db.ts
+.env.example
+```
+
+Also updates `package.json` with Prisma dependencies and scripts:
+
+```bash
+npm run db
+npm run db:push
+npm run db:generate
+```
+
+### Redis
+
+Adds:
+
+```txt
+src/lib/redis.ts
+REDIS_URL in .env.example
+```
+
+### Docker
+
+Adds:
+
+```txt
+Dockerfile
+docker-compose.yml
+```
+
+For projects using PostgreSQL or Redis, Docker Compose includes matching services.
+
+### GitHub Actions
+
+Adds:
+
+```txt
+.github/workflows/ci.yml
+```
+
+The generated workflow runs install, lint, typecheck, and build steps.
+
+## Generated project next steps
+
+After generating a project:
+
+```bash
+cd your-project-name
+npm install
+npm run dev
+```
+
+If `.env.example` is generated:
+
+```bash
+cp .env.example .env
+```
+
+On Windows PowerShell:
+
+```powershell
+Copy-Item .env.example .env
+```
+
+If Prisma is enabled:
+
+```bash
+npm run db:push
+```
+
+## Local development
+
+Install dependencies:
+
+```bash
+npm install
+```
+
+Run the CLI in development mode:
+
+```bash
+npm run dev
+```
+
+Build:
+
+```bash
+npm run build
+```
+
+Run the built CLI:
+
+```bash
+node dist/index.js create
+```
+
+## Manual verification
+
+Generated projects have been manually verified for:
+
+- Website blueprint
+- Full-stack Product blueprint
+- AI App blueprint
+
+See:
+
+```txt
+docs/generated-project-verification.md
+```
+
+## Current limitations
+
+This version focuses on the first stable intent-based scaffolder flow.
+
+Not included yet:
+
+- Authentication implementation
+- Payment integration
+- Full UI component library
+- Deployment automation
+- Backend API blueprint
+- TypeScript package / CLI blueprint
+- Plugin system
+- Dry-run mode
+
+These can be added in future versions.
+
+## License
+
+MIT

package/dist/commands/create.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from 'commander';
+export declare function registerCreateCommand(program: Command): void;
+//# sourceMappingURL=create.d.ts.map

package/dist/commands/create.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../src/commands/create.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAOzC,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAsD5D"}

package/dist/commands/create.js

@@ -0,0 +1,48 @@
+import { applyPlan } from '../generators/applyPlan.js';
+import { createNextBase } from '../generators/createNextBase.js';
+import { askCreatePlan } from '../prompts/askCreatePlan.js';
+import { pathExists } from '../utils/pathExists.js';
+import { runCommand } from '../utils/runCommand.js';
+export function registerCreateCommand(program) {
+    program
+        .command('create')
+        .description('Create an intent-based project scaffold')
+        .action(async () => {
+        console.log('\n🚀 Let’s create a new project.\n');
+        try {
+            const plan = await askCreatePlan();
+            if (await pathExists(plan.targetPath)) {
+                console.error(`\n❌ A folder named "${plan.projectName}" already exists. Please choose a different name.`);
+                process.exit(1);
+            }
+            console.log('\n📦 Creating Next.js base project...\n');
+            await createNextBase(plan);
+            console.log('\n🧱 Applying project blueprint...\n');
+            await applyPlan(plan);
+            if (plan.installDependencies) {
+                console.log('\n📥 Installing dependencies...\n');
+                await runCommand('npm', ['install'], plan.targetPath);
+            }
+            console.log('\n✅ Project successfully created!\n');
+            console.log('Next steps:');
+            console.log(`  cd ${plan.projectName}`);
+            if (!plan.installDependencies) {
+                console.log('  npm install');
+            }
+            if (plan.modules.includes('env-example')) {
+                console.log('  cp .env.example .env');
+                console.log('  # Windows PowerShell: Copy-Item .env.example .env');
+            }
+            if (plan.modules.includes('prisma')) {
+                console.log('  npm run db:push');
+            }
+            console.log('  npm run dev\n');
+        }
+        catch (error) {
+            console.error('\n❌ Failed to create project.');
+            console.error(error);
+            process.exit(1);
+        }
+    });
+}
+//# sourceMappingURL=create.js.map

package/dist/commands/create.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create.js","sourceRoot":"","sources":["../../src/commands/create.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACjE,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAEpD,MAAM,UAAU,qBAAqB,CAAC,OAAgB;IACpD,OAAO;SACJ,OAAO,CAAC,QAAQ,CAAC;SACjB,WAAW,CAAC,yCAAyC,CAAC;SACtD,MAAM,CAAC,KAAK,IAAI,EAAE;QACjB,OAAO,CAAC,GAAG,CAAC,oCAAoC,CAAC,CAAC;QAElD,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,aAAa,EAAE,CAAC;YAEnC,IAAI,MAAM,UAAU,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;gBACtC,OAAO,CAAC,KAAK,CACX,uBAAuB,IAAI,CAAC,WAAW,mDAAmD,CAC3F,CAAC;gBAEF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAClB,CAAC;YAED,OAAO,CAAC,GAAG,CAAC,yCAAyC,CAAC,CAAC;YACvD,MAAM,cAAc,CAAC,IAAI,CAAC,CAAC;YAE3B,OAAO,CAAC,GAAG,CAAC,sCAAsC,CAAC,CAAC;YACpD,MAAM,SAAS,CAAC,IAAI,CAAC,CAAC;YAEtB,IAAI,IAAI,CAAC,mBAAmB,EAAE,CAAC;gBAC7B,OAAO,CAAC,GAAG,CAAC,mCAAmC,CAAC,CAAC;gBAEjD,MAAM,UAAU,CAAC,KAAK,EAAE,CAAC,SAAS,CAAC,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;YACxD,CAAC;YAED,OAAO,CAAC,GAAG,CAAC,qCAAqC,CAAC,CAAC;YACnD,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;YAC3B,OAAO,CAAC,GAAG,CAAC,QAAQ,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;YAExC,IAAI,CAAC,IAAI,CAAC,mBAAmB,EAAE,CAAC;gBAC9B,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;YAC/B,CAAC;YAED,IAAI,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC;gBACzC,OAAO,CAAC,GAAG,CAAC,wBAAwB,CAAC,CAAC;gBACtC,OAAO,CAAC,GAAG,CAAC,qDAAqD,CAAC,CAAC;YACrE,CAAC;YAED,IAAI,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;gBACpC,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC;YACnC,CAAC;YAED,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;QACjC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,+BAA+B,CAAC,CAAC;YAC/C,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YACrB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/commands/greet.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from 'commander';
+export declare function registerGreetCommand(program: Command): void;
+//# sourceMappingURL=greet.d.ts.map

package/dist/commands/greet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"greet.d.ts","sourceRoot":"","sources":["../../src/commands/greet.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAU3D"}

package/dist/commands/greet.js

@@ -0,0 +1,10 @@
+export function registerGreetCommand(program) {
+    program
+        .command('greet')
+        .description('Greets the user by name')
+        .argument('<name>', 'The name of the person to greet')
+        .action((name) => {
+        console.log(`🚀 Hello, ${name}! Your TypeScript CLI is officially alive.`);
+    });
+}
+//# sourceMappingURL=greet.js.map

package/dist/commands/greet.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"greet.js","sourceRoot":"","sources":["../../src/commands/greet.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,oBAAoB,CAAC,OAAgB;IACnD,OAAO;SACJ,OAAO,CAAC,OAAO,CAAC;SAChB,WAAW,CAAC,yBAAyB,CAAC;SACtC,QAAQ,CAAC,QAAQ,EAAE,iCAAiC,CAAC;SACrD,MAAM,CAAC,CAAC,IAAY,EAAE,EAAE;QACvB,OAAO,CAAC,GAAG,CACT,aAAa,IAAI,4CAA4C,CAC9D,CAAC;IACJ,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/generators/applyAiPlan.d.ts

@@ -0,0 +1,3 @@
+import type { CreatePlan } from '../types.js';
+export declare function applyAiPlan(plan: CreatePlan): Promise<void>;
+//# sourceMappingURL=applyAiPlan.d.ts.map

package/dist/generators/applyAiPlan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"applyAiPlan.d.ts","sourceRoot":"","sources":["../../src/generators/applyAiPlan.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAK9C,wBAAsB,WAAW,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAWjE"}