Skip to content

fix(docs): let the Vercel build install what the web components import - #242

Merged
Khalidabdi1 merged 1 commit into
mainfrom
fix/docs-deploy-web-deps
Oct 13, 2026
Merged

Khalidabdi1 merged 1 commit into
mainfrom
fix/docs-deploy-web-deps

Conversation

@Khalidabdi1

@Khalidabdi1 Khalidabdi1 commented Oct 13, 2026 •

Copy link
Copy Markdown
Contributor

What this changes

apps/docs now depends on panelui-web by name.

Why

The production deploy of main after #241 failed on Vercel:

Module not found: Can't resolve 'tailwind-variants'
./packages/web/src/components/tilt-card/index.tsx

Vercel builds from apps/docs, and npm install run inside a workspace brings only that workspace's dependencies. The docs pages import the web components' source by path, and that source imports tailwind-variants, which the docs app never declared. CI runs npm ci at the root, which brings everything, so every check was green.

Type of change

  • Bug fix
  • Internal: refactor, tooling, CI

How it was tested

  • Cloned the repository fresh, ran npm install in apps/docs: tailwind-variants was missing before this change and present after it.
  • In that same clone, npm run build in apps/docs passes, which is what Vercel runs.
  • npm test (819 pass, one new), npm run typecheck, npm run docs:generate leaves no diff.

A contract test now holds the dependency in place and checks that packages/web/package.json declares everything its source imports. The lockfile gains one line; no version moved.

🤖 Generated with Claude Code

Summary by CodeRabbit

  • Bug Fixes

    • Fixed Vercel documentation builds by declaring the web package as a dependency, avoiding reliance on packages available only through root-level CI installs.
  • Documentation

    • Clarified how Vercel installs dependencies and added steps for checking a deployment-like build from a fresh clone.
  • Tests

    • Added checks that the docs app and web package declare their required dependencies.

The site is built on Vercel from apps/docs, and an install run from
there brings only the docs app's own dependencies. Its pages import the
web components' source by path, and that source imports
tailwind-variants, which the docs app had never declared. CI installs
every workspace from the root, so it was there in CI and missing on
Vercel: the first deploy with the web collection failed at
"Module not found: tailwind-variants" with every check green.

The docs app now depends on panelui-web by name, which brings that
package's dependencies with it. Checked by cloning the repository
fresh, installing from apps/docs and building, which is what Vercel
does.

A contract test keeps the dependency there, and checks that the web
package declares everything its source imports. CLAUDE.md says how the
two installs differ and how to reproduce Vercel's.

The lockfile gains one line, the new edge. No version moved.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@coderabbitai

coderabbitai Bot commented Oct 13, 2026 •

Copy link
Copy Markdown

Review in Change Stack →

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration
  • Configuration used: defaults
  • Review profile: CHILL
  • Plan: Advanced
  • Run ID: 3751ffe6-2bc6-445f-8f7b-ec70f390acf5
📥 Commits

Reviewing files that changed from the base of the PR and between 3e7e449 and 0cea295.

⛔ Files ignored due to path filters (1)
  • package-lock.json is excluded by !**/package-lock.json
📒 Files selected for processing (3)
  • CLAUDE.md
  • apps/docs/package.json
  • apps/docs/test/web-registry.test.mjs

Included review availability: This review used your included allowance. Your plan provides up to 4 included reviews per hour; 3 remain after this review.

📝 Walkthrough

The docs workspace now declares panelui-web as a dependency. A test checks that declaration and verifies external imports in packages/web against its declared dependencies. Deployment guidance describes the Vercel install context and a fresh-clone build check.

Changes: Docs workspace dependency

Layer / File(s) Summary
Declare and verify web dependencies
apps/docs/package.json, apps/docs/test/web-registry.test.mjs, CLAUDE.md
The docs package declares panelui-web. A test checks that declaration and verifies external imports in packages/web against its dependencies or peer dependencies. The deployment guidance describes the Vercel install context and a fresh-clone build check.

Priority: ➖ Normal

Estimated code review effort: 2 (Simple) | ~10 minutes

Change: Bug fix

Suggested reviewers: danestves

Merge Risk: ⚪ Minimal · up to 0cea2

No actionable issue is identified in this change; it is mergeable after normal checks.

Pre-merge checks · Passed 5
Passed Passed checks (5 passed)
Check name Status Explanation
Description Check Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check Passed The title clearly identifies the main change: allowing the Vercel docs build to install the web components dependency.
Docstring Coverage Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check. Docstring coverage is scoped to functions touched by this diff. Analyzed 0 functions across 1…
Linked Issues check Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check Passed Check skipped because no linked issues were found for this pull request.
✨ Finishing Touches
📝 Generate docstrings
  • Commit to this branch
  • Create a new PR
🧪 Generate unit tests (beta)
  • Commit to this branch
  • Create a new PR
  • Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@Khalidabdi1
Khalidabdi1 merged commit 5483f71 into main Oct 13, 2026
3 checks passed
@Khalidabdi1
Khalidabdi1 deleted the fix/docs-deploy-web-deps branch October 13, 2026 12:56
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant