Smolpress is a small website builder. It aims to be an alternative to the increasingly complex static site generators and content managers available today.
With smolpress you would just write your posts in markdown using the built-in online editor. The markdown content is saved on the disk and converted to html on the spot. No database is required, everything is file based.
It can be used for personal websites, blogs, quick prototypes or as a baseline for more complex sites.
A node.js server is used to provide some dynamic content like comments, image upload and markdown editing.
Smolpress is also a static site generator and supports ejs templates in addition to markdown files. To statically generate the site simply start the server. While smolpress runs on a node.js server to provide some dynamic features, your posts are statically generated at all time so you can move them to a different web server if you feel the need.
Compared to an SSG, smolpress provides an online markdown editor so you can edit your posts using your own website rather than using an external editor and fiddling with live-reload or deploy scripts.
Smolpress is very similar to a CMS, in the sense that you can manage your content from an online interface. However it is smaller, much smaller than a real CMS like Wordpress.
With smolpress all posts sit nicely on the disk written in Markdown and are not deeply burried inside a database. In fact smolpress does not even require a database.
npm install -g smolpress
cd blog
smolpress init
export SMOLPRESS_VAULT_PASSWORD=yourpassword
smolpress start
If you're running Windows replace the export command above with set.
Alternate installation (that doesn't involve the global smolpress command):
git clone https://github.com/mihaifm/smolpress blog
cd blog
npm install
export SMOLPRESS_VAULT_PASSWORD=yourpassword
node index.js
Now simply visit localhost:3939 to view your blog and localhost:3939/admin to create a new post.
Smolpress 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 SMOLPRESS_VAULT_PASSWORD environment variable. User password is also hashed with sha512.
You can edit any post by visiting the /admin panel and clicking the Edit link for any post. Click Preview to see the markdown output and Save to have the post converted to html.
Images can be uploaded via the /media link in the admin panel or by drag and drop in the editor. New images are stored in source/media and copied to public/media when the site in generated.
Smolpress uses front-matter to add metadata to your pages. Any property name is supported and can be later used in the theme for customization.
The layout, title and date properties are supported by the default theme.
Date format needs to be specified in the /settings panel. Simple and advanced formats are provided by dayjs.
The comments system is simple and smol. Comments are saved as json files and converted to html when the site is generated. There is no anti-spam protection but the number of comments per post and comment length are limited by config options. You can also moderate comments from the admin panel.
Themes are based on ejs templates and are placed in the themes folder. Smolpress has a default theme called tiny. Changing the theme can be done in the /settings panel.
It is recommended to make a copy of the default theme and naming it to something else before making any customizations to the site. This way you won't lose any changes when updating smolpress.
RSS feed is generated automatically for the entire site. RSS fields can be configured by editing data/feedconfig.json. This file is generated with some placeholder values when the server is first started.
3939sourcepublicdatathemesA smol number of options like site title and description are available in the config.json file (stored in the data folder).
You can edit the file manually or use the /settings panel of your website.
FAQs
Smol Website Builder
The npm package smolpress receives a total of 3 weekly downloads. As such, smolpress popularity was classified as not popular.
We found that smolpress demonstrated a not healthy version release cadence and project activity because the last version was released a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
Multiple high-impact npm maintainers confirm they have been targeted in the same social engineering campaign that compromised Axios.
Security News
Axios compromise traced to social engineering, showing how attacks on maintainers can bypass controls and expose the broader software supply chain.
Security News
Node.js has paused its bug bounty program after funding ended, removing payouts for vulnerability reports but keeping its security process unchanged.