shire-studio/laravel-starter-kit-cli
A command-line installer for the Shire Studio Laravel starter kit, giving you a quick way to scaffold a new Laravel project with the starter kit's structure and defaults already in place. Useful if you want a repeatable starting point instead of wiring things up by hand.
Architecture fit: laravel-starter-kit-cli is a developer-facing CLI tool rather than a runtime library. v1.0.2 is significant because it moves distribution to a self-contained PHAR (feat: release the cli as a phar), which changes how the tool is consumed: teams no longer need a Composer global install or a checked-out repo to run scaffolding. For a Laravel/PHP shop this fits well as a one-shot project bootstrap utility, not as a dependency in application code. It should not appear in composer.json of production services.
Integration feasibility: Low integration cost. The PHAR is a downloadable artifact; adopting it means adding a step to developer onboarding docs and possibly CI templates. MIT licensing (docs: add MIT license) removes the biggest legal/approval blocker for Enterprise use and means we can vendor/fork the PHAR if needed. The show the help command in the command list change is minor UX polish but reduces first-run friction, which matters for adoption.
Technical risk: Moderate-low. Key risks: (1) PHAR artifacts are opaque binaries — supply-chain review requires verifying build provenance/signature against the tagged source; (2) young project (v1.0.x, small maintainer footprint, single contributor @joshdonnell), so bus-factor risk is real; (3) a generic chore(deps): update with no changelog detail means we can't audit transitive dependency movement in the PHAR; (4) PHAR tooling can lag PHP runtime upgrades (PHP 8.3/8.4 compatibility unverified here). No breaking changes signalled — the compare range is v1.0.0...v1.0.2, an additive patch line.
Key questions: Does the PHAR build run in CI from the tagged source with a reproducible pipeline, and is it signed? What PHP versions does the PHAR target? Is the starter kit it scaffolds pinned to a Laravel version, or does it track latest? Who is the successor maintainer? Does it require network access at runtime (e.g. pulling templates from GitHub)? Is there a documented non-interactive/flag-driven mode suitable for CI?
Stack fit: Fits Laravel 10/11/12 greenfield project bootstrapping and internal "golden path" templating. Poor fit for existing applications, legacy PHP, or anything needing runtime library behaviour. It complements — does not replace — our existing Composer skeleton/internal template repo.
Migration path: Treat as an additive developer tool, not a migration. Phase 1: pilot on one or two new services, running the PHAR side-by-side with the current scaffold process and diffing output. Phase 2: if output matches or improves on our internal template, document the PHAR as the preferred bootstrap for greenfield work. No migration of existing codebases is implied by this release.
Compatibility: Verify PHAR runs on the PHP versions in our developer baseline and CI images before promoting. Because it is standalone, it avoids Composer version-conflict issues entirely — a genuine advantage over the previous install model — but it also means it will not pick up our pinned dependency versions, so scaffolded output must be reconciled with our internal standards.
Sequencing: (1) Security/provenance review of the PHAR artifact and MIT licence confirmation; (2) sandbox run to inspect generated project structure; (3) internal docs + onboarding snippet; (4) optional CI job to smoke-test the PHAR on new releases; (5) revisit if upstream adds config/template extensibility.
Maintenance: Very low for us — no runtime dependency, nothing to patch in production. The maintenance burden is upstream's: we should expect to re-download the PHAR on a cadence and re-verify checksums. Budget a small recurring review (quarterly) rather than continuous upkeep.
Support: Minimal. Internal support load is limited to onboarding questions and "the scaffold doesn't match our standards" issues, which are policy problems, not vendor bugs. Upstream support is community-only via GitHub issues, with a single active maintainer — set expectations accordingly and keep an internal fallback template.
Scaling: Scales trivially; it's a developer tool with no production traffic or licensing per-seat cost. The real scaling constraint is governance: if many teams adopt it, divergent scaffold output becomes a standardisation problem, so pair adoption with a documented post-scaffold checklist.
Failure modes: (a) Upstream abandonment or repo deletion — mitigate by archiving the PHAR plus source tag internally; (b) compromised or tampered PHAR release — mitigate with checksum pinning and provenance verification; (c) PHAR incompatible with a future PHP upgrade — mitigate by keeping the plain-source Composer path documented as fallback; (d) scaffolded output drifting from internal conventions — mitigate with the post-scaffold checklist; (e) undocumented dependency bumps introducing behavioural changes — mitigate by pinning to reviewed versions rather than always-latest.
Ramp-up: Under an hour for an experienced Laravel developer, aided by the now-listed help command. Add a short onboarding note covering licence, where to get the PHAR, checksum verification, and the internal post-scaffold checklist. No training programme required.
How can I help you explore Laravel packages today?