Download the PHP package ahmedtarboush/papyrus-docs without Composer

¶ PAPYRUS DOCS

A Postman-like API documentation & testing client — natively inside Laravel.

What is Papyrus?

Papyrus Docs is an enterprise-grade API documentation and playground that lives inside your Laravel application. It automatically reads your FormRequest validation rules — including nested arrays, Enum options, file uploads, and conditional rules — and renders them as an interactive, Postman-like testing UI with zero configuration.

No OpenAPI YAML. No manual annotations. Just write your FormRequests, and Papyrus does the rest.

Why Papyrus?

Features at a Glance

• 🧠 Exhaustive Validation Engine — Parses every Laravel 12 rule: required, nullable, min, max, regex, between, confirmed, dimensions, conditional rules (required_if, prohibited_unless), and more.
• 🔍 Dynamic Type Discovery — Rules like uuid, ulid, ip, mac_address are dynamically registered as custom types with format-specific UI hints.
• 📋 Enum & Options Extraction — Automatically extracts in:a,b,c, Rule::in(), and PHP 8.1+ Enum cases into selectable dropdowns.
• 🔄 Two-Way Sync — Edit payload via Visual Form or Raw JSON — changes sync bidirectionally with a file-guard safety mechanism.
• ☑️ Postman Checkbox — Toggle individual fields on/off. Disabled fields are excluded from the request but preserved in state.
• ✏️ Inline Key Editor — Click any key to rename it. Add/remove custom properties dynamically.
• 🔁 Recursive Form Engine — Infinite nesting via DynamicField → ObjectBuilder → ArrayBuilder → DynamicField.
• 📝 Non-Truncated Validation Badges — All rules displayed as expandable badges, never truncated.
• 🔧 DocBlock Overrides — Absolute manual control with powerful custom directives like @papyrus-bodyParam, @papyrus-queryParam, @papyrus-header, and multi-line markdown blocks for @papyrus-description-start and @papyrus-responseExample-start.
• 📡 Code Snippets — Auto-generated cURL, PHP (Guzzle), JavaScript (fetch), and Python (requests) snippets for every endpoint.
• 📦 FormData Auto-Handling — File uploads automatically switch to multipart/form-data with correct boundary headers.
• ⚙️ Configurable Grouping — Group endpoints by controller, route name, or URI regex patterns.
• 🎨 Global Dark & Light Mode — Fully responsive dark theme that defaults to your OS preference.
• 🎯 OpenAPI Export — Export your documentation as OpenAPI 3.0 JSON specification.
• 📮 Postman Export — Export as Postman Collection v2.1 for team sharing.
• 🛡️ Authorization Gate — Built-in viewPapyrusDocs gate for access control.
• 🐛 Debug Mode — Debug headers with execution time, memory usage, PHP and Laravel versions.
• 🔧 Artisan Commands — papyrus:install for one-step setup.

Installation

1. Require the package

2. Run the install command (recommended)

This publishes both the config file and production assets in one step.

3. Or publish manually

4. Access the dashboard

Navigate to:

That's it. No annotations required. Papyrus automatically scans your routes and FormRequests.

Quick Start

Step 1: Create a FormRequest

Step 2: Type-hint it in your controller

Step 3: Open Papyrus

Visit /papyrus-docs in your browser. The endpoint above will appear with:

• All fields rendered with correct input types (email field, number with min/max, file upload with .jpg,.png,.webp accept filter)
• role rendered as a Select dropdown with admin, editor, viewer
• tags rendered as a repeatable array builder
• Validation badges showing required, string, max:255 on each field
• A fully functional playground to test the endpoint with real requests

Documentation

Artisan Commands

papyrus:install

One-step installation that publishes both config and assets:

Equivalent to running:

papyrus:export

Export your API schema directly to a JSON file (uses config('papyrus.export_path')):

Exporters

OpenAPI 3.0 Export

Papyrus includes an OpenApiGenerator that converts your scanned routes into an OpenAPI 3.0 specification:

Configure the export via config/papyrus.php under the open_api key.

Postman Collection Export

The PostmanGenerator exports your API as a Postman Collection v2.1:

Import the resulting JSON directly into Postman to share with your team.

Debug Mode

Enable debug mode to get execution metadata in the schema API response headers:

The /papyrus-docs/api/schema endpoint will include:

Authorization

By default, Papyrus is only accessible in local and testing environments via the viewPapyrusDocs gate.

The default gate definition:

To customize access, override the gate in your AuthServiceProvider:

Internal Routes

Papyrus registers these routes under the configured URL prefix:

All routes respect the middlewares config and are prefixed with the url config value.

Disabling in Production

Set the environment variable:

This prevents all Papyrus routes from being registered. The ServiceProvider short-circuits entirely.

Requirements

• PHP 8.1+
• Laravel 10, 11, or 12
• phpdocumentor/reflection-docblock (auto-installed)

Created By

Ahmed Tarboush — LinkedIn

License

Papyrus Docs is open-source software licensed under the MIT License.