https://github.com/jbrooksuk/chirper

Example application that demonstrates how to document Laravel APIs using Scribe.
https://github.com/jbrooksuk/chirper

laravel openapi scribe

Last synced: about 10 hours ago
JSON representation

Example application that demonstrates how to document Laravel APIs using Scribe.

• Host: GitHub
• URL: https://github.com/jbrooksuk/chirper
• Owner: jbrooksuk
• Created: 2022-12-15T14:19:10.000Z (almost 2 years ago)
• Default Branch: main
• Last Pushed: 2024-02-19T09:31:50.000Z (8 months ago)
• Last Synced: 2024-05-02T00:19:20.765Z (5 months ago)
• Topics: laravel, openapi, scribe
• Language: PHP
• Homepage: https://james.brooks.page
• Size: 482 KB
• Stars: 25
• Watchers: 2
• Forks: 3
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# Chirper - Documenting Laravel APIs

This is the repository for the Chirper application that demonstrates how to document Laravel APIs using the OpenAPI specification with [Scribe](https://scribe.knuckles.wtf).

> [!NOTE]

> Checkout the `complete` branch for the completed documentation.

# Building The Documentation

Run the `./build.sh` script to generate the API documentation. This will generate the OpenAPI specification and static documentation in the `./public/docs` directory.

# Video

I have given this talk at a few conferences, some of which are recorded. I would recommend watching the video to get a better understanding of the concepts used. 

- Laracon AU, 2023 - https://youtu.be/K-g-t99mKZU

- PHP UK, 2024 - https://youtu.be/aj7W__I5YXU