This is a Kobweb project bootstrapped with the app/empty
template.
This template is useful if you already know what you're doing and just want a clean slate. By default, it just creates a blank home page (which prints to the console so you can confirm it's working)
If you are still learning, consider instantiating the app
template (or one of the examples) to see actual,
working projects.
First, run the development server by typing the following command in a terminal under the site
folder:
$ cd site
$ kobweb run
Open http://localhost:8080 with your browser to see the result.
You can use any editor you want for the project, but we recommend using IntelliJ IDEA Community Edition downloaded using the Toolbox App.
Press Q
in the terminal to gracefully stop the server.
Feel free to edit / add / delete new components, pages, and API endpoints! When you make any changes, the site will indicate the status of the build and automatically reload when ready.
When you are ready to ship, you should shutdown the development server and then export the project using:
kobweb export
When finished, you can run a Kobweb server in production mode:
kobweb run --env prod
If you want to run this command in the Cloud provider of your choice, consider disabling interactive mode since nobody is sitting around watching the console in that case anyway. To do that, use:
kobweb run --env prod --notty
Kobweb also supports exporting to a static layout which is compatible with static hosting providers, such as GitHub Pages, Netlify, Firebase, any presumably all the others. You can read more about that approach here: https://bitspittle.dev/blog/2022/staticdeploy