README.md

Bl0g

A simple blog/personal site with an MVC architecture and new-school tech flavors.

Stack

• Axum
• Twailwind CSS
• htmx
• Alpine.js

Creating a new blog post

• To create a new post run:

cargo run --bin post-maker <post-title-here>

Important

You'll need an .env file with an api token, e.g. API_TOKEN=123456789, in the project's root.

This will create a markdown file in the content/posts/ directory. The file's frontmatter contains a draft key which defaults to true. For the post to appear on the website, you must change it to false.

Developing

• Install and config the Tailwindcss cli.
• Install cargo-watch: cargo install cargo-watch
• Install just

Included is a bash script in a justfile that can be run with:

just dev

This will start the Axum server and Tailwind binary in watch modes so that saves will trigger rebuilds while you're developing. On exiting this process, the Tailwind binary will minify its outputted css.

Building the Tailwind CSS separately

• Run:

just build-tailwind

• Or as developing, in another tab run:

just run-tailwind

to automatically compile the tailwind as you're making changes.

Deploying to Fly.io

• Install flyctl to be able to deploy to Fly.io.

After the inital fly launch the following deploys can be done with:

fly deploy