belnadris/angular-electron

This repository is a starter template for building desktop applications using Angular and Electron. Angular is a framework for building web interfaces, Electron is a tool that packages web apps as native desktop programs for Windows, Mac, and Linux. This project combines the two into a single ready-to-run setup so developers can start building without spending hours on configuration. When you run the development server with npm start, the app opens in an Electron window and automatically refreshes whenever you change a file, a feature called hot reload. This speeds up the development cycle considerably. The project separates its code into two main folders: app holds the Electron main process (the Node.js side that talks to the operating system), and src holds the Angular renderer process (the web interface side). Once you are done building, you can package the app into an installer or executable for any supported platform. On Linux, the build produces both an AppImage and a Flatpak. The build process handles bundling all necessary dependencies so the final output is self-contained. The project uses TypeScript, which adds type-checking on top of JavaScript, and SASS, which adds variables and other features on top of CSS. Testing is set up through Vitest for unit tests and Playwright for end-to-end tests. Debugging through VS Code is also pre-configured. One thing worth noting: this template uses two separate package.json files. One handles dependencies for the Electron main process and one handles the Angular renderer process. This is a standard Electron pattern that keeps the final app bundle smaller and allows Angular's code generation tools to function correctly. When adding third-party libraries, you need to decide which side of the app they belong to and install them in the right location.