ScaffoldJS 🏗️

A powerful CLI tool for scaffolding code templates with multi-variable support. Generate consistent, organized code structures across your projects with customizable templates and flexible variable transformations.

✨ Features

• 🎯 Multi-Variable Support - Use multiple custom variables like module, feature, domain, etc.
• 🔄 Smart Transformations - Built-in case transformations (camelCase, PascalCase, snake_case, etc.)
• 📁 Flexible Structure - Generate files in any directory structure
• 💉 Template Injection - Inject code snippets into existing files
• 👥 Template Groups - Generate multiple related files at once
• 🔧 Configurable - JSON-based configuration for all templates
• ⚡ CLI Friendly - Simple, intuitive command-line interface
• 🔄 Backward Compatible - Works with existing single-variable setups

🚀 Quick Start

# Install globally
npm install -g scaffoldjs-cli

# Or use directly with npx
npx scaffold help

Initialize Your Project

# Set up configuration and default templates
npx scaffold setup

# View available templates
npx scaffold list

# Get help
npx scaffold help

# View comprehensive guide
npx scaffold guide

📖 Usage

Basic Commands

# Generate a single file
npx scaffold make user controller

# Generate with custom variables
npx scaffold make table controller -v module=restaurant feature=dining

# Generate multiple files using a group
npx scaffold make booking crud-group -v module=hotel feature=reservations

# Inject code into existing files
npx scaffold inject import-statement src/app.module.ts -v module=auth

# Force overwrite existing files
npx scaffold make order service -v module=ecommerce --force

Command Reference

Command	Description	Example
setup	Initialize scaffoldjs in your project	npx scaffold setup
list	Show available templates and groups	npx scaffold list
make <resource> <template>	Generate new files from templates	npx scaffold make user controller
inject <template> <file>	Inject code into existing files	npx scaffold inject method src/user.service.ts
help	Display help information	npx scaffold help
guide	Show comprehensive usage guide	npx scaffold guide

Options

Option	Short	Description	Example
--vars	-v	Custom variables in key=value format	-v module=auth feature=users
--force	-f	Force overwrite existing files	--force
--target	-t	Target point for injection	-t "// inject:methods"
--resource	-r	Resource name for injection	-r user

⚙️ Configuration

scaffold.config.json

The configuration file defines your templates, injection points, and groups:

{
  "version": 1,
  "templates": {
    "controller": {
      "description": "Generate a controller file",
      "src": "./scaffolds/controller.tp",
      "dest": "./src/{{module}}/controllers/{{resource.singular.lowerCase}}.controller.ts"
    },
    "service": {
      "description": "Generate a service file", 
      "src": "./scaffolds/service.tp",
      "dest": "./src/{{module}}/services/{{resource.singular.lowerCase}}.service.ts"
    },
    "import-statement": {
      "description": "Import statement for injection",
      "src": "./scaffolds/{{feature}}-import.tp",
      "dest": "inject"
    },
    "crud-group": [
      "controller",
      "service", 
      "dto",
      "entity"
    ]
  }
}

Template Structure

your-project/
├── scaffold.config.json
├── scaffolds/
│   ├── controller.tp
│   ├── service.tp
│   ├── dto.tp
│   └── auth-import.tp
└── src/
    └── (generated files will go here)

🔧 Variables & Transformations

Built-in Variables

• resource - Automatically provided primary variable
• Custom variables - Any variables you define (module, feature, domain, etc.)

Available Transformations

Transformation	Example Input	Example Output
raw	user-account	user-account
singular	users	user
plural	user	users
lowerCase	UserAccount	useraccount
upperCase	user	USER
camelCase	user-account	userAccount
pascalCase	user-account	UserAccount
snakeCase	user-account	user_account
spaceCase	user-account	user account
hyphenCase	user account	user-account
sentenceCase	user-account	Useraccount

Chaining Transformations

{{resource.singular.pascalCase}}     // user-accounts → UserAccount
{{module.plural.upperCase}}          // auth → AUTHS
{{feature.singular.camelCase}}       // dining-tables → diningTable

📝 Template Examples

Controller Template (scaffolds/controller.tp)

import { Controller, Get, Post, Put, Delete, Body, Param } from '@nestjs/common';
import { {{resource.singular.pascalCase}}Service } from '../services/{{resource.singular.lowerCase}}.service';
import { Create{{resource.singular.pascalCase}}Dto } from '../dto/{{resource.singular.lowerCase}}.dto';

@Controller('{{module}}/{{feature}}/{{resource.plural.lowerCase}}')
export class {{resource.singular.pascalCase}}Controller {
  constructor(
    private readonly {{resource.singular.camelCase}}Service: {{resource.singular.pascalCase}}Service
  ) {}

  @Get()
  async findAll{{resource.plural.pascalCase}}() {
    return this.{{resource.singular.camelCase}}Service.findAll();
  }

  @Post()
  async create{{resource.singular.pascalCase}}(@Body() dto: Create{{resource.singular.pascalCase}}Dto) {
    return this.{{resource.singular.camelCase}}Service.create(dto);
  }
}

// Generated for {{module}} module, {{feature}} feature

Import Injection Template (scaffolds/auth-import.tp)

import { {{resource.singular.pascalCase}}Module } from './{{module}}/{{resource.singular.lowerCase}}.module';

🎯 Real-World Examples

E-commerce Application

# Generate product management
npx scaffold make product crud-group -v module=catalog feature=products

# Generate order processing
npx scaffold make order service -v module=sales feature=checkout

# Add authentication
npx scaffold make user controller -v module=auth feature=users

Generated structure:

src/
├── catalog/
│   ├── controllers/product.controller.ts
│   ├── services/product.service.ts
│   ├── dto/product.dto.ts
│   └── entities/product.entity.ts
├── sales/
│   └── services/order.service.ts
└── auth/
    └── controllers/user.controller.ts

Hotel Management System

# Room management
npx scaffold make room full-feature -v module=hotel feature=rooms

# Booking system  
npx scaffold make booking crud-group -v module=reservations feature=bookings

# Guest services
npx scaffold make guest service -v module=hospitality feature=guests

Multi-tenant SaaS

# Tenant management
npx scaffold make tenant controller -v module=core domain=admin

# Feature modules per tenant
npx scaffold make dashboard service -v module=analytics domain=tenant

# Billing system
npx scaffold make invoice crud-group -v module=billing domain=finance

💉 Code Injection

Inject code snippets into existing files at specific points:

# Inject import statements
npx scaffold inject import-statement src/app.module.ts -v module=auth

# Inject methods into services
npx scaffold inject crud-methods src/user.service.ts -r user

# Inject routes with target point
npx scaffold inject api-route src/app.routes.ts -t "// inject:routes" -v module=auth

Injection Targets

• Automatic placement - Top/bottom of file (prompted)
• Specific markers - // inject:imports, <!-- inject:methods -->, etc.
• Duplicate prevention - Automatically skips if content already exists

🔄 Migration from Single Variable

Existing templates using only {{resource}} variables continue to work seamlessly:

// Old template - still works
export class {{resource.pascalCase}}Service {}

// New multi-variable template
export class {{resource.pascalCase}}Service {
  // Module: {{module}}
  // Feature: {{feature}}
}

🛠️ Advanced Configuration

Dynamic Template Paths

{
  "templates": {
    "feature-controller": {
      "src": "./scaffolds/{{feature}}/controller.tp",
      "dest": "./src/{{module}}/{{feature}}/{{resource.plural.lowerCase}}.controller.ts"
    }
  }
}

Conditional Templates

{
  "templates": {
    "api-controller": {
      "src": "./scaffolds/{{module}}/api-controller.tp", 
      "dest": "./src/{{module}}/controllers/{{resource.singular.lowerCase}}.controller.ts"
    },
    "web-controller": {
      "src": "./scaffolds/{{module}}/web-controller.tp",
      "dest": "./src/{{module}}/controllers/{{resource.singular.lowerCase}}.controller.ts" 
    }
  }
}

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🆘 Support

• Issues: GitHub Issues
• Discussions: GitHub Discussions
• Documentation: Run npx scaffold guide for comprehensive documentation

☕️ Support the Project

If ScaffoldJS has saved you time and helped improve your development workflow, consider buying us a coffee! Your support helps us maintain and improve the project.

Other ways to support:

• ⭐ Star the project on GitHub
• 🐛 Report bugs and suggest features
• 📖 Improve documentation
• 📢 Share with your team and on social media

Every contribution, no matter how small, helps make ScaffoldJS better for everyone! 🙏

🗺️ Roadmap

• Custom Transformations - User-defined transformation functions
• Template Inheritance - Template extending and composition
• IDE Integration - VSCode extension
• Interactive Mode - Guided template generation
• Template Marketplace - Community template sharing
• TypeScript Definitions - Better IntelliSense support

---

Made with ❤️ by Ebuka Odini

Scaffold smarter, code faster! 🚀