SCRIPE CLI Tooling

$ scripe new-module <name> [options]

# Options:
# --backend-only          Generate only the backend module
# --frontend-only         Generate only the frontend module
# --entity <name>         Custom name for the first entity
# --with-no-entity        Create bare skeleton without initial CRUD entity
# --no-cache              Skip Redis cache integration on queries/commands
# --no-cleaner-bg-service Skip soft-delete cleanup background job generation

src/modules/{kebab-name}/
├── di.ts                           # DI container (wires all sub-modules)
├── index.ts                        # Public API barrel file
└── {sub-module}/                   # Sub-module named folder (e.g., {kebab-name})
    ├── index.ts                    # Sub-module barrel
    ├── locales/                    # Sub-module-owned translations
    │   ├── {sub-module}.en.ts
    │   ├── {sub-module}.ar.ts
    │   └── index.ts
    └── src/
        ├── domain/
        │   ├── entities/{Entity}.ts # Zod schema entity
        │   └── interfaces/
        │       ├── I{Entity}Repository.ts
        │       └── I{Entity}Service.ts
        ├── data/
        │   ├── models/{Entity}Model.ts
        │   ├── mappers/{Entity}Mapper.ts
        │   └── repositories/{Entity}Repository.ts
        └── presentation/
            ├── viewmodels/use{Entity}ViewModel.ts
            └── views/{Entity}ListView.tsx

$ scripe new-feature <module> <entity> -p <properties> [options]

# Options:
# -p, --properties <props>  (Required) Property definitions string
# --backend-only            Generate only backend files
# --frontend-only           Generate only frontend files
# --no-controller           Skip REST controller generation
# --no-cache                Skip cache integration
# --no-cleaner-bg-service   Skip adding entity to soft-delete cleanup job

# Example: E-commerce Invoice
$ scripe new-feature Products Invoice \
  -p "Title:string:required:max(200),Amount:decimal:required:min(0),Status:enum(Draft|Sent|Paid):required"

# Remove a full module and aggressively rollback ALL auto-wiring safely
$ scripe remove-module Products --confirm

# Remove a specific feature/entity and rollback its DI and permissions
$ scripe remove-feature Products Invoice --confirm

# Auto-detect the most recent scaffolding and obliterate it
$ scripe remove-module --last --confirm

# Automatically generate and wire a Hangfire Soft-Delete Cleanup Job
$ scripe add-bg-service Products

$ scripe remove-bg-service Products

# Generate migration for all 3 providers (SqlServer, Oracle, PostgreSql)
$ scripe db add-migration Initial -m CRM

# Generate migration for a specific provider only
$ scripe db add-migration Initial -m CRM -p SqlServer

# Apply migrations (auto-detects provider from appsettings.json)
$ scripe db update -m CRM

# Override provider for update
$ scripe db update -m CRM -p Oracle

# Remove last migration from all 3 providers
$ scripe db remove-migration -m CRM

# Remove last migration from a specific provider only
$ scripe db remove-migration -m CRM -p SqlServer

# Rebuild frontend schemas to mirror live Backend structure
$ scripe sync-api https://localhost:5035/swagger/v1/swagger.json -m crm

{
  "backend": {
    "root": "./SCRIPE-Backend",
    "solutionFile": "SCRIPE-Backend.sln",
    "modulesDir": "src/Modules",
    "hostDir": "src/Host/API",
    "coreDir": "src/Core"
  },
  "frontend": {
    "root": "./SCRIPE-Frontend",
    "modulesDir": "src/modules",
    "appDir": "src/app",
    "coreDir": "src/core",
    "localesDir": "src/core/locales"
  },
  "defaults": {
    "targetFramework": "net10.0",
    "languages": ["en", "ar"]
  }
}

# Fast installation trees targeting specific ecosystems
$ scripe install all        # Both CLI and Frontend via npm/pnpm
$ scripe install frontend   # Only Frontend

# Fast compilation targets
$ scripe build all          # Typescript CLI -> dotnet build -> pnpm build
$ scripe build backend      # dotnet build 

# Local Server Proxies
$ scripe dev frontend       # Next.js Server
$ scripe dev backend        # Kestrel .NET Engine