What types of data can Bun macros return?

Macros must return JSON-serializable values such as strings, numbers, booleans, arrays, or plain objects, as these values must be represented as literals in the final output.

Bun macros are functions that run during the bundling process rather than at runtime, allowing the results to be inlined directly into your source code for maximum performance.

Can Bun macros perform asynchronous operations?

Yes, Bun macros support async/await, making them ideal for fetching remote schemas or reading files from the disk during the bundling process.

How do I import a Bun macro?

Macros are imported using the specific syntax: import { function } from './file' with { type: 'macro' }. This tells the bundler to execute the function during the build.

Do macros run when I use 'bun run'?

By default, macros only execute during the 'bun build' process. When using 'bun run' on source files, they behave as standard JavaScript imports unless the loader is specifically configured.

Bun Macros Optimization

Name: Bun Macros Optimization
Author: secondsky

bysecondsky

•

배포 및 DevOps

Optimizes JavaScript applications by executing code at bundle time and inlining results for improved runtime performance.

소개

The Bun Macros skill empowers Claude to implement and manage compile-time JavaScript execution within the Bun ecosystem. It allows developers to shift heavy computations, file reading, and environment variable resolution from the user's browser or server runtime to the build phase. This skill is essential for generating type-safe API clients, embedding static assets directly into bundles, and creating environment-aware builds without runtime overhead.

주요 기능

Dynamic build-time code generation and schema parsing
Compile-time JavaScript execution and result inlining
Secure environment variable inlining without runtime leakage
21 GitHub stars
Automated Git metadata and build-info embedding
Asynchronous macro support for remote data fetching during builds

사용 사례

Embedding licensing information or configuration files directly into the production bundle
Removing development-only code blocks based on build-time environment checks
Generating static routes or API clients from filesystem structures at build time

소개

주요 기능

Dynamic build-time code generation and schema parsing
Compile-time JavaScript execution and result inlining
Secure environment variable inlining without runtime leakage
21 GitHub stars
Automated Git metadata and build-info embedding
Asynchronous macro support for remote data fetching during builds

사용 사례

Embedding licensing information or configuration files directly into the production bundle
Removing development-only code blocks based on build-time environment checks
Generating static routes or API clients from filesystem structures at build time