Tuna Setup

Install and wire the Tuna visual devtools overlay (@suryanewa/tuna) into a Vite or Next.js project, restricted to development only.

Docs reference: https://github.com/suryanewa/tuna

Runtime convention

This project uses Bun as the runtime. Always substitute Bun for npm:

• Install: bun install @suryanewa/tuna (NOT npm install)

Dev-only principle

Tuna self-guards its display and only renders in development by default (it auto-detects process.env.NODE_ENV and import.meta.env.DEV since v0.7.2). However, a static import still pulls the package into the production JS bundle. To keep Tuna fully out of production builds (no shipped code), use a lazy/dynamic import gated by the framework's dev flag. Never add the force prop (it shows Tuna in production).