stackkit 0.1.9 → 0.2.0

package/README.md

@@ -1,43 +1,37 @@
 # StackKit CLI
 
-Production-ready CLI for creating and enhancing JavaScript applications.
+CLI for scaffolding and composing modular JavaScript applications.
 
-## Installation
+Quick Start
+-----------
 
-```bash
-npm install -g stackkit
-# or
-npx stackkit
-```
-
-## Create New Project
+Create a new project without installing globally:
 
 ```bash
-npx stackkit create my-app
+npx stackkit@latest create my-app
 ```
 
-## Add Features to Existing Project
+Add features to an existing project:
 
 ```bash
-npx stackkit add
-# or non-interactive
-npx stackkit add auth
-npx stackkit add database
+npx stackkit@latest add <module>
 ```
 
-## Check Project Health
+Check project health:
 
 ```bash
-npx stackkit doctor
+npx stackkit@latest doctor
 ```
 
-## Supported Technologies
+Supported technologies
+----------------------
 
-- **Frameworks**: Next.js, React, Express
-- **Databases**: Prisma (PostgreSQL, MongoDB, MySQL, SQLite), Mongoose (MongoDB)
-- **Auth**: Better Auth, Auth.js
+- Frameworks: Next.js, React, Express
+- Databases: Prisma, Mongoose
+- Auth: Auth.js / Better Auth
 
-## Documentation
+Links
+-----
 
-- [StackKit Docs](https://stackkit.tariqul.dev)
-- [GitHub Repository](https://github.com/tariqul420/stackkit)
+- Website: https://stackkit.tariqul.dev
+- Repo: https://github.com/tariqul420/stackkit

package/dist/cli/add.js

@@ -44,15 +44,15 @@ async function getAddConfig(module, options, projectInfo) {
         return await getInteractiveConfig(modulesDir, projectInfo);
     }
     // Only allow: no-arg interactive, or explicit category + --provider.
-    // Disallow positional provider names like `npx stackkit add better-auth` or
-    // `npx stackkit add auth prisma-postgresql` — require `--provider` flag.
+    // Disallow positional provider names like `npx stackkit@latest add better-auth` or
+    // `npx stackkit@latest add auth prisma-postgresql` — require `--provider` flag.
     if (module === "database" || module === "auth") {
         if (!options?.provider) {
             if (module === "database") {
-                throw new Error("Provider is required for database. Use: `npx stackkit add database --provider <provider>`");
+                throw new Error("Provider is required for database. Use: `npx stackkit@latest add database --provider <provider>`");
             }
             else {
-                throw new Error("Provider is required for auth. Use: `npx stackkit add auth --provider <provider>`");
+                throw new Error("Provider is required for auth. Use: `npx stackkit@latest add auth --provider <provider>`");
             }
         }
         if (module === "database") {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "stackkit",
-  "version": "0.1.9",
+  "version": "0.2.0",
   "description": "Production-ready CLI to create and extend JavaScript or TypeScript apps with modular stacks.",
   "main": "dist/index.js",
   "bin": {

package/templates/express/README.md

@@ -0,0 +1,48 @@
+# Express Template
+
+Production-ready Express (TypeScript) starter for building REST APIs and backend services.
+
+Requirements
+------------
+
+- Node.js 18+ (LTS recommended)
+- pnpm or npm
+
+Quick Start
+-----------
+
+Install dependencies and start the development server:
+
+```bash
+# using pnpm (recommended)
+pnpm install
+pnpm dev
+
+# or using npm
+npm install
+npm run dev
+```
+
+Scripts
+-------
+
+- `npm run dev` - Start development server
+- `npm run build` - Build TypeScript
+- `npm start` - Start production server
+
+Environment
+-----------
+
+Use a `.env` file or environment variables for configuration. See `.env.example` for available keys.
+
+---
+
+## Generated with StackKit
+
+This project was scaffolded using **StackKit** — a CLI toolkit for building production-ready applications.
+
+- Generated via: `npx stackkit@latest create`
+
+Learn more about StackKit:
+https://github.com/tariqul420/stackkit
+

package/templates/nextjs/README.md

@@ -2,9 +2,23 @@
 
 Production-ready Next.js starter with TypeScript and App Router.
 
-## Quick Start
+Requirements
+------------
+
+- Node.js 18+ (LTS recommended)
+- pnpm or npm
+
+Quick Start
+-----------
+
+Install dependencies and start a development server:
 
 ```bash
+# using pnpm (recommended)
+pnpm install
+pnpm dev
+
+# or using npm
 npm install
 npm run dev
 ```
@@ -40,7 +54,7 @@ public/            # Static assets
 
 ## Environment Variables
 
-Create `.env.local` file for environment variables.
+Create a `.env.local` (Next.js) file for local environment variables. Keep secrets out of the repository.
 
 ## Deployment
 
@@ -50,3 +64,15 @@ npm run start
 ```
 
 Deploy to Vercel, Netlify, or any Node.js hosting service.
+
+---
+
+## Generated with StackKit
+
+This project was scaffolded using **StackKit** — a CLI toolkit for building production-ready applications.
+
+- Generated via: `npx stackkit@latest create`
+
+Learn more about StackKit:
+https://github.com/tariqul420/stackkit
+

package/templates/nextjs/app/page.tsx

@@ -5,7 +5,7 @@ export default function Home() {
     <div className="flex min-h-screen items-center justify-center bg-zinc-50 font-sans dark:bg-black">
       <main className="flex min-h-screen w-full max-w-3xl flex-col items-center justify-between py-32 px-16 bg-white dark:bg-black sm:items-start">
         <div className="flex items-center gap-4 mb-8">
-          <div className="text-2xl font-bold text-black dark:text-white">Stackkit</div>
+          <div className="text-2xl font-bold text-black dark:text-white">StackKit</div>
           <span className="text-xl text-zinc-400">+</span>
           <Image
             className="dark:invert"
@@ -21,14 +21,14 @@ export default function Home() {
             To get started, edit the page.tsx file.
           </h1>
           <p className="max-w-md text-lg leading-8 text-zinc-600 dark:text-zinc-400">
-            This template includes Next.js, Tailwind CSS, and Stackkit best practices. Check out the{" "}
+            This template includes Next.js, Tailwind CSS, and StackKit best practices. Check out the{" "}
             <a
               href="https://github.com/tariqul420/stackkit"
               className="font-medium text-zinc-950 dark:text-zinc-50 hover:underline"
               target="_blank"
               rel="noopener noreferrer"
             >
-              Stackkit repository
+              StackKit repository
             </a>{" "}
             for more info.
           </p>

package/templates/react/README.md

@@ -2,11 +2,25 @@
 
 Production-ready React starter with TypeScript, Vite, and essential libraries.
 
-## Quick Start
+Requirements
+------------
+
+- Node.js 18+ (LTS recommended)
+- pnpm (recommended) or npm
+
+Quick Start
+-----------
+
+Install dependencies and run the dev server:
 
 ```bash
+# using pnpm (recommended)
 pnpm install
 pnpm dev
+
+# or using npm
+npm install
+npm run dev
 ```
 
 ## Features
@@ -27,7 +41,9 @@ pnpm dev
 
 ## Environment Variables
 
-Copy `.env.example` to `.env` and configure:
+Copy `.env.example` to `.env` and configure local values. Do not commit secrets.
+
+Example:
 
 ```env
 VITE_API_URL=http://localhost:3000/api
@@ -49,8 +65,28 @@ src/
 
 ## Deployment
 
+Build for production and serve or deploy the static output:
+
 ```bash
+# pnpm
 pnpm build
+pnpm preview
+
+# npm
+npm run build
+npm run preview
 ```
 
-Deploy the `dist` folder to Vercel, Netlify, or any static hosting service.
+Deploy the resulting `dist`/build output to your hosting platform (Vercel, Netlify, etc.).
+
+---
+
+## Generated with StackKit
+
+This project was scaffolded using **StackKit** — a CLI toolkit for building production-ready applications.
+
+- Generated via: `npx stackkit@latest create`
+
+Learn more about StackKit:
+https://github.com/tariqul420/stackkit
+

package/templates/react/src/pages/Home.tsx

@@ -7,7 +7,7 @@ export default function Home() {
       <div className="flex min-h-screen items-center justify-center bg-black">
         <main className="flex min-h-screen w-full max-w-3xl flex-col items-center justify-between py-32 px-16 bg-black sm:items-start">
           <div className="flex items-center gap-4 mb-8">
-            <div className="text-2xl font-bold text-white">Stackkit</div>
+            <div className="text-2xl font-bold text-white">StackKit</div>
             <span className="text-xl text-zinc-400">+</span>
             <img src="https://react.dev/favicon.ico" alt="React logo" width={32} height={32} />
           </div>
@@ -28,7 +28,7 @@ export default function Home() {
 
           <div className="flex flex-col gap-4 text-base font-medium sm:flex-row">
             <a
-              className="flex h-12 w-full items-center justify-center rounded-full bg-white text-black px-5 transition-colors hover:bg-zinc-200 md:w-39.5"
+              className="flex h-12 w-full items-center justify-center rounded-full bg-white text-black px-5 transition-colors hover:bg-zinc-200 md:w-40"
               href="https://react.dev"
               target="_blank"
               rel="noopener noreferrer"
@@ -36,7 +36,7 @@ export default function Home() {
               Get Started
             </a>
             <a
-              className="flex h-12 w-full items-center justify-center rounded-full px-5 transition-colors hover:border-transparent bg-zinc-900 md:w-39.5 dark:text-white text-black"
+              className="flex h-12 w-full items-center justify-center rounded-full bg-black text-white px-5 transition-colors hover:bg-zinc-900 md:w-40"
               href="/about"
             >
               Documentation