HaNdTriX / next-electron-server

Server your Next.js app inside electron using a custom scheme.
https://npmjs.com/package/next-electron-server
27 stars 6 forks source link
electron nextjs react

Next.js Electron Server

Serve your Next.js app inside Electron using a custom scheme.

Install

$ npm install next-electron-server

or using yarn

$ yarn add next-electron-server

Usage

const serveNextAt = require("next-electron-server");

serveNextAt("next://app");

app.on("ready", async () => {
  const mainWindow = new BrowserWindow({
    width: 800,
    height: 600,
  });

  mainWindow.loadURL("next://app");
  // mainWindow.loadURL("next://app/page1");
  // mainWindow.loadURL("next://app/page2");
});

For more infos check out the example directory.

Motivation

Most electron tutorials recommend using a url switch to differentiate between devserver localhost urls in development and static urls used in production:

app.on("ready", async () => {
  const mainWindow = new BrowserWindow({
    width: 800,
    height: 600,
  });

  const url = isDev
    ? "http://localhost:8000"
    : format({
        pathname: join(__dirname, "../renderer/out/index.html"),
        protocol: "file:",
        slashes: true,
      });

  mainWindow.loadURL(url);
});

From my point of view this approach has many drawbacks.

That's why I created next-electron-server. The render page will always being served using the same protocol and url.

Features

API

serveNextAt(uri, options)

uri

Required\ Type: string\ Example: next://app

The entry-point of your Next.js app.

options

Type: object

↳ outputDir

Type: string\ Default: "./out"

The directory to serve, relative to the app root directory.

↳ port

Type: number\ Default: 3000

The port your Next.js dev-server runs on.

↳ dev

Type: boolean\ Default !app.isPackaged

This flag decides how to serve the files. When dev === true a proxy will be created pointing to localhost:3000.

↳ privileges

Type: object

Check out electron/docs/protocol for more infos about this config object.

↳ partition

Type: string\ Default: electron.session.defaultSession

The partition the protocol should be installed to, if you're not using Electron's default partition.

Contributing

  1. Fork this repository to your own GitHub account and then clone it to your local device
  2. Link it to the global module directory: yarn link
  3. Install in your local project using yarn link next-electron-server

Author

Henrik Wenz (@HenrikWenz)