Basil Server Manual
Basil is a web server that runs Parsley handlers. Drop a .pars file in a directory and it becomes a route. One binary, almost no configuration, no build step — with a database, authentication, search, and an image server already inside.
New to Basil? The Get Started tutorial takes you from install to a working site in ten minutes.
The Server
| Page |
Description |
| Running Basil |
Install, --init, dev mode, CLI commands, and signals |
| Configuration |
The basil.yaml file — every section explained |
| Routing |
Site mode, folder-named handlers, explicit routes, and static files |
Features
| Page |
Description |
| Database |
The built-in SQLite database, @DB, and the database inspector |
| Authentication |
Passkey login, users, roles, protected paths, and API keys |
| Parts |
Interactive components that update without page reloads |
| Search |
Full-text search over your content with @SEARCH |
| Images |
Image transformation, smart crop, and responsive srcsets |
| Git Deploy |
Push-to-deploy over HTTPS with the built-in Git server |
Development & Production
| Page |
Description |
| Dev Tools |
Hot reload, the dev log panel, and error pages |
| Deployment |
TLS, production mode, compression, CORS, and security |
Reference