stackkit 0.3.4 → 0.3.6

package/README.md

@@ -2,9 +2,9 @@
 
 Production-ready full-stack project generator.
 
-## Installation
+## Usage
 
-No installation required. Use npx to get the latest version:
+No installation required:
 
 ```bash
 npx stackkit@latest <command>
@@ -14,40 +14,43 @@ npx stackkit@latest <command>
 
 ### create
 
-Generate a new project:
+Scaffold a new project:
 
 ```bash
-# Interactive mode
+# Interactive — follow the prompts
 npx stackkit@latest create my-app
 
-# With options
+# With flags — skip the prompts
 npx stackkit@latest create my-app \
   --framework nextjs \
   --database prisma-postgresql \
-  --auth better-auth \
-  --language typescript
+  --auth better-auth
 ```
 
 **Options:**
 
-- `--framework, -f` - nextjs, express, react
-- `--database, -d` - prisma-postgresql, prisma-mysql, prisma-sqlite, prisma-mongodb, mongoose, none
-- `--auth, -a` - better-auth, authjs, none
-- `--language, -l` - typescript, javascript
-- `--package-manager, -p` - pnpm, npm, yarn, bun
-- `--yes, -y` - Use defaults
-- `--skip-install` - Don't install dependencies
-- `--no-git` - Don't initialize git
+| Flag                    | Values                                                                                     |
+| ----------------------- | ------------------------------------------------------------------------------------------ |
+| `--framework, -f`       | `nextjs`, `express`, `react`                                                               |
+| `--database, -d`        | `prisma-postgresql`, `prisma-mysql`, `prisma-sqlite`, `prisma-mongodb`, `mongoose`, `none` |
+| `--auth, -a`            | `better-auth`, `none`                                                                      |
+| `--ui, -u`              | `shadcn`                                                                                   |
+| `--storage-provider`    | `cloudinary`                                                                               |
+| `--language, -l`        | `typescript`, `javascript`                                                                 |
+| `--package-manager, -p` | `pnpm`, `npm`, `yarn`, `bun`                                                               |
+| `--yes, -y`             | Use defaults, skip prompts                                                                 |
+| `--skip-install`        | Skip dependency installation                                                               |
+| `--no-git`              | Skip git initialization                                                                    |
 
 ### add
 
-Add features to existing project:
+Add a module to an existing project:
 
 ```bash
 npx stackkit@latest add
 ```
 
-Interactively select and install modules.
+Interactively select and install modules (database, auth, ui, storage, components).
 
 ### doctor
 
@@ -61,52 +64,57 @@ npx stackkit@latest doctor --verbose
 
 # JSON output (for CI/CD)
 npx stackkit@latest doctor --json
+
+# Treat warnings as errors
+npx stackkit@latest doctor --strict
 ```
 
 ### list
 
-Show available options:
+Show available frameworks and modules:
 
 ```bash
 npx stackkit@latest list
+npx stackkit@latest list --frameworks
+npx stackkit@latest list --modules
 ```
 
-## Supported Technologies
-
-**Frameworks:**
-
-- Next.js (App Router)
-- Express (TypeScript API)
-- React (Vite SPA)
-
-**Databases:**
-
-- Prisma (PostgreSQL, MySQL, SQLite, MongoDB)
-- Mongoose (MongoDB)
+## Supported stack
 
-**Authentication:**
-
-- Better Auth (All frameworks)
-- Auth.js (Next.js only)
+| Category       | Options                                                  |
+| -------------- | -------------------------------------------------------- |
+| Frameworks     | Next.js (App Router), Express (TypeScript), React (Vite) |
+| Databases      | Prisma (PostgreSQL, MySQL, SQLite, MongoDB), Mongoose    |
+| Authentication | Better Auth (all frameworks)                             |
+| UI             | Shadcn UI (Next.js, React)                               |
+| Storage        | Cloudinary (Express)                                     |
+| Components     | TiptapEditor, DataTable, SearchBar, FilterBar, and more  |
 
 ## Examples
 
 ```bash
 # Full-stack Next.js
-npx stackkit@latest create my-app --framework nextjs --database prisma-postgresql --auth better-auth
+npx stackkit@latest create my-app \
+  --framework nextjs \
+  --database prisma-postgresql \
+  --auth better-auth
 
-# Express API
-npx stackkit@latest create my-api --framework express --database mongoose
+# Express API with MongoDB
+npx stackkit@latest create my-api \
+  --framework express \
+  --database mongoose
 
-# React frontend
-npx stackkit@latest create my-spa --framework react --auth better-auth
+# React SPA with auth
+npx stackkit@latest create my-spa \
+  --framework react \
+  --auth better-auth
 ```
 
 ## Links
 
-- **Documentation**: https://stackkit.tariqul.dev
-- **GitHub**: https://github.com/tariqul420/stackkit
-- **Issues**: https://github.com/tariqul420/stackkit/issues
+- [Documentation](https://stackkit.tariqul.dev)
+- [GitHub](https://github.com/tariqul420/stackkit)
+- [Issues](https://github.com/tariqul420/stackkit/issues)
 
 ## License
 

package/dist/cli/add.js

@@ -7,8 +7,8 @@ exports.addCommand = addCommand;
 const chalk_1 = __importDefault(require("chalk"));
 const child_process_1 = require("child_process");
 const fs_extra_1 = __importDefault(require("fs-extra"));
-const inquirer_1 = __importDefault(require("inquirer"));
 const path_1 = __importDefault(require("path"));
+const prompts_1 = __importDefault(require("prompts"));
 const module_discovery_1 = require("../lib/discovery/module-discovery");
 const shared_1 = require("../lib/discovery/shared");
 const env_editor_1 = require("../lib/env/env-editor");
@@ -122,26 +122,33 @@ async function getInteractiveConfig(modulesDir, projectInfo, options) {
     if (compatibleAuths.length > 0) {
         categories.push({ name: "Auth", value: "auth" });
     }
-    const answers = await inquirer_1.default.prompt([
-        {
-            type: "list",
-            name: "category",
-            message: "What would you like to add?",
-            choices: categories,
-        },
-    ]);
-    const category = answers.category;
+    if (["react", "nextjs"].includes(projectInfo?.framework || defaultFramework)) {
+        const fw = projectInfo?.framework || defaultFramework;
+        const availableComponents = (discovered.components || []).filter((c) => !c.supportedFrameworks || c.supportedFrameworks.includes(fw));
+        if (availableComponents.length > 0) {
+            categories.push({ name: "Components", value: "components" });
+        }
+    }
+    const categoryResp = await (0, prompts_1.default)({
+        type: "select",
+        name: "category",
+        message: "What would you like to add?",
+        choices: categories.map((c) => ({ title: c.name, value: c.value })),
+    });
+    const category = categoryResp.category;
     if (category === "database") {
         const dbChoices = (0, module_discovery_1.getDatabaseChoices)(discovered.databases || [], projectInfo?.framework || defaultFramework);
-        const dbAnswers = await inquirer_1.default.prompt([
-            {
-                type: "list",
-                name: "database",
-                message: "Select database:",
-                choices: dbChoices,
-            },
-        ]);
-        const selectedDb = dbAnswers.database;
+        const dbChoicesNormalized = dbChoices.map((c) => ({
+            title: c.name || c.title || String(c.value ?? ""),
+            value: c.value ?? String(c.title ?? ""),
+        }));
+        const dbResp = await (0, prompts_1.default)({
+            type: "select",
+            name: "database",
+            message: "Select database:",
+            choices: dbChoicesNormalized,
+        });
+        const selectedDb = dbResp.database;
         if (selectedDb.startsWith("prisma-")) {
             const provider = selectedDb.split("-")[1];
             return {
@@ -166,15 +173,17 @@ async function getInteractiveConfig(modulesDir, projectInfo, options) {
         if (!projectInfo?.hasDatabase) {
             logger_1.logger.warn("No database detected in the project. Authentication requires a database.");
             const dbChoices = (0, module_discovery_1.getDatabaseChoices)(discovered.databases || [], projectInfo?.framework || defaultFramework);
-            const dbAnswer = await inquirer_1.default.prompt([
-                {
-                    type: "list",
-                    name: "database",
-                    message: "Select a database to add before authentication:",
-                    choices: dbChoices,
-                },
-            ]);
-            const selectedDb = dbAnswer.database;
+            const dbChoicesNormalized2 = dbChoices.map((c) => ({
+                title: c.name || c.title || String(c.value ?? ""),
+                value: c.value ?? String(c.title ?? ""),
+            }));
+            const dbAnswerResp = await (0, prompts_1.default)({
+                type: "select",
+                name: "database",
+                message: "Select a database to add before authentication:",
+                choices: dbChoicesNormalized2,
+            });
+            const selectedDb = dbAnswerResp.database;
             if (!selectedDb || selectedDb === "none") {
                 logger_1.logger.info("Cancelled — authentication requires a database");
                 process.exit(0);
@@ -207,15 +216,21 @@ async function getInteractiveConfig(modulesDir, projectInfo, options) {
         }
         const dbString = projectInfo?.hasPrisma ? "prisma" : "none";
         const authChoices = (0, module_discovery_1.getCompatibleAuthOptions)(discovered.auth || [], projectInfo?.framework || defaultFramework, dbString);
-        const authAnswers = await inquirer_1.default.prompt([
-            {
-                type: "list",
-                name: "auth",
-                message: "Select authentication:",
-                choices: authChoices,
-            },
-        ]);
-        const selectedAuth = authAnswers.auth;
+        const authChoicesNormalized = authChoices.map((c) => ({
+            title: c.name
+                ? c.description
+                    ? `${c.name} — ${c.description}`
+                    : c.name
+                : String(c.value ?? ""),
+            value: c.value ?? String(c.name ?? ""),
+        }));
+        const authResp = await (0, prompts_1.default)({
+            type: "select",
+            name: "auth",
+            message: "Select authentication:",
+            choices: authChoicesNormalized,
+        });
+        const selectedAuth = authResp.auth;
         if (selectedAuth === "none") {
             logger_1.logger.info("Cancelled");
             process.exit(0);
@@ -240,6 +255,35 @@ async function getInteractiveConfig(modulesDir, projectInfo, options) {
         }
         return result;
     }
+    else if (category === "components") {
+        const fw = projectInfo?.framework || defaultFramework;
+        const compMeta = (discovered.components || []).find((c) => !c.supportedFrameworks || c.supportedFrameworks.includes(fw));
+        if (!compMeta) {
+            logger_1.logger.info("No components available for this framework");
+            process.exit(0);
+        }
+        const compResp = await (0, prompts_1.default)({
+            type: "confirm",
+            name: "add",
+            message: `Add ${compMeta.displayName || compMeta.name}?${compMeta.description ? ` (${compMeta.description})` : ""}`,
+            initial: true,
+        });
+        if (compResp.add === false) {
+            logger_1.logger.info("No components selected");
+            process.exit(0);
+        }
+        const meta = await loadModuleMetadata(modulesDir, "components", "components");
+        if (!meta) {
+            logger_1.logger.error("Failed to load components module metadata");
+            process.exit(1);
+        }
+        return {
+            module: "components",
+            provider: "components",
+            displayName: meta.displayName || "Components",
+            metadata: meta,
+        };
+    }
     throw new Error("Invalid selection");
 }
 async function addModuleToProject(projectRoot, projectInfo, config, options) {
@@ -247,14 +291,12 @@ async function addModuleToProject(projectRoot, projectInfo, config, options) {
     const selectedProvider = config.provider;
     if (config.module === "auth" && projectInfo.hasAuth && !options?.force) {
         logger_1.logger.warn("Auth library already detected in this project");
-        const { proceed } = await inquirer_1.default.prompt([
-            {
-                type: "confirm",
-                name: "proceed",
-                message: "Continue anyway? (use --force to skip this prompt)",
-                default: false,
-            },
-        ]);
+        const { proceed } = await (0, prompts_1.default)({
+            type: "confirm",
+            name: "proceed",
+            message: "Continue anyway? (use --force to skip this prompt)",
+            initial: false,
+        });
         if (!proceed) {
             logger_1.logger.info("Cancelled");
             return;
@@ -262,14 +304,12 @@ async function addModuleToProject(projectRoot, projectInfo, config, options) {
     }
     if (config.module === "database" && projectInfo.hasDatabase && !options?.force) {
         logger_1.logger.warn("Database library already detected in this project");
-        const { proceed } = await inquirer_1.default.prompt([
-            {
-                type: "confirm",
-                name: "proceed",
-                message: "Continue anyway? (use --force to skip this prompt)",
-                default: false,
-            },
-        ]);
+        const { proceed } = await (0, prompts_1.default)({
+            type: "confirm",
+            name: "proceed",
+            message: "Continue anyway? (use --force to skip this prompt)",
+            initial: false,
+        });
         if (!proceed) {
             logger_1.logger.info("Cancelled");
             return;
@@ -287,7 +327,8 @@ async function addModuleToProject(projectRoot, projectInfo, config, options) {
         const moduleName = path_1.default.basename(moduleBasePath);
         const available = gen.getAvailableGenerators();
         const alreadyRegistered = (config.module === "database" && available.databases.includes(moduleName)) ||
-            (config.module === "auth" && available.auths.includes(moduleName));
+            (config.module === "auth" && available.auths.includes(moduleName)) ||
+            (config.module === "components" && available.components.length > 0);
         if (!alreadyRegistered) {
             const ops = [];
             if (Array.isArray(moduleMetadata.patches)) {
@@ -346,6 +387,9 @@ async function addModuleToProject(projectRoot, projectInfo, config, options) {
         if (config.module === "auth" && config.provider) {
             selectedModules.auth = config.provider;
         }
+        else if (config.module === "components") {
+            selectedModules.components = true;
+        }
         const postInstall = await gen.applyToProject(selectedModules, [], projectRoot);
         if (!options?.dryRun && options?.install !== false) {
             const installSpinner = logger_1.logger.startSpinner("Installing dependencies...");
@@ -367,7 +411,7 @@ async function addModuleToProject(projectRoot, projectInfo, config, options) {
                 const postInstallSpinner = logger_1.logger.startSpinner("Running post-install commands...");
                 try {
                     for (const command of postInstall) {
-                        (0, child_process_1.execSync)(command, { cwd: projectRoot, stdio: "pipe" });
+                        (0, child_process_1.execSync)(command, { cwd: projectRoot, stdio: "inherit" });
                     }
                     postInstallSpinner.succeed("Post-install commands completed");
                 }
@@ -447,7 +491,7 @@ async function addModuleToProject(projectRoot, projectInfo, config, options) {
             const postInstallSpinner = logger_1.logger.startSpinner("Running post-install commands...");
             try {
                 for (const command of moduleMetadata.postInstall) {
-                    (0, child_process_1.execSync)(command, { cwd: projectRoot, stdio: "pipe" });
+                    (0, child_process_1.execSync)(command, { cwd: projectRoot, stdio: "inherit" });
                 }
                 postInstallSpinner.succeed("Post-install commands completed");
             }
@@ -533,6 +577,17 @@ async function loadModuleMetadata(modulesDir, moduleName, provider) {
                 }
             }
         }
+        // Check flat module (e.g., modules/components/module.json)
+        const flatMetaPath = path_1.default.join(categoryPath, "module.json");
+        if (await fs_extra_1.default.pathExists(flatMetaPath)) {
+            const metadata = await fs_extra_1.default.readJSON(flatMetaPath);
+            if (provider && category === provider) {
+                return metadata;
+            }
+            if (!provider && (metadata.category === moduleName || category === moduleName)) {
+                return metadata;
+            }
+        }
     }
     return null;
 }
@@ -605,6 +660,17 @@ async function findModulePath(modulesDir, moduleName, provider) {
                 }
             }
         }
+        // Check flat module (e.g., modules/components/)
+        const flatMetaPath = path_1.default.join(categoryPath, "module.json");
+        if (await fs_extra_1.default.pathExists(flatMetaPath)) {
+            const metadata = await fs_extra_1.default.readJSON(flatMetaPath);
+            if (provider && category === provider) {
+                return categoryPath;
+            }
+            if (!provider && metadata.name === moduleName) {
+                return categoryPath;
+            }
+        }
     }
     return null;
 }

package/dist/cli/create.d.ts

@@ -17,6 +17,8 @@ interface CliOptions {
     noGit?: boolean;
     yes?: boolean;
     y?: boolean;
+    ui?: string;
+    storageProvider?: string;
 }
 export declare function createProject(projectName?: string, options?: CliOptions): Promise<void>;
 export {};