These examples assume that you have installed Lume as the
To build your website, simply run:
This command will compile your documents to HTML and save them into the dest
Typically you will want to see the site in your browser so to start a local
server with your site, add the
This command init a local web server and starts watching the changes of
your site. So if you edit anything, Lume will rebuild the site and reload
automatically your browser with the new changes. The local server use the port
3000 by default but you can change it with the
--port argument. For example:
lume --serve --port=8000
If you don't want to start a local server but want to watch the changes, use the
Lume don't need a config file to work, but is required to change the default behavior like adding plugins, ignore files, etc. The config file is very simple and you can create it by yourself, but for convenience you can use the following command.
This will create a config file for you, after some questions. It also can
configure VS Code if you use this code editor
If you only need to configure VSCode, just run
lume init --only=vscode.
There are other useful commands like:
lume -V: to show the current version.
lume upgrade: to upgrade Lume to the latest version.
lume run: to run a custom script.
To see all available commands and arguments, run
Deno CLI has some options that can be interesting for your site build. For
Node.js compatiblity mode
a configuration file
--config=<FILE> or a
import map file
Lume CLI runs Deno CLI with some arguments predefined, but you can customize
them including the Deno arguments after
--. For example, if you want to run
Lume with a custom import map and Node compatibility:
lume -- --import-map=import_map.json --compat