PHPackages eoads/eoads-starter-kit - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Framework](/categories/framework) 4. / 5. eoads/eoads-starter-kit ActiveLibrary[Framework](/categories/framework) eoads/eoads-starter-kit ======================= EO-ADS Laravel starter kit — full project scaffold with AI-assisted module development v1.0.8(3w ago)03MITPHPPHP ^8.2 Since Jun 24Pushed 1mo agoCompare [ Source](https://github.com/olinexs/eoads-starter-kit)[ Packagist](https://packagist.org/packages/eoads/eoads-starter-kit)[ RSS](/packages/eoads-eoads-starter-kit/feed)WikiDiscussions main Synced 2w ago READMEChangelog (1)Dependencies (8)Versions (14)Used By (0) eoads/eoads-starter-kit ======================= [](#eoadseoads-starter-kit) > EO-ADS Laravel Starter Kit — scaffolds a full project structure with AI-assisted module development via Claude Code. --- Project Structure ----------------- [](#project-structure) This starter kit is designed for a **decoupled** backend + frontend architecture: ``` my-project/ ├── backend/ ← Laravel 12 API (run artisan from here) │ ├── Modules/ ← Business modules (nwidart/laravel-modules) │ ├── .claude/CLAUDE.md ← AI instruction file │ ├── .docs/ ← Architecture & sprint docs │ ├── .skills/ ← AI process methodology │ └── .design/ ← Ecogreen design system └── frontend/ ← Vue 3 + Vite SPA └── resources/js/ └── modules/ ← Frontend modules (mirror of backend) ``` > **Note on ordering:** the `backend/` folder is created by `laravel new backend`, and the `frontend/` folder is created by `php artisan eoads:install`. You don't create these folders yourself — the tooling generates them. --- Requirements ------------ [](#requirements) Make sure these are installed and on your `PATH` before starting: - **PHP** 8.2+ and **Composer** - The **`laravel`** installer (`composer global require laravel/installer`) - **Node.js** and **npm** --- Quick start (one command — recommended) --------------------------------------- [](#quick-start-one-command--recommended) Install the global `eoads` command once: ``` composer global require eoads/installer ``` > Ensure Composer's global bin is on your `PATH` (see [installer/README.md](installer/README.md)). Then, from **any folder**, create a complete project: ``` eoads new my-project ``` This does **everything** automatically and **asks your preferences** during install (project name, team, sprint, frontend template, JS/TS, version, auth): 1. Creates `my-project/` 2. Runs `laravel new backend` 3. Runs `composer require eoads/eoads-starter-kit` 4. Runs `php artisan eoads:install` (the interactive questionnaire) + scaffolds the frontend with `npm install` The result is `my-project/backend/` + `my-project/frontend/`, ready to run. Omit the name (`eoads new`) and it will prompt for one. ### Alternative: bootstrap script (no global install) [](#alternative-bootstrap-script-no-global-install) If you'd rather not install the global command, run the bundled script from this repo instead — same result: ``` # macOS / Linux / Git-Bash ./create-project.sh my-project ``` ``` :: Windows create-project.bat my-project ``` > Run it from the **parent** directory — the script creates `my-project/` for you. Prefer to do each step by hand? See **Manual installation** below. --- Manual installation ------------------- [](#manual-installation) These steps do exactly what the one-command script does, just by hand: ``` # 1. Create the project root mkdir my-project && cd my-project # 2. Create the Laravel backend (creates the backend/ folder) laravel new backend cd backend # 3. Require the starter kit composer require eoads/eoads-starter-kit # 4. Run the interactive installer (creates the frontend/ folder + npm install) php artisan eoads:install ``` The installer will ask for: - Project name & description - Team / department name - First sprint number, title, PIC, and ETC - **Frontend template** (discovered from the kit's bundled templates) - **JavaScript or TypeScript** - **Version** — Starter Kit or Full - **Authentication system** — Local (Sanctum), LDAP (Active Directory), or Keycloak (SSO) Then open the **project root** in Claude Code: ``` cd .. claude . ``` Tell Claude: *"I want to create a module for Purchase Orders"* — it scaffolds everything automatically. --- Running the project ------------------- [](#running-the-project) ``` # Backend API (port 8000) cd backend && php artisan serve # Frontend SPA (port 5173) — in a second terminal cd frontend && npm run dev ``` --- What gets installed ------------------- [](#what-gets-installed) ### Backend (`backend/`) [](#backend-backend) PathPurpose`.claude/CLAUDE.md`AI instruction file — conventions & automatic behaviours`.claude/settings.local.json`Pre-approved artisan/git commands (no permission prompts)`AGENTS.md`Alias pointing to CLAUDE.md`.docs/ARCHITECTURE.md`Full system architecture reference`.docs/app-blueprint.md`Domain model — fill in your entities and rules`.docs/sprints/sprint-XX.md`First sprint doc with your info filled in`.docs/sprints/sprint-roadmap.md`Sprint registry`.skills/`4 AI process skills (TDD, debugging, planning, verification)`.design/DESIGN-SYSTEM.md`Vuetify 3 theme — Ecogreen brand`.design/colors_and_type.css`CSS design tokens`dev-agent.sh`Shell launcher for Claude Code### Frontend (`frontend/`) [](#frontend-frontend) > The exact file set depends on the **template**, **JS/TS**, and **auth** options chosen during install. The table below shows the core working files common to the default Vue + Vuetify template; the selected auth adds login pages and an auth module, and the full template source is parked under `resources/js/.template/` as read-only AI reference. PathPurpose`package.json`Vue 3 + Vuetify 3 + Pinia + Axios + Vue Router + Vite`vite.config.js``@` alias → `resources/js/`, proxy `/api` → `localhost:8000``index.html`App entry point`resources/js/main.js`App bootstrap — wires Vuetify, Pinia, Router`resources/js/App.vue`Root component`resources/js/plugins/vuetify.js`Ecogreen Vuetify theme config`resources/js/plugins/axios.js`Shared Axios instance (`export { api }`) with auth interceptors`resources/js/plugins/router/routes.js`Root route registry`resources/js/stores/toastStore.js`Pinia toast/alert store`resources/js/layouts/DefaultLayout.vue`App shell + navigation (`navItems`)> `npm install` runs automatically after install. --- Adding a new module ------------------- [](#adding-a-new-module) **AI way (recommended):** ``` Tell Claude Code: "Create a module for [feature name]" ``` Claude runs `module:make`, implements the feature, and wires the route and nav item. **Manual way (from `backend/`):** ``` php artisan module:make PurchaseOrder ``` Creates: ``` backend/Modules/PurchaseOrder/ ← full backend structure frontend/resources/js/modules/purchaseOrder/ ← service, store, view, routes ``` Skip frontend scaffold: ``` php artisan module:make PurchaseOrder --no-frontend ``` --- How the AI workflow works ------------------------- [](#how-the-ai-workflow-works) ``` Developer says: "create a module for Inventory" ↓ Claude reads: .claude/CLAUDE.md + .docs/ARCHITECTURE.md + active sprint doc ↓ Runs: php artisan module:make Inventory (from backend/) ↓ Backend: Controller, FormRequest, Action, Repository, ServiceProvider, routes Frontend: Service, Pinia store, Vue view, routes.js ↓ Wires: route import in router/routes.js + nav item in DefaultLayout.vue ↓ Commits: feat(Inventory): scaffold module [sprint-XX brief-XX] ``` --- Upgrading --------- [](#upgrading) ``` cd backend composer update eoads/eoads-starter-kit eoads/module-make php artisan eoads:install --force ``` > Use `--force` to overwrite existing stub files. Back up any customised docs first. --- Dependencies ------------ [](#dependencies) - [`eoads/module-make`](https://github.com/olinexs/eoads-module-make) — the scaffolding engine (auto-installed) - `illuminate/console` ^11.0|^12.0 - `illuminate/support` ^11.0|^12.0 ### Health Score 41 — FairBetter than 87% of packages Maintenance93 Actively maintained with recent releases Popularity4 Limited adoption so far Community2 Small or concentrated contributor base Maturity53 Maturing project, gaining track record How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~1 days Total 13 Last Release 27d ago ### Community Maintainers ![](https://avatars.githubusercontent.com/u/55356429?v=4)[Caroline Panggabean](/maintainers/olinexs)[@olinexs](https://github.com/olinexs) ### Embed Badge ![Health badge](/badges/eoads-eoads-starter-kit/health.svg) ``` [![Health](https://phpackages.com/badges/eoads-eoads-starter-kit/health.svg)](https://phpackages.com/packages/eoads-eoads-starter-kit) ``` ### Alternatives [laravel/sail Docker files for running a basic Laravel application. 1.9k212.4M1.4k](/packages/laravel-sail)[laravel/ai The official AI SDK for Laravel. 1.1k4.6M275](/packages/laravel-ai)[laravel/mcp Rapidly build MCP servers for your Laravel applications. 78727.1M205](/packages/laravel-mcp)[laravel/boost Laravel Boost accelerates AI-assisted development by providing the essential context and structure that AI needs to generate high-quality, Laravel-specific code. 3.5k26.0M738](/packages/laravel-boost)[propaganistas/laravel-disposable-email Disposable email validator 6023.2M7](/packages/propaganistas-laravel-disposable-email)[laravel/surveyor Static analysis tool for Laravel applications. 87157.7k15](/packages/laravel-surveyor) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)