Troubleshooting

AppImage won't run on Linux

Solution: Make the AppImage executable:

Then run it directly:

Missing dependencies on Linux

Solution: Install required dependencies:

For Arch/CachyOS:

macOS says "app is damaged" on launch

Solution: This is a macOS security gate for unsigned apps. Right-click the app and select "Open", then click "Open" in the dialog. This only needs to be done once.

Varve is slow or laggy

Solution:

• Check if you have many objects on canvas (viewport culling helps, but extreme counts may slow down)
• Ensure your GPU drivers are up to date
• Close other applications to free memory
• Check if you're running on Wayland (primary dev environment) vs X11

Canvas rendering is slow

Solution: Varve uses IR-replay for 86fps rendering. If you're experiencing slow rendering, check if you're using the WASM backend (web) vs native backend (desktop). Native Rust engine is significantly faster.

Rich text not rendering correctly

Solution: Rich text, variable fonts, and OpenType features are declared in types but rendering is still in development. Use basic text styling (font family, size, weight) for now. See the Typography page for current status.

Collaboration features not working

Solution: Collaboration features are UI scaffolding only with no transport or wire protocol. Real-time collaboration is planned for future development.

Print export not showing bleed

Solution: Bleed is an export-time parameter and is not visualized on canvas. Canvas bleed/trim visualization is planned for future development.

Varve crashes on startup

Solution:

• Check system requirements (4GB RAM minimum, 8GB recommended)
• Ensure you're using a supported OS version
• Check if other applications are using excessive memory
• Report the issue with your OS, version, and crash logs

Specific tool crashes

Solution: Report the issue with steps to reproduce, your OS, and Varve version. Include any error messages or crash logs if available.