mirror of
https://github.com/supabase/supabase.git
synced 2026-10-05 17:35:10 +03:00
Katerina Skroumpelou
81aefa3c55
## I have read the [CONTRIBUTING.md](https://github.com/supabase/supabase/blob/master/CONTRIBUTING.md) file. YES ## What kind of change does this PR introduce? Bug fix. ## What is the current behavior? Running `make` in `apps/docs/spec` (used by the `docs-js-libs-update` workflow) fails with: ``` ERR_PNPM_RECURSIVE_EXEC_FIRST_FAIL Command "redocly" not found make: *** [Makefile:56: dereference.api.v1] Error 254 ``` This regression was introduced in #44428, which removed `@redocly/cli` from `packages/generator/package.json` as an "unused" dependency. It was previously placed there because the Makefile ran `cd packages/generator && pnpm exec redocly` — but that directory had no logical ownership of the dependency. ## What is the new behavior? - `@redocly/cli` is now a devDependency of `apps/docs`, which is the package that owns the spec generation workflow. - The Makefile no longer `cd`s into `packages/generator` for the redocly calls. It runs `pnpm exec redocly` directly from `apps/docs/spec`, where the binary is now available. - The `tsdoc:dereference` targets are unchanged and still `cd` into `packages/generator` to run scripts defined there. ## Additional context The `cd packages/generator` pattern for redocly was introduced in #42987 to fix a peer dependency resolution issue with `npx @redocly/cli`. The fix was correct but placed the dependency in the wrong package. This PR moves it to its logical home. <!-- This is an auto-generated comment: release notes by coderabbit.ai --> ## Summary by CodeRabbit * **Chores** * Added documentation processing tool as a development dependency. * Updated documentation generation configuration to optimize command execution paths. <!-- end of auto-generated comment: release notes by coderabbit.ai -->
Supabase Specs
These spec files are used to generate the reference documentation.
Preparation
To get started, run make init. This installs all dependencies.
Usage
make # download and transform specs into docs