https://github.com/dedoc/scramble

Modern Laravel OpenAPI (Swagger) documentation generator. No PHPDoc annotations required.
https://github.com/dedoc/scramble

api generator laravel openapi swagger

Last synced: 26 days ago
JSON representation

Modern Laravel OpenAPI (Swagger) documentation generator. No PHPDoc annotations required.

• Host: GitHub
• URL: https://github.com/dedoc/scramble
• Owner: dedoc
• License: mit
• Created: 2022-08-05T17:16:20.000Z (over 2 years ago)
• Default Branch: main
• Last Pushed: 2024-09-24T06:44:02.000Z (about 2 months ago)
• Last Synced: 2024-10-01T00:02:48.829Z (about 1 month ago)
• Topics: api, generator, laravel, openapi, swagger
• Language: PHP
• Homepage: https://scramble.dedoc.co/
• Size: 1.49 MB
• Stars: 1,173
• Watchers: 14
• Forks: 112
• Open Issues: 27
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE.md

Awesome Lists containing this project

• awesome-projects - scramble

README

        


  

    

  



# Scramble

Scramble generates API documentation for Laravel project. Without requiring you to manually write PHPDoc annotations. Docs are generated in OpenAPI 3.1.0 format.

> **Warning**

> Package is in early stage. It means there may be bugs and API is very likely to change. Create an issue if you spot a bug. Ideas are welcome.

## Documentation

You can find full documentation at [scramble.dedoc.co](https://scramble.dedoc.co).

## Introduction

The main motto of the project is generating your API documentation without requiring you to annotate your code.

This allows you to focus on code and avoid annotating every possible param/field as it may result in outdated documentation. By generating docs automatically from the code your API will always have up-to-date docs which you can trust.

## Installation

You can install the package via composer:

```shell

composer require dedoc/scramble

```

## Usage

After install you will have 2 routes added to your application:

- `/docs/api` - UI viewer for your documentation

- `/docs/api.json` - Open API document in JSON format describing your API.

By default, these routes are available only in `local` environment. You can change this behavior by defining `viewApiDocs` gate.

---