@orif-pomy-intersection/create

CLI scaffolding tool for ORIF Pomy Intersection web projects. Generates a project skeleton from a template, installs dependencies, and wires up the CI/CD pipeline.

Usage

npx @orif-pomy-intersection/create

Or run locally during development:

npm install
node create.js

The CLI will prompt for:

• Project type — choose from the available templates
• Project name — must be a valid npm package name
• Project description

Templates

| Template | Structure | Use case | | -------------- | ----------------------------------- | ------------------------------- | | vite-express | backend/ + Vite React frontend/ | Full-stack with Vite dev server | | web-express | backend/ + static frontend/ | Full-stack, no build step | | web-static | frontend/ only | Static site |

Development

Adding a template

Create a new directory under templates/ — it is discovered automatically at runtime. Follow the existing structure:

• Root package.json with install:all and start scripts
• frontend/ and/or backend/ subdirectories, each with their own package.json
• github/workflows/workflow.yml (renamed to .github/ after scaffolding)

Files shared across all templates (.gitignore, .dockerignore) live in templates/shared/ and are copied first, so template-specific files can override them.

Note: Backend Express servers must listen on port 3000 — the CI/CD pipeline depends on this.

CI/CD

Each generated project includes a GitHub Actions workflow that triggers on PR merge to dev and delegates to reusable org-level workflows in OrifIntersection/org-workflows:

• web-static → deploy-static.yml
• web-express / vite-express → deploy-express.yml