mirror/api

mirror of https://github.com/unraid/api.git synced 2025-12-30 21:19:49 -06:00

Files

github-actions[bot] d3459ecbc6 chore(main): release 4.19.0 (#1650 )

🤖 I have created a release *beep* *boop*
---


## [4.19.0](https://github.com/unraid/api/compare/v4.18.2...v4.19.0)
(2025-09-04)


### Features

* mount vue apps, not web components
([#1639](https://github.com/unraid/api/issues/1639))
([88087d5](88087d5201))


### Bug Fixes

* api version json response
([#1653](https://github.com/unraid/api/issues/1653))
([292bc0f](292bc0fc81))
* enhance DOM validation and cleanup in vue-mount-app
([6cf7c88](6cf7c88242))
* enhance getKeyFile function to handle missing key file gracefully
([#1659](https://github.com/unraid/api/issues/1659))
([728b38a](728b38ac11))
* info alert docker icon
([#1661](https://github.com/unraid/api/issues/1661))
([239cdd6](239cdd6133))
* oidc cache busting issues fixed
([#1656](https://github.com/unraid/api/issues/1656))
([e204eb8](e204eb80a0))
* **plugin:** restore cleanup behavior for unsupported unraid versions
([#1658](https://github.com/unraid/api/issues/1658))
([534a077](534a07788b))
* UnraidToaster component and update dialog close button
([#1657](https://github.com/unraid/api/issues/1657))
([44774d0](44774d0acd))
* vue mounting logic with tests
([#1651](https://github.com/unraid/api/issues/1651))
([33774aa](33774aa596))

---
This PR was generated with [Release
Please](https://github.com/googleapis/release-please). See
[documentation](https://github.com/googleapis/release-please#release-please).

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>

2025-09-04 15:42:35 -04:00

.vscode

feat: begin building plugin with node instead of bash (#1120 )

2025-02-06 12:32:41 -05:00

builder

feat: mount vue apps, not web components (#1639 )

2025-09-03 15:42:21 -04:00

plugins

fix(plugin): restore cleanup behavior for unsupported unraid versions (#1658 )

2025-09-04 15:28:20 -04:00

scripts

feat: slightly better watch mode (#1398 )

2025-05-22 13:42:08 -04:00

source/dynamix.unraid.net

fix(plugin): restore cleanup behavior for unsupported unraid versions (#1658 )

2025-09-04 15:28:20 -04:00

tests

feat: mount vue apps, not web components (#1639 )

2025-09-03 15:42:21 -04:00

.dockerignore

feat: split plugin builds

2025-03-04 15:18:04 -05:00

.env.example

feat: improve local dev with install path (#1221 )

2025-03-17 09:44:10 -04:00

.gitattributes

fix: replace files lost during pruning

2025-03-27 15:47:29 -04:00

.gitignore

chore: extract connect to an API plugin (#1367 )

2025-06-10 15:16:26 -04:00

.nvmrc

feat: slightly better watch mode (#1398 )

2025-05-22 13:42:08 -04:00

.prettierrc.mjs

feat: begin building plugin with node instead of bash (#1120 )

2025-02-06 12:32:41 -05:00

docker-compose.yml

chore: include node_modules in api slackware package (#1415 )

2025-06-11 12:07:32 -04:00

Dockerfile

fix(deps): update all non-major dependencies (#1543 )

2025-08-08 21:12:46 -04:00

package.json

chore(main): release 4.19.0 (#1650 )

2025-09-04 15:42:35 -04:00

pnpm-lock.yaml

feat: split plugin builds

2025-03-04 15:18:04 -05:00

README.md

chore: cleanup the cleanup scripts (#1266 )

2025-03-24 12:35:25 -04:00

vitest.config.ts

feat: mount vue apps, not web components (#1639 )

2025-09-03 15:42:21 -04:00

README.md

Unraid Plugin Builder

Tool for building and testing Unraid plugins locally as well as packaging them for deployment.

Development Workflow

1. Watch for Changes

The watch command will automatically sync changes from the API, UI components, and web app into the plugin source:

# Start watching all components
pnpm run watch:all

# Or run individual watchers:
pnpm run api:watch    # Watch API changes
pnpm run ui:watch     # Watch Unraid UI component changes
pnpm run wc:watch     # Watch web component changes

This will copy:

API files to ./source/dynamix.unraid.net/usr/local/unraid-api
UI components to ./source/dynamix.unraid.net/usr/local/emhttp/plugins/dynamix.my.servers/unraid-components
Web components to the same UI directory

2. Build the Plugin

Once your changes are ready, build the plugin package:

# Build using Docker - on non-Linux systems
pnpm run docker:build-and-run

# Or build with the build script
pnpm run build:validate

This will create the plugin files in ./deploy/release/

3. Serve and Install

Start a local HTTP server to serve the plugin files:

# Serve the plugin files
pnpm run http-server

Then install the plugin on your Unraid development machine by visiting:

http://SERVER_NAME.local/Plugins

Then paste the following URL into the Unraid Plugins page:

http://YOUR_LOCAL_DEV_MACHINE_IP:5858/plugins/local/dynamix.unraid.net.plg

Replace SERVER_NAME with your development machine's hostname.

Development Tips

Run watchers in a separate terminal while developing
The http-server includes CORS headers for local development
Check the Unraid system log for plugin installation issues

Environment Setup

Initialize environment:
```
pnpm run env:init
```
Validate environment:
```
pnpm run env:validate
```

Available Commands

Build Commands

build - Build the plugin package
build:validate - Build with environment validation
docker:build - Build the Docker container
docker:run - Run the builder in Docker
docker:build-and-run - Build and run in Docker

Watch Commands

watch:all - Watch all component changes
api:watch - Watch API changes
ui:watch - Watch UI component changes
wc:watch - Watch web component changes

Server Commands

http-server - Serve the plugin files locally

Environment Commands

env:init - Create initial .env file
env:validate - Validate environment setup
env:clean - Remove .env file

Troubleshooting

Watch not updating files
- Check that source directories exist
- Verify file permissions
Build failures
- Ensure .env file exists
- Check Docker setup if using containerized build
- Verify source files are present
Installation issues
- Confirm http-server is running
- Check your local IP is correct
- Verify plugin file permissions