Skip to content

docs(remix): Update the Remix 3 page for Remix 3.0.0 - #19775

Open
chargome wants to merge 1 commit into
masterfrom
charlygomez/js-3777-remix-3-docs-300
Open

chargome wants to merge 1 commit into
masterfrom
charlygomez/js-3777-remix-3-docs-300

Conversation

@chargome

@chargome chargome commented Oct 2, 2026

Copy link
Copy Markdown
Member

DESCRIBE YOUR PR

Follow-up to #19773, which is already merged. Updates the Remix 3 alpha page for Remix 3.0.0:

  • The install step asks for Remix 3.0.0 or later instead of remix@3.0.0-rc.1.
  • The browser entry imports run from remix/component, since 3.0.0 renamed @remix-run/ui to @remix-run/component.

Nothing else changes. The import map setup (getScriptEntry, <ImportMap>) that 3.0.0 requires is a Remix change every app makes and is documented by Remix, so it stays out of this page, which only shows the Sentry additions. The server snippet, the asset server snippet and the upload section are unchanged.

Stays a draft until the SDK alpha with the 3.0.0 fix is published. Refs getsentry/sentry-javascript#25008.

IS YOUR CHANGE URGENT?

Help us prioritize incoming PRs by letting us know when the change needs to go live.
Select exactly one option. For deadlines, replace YYYY-MM-DD with the due date. You can update this information later by editing the PR description.

  • Urgent deadline (GA date, etc.): YYYY-MM-DD
  • Other deadline: YYYY-MM-DD
  • No deadline: Not urgent, can wait up to 1 week+

SLA

  • Teamwork makes the dream work, so please add a reviewer to your PRs.
  • Please give the docs team up to 1 week to review your PR unless you've supplied a deadline.

Thanks in advance for your help!

PRE-MERGE CHECKLIST

Make sure you've checked the following before merging your changes:

  • Checked Vercel preview for correctness, including links
  • PR was reviewed and approved by any necessary SMEs (subject matter experts)
  • PR was reviewed and approved by a member of the Sentry docs team

Remix 3.0.0 renamed `@remix-run/ui` to `@remix-run/component`, so the
browser entry imports `run` from `remix/component`. The install step no
longer points at the release candidate.

The import map setup 3.0.0 requires is a Remix change every app makes and
is documented by Remix, so it stays out of this page.

Refs getsentry/sentry-javascript#25008
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
@chargome chargome self-assigned this Oct 2, 2026
@vercel

vercel Bot commented Oct 2, 2026 •

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
sentry-docs Ready Ready Preview Oct 2, 2026 3:50pm UTC
1 Skipped Deployment
Project Deployment Actions Updated
develop-docs Ignored Ignored Oct 2, 2026 3:50pm UTC

Request Review

@linear-code

linear-code Bot commented Oct 2, 2026

Copy link
Copy Markdown

JS-3777

@github-actions github-actions Bot added the Priority: Normal Docs review has no urgent deadline label Oct 2, 2026
@chargome
chargome marked this pull request as ready for review October 2, 2026 15:43
@cursor

cursor Bot commented Oct 2, 2026 •

Copy link
Copy Markdown
Contributor

The plan checks Remix 3 page loads, sibling Remix guide loads, JavaScript-platform 404s, and missing-file logs. An issue escalates when the Remix 3 page stops loading, 404s rise, or those logs appear.

Services: sentry-docs.

Mention @change-monitor in a comment to update the plan.

Plan

What changed

The Remix 3 setup page now requires Remix 3.0.0 or later.
The browser entry snippet now imports run from remix/component.
sentry-docs must deploy before this page is live.

Risk

Readers who copy the snippet can call a Remix API that no longer exists.
A compile miss can 404 this page or nearby JavaScript platform routes.
Shared app code did not change.

Intended effect

This docs text change has no queryable intended effect.
No signal records the new version line or the remix/component import.
absent is the state until a person reads those two strings on the live page.

Regression watch

This diff can drop the Remix 3 page or other JavaScript platform routes.
Page-load traces collapse to /:path*?, so use the docs.page.load path attribute.
All Remix 3 loads in the last 7 days fell in the last 24 hours. Treat a quiet window as unknown, not as a 404, unless the Remix index still has loads.

Signal Baseline Rule Source
Remix 3 page loads (docs.page.load counter, path:/platforms/javascript/guides/remix/remix-3/) 3 loads in 2026-10-01T15:44:22Z to 2026-10-02T15:44:22Z. Same 3 loads in 2026-09-25T15:44:22Z to 2026-10-02T15:44:22Z. Pair with Remix index loads in the same window. Hold near 3 loads per 24h when the index also has loads. detected if this path is 0 and the index is not. Sentry sentry / docs
Remix index page loads (docs.page.load counter, path:/platforms/javascript/guides/remix/) 3 loads in 2026-10-01T15:44:22Z to 2026-10-02T15:44:22Z. 40 loads in 2026-09-25T15:44:22Z to 2026-10-02T15:44:22Z, about 5-6 per day. Hold in the 3-6 loads per 24h band. detected if 24h count is 0. Sentry sentry / docs
JavaScript platform 404s (docs.page.not_found counter, requested_path:platforms/javascript) 38 in 2026-10-01T15:44:22Z to 2026-10-02T15:44:22Z. 408 in 2026-09-25T15:44:22Z to 2026-10-02T15:44:22Z, about 58 per day. Hold in the 38-58 per 24h band. detected if 24h count rises above 58. Sentry sentry / docs
MDX missing-file logs (message:"*MDX file not found at runtime*") 0 events in 2026-09-25T15:44:22Z to 2026-10-02T15:44:22Z. Hold at 0. detected if any event appears. Sentry sentry / docs logs

If 404s rise, check whether /platforms/javascript/guides/remix/remix-3/ is missing from the deploy.

Not observable

The live HTML still showing remix@3.0.0-rc.1 or import { run } from "remix/ui".
Whether copied snippets fail in reader apps.
Pageload or error events tagged with this URL. The transaction name is /:path*?. A url:*remix-3* error search returned 0.

This branch was successfully deployed

1 active deployment
Preview – sentry-docs — 8970b211 Deployed Oct 2, 2026 by vercel[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Priority: Normal Docs review has no urgent deadline

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants