docs(hono): Document dedicated `@sentry/hono` SDK by s1gr1d · Pull Request #17557 · getsentry/sentry-docs

s1gr1d · 2026-04-30T09:12:47Z

DESCRIBE YOUR PR

The Hono docs previously documented the setup using other SDKs, but not @sentry/hono. This PR changes the quick setup page to include the new setup.

Closes getsentry/sentry-javascript#20402

IS YOUR CHANGE URGENT?

Help us prioritize incoming PRs by letting us know when the change needs to go live.

Urgent deadline (GA date, etc.):
Other deadline:
None: 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 added an urgent due date to it.
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

vercel · 2026-04-30T09:12:52Z

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

Project	Deployment	Actions	Updated (UTC)
sentry-docs	Ready	Preview, Comment	May 5, 2026 9:11am

1 Skipped Deployment

Project	Deployment	Actions	Updated (UTC)
develop-docs	Ignored	Preview	May 5, 2026 9:11am

inventarSarah

Hey @s1gr1d 👋
left some questions and suggestions -- thank you!

inventarSarah · 2026-04-30T11:25:15Z

- **Cloudflare Workers**: Use `@sentry/cloudflare` – see our [Hono on Cloudflare guide](/platforms/javascript/guides/cloudflare/frameworks/hono/)
- **Deno**: Use `@sentry/deno` – see our [Deno guide](/platforms/javascript/guides/deno/) (Beta)
- **Bun**: Use `@sentry/bun` – see our [Bun guide](/platforms/javascript/guides/bun/)
+The community middleware `@hono/sentry` has been deprecated in favor of `@sentry/hono`, which provides better performance and more features. If you're currently using `@hono/sentry`, see the [migration section](#migrating-from-honosentry) below.


You could create an Expandable section "Are you using @hono/sentry?", add this content inside it, and then also the migration section from the end of the guide.
This would still only require minimal space, and it removes the migration part at the end, which currently looks a bit lost.
What do you think?

inventarSarah · 2026-04-30T11:31:25Z

+  options={["error-monitoring", "performance", "logs"]}
+/>
+
+<Include name="quick-start-features-expandable" />


This still lists "Profiling" -> you can update this in the include file

I think I'll just add profiling as people can still use it when they are on the Node runtime.

inventarSarah · 2026-04-30T11:34:19Z

+
+## Configure
+
+<Expandable title="Cloudflare Workers: Enable Node.js Compatibility">


What is our plan regarding the Hono on Cloudflare guide?
Currently, the installation of the hono SDK is missing here (otherwise it looks alright?). If we want to keep the CF guide, we could remove the Cloudflare instructions from this guide and link to Cloudflare.

True, it makes sense to include this to the list of frameworks there. As this is using the cloudflare sdk under the hood, it makes sense to already be in the cloudflare docs.
However, we could also link from cloudflare to the hono docs? Then we would have the hono docs in one place and just need different code snippets. What do you think @inventarSarah ?

Yes, that sounds okay to me.
It's definitely easier for us to maintain.

So we need to:

replace the link to Hono on the CF quick start guide

remove the content from "hono on CF" and link to the Hono quick start guide instead (I don't think we can link to the Hono guide directly from the CF navigation, right?)

That should be it, I think 🤔

Changed that here: 4a4bd1b

Perfect, thank you!

inventarSarah

Thanks for the updates!

We only need to update Hono on CF :)

inventarSarah · 2026-05-05T06:27:08Z

+<SplitSection>
+<SplitSectionText>
+
+Profiling is available for the Node.js runtime. Install the `@sentry/profiling-node` package:


Suggested change

Profiling is available for the Node.js runtime. Install the `@sentry/profiling-node` package:

Profiling is only available for the Node.js runtime. Install the `@sentry/profiling-node` package:

adding "only" here again just to make sure users don't miss this

inventarSarah · 2026-05-05T06:33:59Z

+
+## Configure
+
+<Expandable title="Cloudflare Workers: Enable Node.js Compatibility">


Yes, that sounds okay to me.
It's definitely easier for us to maintain.

So we need to:

replace the link to Hono on the CF quick start guide

remove the content from "hono on CF" and link to the Hono quick start guide instead (I don't think we can link to the Hono guide directly from the CF navigation, right?)

That should be it, I think 🤔

chargome

Just found a small bug, other than that lgtm!

chargome · 2026-05-05T08:42:47Z

+```bash
+node --import ./instrument.mjs app.js
+```
+
+```bash
+NODE_OPTIONS="--import ./instrument.mjs"
+```


This does not render properly with the same title, you might need to give it a filename or rename the tab title it seems

inventarSarah

Thank you 🎉

s1gr1d requested review from a team and inventarSarah April 30, 2026 09:12

sentry Bot reviewed Apr 30, 2026

View reviewed changes

Comment thread docs/platforms/javascript/guides/hono/index.mdx

Comment thread docs/platforms/javascript/guides/hono/index.mdx Outdated

s1gr1d force-pushed the sig/hono-docs branch from 58a3337 to f7aeced Compare April 30, 2026 09:17

vercel Bot deployed to Preview – sentry-docs April 30, 2026 09:27 View deployment

docs(hono): Document dedicated @sentry/hono SDK

ff54262

s1gr1d force-pushed the sig/hono-docs branch from f7aeced to ff54262 Compare April 30, 2026 10:29

vercel Bot deployed to Preview – sentry-docs April 30, 2026 10:39 View deployment

inventarSarah reviewed Apr 30, 2026

View reviewed changes

review suggestions

99aebaa

sentry Bot reviewed May 4, 2026

View reviewed changes

Comment thread docs/platforms/javascript/guides/hono/index.mdx

vercel Bot deployed to Preview – sentry-docs May 4, 2026 13:17 View deployment

add platform includes

c58d8b6

s1gr1d requested a review from inventarSarah May 4, 2026 13:38

vercel Bot deployed to Preview – sentry-docs May 4, 2026 13:48 View deployment

inventarSarah reviewed May 5, 2026

View reviewed changes

chargome approved these changes May 5, 2026

View reviewed changes

link to Hono docs

4a4bd1b

sentry Bot reviewed May 5, 2026

View reviewed changes

Comment thread platform-includes/performance/configure-sample-rate/javascript.hono.mdx

add tab titles

4f7ef0d

sentry Bot reviewed May 5, 2026

View reviewed changes

Comment thread platform-includes/set-environment/javascript.hono.mdx

fix imports

8d1529d

vercel Bot deployed to Preview – sentry-docs May 5, 2026 09:11 View deployment

s1gr1d requested a review from inventarSarah May 5, 2026 09:43

inventarSarah approved these changes May 5, 2026

View reviewed changes

s1gr1d merged commit 3039062 into master May 5, 2026
18 checks passed

s1gr1d deleted the sig/hono-docs branch May 5, 2026 10:59


		## Configure

		<Expandable title="Cloudflare Workers: Enable Node.js Compatibility">

	Profiling is available for the Node.js runtime. Install the `@sentry/profiling-node` package:
	Profiling is only available for the Node.js runtime. Install the `@sentry/profiling-node` package:

Uh oh!

Conversation

s1gr1d commented Apr 30, 2026

DESCRIBE YOUR PR

IS YOUR CHANGE URGENT?

SLA

PRE-MERGE CHECKLIST

Uh oh!

vercel Bot commented Apr 30, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Uh oh!

Uh oh!

inventarSarah left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

s1gr1d May 4, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

inventarSarah left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

chargome left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

inventarSarah left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

vercel Bot commented Apr 30, 2026 •

edited

Loading

s1gr1d May 4, 2026 •

edited

Loading