aboutsummaryrefslogtreecommitdiff
path: root/docs/guides/ecosystem
diff options
context:
space:
mode:
Diffstat (limited to 'docs/guides/ecosystem')
-rw-r--r--docs/guides/ecosystem/express.md2
-rw-r--r--docs/guides/ecosystem/nextjs.md31
2 files changed, 32 insertions, 1 deletions
diff --git a/docs/guides/ecosystem/express.md b/docs/guides/ecosystem/express.md
index 211e117c4..6042b17e4 100644
--- a/docs/guides/ecosystem/express.md
+++ b/docs/guides/ecosystem/express.md
@@ -5,7 +5,7 @@ name: Build an HTTP server using Express and Bun
Express and other major Node.js HTTP libraries should work out of the box. Bun implements the [`node:http`](https://nodejs.org/api/http.html) and [`node:https`](https://nodejs.org/api/https.html) modules that these libraries rely on.
{% callout %}
-Refer to the [Runtime > Node.js APIs](/docs/runtime/nodejs-apis#node_http) page for more detailed compatibility information.
+Refer to the [Runtime > Node.js APIs](/docs/runtime/nodejs-apis#node-http) page for more detailed compatibility information.
{% /callout %}
```sh
diff --git a/docs/guides/ecosystem/nextjs.md b/docs/guides/ecosystem/nextjs.md
new file mode 100644
index 000000000..b8b45ca59
--- /dev/null
+++ b/docs/guides/ecosystem/nextjs.md
@@ -0,0 +1,31 @@
+---
+name: Build an app with Next.js and Bun
+---
+
+{% callout %}
+Next.js currently relies on Node.js APIs that Bun does not yet implement. The guide below uses Bun to initialize a project and install dependencies, but it uses Node.js to run the dev server.
+{% /callout %}
+
+---
+
+Initialize a Next.js app with `create-next-app`. This automatically installs dependencies using `npm`.
+
+```sh
+$ bunx create-next-app
+✔ 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 `src/` directory with this project? … No / Yes
+✔ Would you like to use experimental `app/` directory with this project? … No / Yes
+✔ What import alias would you like configured? … @/*
+Creating a new Next.js app in /path/to/my-app.
+```
+
+---
+
+To start the dev server, run `bun run dev` from the project root.
+
+```sh
+$ cd my-app
+$ bun run dev
+```