Get started
Local development
Install from the lockfile and start Vite on port 2499.
git clone https://github.com/lucas-lepajollec/SwissKnife.git
cd SwissKnife
npm ci
npm run devBy default, the application is available only at http://127.0.0.1:2499. To test from another device on your trusted local network, run npm run dev:lan and open the network address shown by Vite.
You cannot develop against the prebuilt GHCR image; use a source checkout.
Useful commands
| Command | Purpose |
|---|---|
npm run dev | standard product on port 2499 |
npm run dev:lan | trusted-LAN product on port 2499 |
npm run build | build and copy the FFmpeg core to dist/ffmpeg/ |
npm run build:demo | Vercel demo build with VITE_DEMO=true and noindex |
npm run preview | preview dist/ with the same WASM headers as development |
npm test | run Vitest |
npm run lint | run tsc --noEmit and ESLint |
Local demo build
npm run build:demo
npx vite preview --port 2499This is not the default behavior of npm run dev. See Demo mode.
Do not commit dist/
dist/, node_modules/ and .env* are ignored and must not appear in a pull request.