Skip to content

trodi/electron-splashscreen

Repository files navigation

electron-splashscreen Build Status

Simple splashscreen for Electron applications.

Ideally, your application loads instantaneously. However, some applications are larger and/or may be running on a slower machine, causing the load to take longer. If the application is taking a bit to load, electron-splashscreen will appear so the user knows the application is loading, but can't interact with a partially loaded application.

electron-splashscreen is simple to incorporate, while allowing you the freedom to customize with any look, feel, and functionality.

No external dependencies.

Install

npm install @trodi/electron-splashscreen

Usage

Typescript Usage (javascript would be similar)

Example of your Electron browser process.

// import the module
import * as Splashscreen from "@trodi/electron-splashscreen";
const mainOpts: Electron.BrowserWindowConstructorOptions = ...
// configure the splashscreen
const config: Splashscreen.Config = {
    windowOpts: mainOpts;
    templateUrl: `${__dirname}/splash-screen.html`;
    splashScreenOpts: {
        width: 425,
        height: 325,
    },
};
// initialize the splashscreen handling
const main: BrowserWindow = Splashscreen.initSplashScreen(config);
// load your browser window per usual
main.loadURL(`file://index.html`);

You can run examples via npm run example and npm run example-dynamic.

API

API Documentation

Build

npm run build

Publish

  • npm version <patch|minor|major>
  • npm publish
  • Commit and push changes to git

License

MIT License

About

Simple splashscreen for electron applications.

Topics

Resources

License

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 3

  •  
  •  
  •