parcel-plugin-nodegui v1.0.3
📦 parcel-plugin-nodegui
Use and bundle assets with your nodegui app
General
This plugin allows you to import actual assets, such as css and image files, into your NodeGUI app and utilize them in your app.
You can see an example project that uses parcel and this plugin here.
Disclaimer: this plugin is in its early stages. Bugs are probable. Feature requests, bug reports and contributions are most welcome!
Features
- Utilize CSS files in your code using
require(much like web and React Native) 🎨 - Import image assets and utilize them with QImage widgets using
require🖼
Getting Started
Prerequisites
As this is a parcel plugin, your project has to use parcel for managing its bundle. Read about it here.
Installation
Run the following command inside your project to install this :
npm install --save-dev parcel-plugin-nodeguiBuilding for NodeGUI
Make sure that you select the node target when bundling your projects for the NodeGUI platform (using the build and watch commands). Read about project targets here.
Example
Building for node target:
npx parcel build --target node src/index.tsxWatching for node target (auto bundle build upon file save):
npx parcel watch --target node src/index.tsxPlugins
CSS
Import and use css with your NodeGUI windows's styleSheet prop.
Usage
In order to use CSS in your NodeGUI app, simply require it:
const style = require('./style.css');And use it with the Window widget's styleSheet property:
<Window styleSheet={style}>
...
</Window>Note: Do not forget that selectors in NodeGUI apps are the elements' ids, and therefore you should use the
#thisIsIdselector in your stylesheets.
Example
style.css
#container {
flex: 1;
flex-direction: column;
min-height: '100%';
background: #4B4B4B;
}
#text {
color: white;
}app.jsx
const App = () => {
return (
<Window
styleSheet={require('./style.css')}
>
<View id="container">
<Text id="text">Hello, world</Text>
</View>
</Window>
);
};Using with pre-processors (SASS \ LESS)
Simply follow the regular guide regarding how to use said pre-processors in your project:
- SASS: https://parceljs.org/scss.html
- LESS: https://parceljs.org/less.html
- Stylus: https://parceljs.org/stylus.html
The plugin will automatically utilize their output CSS in your project.
Images
Import and use image files with your NodeGUI's Image components.
Usage
In order to use image assets in your NodeGUI app, simply require them:
const image = require('./image.png');And use them with the Image widget's src property:
<Image src={image} />