doom dev
Start the development server with hot module replacement and live reload. This is the default command when runningdoom without arguments.
Usage
Arguments
Root directory of the documentation. Defaults to current working directory.
Options
Dev server host nameExample:
Dev server port numberExample:
Enable lazy compilation to improve compilation performance. Only compiles modules when they are requested.Example:
Disable lazy compilation and compile all modules upfront.Example:
Do not automatically open the browser after starting the server.Example:
Behavior
The dev server includes the following features:Hot Reload
The server automatically restarts when detecting changes to:- Configuration files (
doom.config.*) - Sites configuration (
sites.yaml) - Meta files (
_meta.json) - Source i18n path files
- Documentation directory structure changes (add/unlink files)
File Watching
The watcher ignores:**/node_modules/****/.git/****/.DS_Store/**
Auto Browser Opening
By default, the dev server opens your default browser. Use--no-open to disable this behavior.
Examples
Basic usage
Custom port and host
Specify documentation root
Development with custom config
Disable lazy compilation
Don’t open browser
Ignore internal routes
Development with specific language
Output
When starting the dev server, you’ll see output similar to:Troubleshooting
Port already in use
If the default port is in use, specify a different port:Server not accessible from network
Bind to all network interfaces:Changes not reflecting
For configuration changes, the server automatically restarts. For other issues, try:- Stop the server (Ctrl+C)
- Clear any caches
- Restart with
doom dev
Related Commands
- doom build - Build for production
- doom serve - Preview production build