Scribe

knuckleswtf/scribe image

Scribe stats

Downloads
3.7M
Stars
1,298
Open Issues
37
Forks
225

View on GitHub →

Generate API documentation for humans from your Laravel codebase.✍

Scribe for Laravel

Scribe is a powerful tool designed to enhance your Laravel, Lumen, or Dingo API development by automatically generating human-friendly API documentation. It simplifies the documentation process, ensuring that you spend less time writing docs and more time coding.

Key Features

  • Rich Output: Generates a visually appealing single-page HTML document equipped with code samples, human-friendly text, and an interactive "Try It Out" feature. Additionally, it supports exporting to Postman collections and OpenAPI specifications.

  • Intelligent Processing: Scribe automatically extracts request parameters from FormRequests or validation rules and can invoke API endpoints to obtain sample responses. It also supports generating examples from Eloquent API Resources or Transformers.

  • High Customizability: The appearance and content of the documentation can be tailored to meet specific needs. Modifications can range from simple text changes to complete UI overhauls. Developers can also integrate custom strategies to enhance data extraction and document endpoints or details not present in the codebase.

Installation and Usage

The documentation for Scribe is comprehensive and provides detailed guidelines on installation, configuration, and usage. It includes instructions for users migrating from mpociot/laravel-apidoc-generator, with specific steps to transition from version 3 to the latest release.

Visit the official Scribe documentation to get started and explore advanced configurations.

Contribution

Contributors are welcome! If you're interested in improving Scribe or adding new features, check out the contribution guide.

For those looking to elevate their API documentation skills further, the developer of Scribe also offers a specialized course on crafting excellent API documentation.

Scribe is continually evolving with enhancements like subgrouping, easier sorting, and automated upgrade commands in its latest version, making it an essential tool for modern API development in Laravel.

Cube

Laravel Newsletter

Join 40k+ other developers and never miss out on new tips, tutorials, and more.


Knuckleswtf Scribe Related Articles

Automating your OpenAPI Documentation image

Automating your OpenAPI Documentation

Read article
SaaSykit: Laravel SaaS Starter Kit logo

SaaSykit: Laravel SaaS Starter Kit

SaaSykit is a Multi-tenant Laravel SaaS Starter Kit that comes with all features required to run a modern SaaS. Payments, Beautiful Checkout, Admin Panel, User dashboard, Auth, Ready Components, Stats, Blog, Docs and more.

SaaSykit: Laravel SaaS Starter Kit
Tighten logo

Tighten

We help companies turn great ideas into amazing apps, products, and services.

Tighten
Tinkerwell logo

Tinkerwell

The must-have code runner for Laravel developers. Tinker with AI, autocompletion and instant feedback on local and production environments.

Tinkerwell
No Compromises logo

No Compromises

Joel and Aaron, the two seasoned devs from the No Compromises podcast, are now available to hire for your Laravel project. ⬧ Flat rate of $9500/mo. ⬧ No lengthy sales process. ⬧ No contracts. ⬧ 100% money back guarantee.

No Compromises
Securing Laravel logo

Securing Laravel

The essential security resource for Laravel devs, covering everything you need to keep your apps secure. Sign up to receive weekly security tips and monthly in depth articles, diving deep into security concepts you need to know!

Securing Laravel
Shift logo

Shift

Running an old Laravel version? Instant, automated Laravel upgrades and code modernization to keep your applications fresh.

Shift