@shakil-dev/shakil-stack 1.0.0 → 1.2.0

package/.github/workflows/publish.yml

@@ -0,0 +1,47 @@
+name: Publish to NPM
+
+on:
+  push:
+    branches:
+      - main
+
+permissions:
+  contents: write
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout Code
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0 # We need to fetch all history to push tags
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          registry-url: 'https://registry.npmjs.org'
+
+      - name: Install Dependencies
+        run: npm ci
+
+      - name: Debug Git Status
+        run: git status
+
+      - name: Set Git Identity
+        run: |
+          git config --global user.name "github-actions[bot]"
+          git config --global user.email "github-actions[bot]@users.noreply.github.com"
+          git add . # Ensure any changes like package-lock.json are staged
+
+      - name: Bump Version
+        run: npm version patch
+
+      - name: Publish to NPM
+        run: npm publish --access public
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+
+      - name: Push Version Change to GitHub
+        run: git push origin main --tags

package/README.md

@@ -0,0 +1,79 @@
+# Shakil-Stack Project Generator 🚀
+
+**Shakil-Stack** is a powerful full-stack project generator CLI that scaffolds a robust, production-ready environment based on the **EchoNet** backend architecture and a modern **Next.js** frontend.
+
+## ✨ Features
+
+- **🛡️ EchoNet-Style Backend**:
+    - **Architecture**: Clean `src/app/...` structure (config, middleware, routes, utils).
+    - **Database**: Prisma 7+ with PostgreSQL adapter.
+    - **Authentication**: Pre-configured **Better Auth** with User, Session, and Account models.
+    - **Security**: Helmet, Express Rate Limit, and Request Sanitizer.
+    - **Error Handling**: Global error handler with `ApiError` support.
+    - **Validation**: Zod-ready structure.
+- **🌐 Next.js Frontend**:
+    - Modern Next.js (App Router, TypeScript, Tailwind CSS).
+    - Pre-defined project folders: `config`, `hooks`, `lib`, `services`, `types`.
+- **🛠️ Interactive Setup**: Choose your package manager (npm, pnpm, yarn) and auto-install dependencies.
+
+## 🚀 Getting Started
+
+You can generate a new project instantly using `npx`:
+
+```bash
+npx @shakil-dev/shakil-stack my-awesome-project
+```
+
+### Or, if already installed globally:
+
+```bash
+shakil-stack my-awesome-project
+```
+
+## 📂 Project Structure
+
+```text
+my-awesome-project/
+├── backend/
+│   ├── prisma/
+│   │   └── schema.prisma (Better Auth & Prisma 7 ready)
+│   ├── src/
+│   │   ├── server.ts
+│   │   └── app/ (EchoNet logic)
+│   └── .env
+├── frontend/ (Next.js App)
+│   ├── src/
+│   │   ├── app/
+│   │   ├── components/
+│   │   └── ...
+└── README.md
+```
+
+## 🏗️ Post-Installation Steps
+
+After the generator finishes, follow these steps to start your development:
+
+1.  **Configure Database**: Update the `DATABASE_URL` in `backend/.env`.
+2.  **Start Backend**:
+    ```bash
+    cd backend
+    pnpm dev  # or npm run dev
+    ```
+3.  **Start Frontend**:
+    ```bash
+    cd frontend
+    pnpm dev  # or npm run dev
+    ```
+
+## 📜 Commands (Backend)
+
+- `pnpm dev`: Starts the server with `tsx` and `nodemon`.
+- `pnpm build`: Builds the project using `tsup`.
+- `pnpm start`: Runs the built project from  `dist/`.
+
+## 🤝 Contributing
+
+Feel free to open issues or submit pull requests to improve the Shakil-Stack generator!
+
+---
+Developed with by **Shakil Ahmed Billal**

package/bin/index.js

@@ -69,6 +69,7 @@ async function main() {
     spinner.text = `📦 Running create-next-app for frontend...`;
     spinner.stop(); 
     
+    // We run create-next-app in the project root to create the 'frontend' folder
     const nextAppCmd = `npx create-next-app@latest frontend --typescript --tailwind --eslint --app --src-dir --import-alias "@/*" --use-${packageManager} --no-git`;
     try {
       execSync(nextAppCmd, { cwd: projectPath, stdio: 'inherit' });
@@ -88,9 +89,9 @@ async function main() {
     // 5. Root Files
     await fs.outputFile(path.join(projectPath, '.env'), 'DATABASE_URL="postgresql://user:password@localhost:5432/mydb"\nPORT=8000\nNODE_ENV=development\nJWT_SECRET="your-secret-key"');
     await fs.outputFile(path.join(projectPath, '.gitignore'), 'node_modules\n.env\ndist\n*.db\n.next\n.DS_Store');
-    await fs.outputFile(path.join(projectPath, 'README.md'), `# ${projectName}\n\nGenerated with Full EchoNet-style CLI.`);
+    await fs.outputFile(path.join(projectPath, 'README.md'), `# ${projectName}\n\nGenerated with Full Shakil-Stack CLI.`);
 
-    // 6. Backend Files (Refined)
+    // 6. Backend Files (Complete EchoNet Clone)
     
     const serverTs = `import { Server } from 'http';
 import app from './app.js';
@@ -304,6 +305,7 @@ export const sanitizeRequest = (req: Request, res: Response, next: NextFunction)
 
 datasource db {
   provider = "postgresql"
+  url      = env("DATABASE_URL")
 }
 
 model User {
@@ -342,6 +344,39 @@ model Account {
   updatedAt             DateTime  @updatedAt
   user                  User      @relation(fields: [userId], references: [id], onDelete: Cascade)
 }
+`;
+
+    const prismaConfigTs = `import "dotenv/config";
+import { defineConfig } from "prisma/config";
+import process from "process";
+
+export default defineConfig({
+  schema: "prisma/schema.prisma",
+  datasource: {
+    url: process.env.DATABASE_URL,
+  },
+});
+`;
+
+    const tsconfigTs = `{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "baseUrl": ".",
+    "paths": {
+      "@/*": ["src/*"]
+    }
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}
 `;
 
     // Write backend files
@@ -358,6 +393,9 @@ model Account {
     await fs.outputFile(path.join(projectPath, 'backend', 'src', 'app', 'utils', 'sanitizer.ts'), sanitizerTs);
     await fs.outputFile(path.join(projectPath, 'backend', 'src', 'app', 'errorHelpers', 'ApiError.ts'), apiErrorTs);
     await fs.outputFile(path.join(projectPath, 'backend', 'prisma', 'schema.prisma'), schemaPrisma);
+    await fs.outputFile(path.join(projectPath, 'backend', 'prisma.config.ts'), prismaConfigTs);
+    await fs.outputFile(path.join(projectPath, 'backend', 'tsconfig.json'), tsconfigTs);
+    await fs.outputFile(path.join(projectPath, 'backend', '.gitignore'), 'node_modules\ndist\n.env');
     await fs.outputFile(path.join(projectPath, 'backend', '.env'), 'DATABASE_URL="postgresql://user:password@localhost:5432/mydb"\nJWT_SECRET="your-secret-key"');
 
     // Backend package.json

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shakil-dev/shakil-stack",
-  "version": "1.0.0",
+  "version": "1.2.0",
   "description": "Full-stack EchoNet-style project generator CLI",
   "main": "./bin/index.js",
   "bin": {