Abandoned. I recommend looking at Proton Native instead: https://github.com/kusti8/proton-native
React Native GTK allows developers to write ReactJS apps for desktop with native UI elements!
You can setup the project locally to develop in 1 command!
npm install
npm run lint
npm test
There are example applications in the example/ directory. You can run any of these examples
with the following command:
./node_modules/.bin/ts-node ./example/<file>.tsx
# e.g. running the todo app
./node_modules/.bin/ts-node ./example/TodoApp.tsx
This package makes use of node-gir. The node-gir package provides the
GObject Introspection bindings that this library uses
to interact with GTK. In some cases you might want to
debug/develop these two libraries (node-gir and react-native-gtk) together. Thankfully NPM provides a nice
tool to do this called npm link
git clone https://github.com/Place1/react-native-gtk
git clone https://github.com/Place1/node-gir
cd react-native-gtk
npm link ../node-gir
# now 'react-native-gtk' will use your local copy of node-gir!
Send us a Pull Request! Here is how:
- Fork it!
- Create your feature branch: git checkout -b my-new-feature
- Stage your changes: git add .
- Commit your changes: git commit -m 'Add some feature'
- Push to the branch: git push origin my-new-feature
- Submit a pull request
Here are some helpful tips for code contributors:
- Open an issue before you start coding so others know what you're working on.
- Open your pull request early, even if you're not done so others can provide input/feedback!
If you have input but don't want to/can't contribute code just yet, here's some other options:
- Open issues to track bugs you've found using react-native-gtk
- Open issues to contribute your thoughts/suggestions/questions about the future of the package and the direction the developers are taking!
- Documentation: we haven't started our documentation efforts just yet but this will be a very important aspect of the project!
react-native-gtk is currently in its infancy and should be considered a work in progress!
- There is still a lot of work to be done on the parent project, node-gir, to provide bullet proof GObject Introspection bindings for us to consume here.
Many aspects of react-native-gtk are still being developed as well. The layout system (flexbox using YogaLayout) still requires a lot of work to make sure it's fast and 'works as expected' on-top of GTK. The architecture behind the intrinsic react elements could also benefit from some detailed research and design proposal/improvements!
This project may also want to consider producing CLI tools to make bundling/packaging applications easier. A react-native-gtk application will have three primary environmental dependencies: node.js, gobject-introspection and GTK. How will our consumers (primarily NodeJS/JavaScript developers making desktop apps) convert their react-native-gtk code into an installable application for Mac, Windows and Linux? The process from hello world to final app should be quick and easy! If you have suggestions on this topic then please open an issue or contribute to existing issues relating to!