Skip to content
Back to search

larecipe

MarketplaceWorks with Claude CodeGitHub

✏️ 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.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/saleem-hadad--larecipe/badge.svg)](/listings/saleem-hadad--larecipe)

HTML

<a href="/listings/saleem-hadad--larecipe"><img src="/api/listings/saleem-hadad--larecipe/badge.svg" alt="findsafeskills safety rating" /></a>

Install

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 20 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. {
  2. "name": "larecipe",
  3. "owner": {
  4. "name": "Saleem Hadad",
  5. "url": "https://larecipe.saleem.dev"
  6. },
  7. "metadata": {
  8. "description": "LaRecipe for Claude Code: write and update your Laravel app's docs in the same push as the code.",
  9. "version": "3.0.0"
  10. },
  11. "plugins": [
  12. {
  13. "name": "larecipe",
  14. "source": "./",
  15. "description": "LaRecipe's docs skills, the pre-push docs check, the SessionStart docs map and the local docs MCP server.",
  16. "category": "documentation",
  17. "homepage": "https://larecipe.saleem.dev"
  18. }
  19. ]
  20. }
README.md · README · 111 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. <p align="center">
  2. <a href="https://larecipe.saleem.dev"><img src=".github/assets/screenshot.webp" alt="The LaRecipe docs site in a browser: the sidebar, the Introduction page, and the panel of actions for agents, such as Copy as Markdown and Connect MCP. A badge on the window reads 3M+ downloads."></a>
  3. </p>
  4. <h1 align="center">Docs that keep up with your code</h1>
  5. <p align="center">
  6. LaRecipe lives inside your Laravel app. Your coding agents write the docs and update them with every change. <br>
  7. People get a fast, beautiful site; agents get Markdown, llms.txt and MCP.
  8. </p>
  9. <p align="center">
  10. <a href="https://github.com/saleem-hadad/larecipe/actions/workflows/tests.yml"><img src="https://img.shields.io/github/actions/workflow/status/saleem-hadad/larecipe/tests.yml?branch=main&label=tests" alt="Tests"></a>
  11. <a href="https://github.com/saleem-hadad/larecipe/releases"><img src="https://img.shields.io/github/v/release/saleem-hadad/larecipe?label=release" alt="Latest release"></a>
  12. <a href="https://packagist.org/packages/binarytorch/larecipe/stats"><img src="https://img.shields.io/packagist/dt/binarytorch/larecipe?label=downloads" alt="Downloads"></a>
  13. <a href="https://github.com/saleem-hadad/larecipe/stargazers"><img src="https://img.shields.io/github/stars/saleem-hadad/larecipe?style=flat&label=stars" alt="GitHub stars"></a>
  14. <a href="LICENSE"><img src="https://img.shields.io/github/license/saleem-hadad/larecipe" alt="MIT license"></a>
  15. </p>
  16. <p align="center">
  17. <a href="https://larecipe.saleem.dev"><strong>See it live</strong></a> ·
  18. <a href="#-get-started">Get started</a> ·
  19. <a href="#-upgrading-from-larecipe-2">Upgrade from v2</a> ·
  20. <a href="CHANGELOG.md">Changelog</a>
  21. </p>
  22. ---
  23. ## 🚀 Get started
  24. ```bash
  25. composer require larecipe/larecipe
  26. php artisan larecipe:install
  27. ```
  28. Open `/docs`. Your docs site is ready, and your coding agents (Claude Code, Codex, Cursor, Gemini, Copilot) are set up to keep it current.
  29. ## 🔄 How it works
  30. 1. Each page lists the code it describes.
  31. 2. Your agent updates the affected pages before it pushes.
  32. 3. If it forgets, a hook holds the push and names the pages.
  33. 4. You review docs and code in the same pull request.
  34. What your agent sees when it forgets:
  35. ```console
  36. $ git push
  37. LaRecipe: this push changes code that 1 docs page describes, and it was not updated:
  38. - docs/billing.md (sources: app/Billing/**)
  39. Update it with the larecipe-update-docs skill, run php artisan larecipe:validate,
  40. show the user the docs diff and wait for approval, then commit and push again.
  41. ```
  42. ## ✨ Features
  43. **For readers**
  44. - A fast site, light and dark, right to left, phone to desktop. Just beautiful 💄!
  45. - Search in the browser, with no service to run
  46. - Versions, languages and private docs
  47. - Live references read from your running app
  48. - Ask AI, with answers that cite your pages
  49. **For agents**
  50. - Every page as Markdown
  51. - `llms.txt` and `llms-full.txt`
  52. - An MCP server
  53. - A skill for your docs
  54. **[See it live at larecipe.saleem.dev →](https://larecipe.saleem.dev)** The LaRecipe docs are built with LaRecipe.
  55. ## ⬆️ Upgrading from LaRecipe 2
  56. ```bash
  57. composer require larecipe/larecipe
  58. php artisan larecipe:upgrade
  59. ```
  60. 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](https://larecipe.saleem.dev/3.x/upgrade).
  61. ## 📋 Requirements
  62. PHP 8.3+ and Laravel 12.62+ or 13. Ask AI needs `laravel/ai`.
  63. ## 🙌 Contributors
  64. This project exists thanks to all the people who contribute. [Contribute](CONTRIBUTING.md).
  65. <a href="https://github.com/saleem-hadad/larecipe/graphs/contributors"><img src="https://opencollective.com/larecipe/contributors.svg?width=890&button=false" alt="The people who contribute to LaRecipe"></a>
  66. <details>
  67. <summary>Work on LaRecipe locally</summary>
  68. ```bash
  69. composer install
  70. pnpm install
  71. pnpm build # the prebuilt UI in dist/
  72. vendor/bin/pest # PHP tests
  73. pnpm test # UI tests
  74. pnpm test:browser # browser tests against the workbench
  75. ```
  76. </details>
  77. ## 📄 License
  78. MIT. Made by [Saleem Hadad](https://github.com/saleem-hadad).
  79. ⭐ If LaRecipe saves you time, star the repo.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.