@shivasankaran18/stackd 1.1.0

package/.github/workflows/ci.yml

@@ -0,0 +1,30 @@
+name: CI/CD Pipeline
+
+on:
+  push:
+    branches:
+      - main
+  pull_request:
+    branches:
+      - main
+      
+jobs:
+  build-and-test:
+    name: Build and Test Next.js
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 18
+          cache: 'npm'
+
+      - name: Install dependencies
+        run: npm install
+        
+      - name: Build Next.js App
+        run: npm run build

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Shiva
+
+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,115 @@
+# STACKD - Full-Stack Scaffolding Tool
+
+STACKD (Abbreviation TBD) is an open-source scaffolding tool that simplifies the process of setting up a full-stack web application. It allows developers to generate a project with pre-configured frontend, backend, database, authentication, and other essential components in just a few clicks.
+
+## 📖 Table of Contents
+
+- [Motivation](#motivation)
+- [Features](#features)
+- [Tech Stack Options](#tech-stack-options)
+- [Installation](#installation)
+- [Usage](#usage)
+- [Future Ideas](#future-ideas)
+- [License](#license)
+
+## 💡 Motivation
+
+Every time my team and I participated in a hackathon, we found ourselves spending a significant amount of time setting up the project’s basic structure—configuring the frontend, backend, database, authentication, and other essential components. The same challenge extends to professionals in the industry, where initial setup can be tedious and time-consuming. To solve this, we created STACKD—a tool that eliminates repetitive setup tasks, allowing developers to focus on building their applications right away.
+
+## 🚀 Features
+
+- **Flexible Project Setup**: Choose from multiple frontend, backend, database, and authentication options.
+- **Automated Configuration**: Generates all necessary files, environment variables, and configurations.
+- **Git Integration**: Initializes a Git repository and sets up the remote origin.
+- **Pre-configured ORM & Database**: Automatically connects the chosen ORM with the selected database.
+- **Instant Deployment Readiness**: Sets up authentication, UI frameworks, and other dependencies for a fully functional project.
+- **Multiple Interfaces**: STACKD provides both a **CLI** and a **Graphical User Interface (GUI)** for easy project setup.
+
+## 🎥 Demo
+
+### CLI Demo
+https://github.com/user-attachments/assets/debe9515-a38f-4ba2-9126-b9b6f95e3a87
+
+### Web Tool Demo
+https://github.com/user-attachments/assets/465451f2-1e1a-48b6-a99e-253ef4f28e2d
+
+
+## 🛠️ Tech Stack Options
+
+### **Frontend**
+
+- React.js
+- React TypeScript
+- Next.js
+- Vue.js
+- Vue TypeScript
+- Angular TypeScript
+- Django (Frontend Templates)
+
+### **Backend**
+
+- Express.js
+- Express TypeScript
+- Django Rest Framework
+
+### **Database**
+
+- PostgreSQL
+- MongoDB
+
+### **ORM**
+
+- Prisma
+- Hazel
+- Mongoose
+
+### **UI Framework**
+
+- ShadCN
+- Tailwind CSS
+
+### **Authentication**
+
+- JWT
+- NextAuth
+- Passport
+
+### 🛆 Installation
+
+### Prerequisites
+
+Make sure you have the following installed on your system:
+
+- Node.js
+- Git
+
+### Using `npm`
+
+```sh
+npm i @shivasankaran18/stackd
+npx stackd create
+```
+
+### Using `npx`
+
+```sh
+npx @shivasankaran18/stackd create
+```
+
+## ⚡ Usage
+
+Select the frontend, backend, UI, database, ORM, authentication method, database URL, and GitHub URL, and **BOOM!** Your project is ready to work.
+
+## 🔮 Future Ideas
+
+- Adding desktop tools like **Electron**.
+- Expanding support for more development tools and frameworks.
+- Adding mobile app development tools.
+- Building a **robust and efficient** platform that works across **Windows, Linux, and macOS**.
+- Integrating **automated deployment** features, allowing users to deploy their applications instantly.
+- Enabling **Git commit automation and CI/CD integration**, so projects stay updated with minimal manual effort.
+
+## 📜 License
+
+This project is licensed under the MIT License. You are free to use, modify, and distribute this software under the terms of the MIT LICENSE.
+

package/apps/cli/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "@shivasankaran18/stackd",
+  "version": "1.0.0",
+  "main": "index.js",
+  "type": "module",
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "bin": {
+    "mycli": "./cli.js"
+  },
+  "keywords": [],
+  "author": "",
+  "license": "ISC",
+  "description": "",
+  "dependencies": {
+    "@types/chalk": "^2.2.4",
+    "@types/commander": "^2.12.5",
+    "@types/node": "^22.13.5",
+    "chalk": "4",
+    "commander": "^13.1.0",
+    "fs": "^0.0.1-security",
+    "gradient-string": "^3.0.0",
+    "inquirer": "^12.4.2",
+    "ora": "^8.2.0",
+    "path": "^0.12.7"
+  },
+  "devDependencies": {
+    "ts-node": "^10.9.2",
+    "typescript": "^5.7.3"
+  }
+}

package/apps/cli/src/cli.ts

@@ -0,0 +1,271 @@
+#!/usr/bin/env node
+import { program } from 'commander';
+import inquirer from 'inquirer';
+import chalk from 'chalk';
+import { createProject } from './commands/create.js'
+
+export interface ProjectConfig {
+  projectName: string;
+  projectPath: string;
+  frontendPort: number;
+  backendPort: number;
+  frontend: string;
+  backend: string;
+  database: string;
+  orm: string;
+  auth: string;
+  dbUrl: string;
+}
+
+interface Answers {
+  projectPath: string;
+  frontendPort: number;
+  backendPort: number;
+  frontend: string;
+  backend: string;
+  database: string;
+  orm: string;
+  auth: string;
+  dbUrl: string;
+  projectName:string;
+}
+
+const showBanner = () => {
+  console.log(chalk.cyan(`
+     ██████╗████████╗ █████╗  ██████╗██╗  ██╗'██████╗ 
+    ██╔════╝╚══██╔══╝██╔══██╗██╔════╝██║ ██╔╝██╔══██╗
+    ╚█████╗    ██║   ███████║██║     █████═╝ ██║  ██║
+     ╚═══██╗   ██║   ██╔══██║██║     ██╔═██╗ ██║  ██║
+    ██████╔╝   ██║   ██║  ██║╚██████╗██║  ██╗██████╔╝
+    ╚═════╝    ╚═╝   ╚═╝  ╚═╝ ╚═════╝╚═╝  ╚═╝╚═════╝ 
+  `));
+  console.log(chalk.yellow.bold('  🚀 Full Stack Project Generator\n'));
+};
+
+
+const createBorder = () => {
+  const border = '='.repeat(60);
+  return chalk.cyan(border);
+
+};
+
+const CHOICES = {
+  EXPRESS_TS: 'Express + TypeScript',
+  EXPRESS_JS: 'Express (JavaScript)',
+  DJANGO: 'Django',
+  REACT_TS: 'React + TypeScript',
+  REACT_JS: 'React (JavaScript)',
+  VUE_TS: 'Vue + TypeScript',
+  VUE_JS: 'Vue (JavaScript)',
+  DJANGO_TEMPLATES: 'Django Templates',
+  NONE: 'None',
+  SKIP: 'Skip',
+  POSTGRESQL: 'PostgreSQL',
+  MONGODB: 'MongoDB',
+  PRISMA: 'Prisma',
+  DRIZZLE: 'Drizzle',
+  MONGOOSE: 'Mongoose',
+  JWT: 'JWT',
+  NEXTAUTH: 'NextAuth',
+  PASSPORT: 'Passport'
+};
+
+program
+  .command('run ')
+  .description('Create a new full-stack project')
+  .action(async () => {
+    // showBanner();
+    // console.log(createBorder());
+    // console.log(chalk.bgCyan.white.bold('\n  💫 Let\'s create something awesome!  \n'));
+    // console.log(createBorder() + '\n');
+
+    const projectSettings = await inquirer.prompt([
+      {
+        type: 'input',
+        name: 'projectPath',
+        message: chalk.magenta.bold('📁 Where do you want to create the project?'),
+
+      },
+      {
+        type:'input',
+        name:'projectName',
+        message:chalk.magenta.bold('💫 Enter the project name:'),
+      },
+      
+      {
+        type: 'number',
+        name: 'frontendPort',
+        message: chalk.blue.bold('🌐 Enter frontend port:'),
+        default: 3000,
+      },
+      {
+        type: 'number',
+        name: 'backendPort',
+        message: chalk.green.bold('⚙️  Enter backend port:'),
+        default: 3001,
+      }
+    ]);
+
+    
+    const frontendChoice = await inquirer.prompt([
+      {
+        type: 'list',
+        name: 'frontend',
+        message: chalk.yellow.bold('🎨 Choose a frontend framework:'),
+        choices: [
+          chalk.blue(CHOICES.REACT_TS),
+          chalk.blue(CHOICES.REACT_JS),
+          chalk.green(CHOICES.VUE_TS),
+          chalk.green(CHOICES.VUE_JS),
+          chalk.green(CHOICES.DJANGO_TEMPLATES),
+          CHOICES.SKIP
+        ],
+        default: CHOICES.SKIP,
+      }
+    ]);
+
+
+    const backendChoice = await inquirer.prompt([
+      {
+        type: 'list',
+        name: 'backend',
+        message: chalk.cyan.bold('🛠️  Choose a backend framework:'),
+        choices: (answers) => {
+          if (frontendChoice.frontend === chalk.green(CHOICES.DJANGO_TEMPLATES)) {
+            return [chalk.green(CHOICES.DJANGO)];
+          }
+          return [
+            chalk.blue(CHOICES.EXPRESS_TS),
+            chalk.blue(CHOICES.EXPRESS_JS),
+            chalk.green(CHOICES.DJANGO),
+            CHOICES.SKIP
+          ];
+        },
+        default: chalk.blue(CHOICES.EXPRESS_TS),
+      }
+    ]);
+
+   
+    const databaseChoice = await inquirer.prompt([
+      {
+        type: 'list',
+        name: 'database',
+        message: chalk.magenta.bold('🗄️  Choose a database:'),
+        choices: [
+          chalk.blue(CHOICES.POSTGRESQL),
+          chalk.green(CHOICES.MONGODB),
+          CHOICES.SKIP
+        ],
+        default: CHOICES.SKIP,
+      }
+    ]);
+
+
+    let ormChoice = { orm: CHOICES.SKIP };
+    if (databaseChoice.database !== CHOICES.SKIP) {
+      ormChoice = await inquirer.prompt([
+        {
+          type: 'list',
+          name: 'orm',
+          message: chalk.yellow.bold('🔗 Choose an ORM:'),
+          choices: () => {
+            const cleanDatabase = databaseChoice.database.replace(/\u001b\[\d+m/g, '').trim();
+            return cleanDatabase === CHOICES.POSTGRESQL
+              ? [chalk.magenta(CHOICES.PRISMA), chalk.cyan(CHOICES.DRIZZLE), CHOICES.SKIP]
+              : [chalk.green(CHOICES.MONGOOSE), CHOICES.SKIP];
+          },
+          default: CHOICES.SKIP,
+        }
+      ]);
+    }
+
+      // Step 6: Authentication Selection
+    const authChoice = await inquirer.prompt([
+      {
+        type: 'list',
+        name: 'auth',
+        message: chalk.cyan.bold('🔐 Choose an authentication method:'),
+        choices: [
+          chalk.yellow(CHOICES.JWT),
+          chalk.blue(CHOICES.NEXTAUTH),
+          chalk.green(CHOICES.PASSPORT),
+          CHOICES.SKIP
+        ],
+        default: CHOICES.SKIP,
+      }
+    ]);
+
+    let dbUrlChoice = { dbUrl: '' };
+    if (databaseChoice.database !== CHOICES.SKIP) {
+      dbUrlChoice = await inquirer.prompt([
+        {
+          type: 'input',
+          name: 'dbUrl',
+          message: chalk.green.bold('🔌 Enter database connection URL:'),
+        }
+      ]);
+    }
+
+
+    const answers = {
+      ...projectSettings,
+      ...frontendChoice,
+      ...backendChoice,
+      ...databaseChoice,
+      ...ormChoice,
+      ...authChoice,
+      ...dbUrlChoice,
+    };
+
+
+    const cleanAnswers = Object.entries(answers).reduce((acc, [key, value]) => {
+      if (typeof value === 'string') {
+        const cleanValue = value.replace(/\u001b\[\d+m/g, '').trim();
+        // @ts-ignore
+        acc[key] = cleanValue;
+      } else {
+        // @ts-ignore
+        acc[key] = value;
+      }
+      return acc;
+    }, {});
+
+
+    // @ts-ignore
+    if (cleanAnswers.database !== 'Skip' && cleanAnswers.orm !== 'Skip') {
+      // @ts-ignore
+      if (cleanAnswers.database === 'MongoDB' && cleanAnswers.orm !== 'Mongoose') {
+        console.log('\n' + createBorder());
+        console.error(chalk.bgRed.white.bold(" ❌ Error: MongoDB supports only Mongoose ORM. "));
+        console.log(createBorder());
+        process.exit(1);
+      }
+      // @ts-ignore
+      if (cleanAnswers.database === 'PostgreSQL' && !['Prisma', 'Drizzle'].includes(cleanAnswers.orm)) {
+        console.log('\n' + createBorder());
+        console.error(chalk.bgRed.white.bold(" ❌ Error: PostgreSQL supports only Prisma or Drizzle ORM. "));
+        console.log(createBorder());
+        process.exit(1);
+      }
+    }
+
+
+    // @ts-ignore
+    if (cleanAnswers.frontend === 'Django Templates') {
+      // @ts-ignore
+      cleanAnswers.backend = 'Django';
+    }
+    // @ts-ignore
+    if (cleanAnswers.backend === 'Django') {
+      // @ts-ignore
+      cleanAnswers.frontend = 'Django Templates';
+    }
+
+    console.log('\n' + createBorder());
+    console.log(chalk.bgGreen.black.bold("\n 📦 Creating your project... \n"));
+    console.log(createBorder() + '\n');
+    // @ts-ignore
+    await createProject(projectSettings.projectName, cleanAnswers);
+  });
+
+program.parse(process.argv);

package/apps/cli/src/commands/create.ts

@@ -0,0 +1,162 @@
+import { join } from 'path';
+import { createReactTS } from '../scripts/frontend/reactts.js';
+import { createReactJS } from '../scripts/frontend/reactjs.js';
+import { createVueTS } from '../scripts/frontend/vuets.js';
+import { createVueJS } from '../scripts/frontend/vuejs.js';
+import { createExpressTS } from '../scripts/backend/expressts.js';
+import { createExpressJS } from '../scripts/backend/expressjs.js';
+import { installDjangoDependencies } from '../scripts/backend/django.js';
+import { setupPrisma } from '../scripts/orms/prismaSetup.js';
+import { setupDrizzle } from '../scripts/orms/drizzleSetup.js';
+import { setupMongoose } from '../scripts/orms/mongoSetup.js';
+import { setupNextAuth } from '../scripts/Auth/nextAuth.js';
+import { setupPassport } from '../scripts/Auth/passport.js';
+import { jwtAuthts } from '../scripts/Auth/jwt.js';
+import chalk from 'chalk';
+import ora from 'ora';
+import { mkdir } from 'fs/promises';
+import { ProjectConfig } from '../cli.js';
+
+const emitLog = (message: string): void => {
+  console.log(`[Emit Logs]: ${message}`);
+};
+
+export async function createProject(projectName: string, options: ProjectConfig) {
+  const spinner = ora('Creating project...').start();
+  console.log(options);
+  console.log(projectName);
+  try {
+    const projectDir = join(options.projectPath, projectName);
+    const config = {
+      projectName,
+      projectPath: options.projectPath,
+      frontendPort: options.frontendPort,
+      backendPort: options.backendPort,
+      dbUrl: options.dbUrl,
+    };
+
+    // Create project directory
+    await mkdir(projectDir, { recursive: true });
+    
+    // Frontend setup
+    spinner.text = 'Setting up frontend...';
+    switch(options.frontend) {
+      case 'React + TypeScript':
+        await createReactTS(config, projectDir, emitLog);
+        break;
+      case 'React (JavaScript)':
+        await createReactJS(config, projectDir, emitLog);
+        break;
+      case 'Vue + TypeScript':
+        await createVueTS(config, projectDir, emitLog);
+        break;
+      case 'Vue (JavaScript)':
+        await createVueJS(config, projectDir, emitLog);
+        break;
+      case 'Django Templates':
+        // Django templates will be handled with backend setup
+        break;
+      case 'Skip':
+        emitLog('Skipping frontend setup');
+        break;
+      default:
+        emitLog('Unknown frontend choice');
+        break;
+    }
+
+    // Backend setup
+    spinner.text = 'Setting up backend...';
+    switch(options.backend) {
+      case 'Express + TypeScript':
+        await createExpressTS(config, projectDir,emitLog);
+        break;
+      case 'Express (JavaScript)':
+        await createExpressJS(config, projectDir,emitLog);
+        break;
+      case 'Django':
+        await installDjangoDependencies(projectDir);
+        break;
+      case 'Skip':
+        emitLog('Skipping backend setup');
+        break;
+      default:
+        emitLog('Unknown backend choice');
+        break;
+    }
+
+    // Database & ORM setup
+    if (options.database !== 'Skip') {
+      spinner.text = 'Setting up database and ORM...';
+      
+      // Set up ORM based on database choice
+      if (options.orm !== 'Skip') {
+        switch(options.orm) {
+          case 'Prisma':
+            await setupPrisma(config, projectDir,emitLog);
+            break;
+          case 'Drizzle':
+            await setupDrizzle(config, projectDir,emitLog);
+            break;
+          case 'Mongoose':
+            await setupMongoose(config, projectDir,emitLog);
+            break;
+          default:
+            emitLog('Unknown ORM choice');
+            break;
+        }
+      }
+    }
+
+    // Authentication setup
+    if (options.auth !== 'Skip') {
+      spinner.text = 'Setting up authentication...';
+      switch(options.auth ) {
+        case 'JWT':
+          await jwtAuthts(config, projectDir,emitLog);
+          break;
+        // case 'NextAuth':
+        //   await setupNextAuth(config, projectDir,emitLog);
+        //   break;
+        case 'Passport':
+          await setupPassport(config, projectDir,emitLog  );
+          break;
+        default:
+          emitLog('Unknown authentication choice');
+          break;
+      }
+    }
+
+    spinner.succeed(chalk.green('Project created successfully!'));
+    
+
+    console.log('\nTo get started:');
+    console.log(chalk.cyan(`  cd ${projectName}`));
+    
+    // Add specific instructions based on choices
+    if (options.frontend !== 'Skip' || options.backend !== 'Skip') {
+      // console.log(chalk.cyan('  npm install'));
+      
+      if (options.frontend === 'Django Templates' || options.backend === 'Django') {
+        console.log(chalk.cyan('  python manage.py runserver'));
+      } else {
+        console.log(chalk.cyan('  npm run dev'));
+      }
+    }
+
+    // Add database specific instructions
+    if (options.database !== 'Skip') {
+      console.log(chalk.yellow('\nDatabase Setup:'));
+      if (options.orm === 'Prisma') {
+        console.log(chalk.cyan('  npx prisma generate'));
+        console.log(chalk.cyan('  npx prisma migrate dev'));
+      } else if (options.orm === 'Mongoose') {
+        console.log(chalk.cyan('  Make sure MongoDB is running'));
+      }
+    }
+    
+  } catch (error) {
+    spinner.fail(chalk.red('Failed to create project'));
+    console.error(error);
+    process.exit(1);
+  }
+}