PHPackages ishmael/ishmaelphp-starter - 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. ishmael/ishmaelphp-starter ActiveProject[Framework](/categories/framework) ishmael/ishmaelphp-starter ========================== IshmaelPHP Starter Application 0.7.19(2mo ago)022MITPHPPHP >=8.2CI passing Since Dec 19Pushed 2mo agoCompare [ Source](https://github.com/domsinclair/ishmaelphp-starter)[ Packagist](https://packagist.org/packages/ishmael/ishmaelphp-starter)[ RSS](/packages/ishmael-ishmaelphp-starter/feed)WikiDiscussions master Synced 1mo ago READMEChangelog (10)Dependencies (2)Versions (22)Used By (0) IshmaelPHP Starter Application ============================== [](#ishmaelphp-starter-application) The official starter application for the IshmaelPHP Framework. Features -------- [](#features) - **Module-First Architecture**: Organized by business logic, not just technical layers. - **Slim & Fast**: No unnecessary bloat, just what you need to get started. - **Developer Friendly**: Built-in CLI tools and PHPStorm integration. Installation ------------ [](#installation) You can create a new project using Composer: ``` composer create-project ishmael/ishmaelphp-starter my-app ``` Getting Started --------------- [](#getting-started) 1. **Configure Environment**: Copy `.env.example` to `.env` and adjust your settings (database, etc.). ``` cp .env.example .env ``` 2. **Generate App Key**: ``` php vendor/bin/ish key:generate ``` 3. **Run the Server**: ``` php -S localhost:8080 -t public ``` Visit `http://localhost:8080` in your browser. Documentation ------------- [](#documentation) Comprehensive documentation for IshmaelPHP can be found in the `Docs` folder or online at [ishmaelphp.org](https://ishmaelphp.org) (coming soon). MCP Server ---------- [](#mcp-server) IshmaelPHP has its own mcp server that can provide AI agents with additional information about the framework. If you are using an ide made by jetbrains it should be discovered automatically. Unfortunately this is not quite as straightforward for other ide's and you may need to do some additional configuration. 1. VS Code and Claude Dev / Roo Code If you are using extensions like Claude Dev (now Roo Code) or Cline in VS Code, they are heavy users of MCP. However, they do not use a jetbrains-mcp.json file. Instead, they typically rely on a global configuration file (usually located at %APPDATA%\\Code\\User\\globalStorage\\saoudrizwan.claude-dev\\settings\\cline\_mcp\_settings.json on Windows). Users have to manually add the server configuration there, or use the extension's UI to point to the php executable and the ish-mcp path. 2. GitHub Copilot As of now, GitHub Copilot does not have a native "plug-and-play" discovery mechanism for local MCP servers in the same way JetBrains or specialized Claude extensions do. While Microsoft is moving towards supporting more external "skills" and "extensions," there isn't a single JSON file you can drop into a project root today that will make Copilot automatically start using a local PHP-based MCP server. ### `ide:setup-run-configs` [](#idesetup-run-configs) This tool automatically sets up IDE "Run Configurations," allowing you to execute `ish` commands directly from your IDE's interface. - **Supported IDEs**: PhpStorm (more coming soon). - **Action**: Generates `.xml` files in `.idea/runConfigurations/` for common tasks like `help`, `migrate`, and `make:module`. - **How to use**: Ask your AI assistant to "Set up my IDE run configurations for Ishmael." Be sure to consult the following documents in the guide section of the Docs. - Ai Collaboration - Ai Manifesto - Conventions in the how-to section - Create a Module - Framing Questions and in the reference/modules section - Rag Configuration PhpStorm Integration -------------------- [](#phpstorm-integration) A plugin has been developed to integrate Ishmael with PhpStorm. This plugin automates the setup of run configurations for common tasks, making it easier to execute `ish` commands directly from PhpStorm. It adds a menu (Ishmael) to the main menu that provides access to all the Cli commands and a custom Tool window which, amongst other things, provides access to the documentation. The plugin and mcp server has been designed to work in parralel and provide a rich end user experience for end users of the IshmaelPhp framework. Metric Testing -------------- [](#metric-testing) No formal metric tests are published for the Ishmael Php Framework. This is a deliberate choice because we believe that you should actively test framework metrics on your own hardware so that you can see **exactly** what you are getting. The recomended starting point for you to explore metric testing the framework is [here](https://github.com/domsinclair/ishmaelphp-eval). This is a simple document repository but it will guide you on exactly what metric tests are and how you can test Ishmael Php if you so wish. License ------- [](#license) The IshmaelPHP Starter is open-sourced software licensed under the [MIT license](LICENSE). ### Health Score 38 — LowBetter than 85% of packages Maintenance85 Actively maintained with recent releases Popularity7 Limited adoption so far Community8 Small or concentrated contributor base Maturity46 Maturing project, gaining track record Bus Factor1 Top contributor holds 72.5% of commits — single point of failure 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 ~3 days Total 20 Last Release 78d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/eb2f74ee16f52fea9687b286a5410080ff364ec585769f38e002d49e7a8ca342?d=identicon)[Dom Sinclair](/maintainers/Dom%20Sinclair) --- Top Contributors [![domsinclair](https://avatars.githubusercontent.com/u/12199442?v=4)](https://github.com/domsinclair "domsinclair (50 commits)")[![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?v=4)](https://github.com/github-actions[bot] "github-actions[bot] (19 commits)") --- Tags frameworkSkeletonstarterishmaelphp ### Embed Badge ![Health badge](/badges/ishmael-ishmaelphp-starter/health.svg) ``` [![Health](https://phpackages.com/badges/ishmael-ishmaelphp-starter/health.svg)](https://phpackages.com/packages/ishmael-ishmaelphp-starter) ``` PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)