Nitro-Cool-UI/README.md
2024-07-03 13:25:26 +02:00

56 lines
2.5 KiB
Markdown

# v2.2.0 - Cool UI Beta !! Use at Own Risk as it is still in Beta !!
## Prerequisites
- [Git](https://git-scm.com/)
- [NodeJS](https://nodejs.org/) >= 18
- If using NodeJS < 18 remove `--openssl-legacy-provider` from the package.json scripts
- [Yarn](https://yarnpkg.com/) `npm i yarn -g`
## Installation
- First you should open terminal and navigate to the folder where you want to clone Nitro and Nitro-Renderer
- Clone Nitro (Expl. C:\Github\)
- `git clone https://github.com/duckietm/Nitro-Cool-UI.git` <== For now switch to Dev-RendererV2
- `git clone https://github.com/duckietm/Nitro-Cool-UI-Renderer.git`
- Install the dependencies for the renderer : cd C:\Github\Nitro-Cool-UI-Renderer
- `yarn install`
- Now we will create a Link for the CoolUI : `yarn link` This will give you a link address `yarn link "@nitrots/nitro-renderer"`
- Install the dependencies for Cool UI : cd C:\Github\Nitro-Cool-UI
- `yarn install`
- `yarn link "@nitrots/nitro-renderer` <== This will link the renderer in the project
- Rename a few files
- Rename `public/renderer-config.json.example` to `public/renderer-config.json`
- Rename `public/ui-config.json.example` to `public/ui-config.json`
- Set your links
- Open `public/renderer-config.json`
- Update `socket.url, asset.url, image.library.url, & hof.furni.url`
- Open `public/ui-config.json`
- Update `camera.url, thumbnails.url, url.prefix, habbopages.url`
- `yarn build` <== the final step to build the DIST folder this is where your browser needs to point / or upload this to your /client if you do the compile on a other machine (preferd)
- You can override any variable by passing it to `NitroConfig` in the index.html
## Usage
- To use Nitro you need `.nitro` assets generated, see [nitro-converter](https://git.krews.org/nitro/nitro-converter) for instructions
- See [Morningstar Websockets](https://git.krews.org/nitro/ms-websockets) for instructions on configuring websockets on your server
### Development
Run Nitro in development mode when you are editing the files, this way you can see the changes in your browser instantly
```
yarn start
```
### Production
To build a production version of Nitro just run the following command
```
yarn build:prod
```
- A `dist` folder will be generated, these are the files that must be uploaded to your webserver
- Consult your CMS documentation for compatibility with Nitro and how to add the production files