aboutsummaryrefslogtreecommitdiff
path: root/docs/guides/ecosystem/nextjs.md
diff options
context:
space:
mode:
Diffstat (limited to 'docs/guides/ecosystem/nextjs.md')
-rw-r--r--docs/guides/ecosystem/nextjs.md31
1 files changed, 31 insertions, 0 deletions
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
+```