Next.js

import { Tabs, TabItem, Steps } from '@astrojs/starlight/components'; import CommandTabs from '@components/CommandTabs.astro';

Next.js is a meta framework for React. Learn more about Next.js at https://nextjs.org. This guide is accurate as of Next.js 14.2.3.

Checklist

• Use static exports by setting output: 'export'. Tauri doesn't support server-based solutions.
• Use the out directory as frontendDist in tauri.conf.json.

Example Configuration

<Steps>

1. Update Tauri configuration

   <Tabs> <TabItem label="npm">
   jsonCopy

   // src-tauri/tauri.conf.json
   {
     "build": {
       "beforeDevCommand": "npm run dev",
       "beforeBuildCommand": "npm run build",
       "devUrl": "http://localhost:3000",
       "frontendDist": "../out"
     }
   }
   

   </TabItem> <TabItem label="yarn">
   jsonCopy

   // src-tauri/tauri.conf.json
   {
     "build": {
       "beforeDevCommand": "yarn dev",
       "beforeBuildCommand": "yarn build",
       "devUrl": "http://localhost:3000",
       "frontendDist": "../out"
     }
   }
   

   </TabItem> <TabItem label="pnpm">
   jsonCopy

   // src-tauri/tauri.conf.json
   {
     "build": {
       "beforeDevCommand": "pnpm dev",
       "beforeBuildCommand": "pnpm build",
       "devUrl": "http://localhost:3000",
       "frontendDist": "../out"
     }
   }
   

   </TabItem> <TabItem label="deno">
   jsonCopy

   // src-tauri/tauri.conf.json
   {
     "build": {
       "beforeDevCommand": "deno task dev",
       "beforeBuildCommand": "deno task build",
       "devUrl": "http://localhost:3000",
       "frontendDist": "../out"
     }
   }
   

   </TabItem> </Tabs>

2. Update Next.js configuration

   tsCopy

   // next.conf.mjs
   const isProd = process.env.NODE_ENV === 'production';
   
   const internalHost = process.env.TAURI_DEV_HOST || 'localhost';
   
   /** @type {import('next').NextConfig} */
   const nextConfig = {
     // Ensure Next.js uses SSG instead of SSR
     // https://nextjs.org/docs/pages/building-your-application/deploying/static-exports
     output: 'export',
     // Note: This feature is required to use the Next.js Image component in SSG mode.
     // See https://nextjs.org/docs/messages/export-image-api for different workarounds.
     images: {
       unoptimized: true,
     },
     // Configure assetPrefix or else the server won't properly resolve your assets.
     assetPrefix: isProd ? undefined : `http://${internalHost}:3000`,
   };
   
   export default nextConfig;
   

3. Update package.json configuration

   Copy

   ```json
   "scripts": {
     "dev": "next dev",
     "build": "next build",
     "start": "next start",
     "lint": "next lint",
     "tauri": "tauri"
   }
   ```
   

</Steps>