> ## Documentation Index
> Fetch the complete documentation index at: https://bun-1dd33a4e-farm-c9035eb1-hot-recreated-import-unwatched.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Build an app with Next.js and Bun

[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.

***

<Steps>
  <Step title="Create a new Next.js app">
    Use the interactive CLI to create a new Next.js app. This will scaffold a new Next.js project and automatically install dependencies.

    ```sh terminal icon="terminal" theme={null}
    bun create next-app@latest my-bun-app
    ```
  </Step>

  <Step title="Start the dev server">
    Change to the project directory and run the dev server with Bun.

    ```sh terminal icon="terminal" theme={null}
    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.
  </Step>

  <Step title="Update scripts in package.json">
    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" theme={null}
    {
      "scripts": {
        "dev": "bun --bun next dev", // [!code ++]
        "build": "bun --bun next build", // [!code ++]
        "start": "bun --bun next start", // [!code ++]
      }
    }
    ```
  </Step>
</Steps>

***

## Hosting

Next.js applications on Bun can be deployed to various platforms.

<Columns cols={3}>
  <Card title="Vercel" href="/guides/deployment/vercel" icon="https://mintcdn.com/bun-1dd33a4e-farm-c9035eb1-hot-recreated-import-unwatched/iQiNa3eN_F6jOmGF/icons/ecosystem/vercel.svg?fit=max&auto=format&n=iQiNa3eN_F6jOmGF&q=85&s=4a7ed86fd38e1eccdc441b85d8a242f1" width="24" height="24" data-path="icons/ecosystem/vercel.svg">
    Deploy on Vercel
  </Card>

  <Card title="Railway" href="/guides/deployment/railway" icon="https://mintcdn.com/bun-1dd33a4e-farm-c9035eb1-hot-recreated-import-unwatched/iQiNa3eN_F6jOmGF/icons/ecosystem/railway.svg?fit=max&auto=format&n=iQiNa3eN_F6jOmGF&q=85&s=a6b5a3a908ae9dc7f4f56d8876585461" width="24" height="24" data-path="icons/ecosystem/railway.svg">
    Deploy on Railway
  </Card>

  <Card title="DigitalOcean" href="/guides/deployment/digital-ocean" icon="https://mintcdn.com/bun-1dd33a4e-farm-c9035eb1-hot-recreated-import-unwatched/iQiNa3eN_F6jOmGF/icons/ecosystem/digitalocean.svg?fit=max&auto=format&n=iQiNa3eN_F6jOmGF&q=85&s=34ffab679a127cc937da989c4ef97fac" width="24" height="24" data-path="icons/ecosystem/digitalocean.svg">
    Deploy on DigitalOcean
  </Card>

  <Card title="AWS Lambda" href="/guides/deployment/aws-lambda" icon="https://mintcdn.com/bun-1dd33a4e-farm-c9035eb1-hot-recreated-import-unwatched/iQiNa3eN_F6jOmGF/icons/ecosystem/aws.svg?fit=max&auto=format&n=iQiNa3eN_F6jOmGF&q=85&s=c85baf09d8eedb2bde944a62325347dc" width="24" height="24" data-path="icons/ecosystem/aws.svg">
    Deploy on AWS Lambda
  </Card>

  <Card title="Google Cloud Run" href="/guides/deployment/google-cloud-run" icon="https://mintcdn.com/bun-1dd33a4e-farm-c9035eb1-hot-recreated-import-unwatched/iQiNa3eN_F6jOmGF/icons/ecosystem/gcp.svg?fit=max&auto=format&n=iQiNa3eN_F6jOmGF&q=85&s=7c3ab63db3616e6faa054dfdc9f13b8f" width="24" height="24" data-path="icons/ecosystem/gcp.svg">
    Deploy on Google Cloud Run
  </Card>

  <Card title="Render" href="/guides/deployment/render" icon="https://mintcdn.com/bun-1dd33a4e-farm-c9035eb1-hot-recreated-import-unwatched/iQiNa3eN_F6jOmGF/icons/ecosystem/render.svg?fit=max&auto=format&n=iQiNa3eN_F6jOmGF&q=85&s=d874c7b26d4880924fdd4c3d60ad139b" width="24" height="24" data-path="icons/ecosystem/render.svg">
    Deploy on Render
  </Card>
</Columns>

***

## Templates

<Columns cols={2}>
  <Card title="Bun + Next.js Basic Starter" img="https://mintcdn.com/bun-1dd33a4e-farm-c9035eb1-hot-recreated-import-unwatched/iQiNa3eN_F6jOmGF/images/templates/bun-nextjs-basic.png?fit=max&auto=format&n=iQiNa3eN_F6jOmGF&q=85&s=ffa96dc54a52bf815463c710bc217a48" href="https://github.com/bun-templates/bun-nextjs-basic" arrow="true" cta="Go to template" width="2212" height="1326" data-path="images/templates/bun-nextjs-basic.png">
    A simple App Router starter with Bun, Next.js, and Tailwind CSS.
  </Card>

  <Card title="Todo App with Next.js + Bun" img="https://mintcdn.com/bun-1dd33a4e-farm-c9035eb1-hot-recreated-import-unwatched/iQiNa3eN_F6jOmGF/images/templates/bun-nextjs-todo.png?fit=max&auto=format&n=iQiNa3eN_F6jOmGF&q=85&s=85ad35c45e42f75f3aaa9017527d3404" href="https://github.com/bun-templates/bun-nextjs-todo" arrow="true" cta="Go to template" width="2212" height="1326" data-path="images/templates/bun-nextjs-todo.png">
    A full-stack todo application built with Bun, Next.js, and PostgreSQL.
  </Card>
</Columns>

***

[→ See Next.js's official documentation](https://nextjs.org/docs) for more information on building and deploying Next.js applications.