bitbrain.github.io

bitbrain.github.io

📓 My personal blog, proudly hosted on Github.

👉 bitbra.in

About

This is my personal blog and portfolio website built with Zola, a fast static site generator written in Rust. The site uses the Boring theme for a clean, minimal design.

Features

  • Fast Performance: Built with Zola for lightning-fast build times
  • Modern Design: Clean, responsive design using the Boring theme
  • GitHub Pages: Automatically deployed via GitHub Actions
  • Custom Domain: Hosted at bitbra.in
  • Search: Built-in search functionality
  • Syntax Highlighting: Code blocks with syntax highlighting

Local Development

Prerequisites

  • Zola installed on your system

Setup

  1. Clone the repository:

    git clone https://github.com/bitbrain/bitbrain.github.io.git
    cd bitbrain.github.io
    
  2. Start the development server:

    zola serve
    
  3. Open your browser and navigate to http://127.0.0.1:1111

Building for Production

To build the site for production:

zola build

The built site will be in the public/ directory.

Deployment

The site is automatically deployed to GitHub Pages via GitHub Actions. The workflow:

  • Triggers on pushes to the master branch
  • Builds the site using Zola
  • Deploys to the gh-pages branch
  • Uses the existing CUSTOM_GITHUB_TOKEN for authentication

Custom Domain Setup

If you want to learn how to set up your own blog with a custom domain, I have written a blog post here.

License

This project is open source and available under the MIT License.