Skip to main content
You can test LynxHub card modules during development or after compiling them for production.

​
Development mode testing

LynxHub automatically boots your module in development mode when the codebase exists in the project root.
  1. Place your module project directory in the LynxHub repository root.
  2. Name the folder module.
  3. Run the development server from the LynxHub root directory:
The application detects the /module directory. It automatically loads your module in development mode. The main process dynamically imports your code from module/src/main.ts. The renderer process imports your code from @lynx_module/renderer.

​
Inspector and logs

You can inspect components and debug card behavior using the Electron developer tools.
  • Press Ctrl+Shift+I or F12 to open the developer tools.
  • You can inspect card DOM elements, verify visual rendering, and debug frontend behavior.
  • The main process prints backend logs directly to your terminal window.
  • Vite applies styling changes instantly using Hot Module Replacement (HMR).
  • You must restart the application if you modify backend files or card API definitions.

​
Static validation

You should compile the project to check for typescript errors. To run typescript type checking across the project including your module, run the check script in the LynxHub root directory:
This command validates that your TypeScript files compile without type errors.

​
Production testing

You should test that your compiled module loads correctly in production mode before distributing it.
  1. Build your module for production.
  2. Manually copy the compiled files to your local Plugins directory.
  3. Launch LynxHub to verify that the module cards load without errors.
  4. Read the Building modules guide for detailed installation steps.
Last modified on June 18, 2026