stackkit-cli 0.1.3 → 0.1.4
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md
CHANGED
|
@@ -1,118 +1,112 @@
|
|
|
1
|
-
#
|
|
1
|
+
# stackkit-cli
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
Main CLI package for StackKit - production-ready project generator with modular architecture.
|
|
4
4
|
|
|
5
|
-
|
|
5
|
+
[](https://www.npmjs.com/package/stackkit-cli)
|
|
6
6
|
|
|
7
|
-
|
|
7
|
+
## Installation
|
|
8
8
|
|
|
9
9
|
```bash
|
|
10
|
-
|
|
11
|
-
|
|
10
|
+
# Global installation
|
|
11
|
+
npm install -g stackkit-cli
|
|
12
12
|
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
```bash
|
|
16
|
-
pnpm dev
|
|
13
|
+
# Or use directly with npx
|
|
14
|
+
npx stackkit-cli@latest init my-app
|
|
17
15
|
```
|
|
18
16
|
|
|
19
|
-
|
|
17
|
+
## Usage
|
|
20
18
|
|
|
21
19
|
```bash
|
|
22
|
-
#
|
|
23
|
-
|
|
20
|
+
# Create new project
|
|
21
|
+
npx stackkit-cli init my-app
|
|
24
22
|
|
|
25
|
-
#
|
|
26
|
-
stackkit
|
|
27
|
-
|
|
28
|
-
|
|
23
|
+
# List available resources
|
|
24
|
+
npx stackkit-cli list
|
|
25
|
+
|
|
26
|
+
# Add modules to existing project
|
|
27
|
+
npx stackkit-cli add auth
|
|
29
28
|
```
|
|
30
29
|
|
|
31
30
|
## Commands
|
|
32
31
|
|
|
33
|
-
### `
|
|
32
|
+
### `init [project-name]`
|
|
34
33
|
|
|
35
34
|
Create a new project from a template.
|
|
36
35
|
|
|
37
36
|
**Options:**
|
|
38
|
-
|
|
39
|
-
-
|
|
40
|
-
- `--
|
|
41
|
-
- `--no-install` - Skip installing dependencies
|
|
37
|
+
- `--template <name>` - Template to use
|
|
38
|
+
- `--pm <npm|yarn|pnpm>` - Package manager (default: auto-detect)
|
|
39
|
+
- `--no-install` - Skip dependency installation
|
|
42
40
|
- `--no-git` - Skip git initialization
|
|
43
|
-
-
|
|
44
|
-
|
|
45
|
-
**Example:**
|
|
41
|
+
- `--yes` - Skip all prompts
|
|
46
42
|
|
|
43
|
+
**Examples:**
|
|
47
44
|
```bash
|
|
48
|
-
stackkit init my-app
|
|
45
|
+
npx stackkit-cli init my-app
|
|
46
|
+
npx stackkit-cli init my-app --template next-prisma-postgres-shadcn --pm pnpm
|
|
47
|
+
npx stackkit-cli init my-app --no-install --no-git --yes
|
|
49
48
|
```
|
|
50
49
|
|
|
51
|
-
### `
|
|
50
|
+
### `list`
|
|
52
51
|
|
|
53
52
|
List available templates and modules.
|
|
54
53
|
|
|
55
54
|
**Options:**
|
|
55
|
+
- `--templates` - Show templates only
|
|
56
|
+
- `--modules` - Show modules only
|
|
56
57
|
|
|
57
|
-
|
|
58
|
-
- `-m, --modules` - List only modules
|
|
59
|
-
|
|
60
|
-
**Example:**
|
|
61
|
-
|
|
58
|
+
**Examples:**
|
|
62
59
|
```bash
|
|
63
|
-
stackkit list
|
|
64
|
-
stackkit list --
|
|
60
|
+
npx stackkit-cli list
|
|
61
|
+
npx stackkit-cli list --templates
|
|
62
|
+
npx stackkit-cli list --modules
|
|
65
63
|
```
|
|
66
64
|
|
|
67
|
-
### `
|
|
65
|
+
### `add <module>`
|
|
68
66
|
|
|
69
67
|
Add a module to your existing project.
|
|
70
68
|
|
|
71
69
|
**Options:**
|
|
72
|
-
|
|
73
|
-
- `--provider <provider>` - Specific provider/variant
|
|
70
|
+
- `--dry-run` - Preview changes without applying
|
|
74
71
|
- `--force` - Overwrite existing files
|
|
75
|
-
- `--
|
|
76
|
-
- `--no-install` - Skip installing dependencies
|
|
77
|
-
|
|
78
|
-
**Example:**
|
|
72
|
+
- `--no-install` - Skip dependency installation
|
|
79
73
|
|
|
74
|
+
**Examples:**
|
|
80
75
|
```bash
|
|
81
|
-
stackkit add auth
|
|
82
|
-
stackkit add auth --dry-run
|
|
83
|
-
stackkit add auth --force
|
|
76
|
+
npx stackkit-cli add auth
|
|
77
|
+
npx stackkit-cli add auth --dry-run
|
|
78
|
+
npx stackkit-cli add auth --force
|
|
84
79
|
```
|
|
85
80
|
|
|
86
|
-
##
|
|
81
|
+
## Development
|
|
87
82
|
|
|
88
|
-
|
|
83
|
+
```bash
|
|
84
|
+
# Install dependencies
|
|
85
|
+
pnpm install
|
|
89
86
|
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
- `add.ts` - Add modules
|
|
87
|
+
# Build package
|
|
88
|
+
pnpm build
|
|
93
89
|
|
|
94
|
-
|
|
90
|
+
# Link globally for testing
|
|
91
|
+
pnpm link --global
|
|
95
92
|
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
|
|
99
|
-
- `json-editor.ts` - Safe JSON file editing
|
|
100
|
-
- `env-editor.ts` - Environment variable management
|
|
101
|
-
- `code-inject.ts` - Idempotent code injection
|
|
102
|
-
- `logger.ts` - Consistent CLI output
|
|
93
|
+
# Test locally
|
|
94
|
+
stackkit init test-app
|
|
95
|
+
```
|
|
103
96
|
|
|
104
|
-
|
|
97
|
+
## Publishing
|
|
105
98
|
|
|
106
|
-
|
|
99
|
+
The package uses automated build process:
|
|
107
100
|
|
|
108
|
-
|
|
101
|
+
```bash
|
|
102
|
+
# Version bump
|
|
103
|
+
npm version patch|minor|major
|
|
109
104
|
|
|
110
|
-
|
|
105
|
+
# Publish (prepublishOnly will auto-build and copy templates/modules)
|
|
106
|
+
npm publish --access public
|
|
107
|
+
```
|
|
111
108
|
|
|
112
|
-
|
|
113
|
-
2. Build the package: `pnpm build`
|
|
114
|
-
3. Test locally: `pnpm link --global`
|
|
115
|
-
4. Publish: `npm publish --access public`
|
|
109
|
+
See main [README](../../README.md) for more details.
|
|
116
110
|
|
|
117
111
|
## License
|
|
118
112
|
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../src/commands/list.ts"],"names":[],"mappings":"AAMA,UAAU,WAAW;IACnB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,wBAAsB,WAAW,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,
|
|
1
|
+
{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../src/commands/list.ts"],"names":[],"mappings":"AAMA,UAAU,WAAW;IACnB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,wBAAsB,WAAW,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CA6DrE"}
|
package/dist/commands/list.js
CHANGED
|
@@ -25,8 +25,6 @@ async function listCommand(options) {
|
|
|
25
25
|
for (const template of templates) {
|
|
26
26
|
logger_1.logger.log(chalk_1.default.bold(` ${template.displayName}`));
|
|
27
27
|
logger_1.logger.log(chalk_1.default.gray(` ${template.description}`));
|
|
28
|
-
logger_1.logger.log(chalk_1.default.blue(` Command: stackkit init --template ${template.name}`));
|
|
29
|
-
logger_1.logger.log(chalk_1.default.gray(` Features: ${template.features.join(', ')}`));
|
|
30
28
|
logger_1.logger.newLine();
|
|
31
29
|
}
|
|
32
30
|
}
|
|
@@ -54,8 +52,6 @@ async function listCommand(options) {
|
|
|
54
52
|
for (const mod of mods) {
|
|
55
53
|
logger_1.logger.log(chalk_1.default.bold(` ${mod.displayName}`));
|
|
56
54
|
logger_1.logger.log(chalk_1.default.gray(` ${mod.description}`));
|
|
57
|
-
logger_1.logger.log(chalk_1.default.blue(` Command: stackkit add ${mod.name}`));
|
|
58
|
-
logger_1.logger.log(chalk_1.default.gray(` Supports: ${mod.supportedFrameworks.join(', ')}`));
|
|
59
55
|
logger_1.logger.newLine();
|
|
60
56
|
}
|
|
61
57
|
}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"list.js","sourceRoot":"","sources":["../../src/commands/list.ts"],"names":[],"mappings":";;;;;AAWA,
|
|
1
|
+
{"version":3,"file":"list.js","sourceRoot":"","sources":["../../src/commands/list.ts"],"names":[],"mappings":"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"}
|
package/package.json
CHANGED
|
@@ -1,53 +1,59 @@
|
|
|
1
|
-
#
|
|
1
|
+
# Project
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
Created with [StackKit](https://github.com/tariqul420/stackkit).
|
|
4
4
|
|
|
5
|
-
##
|
|
6
|
-
|
|
7
|
-
1. Install dependencies:
|
|
5
|
+
## Setup
|
|
8
6
|
|
|
9
7
|
```bash
|
|
8
|
+
# Install dependencies
|
|
10
9
|
pnpm install
|
|
11
|
-
```
|
|
12
10
|
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
```bash
|
|
11
|
+
# Configure environment
|
|
16
12
|
cp .env.example .env
|
|
13
|
+
# Update DATABASE_URL in .env
|
|
14
|
+
|
|
15
|
+
# Run migrations
|
|
16
|
+
pnpm prisma migrate dev
|
|
17
|
+
|
|
18
|
+
# Start dev server
|
|
19
|
+
pnpm dev
|
|
17
20
|
```
|
|
18
21
|
|
|
19
|
-
|
|
22
|
+
Open [http://localhost:3000](http://localhost:3000)
|
|
20
23
|
|
|
21
|
-
|
|
24
|
+
## Stack
|
|
22
25
|
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
+
- Next.js 15 (App Router)
|
|
27
|
+
- TypeScript
|
|
28
|
+
- Prisma + PostgreSQL
|
|
29
|
+
- Tailwind CSS
|
|
30
|
+
- shadcn/ui
|
|
31
|
+
- Zod validation
|
|
26
32
|
|
|
27
|
-
|
|
33
|
+
## Structure
|
|
28
34
|
|
|
29
|
-
```
|
|
30
|
-
|
|
35
|
+
```
|
|
36
|
+
├── app/ # Next.js routes
|
|
37
|
+
├── lib/ # Utilities
|
|
38
|
+
├── prisma/ # Database schema
|
|
39
|
+
└── public/ # Static files
|
|
31
40
|
```
|
|
32
41
|
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
## Tech Stack
|
|
42
|
+
## Scripts
|
|
36
43
|
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
44
|
+
```bash
|
|
45
|
+
pnpm dev # Development server
|
|
46
|
+
pnpm build # Production build
|
|
47
|
+
pnpm start # Start production
|
|
48
|
+
pnpm lint # Run linter
|
|
49
|
+
pnpm prisma studio # Open Prisma Studio
|
|
50
|
+
```
|
|
43
51
|
|
|
44
|
-
##
|
|
52
|
+
## Add Features
|
|
45
53
|
|
|
54
|
+
```bash
|
|
55
|
+
npx stackkit-cli add auth
|
|
46
56
|
```
|
|
47
|
-
├── app/ # Next.js App Router
|
|
48
|
-
│ ├── api/ # API routes
|
|
49
|
-
│ ├── layout.tsx # Root layout
|
|
50
|
-
│ └── page.tsx # Home page
|
|
51
57
|
├── lib/ # Shared utilities
|
|
52
58
|
│ ├── db.ts # Prisma client
|
|
53
59
|
│ └── env.ts # Environment validation
|