HHK B/Vlog

Modern Hugo static blog & digital knowledge base powered by Tailwind CSS v4 and Cloudflare Workers edge architecture.

Website Stats

Build & Quality

Technology & Tools

Development Environment

---

Welcome to My Digital World

HHK B/Vlog is my personal technical website for publishing practical notes, project updates, and troubleshooting guides. It focuses on modern web systems, software workflows, server administration, and the tools I use to build and maintain reliable digital infrastructure.

This repository contains the complete source code for the site, including Hugo templates, content, assets, serverless Cloudflare Workers backend, and automated CI/CD pipelines.

---

Architecture Highlights

The platform pairs zero-runtime static site generation with a stateful serverless edge runtime:

• Static Core: Compiled with Hugo Extended (v0.165+), Tailwind CSS v4 modular partials, and instant client-side search via Pagefind.
• Edge Runtime: Served globally on Cloudflare Workers with Static Assets (env.ASSETS), strict Content Security Policy (CSP), and HSTS preloading.
• Stateful Edge Compute: Real-time view tracking powered by Cloudflare Durable Objects (SQLite Storage Engine) and Workers KV namespaces (BLOG_VIEWS, SHOP_DATA).
• Serverless Integrations: Visitor edge telemetry (/api/edge-info), Telegram Bot Webhooks (/api/bot), and Telegram Mini App endpoints (/api/telegram).
• Strict QA & Compliance: Zero-copyleft license auditor (npm run check:licenses), continuous FOSSA SBOM analysis, and SonarCloud Clean Code gate.

👉 For complete architectural diagrams, storage schemas, and directory structure, read the System Architecture Guide.

---

Quick Start

Get a local development server running in three quick steps:

# 1. Clone the repository
git clone git@github.com:hhkmy/id.git && cd id

# 2. Install dependencies & provision Hugo
npm install
./scripts/hugo_installer.sh

# 3. Start the live-reload development server
npm run dev

Visit http://localhost:1313/ to view the site.

👉 For system requirements, environment variables (.env.example), and edge worker testing, consult the Development & Operations Guide.

---

Recent Articles

• Securing a Self-Hosted Telegram Crypto Bot on a Local Raspberry Pi
• Antigravity IDE Python Interpreter Error ပြင်နည်း
• MI Bluetooth Speaker Audio Lag နဲ့ Stutter ပြင်နည်း
• Debian Shutdown Error Debugging နဲ့ Log စစ်ဆေးနည်း
• Debian စတင်ချိန် GNOME Keyring Scope Error ပြင်နည်း

---

Documentation

Deep-dive documentation and specialized guides are organized inside the .github/ folder:

• 🏗️ System Architecture & Edge Guide: Detailed breakdown of Hugo compilation, Cloudflare Workers, Durable Objects SQLite engine, and KV storage.
• ⚙️ Development & Operations Guide: Prerequisites matrix, environment variable configuration, compliance verification, and Cloudflare deployment.
• 📜 NPM Scripts Guide: Complete reference for all 25+ development, build, test, and maintenance scripts.
• 📦 Package Updates Guide: Guidelines for safely updating dependencies and managing license compliance.
• 🔒 Security Policy: Security practices and vulnerability reporting procedures.

---

License

Licensed under the permissive ISC License.