Skip to main content
The Remix development server (remix dev) relies on Node.js APIs that Bun does not implement. This guide uses Bun to initialize the project and install dependencies, and Node.js to run the dev server.

Initialize a Remix app with create-remix.
terminal
bun create remix
 remix   v1.19.3 💿 Let's build a better website...

   dir   Where should we create your new project?
         ./my-app

      ◼  Using basic template See https://remix.run/docs/en/main/guides/templates#templates for more
      ✔  Template copied

   git   Initialize a new git repository?
         Yes

  deps   Install dependencies with bun?
         Yes

      ✔  Dependencies installed
      ✔  Git initialized

  done   That's it!
         Enter your project directory using cd ./my-app
         Check out README.md for development and deploy instructions.

To start the dev server, run bun run dev from the project root. This runs the remix dev command with Node.js.
terminal
cd my-app
bun run dev
$ remix dev

💿  remix dev

info  building...
info  built (263ms)
Remix App Server started at http://localhost:3000 (http://172.20.0.143:3000)

Open http://localhost:3000 to see the app. Changes you make to app/routes/_index.tsx are hot-reloaded in the browser.
Remix app running on localhost

To build your app, run bun run build.
terminal
bun run build
$ remix build
info  building... (NODE_ENV=production)
info  built (158ms)
Then start the app from the project root.
terminal
bun start
$ remix-serve ./build/index.js
[remix-serve] http://localhost:3000 (http://192.168.86.237:3000)

See the Remix docs to learn more.