From f216673f982fed03dcb2361ba64d86857f181ca9 Mon Sep 17 00:00:00 2001
From: Luke Parker <10430890+Hona@users.noreply.github.com>
Date: Sat, 15 Nov 2025 08:05:47 +1000
Subject: [PATCH 1/5] fix: Add missing SIGWINCH for windows (#24704)
### What does this PR do?
Fixes https://github.com/oven-sh/bun/issues/22288
Fixes #22402
Fixes https://github.com/oven-sh/bun/issues/23224
Fixes https://github.com/oven-sh/bun/issues/17803
cc: Should unblock opencode/opentui window resize on windows
https://github.com/sst/opentui/issues/152
### How did you verify your code works?
Clone the linked repro, verified latest bun failed, node worked, then
iterated till my local bun worked.
Here is a screenshot of the branch working with bun on windows
Additionally using bun vs bun-debug on a little test for our downstream
package proves this works
---
src/bun.js/bindings/BunProcess.cpp | 1 +
1 file changed, 1 insertion(+)
diff --git a/src/bun.js/bindings/BunProcess.cpp b/src/bun.js/bindings/BunProcess.cpp
index e38ddf3b22..d079964114 100644
--- a/src/bun.js/bindings/BunProcess.cpp
+++ b/src/bun.js/bindings/BunProcess.cpp
@@ -962,6 +962,7 @@ static void loadSignalNumberMap()
signalNameToNumberMap->add(signalNames[2], SIGQUIT);
signalNameToNumberMap->add(signalNames[9], SIGKILL);
signalNameToNumberMap->add(signalNames[15], SIGTERM);
+ signalNameToNumberMap->add(signalNames[27], SIGWINCH);
#else
signalNameToNumberMap->add(signalNames[0], SIGHUP);
signalNameToNumberMap->add(signalNames[1], SIGINT);
From b2c219a56c3ebcb49f0a47763f88c506d7e38773 Mon Sep 17 00:00:00 2001
From: robobun
Date: Fri, 14 Nov 2025 16:21:04 -0800
Subject: [PATCH 2/5] Implement retry and repeats options for bun:test (#23713)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Fixes #16051, Fixes ENG-21437
Implements retry/repeats
```ts
test("my test", () => {
if (Math.random() < 0.1) throw new Error("uh oh!");
}, {repeats: 20});
```
```
Error: uh oh!
✗ my test
```
```ts
test("my test", () => {
if (Math.random() < 0.1) throw new Error("uh oh!");
}, {retry: 5});
```
```
Error: uh oh!
✓ my test (attempt 2)
```
Also fixes a bug where onTestFinished inside a test would not run if the
test failed
```ts
test("abc", () => {
onTestFinished(() => { console.log("hello" });
throw new Error("uh oh!");
});
```
```
Error: uh oh!
hello
```
---------
Co-authored-by: Claude Bot
Co-authored-by: pfg
Co-authored-by: autofix-ci[bot] <114827586+autofix-ci[bot]@users.noreply.github.com>
---
src/bun.js/test/Execution.zig | 74 +++++---
src/bun.js/test/Order.zig | 20 ++-
src/bun.js/test/ScopeFunctions.zig | 28 +--
src/bun.js/test/bun_test.zig | 13 +-
src/cli/test_command.zig | 14 ++
.../js/bun/test/test-on-test-finished.test.ts | 16 ++
.../bun/test/test-retry-repeats-basic.test.ts | 161 ++++++++++++++++++
7 files changed, 283 insertions(+), 43 deletions(-)
create mode 100644 test/js/bun/test/test-retry-repeats-basic.test.ts
diff --git a/src/bun.js/test/Execution.zig b/src/bun.js/test/Execution.zig
index 69f90ac347..77669082cf 100644
--- a/src/bun.js/test/Execution.zig
+++ b/src/bun.js/test/Execution.zig
@@ -76,7 +76,8 @@ pub const ExecutionSequence = struct {
/// Index into ExecutionSequence.entries() for the entry that is not started or currently running
active_entry: ?*ExecutionEntry,
test_entry: ?*ExecutionEntry,
- remaining_repeat_count: i64 = 1,
+ remaining_repeat_count: u32,
+ remaining_retry_count: u32,
result: Result = .pending,
executing: bool = false,
started_at: bun.timespec = .epoch,
@@ -90,11 +91,18 @@ pub const ExecutionSequence = struct {
} = .not_set,
maybe_skip: bool = false,
- pub fn init(first_entry: ?*ExecutionEntry, test_entry: ?*ExecutionEntry) ExecutionSequence {
+ pub fn init(cfg: struct {
+ first_entry: ?*ExecutionEntry,
+ test_entry: ?*ExecutionEntry,
+ retry_count: u32 = 0,
+ repeat_count: u32 = 0,
+ }) ExecutionSequence {
return .{
- .first_entry = first_entry,
- .active_entry = first_entry,
- .test_entry = test_entry,
+ .first_entry = cfg.first_entry,
+ .active_entry = cfg.first_entry,
+ .test_entry = cfg.test_entry,
+ .remaining_repeat_count = cfg.repeat_count,
+ .remaining_retry_count = cfg.retry_count,
};
}
@@ -349,8 +357,10 @@ fn stepSequenceOne(buntest_strong: bun_test.BunTestPtr, globalThis: *jsc.JSGloba
}
const next_item = sequence.active_entry orelse {
- bun.debugAssert(sequence.remaining_repeat_count == 0); // repeat count is decremented when the sequence is advanced, this should only happen if the sequence were empty. which should be impossible.
- groupLog.log("runOne: no repeats left; wait for group completion.", .{});
+ // Sequence is complete - either because:
+ // 1. It ran out of entries (normal completion)
+ // 2. All retry/repeat attempts have been exhausted
+ groupLog.log("runOne: no more entries; sequence complete.", .{});
return .done;
};
sequence.executing = true;
@@ -455,7 +465,7 @@ fn advanceSequence(this: *Execution, sequence: *ExecutionSequence, group: *Concu
sequence.executing = false;
if (sequence.maybe_skip) {
sequence.maybe_skip = false;
- sequence.active_entry = entry.skip_to;
+ sequence.active_entry = if (entry.failure_skip_past) |failure_skip_past| failure_skip_past.next else null;
} else {
sequence.active_entry = entry.next;
}
@@ -465,18 +475,32 @@ fn advanceSequence(this: *Execution, sequence: *ExecutionSequence, group: *Concu
if (sequence.active_entry == null) {
// just completed the sequence
- this.onSequenceCompleted(sequence);
- sequence.remaining_repeat_count -= 1;
- if (sequence.remaining_repeat_count <= 0) {
- // no repeats left; indicate completion
- if (group.remaining_incomplete_entries == 0) {
- bun.debugAssert(false); // remaining_incomplete_entries should never go below 0
- return;
- }
- group.remaining_incomplete_entries -= 1;
- } else {
+ const test_failed = sequence.result.isFail();
+ const test_passed = sequence.result.isPass(.pending_is_pass);
+
+ // Handle retry logic: if test failed and we have retries remaining, retry it
+ if (test_failed and sequence.remaining_retry_count > 0) {
+ sequence.remaining_retry_count -= 1;
this.resetSequence(sequence);
+ return;
}
+
+ // Handle repeat logic: if test passed and we have repeats remaining, repeat it
+ if (test_passed and sequence.remaining_repeat_count > 0) {
+ sequence.remaining_repeat_count -= 1;
+ this.resetSequence(sequence);
+ return;
+ }
+
+ // Only report the final result after all retries/repeats are done
+ this.onSequenceCompleted(sequence);
+
+ // No more retries or repeats; mark sequence as complete
+ if (group.remaining_incomplete_entries == 0) {
+ bun.debugAssert(false); // remaining_incomplete_entries should never go below 0
+ return;
+ }
+ group.remaining_incomplete_entries -= 1;
}
}
fn onGroupStarted(_: *Execution, _: *ConcurrentGroup, globalThis: *jsc.JSGlobalObject) void {
@@ -580,13 +604,13 @@ pub fn resetSequence(this: *Execution, sequence: *ExecutionSequence) void {
}
}
- if (sequence.result.isPass(.pending_is_pass)) {
- // passed or pending; run again
- sequence.* = .init(sequence.first_entry, sequence.test_entry);
- } else {
- // already failed or skipped; don't run again
- sequence.active_entry = null;
- }
+ // Preserve the current remaining_repeat_count and remaining_retry_count
+ sequence.* = .init(.{
+ .first_entry = sequence.first_entry,
+ .test_entry = sequence.test_entry,
+ .retry_count = sequence.remaining_retry_count,
+ .repeat_count = sequence.remaining_repeat_count,
+ });
_ = this;
}
diff --git a/src/bun.js/test/Order.zig b/src/bun.js/test/Order.zig
index df2902c766..b1df67422e 100644
--- a/src/bun.js/test/Order.zig
+++ b/src/bun.js/test/Order.zig
@@ -46,9 +46,12 @@ pub fn generateAllOrder(this: *Order, entries: []const *ExecutionEntry) bun.JSEr
for (entries) |entry| {
if (bun.Environment.ci_assert and entry.added_in_phase != .preload) bun.assert(entry.next == null);
entry.next = null;
- entry.skip_to = null;
+ entry.failure_skip_past = null;
const sequences_start = this.sequences.items.len;
- try this.sequences.append(.init(entry, null)); // add sequence to concurrentgroup
+ try this.sequences.append(.init(.{
+ .first_entry = entry,
+ .test_entry = null,
+ })); // add sequence to concurrentgroup
const sequences_end = this.sequences.items.len;
try this.groups.append(.init(sequences_start, sequences_end, this.groups.items.len + 1)); // add a new concurrentgroup to order
this.previous_group_was_concurrent = false;
@@ -139,15 +142,20 @@ pub fn generateOrderTest(this: *Order, current: *ExecutionEntry) bun.JSError!voi
// set skip_to values
var index = list.first;
- var skip_to = current.next;
+ var failure_skip_past: ?*ExecutionEntry = current;
while (index) |entry| : (index = entry.next) {
- if (entry == skip_to) skip_to = null;
- entry.skip_to = skip_to; // we should consider matching skip_to in beforeAll to skip directly to the first afterAll from its own scope rather than skipping to the first afterAll from any scope
+ entry.failure_skip_past = failure_skip_past; // we could consider matching skip_to in beforeAll to skip directly to the first afterAll from its own scope rather than skipping to the first afterAll from any scope
+ if (entry == failure_skip_past) failure_skip_past = null;
}
// add these as a single sequence
const sequences_start = this.sequences.items.len;
- try this.sequences.append(.init(list.first, current)); // add sequence to concurrentgroup
+ try this.sequences.append(.init(.{
+ .first_entry = list.first,
+ .test_entry = current,
+ .retry_count = current.retry_count,
+ .repeat_count = current.repeat_count,
+ })); // add sequence to concurrentgroup
const sequences_end = this.sequences.items.len;
try appendOrExtendConcurrentGroup(this, current.base.concurrent, sequences_start, sequences_end); // add or extend the concurrent group
}
diff --git a/src/bun.js/test/ScopeFunctions.zig b/src/bun.js/test/ScopeFunctions.zig
index ba08f8b1c9..9c44d3b388 100644
--- a/src/bun.js/test/ScopeFunctions.zig
+++ b/src/bun.js/test/ScopeFunctions.zig
@@ -132,10 +132,10 @@ pub fn callAsFunction(globalThis: *JSGlobalObject, callFrame: *CallFrame) bun.JS
defer if (formatted_label) |label| bunTest.gpa.free(label);
const bound = if (args.callback) |cb| try cb.bind(globalThis, item, &bun.String.static("cb"), 0, args_list_raw.items) else null;
- try this.enqueueDescribeOrTestCallback(bunTest, globalThis, callFrame, bound, formatted_label, args.options.timeout, callback_length -| args_list.items.len, line_no);
+ try this.enqueueDescribeOrTestCallback(bunTest, globalThis, callFrame, bound, formatted_label, args.options, callback_length -| args_list.items.len, line_no);
}
} else {
- try this.enqueueDescribeOrTestCallback(bunTest, globalThis, callFrame, args.callback, args.description, args.options.timeout, callback_length, line_no);
+ try this.enqueueDescribeOrTestCallback(bunTest, globalThis, callFrame, args.callback, args.description, args.options, callback_length, line_no);
}
return .js_undefined;
@@ -169,7 +169,7 @@ fn filterNames(comptime Rem: type, rem: *Rem, description: ?[]const u8, parent_i
}
}
-fn enqueueDescribeOrTestCallback(this: *ScopeFunctions, bunTest: *bun_test.BunTest, globalThis: *jsc.JSGlobalObject, callFrame: *jsc.CallFrame, callback: ?jsc.JSValue, description: ?[]const u8, timeout: u32, callback_length: usize, line_no: u32) bun.JSError!void {
+fn enqueueDescribeOrTestCallback(this: *ScopeFunctions, bunTest: *bun_test.BunTest, globalThis: *jsc.JSGlobalObject, callFrame: *jsc.CallFrame, callback: ?jsc.JSValue, description: ?[]const u8, options: ParseArgumentsOptions, callback_length: usize, line_no: u32) bun.JSError!void {
groupLog.begin(@src());
defer groupLog.end();
@@ -248,7 +248,9 @@ fn enqueueDescribeOrTestCallback(this: *ScopeFunctions, bunTest: *bun_test.BunTe
_ = try bunTest.collection.active_scope.appendTest(bunTest.gpa, description, if (matches_filter) callback else null, .{
.has_done_parameter = has_done_parameter,
- .timeout = timeout,
+ .timeout = options.timeout,
+ .retry_count = options.retry,
+ .repeat_count = options.repeats,
}, base, .collection);
},
}
@@ -286,15 +288,16 @@ fn errorInCI(globalThis: *jsc.JSGlobalObject, signature: []const u8) bun.JSError
const ParseArgumentsResult = struct {
description: ?[]const u8,
callback: ?jsc.JSValue,
- options: struct {
- timeout: u32 = 0,
- retry: ?f64 = null,
- repeats: ?f64 = null,
- },
+ options: ParseArgumentsOptions,
pub fn deinit(this: *ParseArgumentsResult, gpa: std.mem.Allocator) void {
if (this.description) |str| gpa.free(str);
}
};
+const ParseArgumentsOptions = struct {
+ timeout: u32 = 0,
+ retry: u32 = 0,
+ repeats: u32 = 0,
+};
pub const CallbackMode = enum { require, allow };
pub const FunctionKind = enum { test_or_describe, hook };
@@ -382,13 +385,16 @@ pub fn parseArguments(globalThis: *jsc.JSGlobalObject, callframe: *jsc.CallFrame
if (!retries.isNumber()) {
return globalThis.throwPretty("{f}() expects retry to be a number", .{signature});
}
- result.options.retry = retries.asNumber();
+ result.options.retry = std.math.lossyCast(u32, retries.asNumber());
}
if (try options.get(globalThis, "repeats")) |repeats| {
if (!repeats.isNumber()) {
return globalThis.throwPretty("{f}() expects repeats to be a number", .{signature});
}
- result.options.repeats = repeats.asNumber();
+ if (result.options.retry != 0) {
+ return globalThis.throwPretty("{f}(): Cannot set both retry and repeats", .{signature});
+ }
+ result.options.repeats = std.math.lossyCast(u32, repeats.asNumber());
}
} else if (options.isUndefinedOrNull()) {
// no options
diff --git a/src/bun.js/test/bun_test.zig b/src/bun.js/test/bun_test.zig
index 6931ca5780..83a0e9b858 100644
--- a/src/bun.js/test/bun_test.zig
+++ b/src/bun.js/test/bun_test.zig
@@ -924,6 +924,10 @@ pub const ExecutionEntryCfg = struct {
/// 0 = unlimited timeout
timeout: u32,
has_done_parameter: bool,
+ /// Number of times to retry a failed test (0 = no retries)
+ retry_count: u32 = 0,
+ /// Number of times to repeat a test (0 = run once, 1 = run twice, etc.)
+ repeat_count: u32 = 0,
};
pub const ExecutionEntry = struct {
base: BaseScope,
@@ -935,9 +939,14 @@ pub const ExecutionEntry = struct {
/// when this entry begins executing, the timespec will be set to the current time plus the timeout(ms).
timespec: bun.timespec = .epoch,
added_in_phase: AddedInPhase,
+ /// Number of times to retry a failed test (0 = no retries)
+ retry_count: u32,
+ /// Number of times to repeat a test (0 = run once, 1 = run twice, etc.)
+ repeat_count: u32,
next: ?*ExecutionEntry = null,
- skip_to: ?*ExecutionEntry = null,
+ /// if this entry fails, go to the entry 'failure_skip_past.next'
+ failure_skip_past: ?*ExecutionEntry = null,
const AddedInPhase = enum { preload, collection, execution };
@@ -948,6 +957,8 @@ pub const ExecutionEntry = struct {
.timeout = cfg.timeout,
.has_done_parameter = cfg.has_done_parameter,
.added_in_phase = phase,
+ .retry_count = cfg.retry_count,
+ .repeat_count = cfg.repeat_count,
});
if (cb) |c| {
diff --git a/src/cli/test_command.zig b/src/cli/test_command.zig
index 015efd3bcf..5464a062ab 100644
--- a/src/cli/test_command.zig
+++ b/src/cli/test_command.zig
@@ -604,6 +604,10 @@ pub const CommandLineReporter = struct {
writer: anytype,
comptime dim: bool,
) void {
+ const initial_retry_count = test_entry.retry_count;
+ const attempts = (initial_retry_count - sequence.remaining_retry_count) + 1;
+ const initial_repeat_count = test_entry.repeat_count;
+ const repeats = (initial_repeat_count - sequence.remaining_repeat_count) + 1;
var scopes_stack = bun.BoundedArray(*bun_test.DescribeScope, 64).init(0) catch unreachable;
var parent_: ?*bun_test.DescribeScope = test_entry.base.parent;
@@ -677,6 +681,16 @@ pub const CommandLineReporter = struct {
else
writer.print(comptime Output.prettyFmt(" {s}", false), .{display_label}) catch unreachable;
+ // Print attempt count if test was retried (attempts > 1)
+ if (attempts > 1) switch (Output.enable_ansi_colors_stderr) {
+ inline else => |enable_ansi_colors_stderr| writer.print(comptime Output.prettyFmt(" (attempt {d})", enable_ansi_colors_stderr), .{attempts}) catch unreachable,
+ };
+
+ // Print repeat count if test failed on a repeat (repeats > 1)
+ if (repeats > 1) switch (Output.enable_ansi_colors_stderr) {
+ inline else => |enable_ansi_colors_stderr| writer.print(comptime Output.prettyFmt(" (run {d})", enable_ansi_colors_stderr), .{repeats}) catch unreachable,
+ };
+
if (elapsed_ns > (std.time.ns_per_us * 10)) {
writer.print(" {f}", .{
Output.ElapsedFormatter{
diff --git a/test/js/bun/test/test-on-test-finished.test.ts b/test/js/bun/test/test-on-test-finished.test.ts
index e97a24a2e4..de75e47347 100644
--- a/test/js/bun/test/test-on-test-finished.test.ts
+++ b/test/js/bun/test/test-on-test-finished.test.ts
@@ -114,3 +114,19 @@ describe("onTestFinished with all hooks", () => {
expect(output).toEqual(["test", "inner afterAll", "afterEach", "onTestFinished"]);
});
});
+
+// Test that a failing test still runs the onTestFinished hook
+describe("onTestFinished with failing test", () => {
+ const output: string[] = [];
+
+ test.failing("failing test", () => {
+ onTestFinished(() => {
+ output.push("onTestFinished");
+ });
+ output.push("test");
+ throw new Error("fail");
+ });
+ test("verify order", () => {
+ expect(output).toEqual(["test", "onTestFinished"]);
+ });
+});
diff --git a/test/js/bun/test/test-retry-repeats-basic.test.ts b/test/js/bun/test/test-retry-repeats-basic.test.ts
new file mode 100644
index 0000000000..44e338dbec
--- /dev/null
+++ b/test/js/bun/test/test-retry-repeats-basic.test.ts
@@ -0,0 +1,161 @@
+// Basic tests to verify retry and repeats functionality works
+import { afterAll, afterEach, beforeEach, describe, expect, onTestFinished, test } from "bun:test";
+
+describe("retry option", () => {
+ let attempts = 0;
+ test(
+ "retries failed test until it passes",
+ () => {
+ attempts++;
+ if (attempts < 3) {
+ throw new Error("fail");
+ }
+ },
+ { retry: 3 },
+ );
+ test("correct number of attempts from previous test", () => {
+ expect(attempts).toBe(3);
+ });
+});
+
+describe("repeats option with hooks", () => {
+ let log: string[] = [];
+ describe("isolated test with repeats", () => {
+ beforeEach(() => {
+ log.push("beforeEach");
+ });
+
+ afterEach(() => {
+ log.push("afterEach");
+ });
+
+ test(
+ "repeats test multiple times",
+ () => {
+ log.push("test");
+ },
+ { repeats: 2 },
+ );
+ });
+
+ test("verify hooks ran for each repeat", () => {
+ // Should have: beforeEach, test, afterEach (first), beforeEach, test, afterEach (second), beforeEach, test, afterEach (third)
+ // repeats: 2 means 1 initial + 2 repeats = 3 total runs
+ expect(log).toEqual([
+ "beforeEach",
+ "test",
+ "afterEach",
+ "beforeEach",
+ "test",
+ "afterEach",
+ "beforeEach",
+ "test",
+ "afterEach",
+ ]);
+ });
+});
+
+describe("retry option with hooks", () => {
+ let attempts = 0;
+ let log: string[] = [];
+ describe("isolated test with retry", () => {
+ beforeEach(() => {
+ log.push("beforeEach");
+ });
+
+ afterEach(() => {
+ log.push("afterEach");
+ });
+
+ test(
+ "retries with hooks",
+ () => {
+ attempts++;
+ log.push(`test-${attempts}`);
+ if (attempts < 2) {
+ throw new Error("fail");
+ }
+ },
+ { retry: 3 },
+ );
+ });
+
+ test("verify hooks ran for each retry", () => {
+ // Should have: beforeEach, test-1, afterEach (fail), beforeEach, test-2, afterEach (pass)
+ expect(log).toEqual(["beforeEach", "test-1", "afterEach", "beforeEach", "test-2", "afterEach"]);
+ });
+});
+describe("repeats with onTestFinished", () => {
+ let log: string[] = [];
+ test(
+ "repeats with onTestFinished",
+ () => {
+ onTestFinished(() => {
+ log.push("onTestFinished");
+ });
+ log.push("test");
+ },
+ { repeats: 3 },
+ );
+ test("verify correct log", () => {
+ // repeats: 3 means 1 initial + 3 repeats = 4 total runs
+ expect(log).toEqual([
+ "test",
+ "onTestFinished",
+ "test",
+ "onTestFinished",
+ "test",
+ "onTestFinished",
+ "test",
+ "onTestFinished",
+ ]);
+ });
+});
+
+describe("retry with onTestFinished", () => {
+ let attempts = 0;
+ let log: string[] = [];
+ test(
+ "retry with onTestFinished",
+ () => {
+ attempts++;
+ onTestFinished(() => {
+ log.push("onTestFinished");
+ });
+ log.push(`test-${attempts}`);
+ if (attempts < 3) {
+ throw new Error("fail");
+ }
+ },
+ { retry: 3 },
+ );
+ test("verify correct log", () => {
+ expect(log).toEqual(["test-1", "onTestFinished", "test-2", "onTestFinished", "test-3", "onTestFinished"]);
+ });
+});
+
+describe("retry with inner afterAll", () => {
+ let attempts = 0;
+ let log: string[] = [];
+ test(
+ "retry with inner afterAll",
+ () => {
+ attempts++;
+ afterAll(() => {
+ log.push("inner afterAll");
+ });
+ log.push(`test-${attempts}`);
+ if (attempts < 3) {
+ throw new Error("fail");
+ }
+ },
+ { retry: 3 },
+ );
+ test("verify correct log", () => {
+ expect(log).toEqual(["test-1", "inner afterAll", "test-2", "inner afterAll", "test-3", "inner afterAll"]);
+ });
+});
+
+expect(() => {
+ test("can't pass both", () => {}, { retry: 5, repeats: 6 });
+}).toThrow(/Cannot set both retry and repeats/);
From 8650e7ace41e5389354401060b1af3e085e621ee Mon Sep 17 00:00:00 2001
From: Lydia Hallie
Date: Fri, 14 Nov 2025 16:45:21 -0800
Subject: [PATCH 3/5] Docs: Add templates to guides (#24732)
Adds template cards to the TanStack Start and Next.js guides
---
docs/guides/ecosystem/nextjs.mdx | 116 +++++++++++++------
docs/guides/ecosystem/tanstack-start.mdx | 34 ++++++
docs/images/templates/bun-nextjs-basic.png | Bin 0 -> 690425 bytes
docs/images/templates/bun-nextjs-todo.png | Bin 0 -> 309453 bytes
docs/images/templates/bun-tanstack-basic.png | Bin 0 -> 824881 bytes
docs/images/templates/bun-tanstack-start.png | Bin 0 -> 836134 bytes
docs/images/templates/bun-tanstack-todo.png | Bin 0 -> 287506 bytes
docs/snippets/guides.jsx | 12 +-
8 files changed, 121 insertions(+), 41 deletions(-)
create mode 100644 docs/images/templates/bun-nextjs-basic.png
create mode 100644 docs/images/templates/bun-nextjs-todo.png
create mode 100644 docs/images/templates/bun-tanstack-basic.png
create mode 100644 docs/images/templates/bun-tanstack-start.png
create mode 100644 docs/images/templates/bun-tanstack-todo.png
diff --git a/docs/guides/ecosystem/nextjs.mdx b/docs/guides/ecosystem/nextjs.mdx
index 2a3f4188cb..0cd9ccd04b 100644
--- a/docs/guides/ecosystem/nextjs.mdx
+++ b/docs/guides/ecosystem/nextjs.mdx
@@ -4,54 +4,100 @@ sidebarTitle: Next.js with Bun
mode: center
---
-Initialize a Next.js app with `create-next-app`. This will scaffold a new Next.js project and automatically install dependencies.
-
-```sh terminal icon="terminal"
-bun create next-app
-```
-
-```txt
-✔ What is your project named? … my-app
-✔ Would you like to use TypeScript with this project? … No / Yes
-✔ Would you like to use ESLint with this project? … No / Yes
-✔ Would you like to use Tailwind CSS? ... No / Yes
-✔ Would you like to use `src/` directory with this project? … No / Yes
-✔ Would you like to use App Router? (recommended) ... No / Yes
-✔ What import alias would you like configured? … @/*
-Creating a new Next.js app in /path/to/my-app.
-```
+[Next.js](https://nextjs.org/) is a React framework for building full-stack web applications. It supports server-side rendering, static site generation, API routes, and more. Bun provides fast package installation and can run Next.js development and production servers.
---
-You can specify a starter template using the `--example` flag.
+
+
+ Use the interactive CLI to create a new Next.js app. This will scaffold a new Next.js project and automatically install dependencies.
-```sh
-bun create next-app --example with-supabase
-```
+ ```sh terminal icon="terminal"
+ bun create next-app@latest my-bun-app
+ ```
-```txt
-✔ What is your project named? … my-app
-...
-```
+
+
+ Change to the project directory and run the dev server with Bun.
+
+ ```sh terminal icon="terminal"
+ cd my-bun-app
+ bun --bun run dev
+ ```
+
+ This starts the Next.js dev server with Bun's runtime.
+
+ Open [`http://localhost:3000`](http://localhost:3000) with your browser to see the result. Any changes you make to `app/page.tsx` will be hot-reloaded in the browser.
+
+
+
+ Modify the scripts field in your `package.json` by prefixing the Next.js CLI commands with `bun --bun`. This ensures that Bun executes the Next.js CLI for common tasks like `dev`, `build`, and `start`.
+
+ ```json package.json icon="file-json"
+ {
+ "scripts": {
+ "dev": "bun --bun next dev", // [!code ++]
+ "build": "bun --bun next build", // [!code ++]
+ "start": "bun --bun next start", // [!code ++]
+ }
+ }
+ ```
+
+
+
---
-To start the dev server with Bun, run `bun --bun run dev` from the project root.
+## Hosting
-```sh terminal icon="terminal"
-cd my-app
-bun --bun run dev
-```
+Next.js applications on Bun can be deployed to various platforms.
+
+
+
+ Deploy on Vercel
+
+
+ Deploy on Railway
+
+
+ Deploy on DigitalOcean
+
+
+ Deploy on AWS Lambda
+
+
+ Deploy on Google Cloud Run
+
+
+ Deploy on Render
+
+
---
-To run the dev server with Node.js instead, omit `--bun`.
+## Templates
-```sh terminal icon="terminal"
-cd my-app
-bun run dev
-```
+
+
+ A simple App Router starter with Bun, Next.js, and Tailwind CSS.
+
+
+ A full-stack todo application built with Bun, Next.js, and PostgreSQL.
+
+
---
-Open [http://localhost:3000](http://localhost:3000) with your browser to see the result. Any changes you make to `(pages/app)/index.tsx` will be hot-reloaded in the browser.
+[→ See Next.js's official documentation](https://nextjs.org/docs) for more information on building and deploying Next.js applications.
diff --git a/docs/guides/ecosystem/tanstack-start.mdx b/docs/guides/ecosystem/tanstack-start.mdx
index d7508b3b81..2071671a36 100644
--- a/docs/guides/ecosystem/tanstack-start.mdx
+++ b/docs/guides/ecosystem/tanstack-start.mdx
@@ -755,4 +755,38 @@ To host your TanStack Start app, you can use [Nitro](https://nitro.build/) or a
---
+## Templates
+
+
+
+ A Todo application built with Bun, TanStack Start, and PostgreSQL.
+
+
+ A TanStack Start template using Bun with SSR and file-based routing.
+
+
+ The basic TanStack starter using the Bun runtime and Bun's file APIs.
+
+
+
+---
+
[→ See TanStack Start's official documentation](https://tanstack.com/start/latest/docs/framework/react/guide/hosting) for more information on hosting.
diff --git a/docs/images/templates/bun-nextjs-basic.png b/docs/images/templates/bun-nextjs-basic.png
new file mode 100644
index 0000000000000000000000000000000000000000..95a1c90370f1cc1e7f00dcc5f058a4b991dbc82b
GIT binary patch
literal 690425
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