Nuxt Minimal Starter

Look at the Nuxt documentation to learn more.

Setup

Make sure to install dependencies:

# npm
npm install

# pnpm
pnpm install

# yarn
yarn install

# bun
bun install

Development Server

Start the development server on http://localhost:3000:

# npm
npm run dev

# pnpm
pnpm dev

# yarn
yarn dev

# bun
bun run dev

Production

Build the application for production:

# npm
npm run build

# pnpm
pnpm build

# yarn
yarn build

# bun
bun run build

Locally preview production build:

# npm
npm run preview

# pnpm
pnpm preview

# yarn
yarn preview

# bun
bun run preview

Check out the deployment documentation for more information.

macOS Electron app (.app in Applications)

npm run build only runs Nuxt (SSR/build output). It does not produce a Mac application bundle.

Build the installer

Use the Electron packaging script (static site + electron-builder):

npm run electron:pack

This runs nuxt generate (writes to .output/public) and then electron-builder --mac.

Artifacts appear under release/, for example:

• FAWE-0.1.0.dmg — open this and drag the app into Applications
• FAWE-0.1.0-mac.zip — unzip; inside you’ll find FAWE.app
• A folder like release/mac-arm64/ or release/mac-x64/ with FAWE.app you can copy manually

Install manually:

# Example after unzip; adjust path if your release folder name differs
cp -R release/mac-arm64/FAWE.app /Applications/

First launch: if macOS blocks the app (unidentified developer), right‑click the app → Open, or allow it under System Settings → Privacy & Security.

App icon

1. Prepare a square image, ideally 1024×1024 PNG (with transparency if you like).
2. Produce build/icon.icns (macOS format). Options:
   • Xcode → Asset Catalog / Icon Composer, or
   • iconutil from an .iconset folder (Apple’s iconset layout), or
   • Online PNG → ICNS converters (search “png to icns”).
3. In package.json, under build.mac, set the icon path (create the build/ folder if needed):

"mac": {
  "category": "public.app-category.productivity",
  "icon": "build/icon.icns",
  "target": ["dmg", "zip"]
}

4. Run npm run electron:pack again. The DMG and FAWE.app will use your icon.

If you omit icon, electron-builder uses its default Electron icon until you add a file.