a92c266d32
* upgrade tauri-plugin-shellx * feat(shell): add killPid method to shell API with new permission * fix: extension new window * feat(shell): enhance process management and logging in extensions - Add debug logging for extension process events - Implement process tracking in UI worker - Update shell API to support custom process recording - Modify extension template to demonstrate process spawning - Refactor shell command handling with improved error handling * Add killPid extension API to @kksh/api * chore(deps): update tauri-plugin-shellx-api to version 2.0.15 * pnpm lock * chore(deps): update dependencies and lock file - Upgrade ESLint to version 9.21.0 - Update @types/bun to version 1.2.3 - Bump various development dependencies - Reorganize package.json dependencies in ui package * chore(deps): update SvelteKit template dependencies - Add @eslint/js version 9.21.0 - Update package.json dependency order - Sync pnpm-lock.yaml with package.json changes * chore: add eslint to desktop * chore(deps): remove local tauri-plugin-shellx and use published version 2.0.15 * bump desktop to 0.1.28
Kunkun Custom UI Extension Template (React)
Custom UI Extension Documentation
This is a template for a custom UI extension.
This type of extension is basically a static website. You can use any frontend framework you like, this template uses React.
It is assumed that you have some knowledge of frontend development with React.
Development
Development is the same as developing a normal website.
pnpm install
pnpm dev
pnpm build
- To develop and preview the extension in Kunkun, you need to run the
Add Dev Extensioncommand in Kunkun, and register this extension's path.
In package.json, "devMain" is the url for development server, and "main" is the path to static .html file for production.
To load the extension in development mode, you have to enable it with Toggle Dev Extension Live Load Mode command in Kunkun. A Live badge will be shown on the commands. This indicates that dev extensions will be loaded from devMain instead of main.
Advanced
Multi-Command
To support multiple commands, you will need multiple .html files as entrypoints, and register each command in package.json.
It is recommended to use a meta-framework and build with SSG rendering mode, which comes with routing and will output multiple .html files.
Kunkun provides meta-framework templates for Nuxt, Next, SvelteKit.
Verify Build and Publish
pnpm build # make sure the build npm script works
npx kksh@latest verify # Verify some basic settings
npx kksh@latest verify --publish # Verify some basic settings before publishing
See Documentation for more details on how to publish your extension. You will need to publish your extension package to npm or jsr first with GitHub actioin, then register it on Kunkun's website.