PHPackages fnlla/fnlla - 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. fnlla/fnlla ActiveProject[Framework](/categories/framework) fnlla/fnlla =========== Fnlla starter application with optional AI capabilities v3.0.7(1mo ago)011[1 PRs](https://github.com/fnlla/fnlla/pulls)proprietaryPHPPHP >=8.5CI failing Since Apr 18Pushed 1mo agoCompare [ Source](https://github.com/fnlla/fnlla)[ Packagist](https://packagist.org/packages/fnlla/fnlla)[ RSS](/packages/fnlla-fnlla/feed)WikiDiscussions main Synced 1w ago READMEChangelog (5)Dependencies (15)Versions (11)Used By (0) **fnlla (finella) APP** [![Developed by TechAyo](https://camo.githubusercontent.com/69ef6c3b5b3b0960201422da01b6d979de2564baf4e87ee90daddd0600102832/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f446576656c6f70656425323062792d5465636841796f2d6635396530623f7374796c653d666c61742d737175617265266c6162656c436f6c6f723d66393733313626636f6c6f723d666163633135)](https://techayo.co.uk)[![Latest Release](https://camo.githubusercontent.com/f4792b697d6d52b399dbafc8fa875179f2dff8e308991b017db6d2c6347df2dc/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c617465737425323052656c656173652d332e302e362d3232633535653f7374796c653d666c61742d737175617265266c6162656c436f6c6f723d306561356539)](https://github.com/fnlla/fnlla/releases) This repository contains the standalone fnlla (finella) application (`fnlla (finella)`). **ABOUT**`fnlla/fnlla` is the official fnlla (finella) starter application for product teams. It provides production-ready defaults, an operational safety baseline, and a clear path from local development to CI and release workflows. The starter includes the AI-ready runtime surface from fnlla (finella) packages (AI driver, policy controls, routing, telemetry, and optional RAG), while defaulting to safe local/non-provider settings until explicitly enabled. **OWNERSHIP****-** Author: [TechAyo](https://techayo.co.uk)**-** Project Manager: Marcin Kordyaczny **ACCESS MODES****-** **`fnlla-only` access**: use stable dependencies from `composer.json`. **-** **Cross-repo access** (`fnlla (finella)` + `framework` + `packages`): use local dev profile from `composer.dev.json` (available for maintainers with access to private `fnlla/framework`). **CREATE PROJECT (PUBLIC PACKAGIST)**Create a new app directly: ``` composer create-project fnlla/fnlla my-app ``` Or via installer CLI: ``` composer global config repositories.fnlla-installer vcs https://github.com/fnlla/installer composer global require fnlla/installer:dev-main fnlla new my-app ``` No GitHub cloning is required for the standard bootstrap path. See `documentation/src/private-registry.md` for public/private registry details and private add-on auth examples. **WHY BOTH `fnlla/fnlla` AND `fnlla/installer`****-** `fnlla/fnlla` is the project template consumed by Composer (`create-project`). **-** `fnlla/installer` is a CLI wrapper (`fnlla new`) that improves onboarding UX (preflight checks, guided flow, future stack choices). **-** Both paths generate the same starter baseline and stay release-aligned. **PACKAGIST AUTO-UPDATE****-** Primary path: GitHub webhook (`https://packagist.org/api/github`) on push events. **-** Fallback path: `.github/workflows/packagist-fallback-update.yml` (triggered on `v*` tags or manually) using `PACKAGIST_USERNAME` + `PACKAGIST_API_TOKEN` secrets. **LOCAL DEV WITH SIBLING REPO**Clone repositories side by side: ``` /framework # github.com/fnlla/framework /packages # github.com/fnlla/packages /fnlla # github.com/fnlla/fnlla ``` Then from `fnlla (finella)`: ``` copy .env.example .env composer run deps:dev:install php bin/fnlla db:bootstrap composer run dev ``` `APP_KEY` is auto-bootstrapped on first app boot when `.env` contains an empty `APP_KEY=`. You can also generate it manually with: ``` php bin/fnlla key:generate ``` Optional Python sidecar worker is supported (disabled by default). Use `PYTHON_WORKER_*` variables to point fnlla (finella) at your Python service and verify connectivity with `php bin/fnlla python:ping`. `composer.dev.json` resolves local packages from `../packages/framework` and `../packages/*` in source repository checkouts. `.env.example` is intentionally minimal; advanced environment flags are documented in `documentation/src/environment-reference.md`. **FNLLA-ONLY QUICKSTART (NO FRAMEWORK ACCESS)**From `fnlla (finella)`: ``` copy .env.example .env composer install --no-interaction --prefer-dist php bin/fnlla db:bootstrap composer run dev ``` **COMMANDS****-** Start app: `composer run dev`**-** Smoke tests: `composer run smoke`**-** Ops check: `composer run ops:check`**-** Prod profile check: `composer run ops:check:prod`**-** Enterprise readiness check: `composer run enterprise:check`**-** Composer lock source check: `composer run lock:check`**-** Distribution split check: `composer run distribution:check`**-** Python worker ping: `php bin/fnlla python:ping`**-** Install git hooks: `composer run hooks:install` **PHP RUNTIME PINNING (CLI)****-** In local/dev environments, fnlla (finella) CLI/scripts auto-reexec to PHP 8.5.5 when launched with any other PHP binary. **-** In CI, any PHP 8.5.x runtime is accepted. **-** Preferred local binary can be pinned explicitly with `Fnlla_PHP_BIN` (or `Fnlla_PHP85_BIN`) pointing to PHP 8.5.5. **-** `composer run dev` also runs through this guard; you can override bind address with `Fnlla_DEV_HOST` and `Fnlla_DEV_PORT`. **-** To disable this fallback guard (not recommended), set `Fnlla_PHP_GUARD_DISABLED=1`. **COMMAND REQUIREMENTS** CommandRequires `fnlla/framework` siblingWorks with `fnlla-only` access`composer run deps:dev:install`YesNo`composer run deps:dev:update`YesNo`composer run smoke`NoYes`composer run format:markdown`YesNo`composer run lint:markdown`YesNo`composer run format:github`YesNo`composer run lint:github`YesNo`composer run release:notes:check`YesNo`composer run release:notes:publish`YesNo`composer run release:notes:sync`YesNo`composer run dev`NoYes`composer run ops:check`NoYes`composer run ops:check:prod`NoYes`composer run enterprise:check`NoYes`composer run lock:check`NoYes`composer run distribution:check`NoYes**CI NOTE (STARTER CI)****-** Starter CI is self-contained and does not require cloning `fnlla/framework`. **-** CI validates/install/tests the starter using public package sources from `fnlla/packages`. **-** Cross-repo developer workflows remain available through local sibling checkouts and `composer.dev.json` (source repository mode). **NAME ORIGIN AND TECHNICAL SLUG****-** Product name: `fnlla (finella)` (name origin: fnlla (finella) Gardens, Dundee, UK). **-** Technical slug: `fnlla` (`github.com/fnlla`, `fnlla.co.uk`). **-** Why `fnlla (finella)`: short ASCII-only identifier for repositories, package/tooling paths, and domain naming. **NOTES****-** Use `composer.json` for stable/production installs. **-** `composer.json` resolves fnlla packages via `https://raw.githubusercontent.com/fnlla/packages/main/repository`. **-** Use `composer.dev.json` for local development against your local `framework` repo (source repository checkout mode). **-** `composer.json` intentionally avoids local `path` repositories so `fnlla-only` installs and `create-project` do not require a sibling checkout. **-** Starter template intentionally does not commit `composer.lock`; each generated app should produce its own lock from public package sources. **-** For advanced toggles (AI router, telemetry, integrations), extend your `.env` using `documentation/src/environment-reference.md`. **-** For team onboarding tracks (product developers vs maintainers), start from `documentation/src/onboarding.md`. **-** Use `documentation/src/enterprise-go-live-checklist.md` as the final pre-production gate. **-** Public/private registry setup is documented in `documentation/src/private-registry.md`. **-** Access workflow guidance is maintained in source repository checkouts. ### Health Score 43 — FairBetter than 89% of packages Maintenance92 Actively maintained with recent releases Popularity5 Limited adoption so far Community6 Small or concentrated contributor base Maturity57 Maturing project, gaining track record Bus Factor1 Top contributor holds 100% 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 ~0 days Total 8 Last Release 47d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/23a73d9af8811556702d2675f6385306b6982c0a021fc25076e53b2a8fc24f13?d=identicon)[kordyaczny](/maintainers/kordyaczny) --- Top Contributors [![kordyaczny](https://avatars.githubusercontent.com/u/16237852?v=4)](https://github.com/kordyaczny "kordyaczny (45 commits)") --- Tags aicomposerfinellafnllaframeworkphpstarterstarter-templatewebapp ### Code Quality TestsPHPUnit ### Embed Badge ![Health badge](/badges/fnlla-fnlla/health.svg) ``` [![Health](https://phpackages.com/badges/fnlla-fnlla/health.svg)](https://phpackages.com/packages/fnlla-fnlla) ``` ### Alternatives [laravel/socialite Laravel wrapper around OAuth 1 & OAuth 2 libraries. 5.7k104.3M822](/packages/laravel-socialite)[laravel/dusk Laravel Dusk provides simple end-to-end testing and browser automation. 1.9k38.6M289](/packages/laravel-dusk)[pinguo/php-msf Pinguo Micro Service Framework For PHP 1.7k4.2k](/packages/pinguo-php-msf)[nineinchnick/edatatables Grid widget for the Yii Framework, wrapper for the DataTables jQuery plugin 173.2k](/packages/nineinchnick-edatatables) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)