README

Global installer for the EO-ADS Starter Kit — create a full backend + frontend project from anywhere with one command.

Install (once)

composer global require eoads/installer

Make sure Composer's global bin directory is on your PATH:

• macOS / Linux: ~/.composer/vendor/bin or ~/.config/composer/vendor/bin
• Windows: %USERPROFILE%\AppData\Roaming\Composer\vendor\bin

Usage

eoads new my-project

That single command, run from any folder:

1. Creates my-project/

2. Runs laravel new backend (creates my-project/backend/)

3. Runs composer require eoads/eoads-starter-kit

4. Runs php artisan eoads:install — which interactively asks for:

   • Project name & description
   • Team / department name
   • First sprint number, title, PIC, ETC
   • Frontend template
   • JavaScript or TypeScript
   • Version (Starter Kit or Full)
   • Authentication system (Local / LDAP / Keycloak)

   …then scaffolds my-project/frontend/ and runs npm install.

Omit the name to be prompted:

eoads new

Re-create over an existing folder:

eoads new my-project --force

Requirements

• PHP 8.2+ and Composer
• The laravel installer (composer global require laravel/installer)
• Node.js and npm

Run from a local checkout (development)

cd installer
composer install
php bin/eoads new my-project