Files
2026-07-13 12:28:53 +08:00

52 lines
1.8 KiB
Plaintext

---
title: open-slide dev
description: Run the dev server with hot reload, inspector, and assets panel.
---
```npm
open-slide dev
# or, via the generated script
npm run dev
```
Boots a Vite-powered dev server on `http://localhost:5173` (or the next free
port). Hot module reload is wired up for both the runtime and your slide
files — saving an `index.tsx` updates the canvas without losing slide state.
## What you get
- **Slide browser** — list of every deck under `slides/`.
- **Canvas** — the active page, scaled to fit the viewport.
- **Inspector** — click any element to edit it visually, drop a
`@slide-comment`, or both.
- **Assets panel** — drag, rename, replace, plus svgl logo search.
- **Present mode** — fullscreen playback with presenter view.
## Flags
| Flag | Default | Description |
| --------------------- | --------------- | ----------------------------------------------------------------- |
| `-p, --port <port>` | from config | Override the listening port. |
| `--host [host]` | localhost only | Expose the dev server on the network. Optional host pin. |
| `--open` | off | Open the browser on start. |
| `--no-skills-check` | off | Skip the built-in skills drift check. |
The skills check also obeys the `OPEN_SLIDE_SKIP_SKILLS_CHECK=1`
environment variable — useful in CI or container builds where stdin
isn't a TTY.
## Configuration
Override the port (and a few other knobs) in `open-slide.config.ts`:
```ts title="open-slide.config.ts"
import type { OpenSlideConfig } from '@open-slide/core';
const config: OpenSlideConfig = {
port: 5174,
slidesDir: 'slides',
};
export default config;
```