Code Monkey home page Code Monkey logo

electron-cra-boilerplate's Introduction

Getting Started with electron-cra-boilerplate

This project was bootstrapped with electron-cra-boilerplate.

Using Create React App (Typescript) + Electron + Electron Forge

Quickstart

Installation

$ git clone https://github.com/fm-labs/electron-cra-boilerplate.git my-electron-app
$ cd my-electron-app
$ yarn install

! You can also use npm instead of yarn !

Run in developer mode

Runs the Electron app and the Webpack development server for the React app. Changes in the React app source code, should be automatically updated in the Electron app.

$ yarn run dev

Create Electron package

Creates an Electron app package. Output is stored in out/.

$ yarn run package

// change to the output directory
// depending on your operating system, cpu architecture or electron-forge configuration
// the path might be different.
$ cd ./out/electron-cra-boilerplate-linux-x64
// run the packaged app
$ ./electron-cra-boilerplate

Available Scripts

In the project directory, you can run:

yarn run dev

Runs the Electron app and the React app in development mode. The electron app will open automatically with browser-devtools and react-devtools attached.

This command starts the webpack dev server and the electron app concurrently.

yarn run electron

Runs the Electron app in development mode. The electron app will open automatically with browser-devtools and react-devtools attached.

yarn run package

Creates an Electron app package. By default the packaged app is saved in the out/ directory.

yarn run make

Takes a packaged Electron application and outputs a certain kind of distributable

yarn run lint

Runs eslint and print errors/warnings to console

yarn run lint:fix

Runs eslint and fix errors/warnings in source code files.

yarn start

Runs the app in the development mode.
Open http://localhost:3000 to view it in the browser.

The page will reload if you make edits.
You will also see any lint errors in the console.

yarn test

Launches the test runner in the interactive watch mode.
See the section about running tests for more information.

yarn test:nowatch

Launches the testrunner and exits after tests have been completed.

yarn run build

Builds the app for production to the build folder.
It correctly bundles React in production mode and optimizes the build for the best performance.

The build is minified and the filenames include the hashes.
Your app is ready to be deployed!

See the section about deployment for more information.

yarn run eject

Note: this is a one-way operation. Once you eject, you can’t go back!

If you aren’t satisfied with the build tool and configuration choices, you can eject at any time. This command will remove the single build dependency from your project.

Instead, it will copy all the configuration files and the transitive dependencies (webpack, Babel, ESLint, etc) right into your project so you have full control over them. All of the commands except eject will still work, but they will point to the copied scripts so you can tweak them. At this point you’re on your own.

You don’t have to ever use eject. The curated feature set is suitable for small and middle deployments, and you shouldn’t feel obligated to use this feature. However we understand that this tool wouldn’t be useful if you couldn’t customize it when you are ready for it.

Troubleshooting

Error: yarn not found

$ npm i -g yarn

Error: Cannot make for rpm during yarn run make

Solution for Ubuntu/Debian users: Install rpm package

$ sudo apt install rpm

Useful links:

TODO

  • Remove src from final Electron package
  • Disable source maps generation for production builds of react app
  • App icon
  • React Dev Tools
  • ASAR support
  • ESLint
  • Prettier
  • GitHub Actions Workflow for
    • testing
    • building
    • packaging
    • making
  • npm/yarn scripts to make specific electron-forge maker targets
  • Travis support
  • Badges

electron-cra-boilerplate's People

Contributors

fm-labs avatar

Watchers

 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.