nodegui /nodegui
A library for building cross-platform native desktop applications with Node.js and CSS 🚀. React NodeGui : https://react.nodegui.org and Vue NodeGui: https://vue.nodegui.org
★ 9,236⑂ 313👁 96⑃ 637● 405▤ 128
+0
Daily
9,236
stars
313
forks
96
watchers
637
prs
405
issues
128
releases
README
NodeGui Build performant, native and cross-platform desktop applications with Node.js and CSS like styling.🚀 NodeGUI is powered by Qt6 💚 which makes it CPU and memory efficient as compared to other chromium based solutions like Electron. If you are looking for React based version, check out: React NodeGUI. If you are looking for Vue based version, check out: Vue NodeGUI. If you are looking for Svelte based version, check out: Svelte NodeGUI Visit https://nodegui.github.io/nodegui for docs. How does it look? Code Examples https://github.com/nodegui/examples --- Features - 🧬 Cross platform. Works on major Linux flavours and Windows. Help is requested to bring it to ARM based MacOS. See issue 1024 - 📉 Low CPU and memory footprint. Current CPU stays at 0% on idle and memory usage is under 20MB for a Hello World program. - 💅 Styling with CSS (includes actual cascading). Also has full support for Flexbox layout (thanks to Yoga). - ✅ Complete Nodejs API support (Currently runs on Node v24). Hence has access to all Nodejs compatible NPM modules. - 🎪 Native widget event listener support. Supports all events available from Qt / NodeJs. - 💸 Can be used for Commercial applications. - 🕵️♂️ Good Devtools support. - 📚 Good documentation and website. - 🧙♂️ Good documentation for contributors. - 🦹🏻♀️ Good support for dark mode (Thanks to Qt). - 🏅First class Typescript support (Works on regular JS projects too 😉). Getting Started - Check out nodegui-simple-starter to get up and running with your own React NodeGUI app! - Read through the docs. - Checkout the examples: https://github.com/nodegui/examples . - Tutorial: Build a native Meme Search Desktop app with Javascript (NodeGui) and Giphy API Installation To install latest stable release: npm install @nodegui/nodegui To install the latest version available on master branch: npm install https://github.com/nodegui/nodegui/releases/download/v0.0.0-latest-master/nodegui-master.tgz or a shorter version: npm i http://master-release.nodegui.org If the installation fails to download the Qt binaries, a mirror can be used by setting the following environment variable and running the install command again: sh QT_LINK_MIRROR= eg. QT_LINK_MIRROR=https://qt-mirror.dannhauer.de npm install @nodegui/nodegui See FAQs for more details. Community guides - Tutorial: Build a native Meme Search Desktop app with Javascript (NodeGui) and Giphy API - https://blog.logrocket.com/electron-alternatives-exploring-nodegui-and-react-nodegui/ - Electron alternatives: Exploring NodeGUI and React NodeGUI by Siegfried Grimbeek. - https://hibbard.eu/node-gui/ - Excellent guide from James Hibbard. Talks/Podcasts - NodeGui and React NodeGui at KarmaJS Nov 2019 meetup: https://www.youtube.com/watch?v=8jH5gaEEDv4 - JS Party 96: Performant Node desktop apps with NodeGUI – Listen on Changelog.com Docs for contributing It is easier than you thi
Top issues
#939webpack and nodegui >= 0.45.0 fails to find qt for linux and mac19 comments · 2022-05-05#796Deployed app not opening13 comments · 2021-01-24#1004Mac M1 Support12 comments · 2023-04-08#1065is this project dead?11 comments · 2025-03-17#1012🐞QMenu causes the application to crash9 comments · 2023-06-15#1085Beginner question about Node-GUI8 comments · 2026-03-01#791Linux AppImage "Cannot find module @nodegui/nodegui"8 comments · 2021-01-12#943Strange error in windows10 when npm install @nodegui/nodegui7 comments · 2022-05-14
Discussions
#1064I get errors when running npm install on macOS0 comments · 2025-02-28#1053Does QFileDialog allow saving a file?0 comments · 2024-09-27#1052Streamlined NodeGui starter project for VSCode0 comments · 2024-09-26#1047Why is the package printed by `npx nodegui packer - pack./dist` unable to open properly on macos0 comments · 2024-06-16#1041How To use NodeGui without typescript?0 comments · 2024-02-22#1019How can I use KDE widgets (KParts)0 comments · 2023-08-18#1007How QWidget.layout method works?2 comments · 2023-04-16#1003distribution size2 comments · 2023-04-06
Latest release
v0.74.2 v0.74.2 2026-05-03What's Changed replace the deprecated cuid with @paralleldrive/cuid2 by @MomchilKalestrov in https://github.com/nodegui/nodegui/pull/1088