mirror of
https://github.com/supabase/supabase.git
synced 2026-10-06 01:45:10 +03:00
Katerina Skroumpelou
9065909e3e
## Problem The [spec generation Makefile started failing](https://github.com/supabase/supabase/actions/runs/22142393017) with: ```text ReferenceError: React is not defined at Object. (/Users/.../_npx/.../node_modules/styled-components/dist/styled-components.cjs.js:1:860) ``` This occurred when `@redocly/cli@2.18.2` was released on Feb 16, 2026. The error happens because `npx @redocly/cli` installs the package in an isolated temporary cache without properly resolving peer dependencies (React is a peer dependency of styled-components). ## Solution Replace `npx @redocly/cli` with `pnpm exec redocly` to use the installed version from `packages/generator/package.json`. This ensures: 1. **Proper dependency resolution** - pnpm installs the full dependency tree including peer dependencies 2. **Version control** - locked to the version in package.json instead of always fetching latest 3. **Reproducible builds** - won't break when new versions are released ## Changes - Replace `npx @redocly/cli` → `cd $(GENERATOR_DIR) && pnpm exec redocly` (5 places) - Replace `npm run` → `pnpm run` for consistency with project's package manager (6 places) <!-- This is an auto-generated comment: release notes by coderabbit.ai --> ## Summary by CodeRabbit * **Chores** * Updated build configuration to execute documentation generation tasks from a centralized generator directory with unified package management, ensuring consistent handling of OpenAPI bundling, TypeScript documentation, and validation workflows. <!-- 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