knuckleswtf / knuckleswtf/scribe

scribe not working with @scalar/api-reference 1.39.0 up

Open
#1,036 1 comment 0 reactions 0 assignees View on GitHub
bug triage
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.

Image

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

Open the contributing 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

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.