Hacktoberfest 2026: the issues maintainers tagged for October, open and beginner-friendly. Browse Hacktoberfest issues

Clarify Bun README preload and build-plugin requirements

Open Beginner friendly
#24,555 1 comment 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Assessment

Difficulty
1/5
Estimated time
1-3 hours
Newbie friendliness
90/100
Issue type
Documentation
Clarity
Clearly specified
Activity status
Active
Tech stack
bun
Domain
documentation

Research direction

Start in packages/bun/README.md by reviewing the existing preload documentation and the references to sentryBunPlugin from @sentry/bun/plugin. Done means the README has a separate instrument.js preload example, explains initialization order and build-time instrumentation requirements, and links to the full build example without duplicating it.

Written by the indexing model from the issue text.

Description

Task

Update packages/bun/README.md with a separate instrumentation file and a bun --preload ./instrument.js app.js startup example.

Briefly explain that preload ensures initialization order, while sentryBunPlugin from @sentry/bun/plugin enables build-time instrumentation of supported bundled dependencies. Dependencies needing this instrumentation must be included in the bundle. Link to the full build example rather than duplicating it.

Preload already existed before v11; the build-plugin explanation is the key v11 addition.

Docs PR: getsentry/sentry-docs#19361

Dominant language
TypeScript
Stars
8.7k
Forks
1.9k
Avg merge
1d 18h
Merged PRs (30d)
562

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from getsentry/sentry-javascript

All issues in getsentry/sentry-javascript

Similar issues

More TypeScript issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.