knuckleswtf / knuckleswtf/scribe
scribe not working with @scalar/api-reference 1.39.0 up
- Dominant language
- PHP
- Stars
- 2.3k
- Forks
- 357
- PR merge metrics
- No merged PRs in 30d
Description
### Scribe version
^5.5
### PHP version
8.4
### Laravel version
^12.37
### Scribe config
```ruby
type => "external_laravel"
theme => "scalar"
```
### What happened?
Scribe always uses the latest version of Scalar from jsdelivr `https://cdn.jsdelivr.net/npm/@scalar/api-reference` on `resources/views/scribe/index.blade.php`.
Scalar was updated two days ago to version 1.39.0 and now to 1.39.1. These versions do not work with the OpenAPI YAML file generated by Scribe.
To reproduce the problem, follow the guide at: https://guides.scalar.com/scalar/scalar-api-references/integrations/laravel-scribe
### Docs
- [x] I've checked [the docs](https://scribe.knuckles.wtf/laravel), the [troubleshooting guide](https://scribe.knuckles.wtf/laravel/troubleshooting), and [existing issues](https://github.com/knuckleswtf/scribe/issues?q=is%3Aissue+), but I didn't find a solution
Contributor guide
Research direction
Start with resources/views/scribe/index.blade.php and reproduce the problem using the Scalar Laravel Scribe guide with the shown Scribe, PHP, Laravel, and config versions. Compare the generated OpenAPI YAML with the behavior in Scalar 1.39.0 and later; done means the Scribe-generated documentation renders correctly again.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- laravel, php
- Domain
- documentation
- Issue type
- Bug
- Difficulty
- 3/5
- Estimated time
- 1-2 days
- Activity status
- Stale
- Clarity
- Mostly clear
- Newbie friendliness
- 35/100