binarytorch / larecipe

v3.0.1 2026-10-19 12:51 UTC

Requires

• php: ^8.3
• illuminate/console: ^12.62|^13.0
• illuminate/contracts: ^12.62|^13.0
• illuminate/database: ^12.62|^13.0
• illuminate/http: ^12.62|^13.0
• illuminate/routing: ^12.62|^13.0
• illuminate/support: ^12.62|^13.0
• illuminate/view: ^12.62|^13.0
• laravel/mcp: ^1.0
• laravel/prompts: ^0.3
• league/commonmark: ^2.10.3
• opis/json-schema: ^2.4
• phiki/phiki: ^2.2
• symfony/html-sanitizer: ^7.2|^8.0
• symfony/process: ^7.2|^8.0
• symfony/yaml: ^7.2|^8.0

Requires (Dev)

• laravel/ai: ^1.2
• laravel/pint: ^1.18
• orchestra/testbench: ^10.0|^11.0
• pestphp/pest: ^4.0
• pestphp/pest-plugin-arch: ^4.0
• pestphp/pest-plugin-laravel: ^4.0

Suggests

• laravel/ai: Ask AI for readers and the larecipe:sync docs agent (^1.2)
• nikic/php-parser: Symbol-level sources (App\Billing\Invoice::refund) for drift detection

MIT

• Saleem Hadad

• documentation
• markdown
• docs
• laravel
• agents
• ai
• mcp
• llms.txt

Published on Packagist.org on 2026-10-19 12:51 UTC

README

Docs that keep up with your code

LaRecipe lives inside your Laravel app. Your coding agents write the docs and update them with every change.
People get a fast, beautiful site; agents get Markdown, llms.txt and MCP.

See it live · Get started · Upgrade from v2 · Changelog

🚀 Get started

composer require larecipe/larecipe
php artisan larecipe:install

Open /docs. Your docs site is ready, and your coding agents (Claude Code, Codex, Cursor, Gemini, Copilot) are set up to keep it current.

🔄 How it works

1. Each page lists the code it describes.
2. Your agent updates the affected pages before it pushes.
3. If it forgets, a hook holds the push and names the pages.
4. You review docs and code in the same pull request.

What your agent sees when it forgets:

$ git push
LaRecipe: this push changes code that 1 docs page describes, and it was not updated:
  - docs/billing.md   (sources: app/Billing/**)
Update it with the larecipe-update-docs skill, run php artisan larecipe:validate,
show the user the docs diff and wait for approval, then commit and push again.

✨ Features

For readers

• A fast site, light and dark, right to left, phone to desktop. Just beautiful 💄!
• Search in the browser, with no service to run
• Versions, languages and private docs
• Live references read from your running app
• Ask AI, with answers that cite your pages

For agents

• Every page as Markdown
• llms.txt and llms-full.txt
• An MCP server
• A skill for your docs

See it live at larecipe.saleem.dev → The LaRecipe docs are built with LaRecipe.

⬆️ Upgrading from LaRecipe 2

composer require larecipe/larecipe
php artisan larecipe:upgrade

It starts as a dry run with a report. Add --apply to convert, then let your agent finish with the larecipe-upgrade-v2 skill. Read the upgrade guide.

📋 Requirements

PHP 8.3+ and Laravel 12.62+ or 13. Ask AI needs laravel/ai.

🙌 Contributors

This project exists thanks to all the people who contribute. Contribute.

Work on LaRecipe locally

composer install
pnpm install
pnpm build              # the prebuilt UI in dist/
vendor/bin/pest         # PHP tests
pnpm test               # UI tests
pnpm test:browser       # browser tests against the workbench

📄 License

MIT. Made by Saleem Hadad.

⭐ If LaRecipe saves you time, star the repo.