Smol NPM | npm.io

Smol

Static site generator with a bare minimum set of features.

Generate html from markdown sources
Support for ejs templates
Page metadata (front-matter)
Default theme
Admin panel with authentication
Online markdown editor
Image upload
No database, everthing is file based

For a more complete feature set see smolpress.

Install

Requires node.js >= 10.0

npm install -g smol
cd blog
smol init
export SMOL_VAULT_PASSWORD=yourpassword
smol start

Alternate installation (that doesn't involve the global smol command):

git clone https://github.com/mihaifm/smol blog
cd blog
npm install
export SMOL_VAULT_PASSWORD=yourpassword
node index.js

Visit localhost:3939 to view your blog and localhost:3939/admin to manage posts.

Authentication

Smol provides a single user that is created when visiting /admin. User data is stored in a text file (data/vault.txt) which is encrypted with the password available in the SMOL_VAULT_PASSWORD environment variable.

Environment variables

SMOL_VAULT_PASSWORD - encryption password for the "vault" containing user data.
SMOL_PORT - server port. Default: 3939
SMOL_SRC_PATH - path to the markdown page sources. Default: source
SMOL_OUTPUT_PATH - path to the generated static files. Default: public
SMOL_DATA_PATH - path to the data folder. Default: data