meiraleal / Strapi-V4-Electron-Boilerplate

A Strapi v4 + Electron Boilerplate

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Strapi-V4-Electron-Boilerplate

Clone and run for a quick way to see Electron + Strapi v4 in action.

This is a minimal Electron application based on the Quick Start Guide within the Electron documentation with a Strapi v4 CMS integrated.

This Electron application needs just these files:

  • package.json - Points to the app's main file and lists its details and dependencies.
  • main.js - Starts the app and creates a browser window to render HTML. This is the app's main process.

To Use

To clone and run this repository you'll need Git and Node.js (which comes with npm) installed on your computer. From your command line:

# Clone this repository
git clone https://github.com/AsoStrife/Strapi-V4-Electron-Boilerplate
# Go into the repository
cd Strapi-V4-Electron-Boilerplate
# Install dependencies
npm i

# Run for the very first time strapi
npm run strapi-develop

# Now you can Run the app with electron
npm run electron

# Build the app
npm run build

Scripts

  • strapi-start: run Strapi vanilla, without electron

  • strapi-develop: run Strapi vanilla in develop mode, without electron

  • strapi-build: build strapi UI

  • electron: run Strapi with Electron

  • electron-build: build Electron with Strapi. It produce a .exe if you're on windows

  • build: build Strapi UI + Electron

Better Sqlite3 Build problem

If you run npm run electron-build you may run into the following error:

better_sqlite3.node was compiled against a different Node.js version using
NODE_MODULE_VERSION 93. This version of Node.js requires
NODE_MODULE_VERSION 106. Please try re-compiling or re-installing

To fix this problem you can simply go the following page Releases · WiseLibs/better-sqlite3 (github.com), find the correct build version you need and paste the better_sqlite3.node into /node_modules/better-sqlite3/build/Release.

In my case, using windows and NODE_MODULE_VERSION 106 I downloaded the following file: better-sqlite3-v7.6.2-electron-v106-win32-x64.tar.gz

Built App Crashes on Startup problem

Once the app is built, if you try to run the executable (eg..exe) and the app crashes on startup you may need to copy and paste the .envfile inside the folder where the executable is located.

So if your .exe is located on ./dist/win-unpacked/Strapi-V4-Electron-Boilerplate.exe copy the .env-example into that folder and rename it in .env.

This file follow the Strapi guideline. Check out strapi's documentation to learn more.

About

A Strapi v4 + Electron Boilerplate


Languages

Language:JavaScript 83.5%Language:HTML 11.8%Language:Shell 4.7%