modify README.md and add ci-cd

Author: hnlearndev

.github/workflows/ci-cd.yaml

@@ -0,0 +1,66 @@
+name: Leptos WASM Blog CI/CD
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+  workflow_dispatch:
+
+jobs:
+  check:
+    name: Check & Lint
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Install Rust toolchain
+        uses: dtolnay/rust-toolchain@master
+        with:
+          toolchain: stable
+          components: rustfmt, clippy
+          targets: wasm32-unknown-unknown
+
+      - name: Check formatting
+        run: cargo fmt --all -- --check
+
+      - name: Run clippy
+        run: cargo clippy --all-targets --features ssr -- -D warnings
+
+  test:
+    name: Test
+    runs-on: ubuntu-latest
+    needs: check
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Install Rust toolchain
+        uses: dtolnay/rust-toolchain@master
+        with:
+          toolchain: stable
+          targets: wasm32-unknown-unknown
+
+      - name: Run tests
+        run: cargo test --features ssr
+
+  build:
+    name: Build WASM
+    runs-on: ubuntu-latest
+    needs: test
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Install Rust toolchain
+        uses: dtolnay/rust-toolchain@master
+        with:
+          toolchain: stable
+          targets: wasm32-unknown-unknown
+
+      - name: Install cargo-leptos
+        run: cargo install cargo-leptos
+
+      - name: Build Leptos WASM
+        run: cargo leptos build --release

Cargo.toml

@@ -17,7 +17,7 @@ leptos_meta = { version = "0.8.0" }
 tokio = { version = "1", features = ["rt-multi-thread"], optional = true }
 wasm-bindgen = { version = "0.2.101", optional = true }
 sqlx = { version = "0.8.6", features = ["runtime-tokio", "postgres", "macros", "uuid", "chrono"], optional = true }
-chrono = { version = "0.4.41", features = ["serde"] }
+chrono = { version = "0.4.42", features = ["serde"] }
 uuid = { version = "1.18.1", features = ["v4", "v5", "serde", "js"] }
 thiserror = "2.0.16"
 serde = { version = "1.0.219", features = ["derive"] }

README.md

@@ -1,8 +1,12 @@
 # Willian's Personal Blog
 
-The blog is at [wiiliannguyen.com](https://www.williannguyen.com)
+The final product is [williannguyen.com](https://williannguyen.com).
 
-## Architecture Overview
+Full personal reflection on this project can be found on this [post](https://williannguyen.com/posts/4).
+
+PS: It works. If it does not, please dm me. Thank you for your helps.
+
+## ARCHITECTURE OVERVIEW
 
 This application follows a **full-stack Rust architecture** using:
 
@@ -12,7 +16,7 @@ This application follows a **full-stack Rust architecture** using:
 - **Content**: Markdown-based blog posts with syntax highlighting
 - **Build System**: Custom build script for static content generation
 
-## Tech Stack
+## TECH STACK
 
 ### Core Framework
 
@@ -32,27 +36,18 @@ This application follows a **full-stack Rust architecture** using:
 - **[syntect](https://docs.rs/syntect/)** - Syntax highlighting for code blocks
 - **Static Content Generation** - Build-time markdown processing
 
-### Middleware & Security
-
-- **Rate Limiting** - Per-IP request throttling using Governor
-- **CORS** - Cross-Origin Resource Sharing configuration
-- **CSRF Protection** - Token-based CSRF mitigation
-- **Security Headers** - Comprehensive HTTP security headers
-- **Request Timeout** - Configurable request timeouts
-- **Compression** - Brotli compression for responses
-
 ### Development & Deployment
 
 - **[cargo-leptos](https://crates.io/crates/cargo-leptos)** - Leptos build tool
 - **Hot Reload** - Development server with live reloading
 - **WASM Optimization** - Size-optimized WebAssembly builds
 - **End-to-End Testing** - Playwright integration
 
-## Project Structure
+## PROJECT STRUCTURE
 
 ### 🌐 Frontend (Leptos)
 
-The implementation is  obtained from cargo-leptos axum template provided from. For more detail, please follow the the [instruction](https://github.com/leptos-rs/start-axum).
+The implementation is  obtained from cargo-leptos axum template. For more detail, please follow the the [instruction](https://github.com/leptos-rs/start-axum).
 
 ```text
 src/
@@ -124,17 +119,14 @@ graph TD
 
 #### Middleware & Security Features
 
-- Rate Limiting: Per-IP request throttling using Governor
-- CORS: Cross-Origin Resource Sharing configuration
-- CSRF Protection: Token-based CSRF mitigation
-- Security Headers: Comprehensive HTTP security headers
-- Request Timeout: Configurable request timeouts
-- Compression: Brotli compression for responses
-
-#### Middleware Implementation
-
-- Global: Applied in server.rs (compression, timeout, CORS, security headers)
-- Route-specific: Applied in routes/ modules. For example, subscriber routes apply no_cache, governor, throttle, and CSRF layers.
+- **Global**
+  - Compression: Brotli compression for responses
+  - Request Timeout: Configurable request timeouts
+  - Security Headers: Comprehensive HTTP security headers
+- **Route specific**
+  - Rate Limiting: Per-IP request throttling using Governor
+  - CORS: Cross-Origin Resource Sharing configuration
+  - CSRF Protection: Token-based CSRF mitigation
 
 #### Layer Responsibilities
 
@@ -145,7 +137,7 @@ graph TD
 - Models: Data structures, serialization, validation rules
 - DB: Connection pooling, configuration, state management
 
-## Build System
+## BUILD SYSTEM
 
 The project uses a custom build script (`build.rs`) that:
 
@@ -154,7 +146,7 @@ The project uses a custom build script (`build.rs`) that:
 3. **Static Generation**: Converts markdown to HTML at build time
 4. **Optimized Output**: Generates Rust code with static post data
 
-## Performance Features
+## PERFORMANCE FEATURES
 
 - **Server-Side Rendering (SSR)**: Fast initial page loads
 - **Hydration**: Interactive client-side features without full SPA overhead
@@ -165,7 +157,7 @@ The project uses a custom build script (`build.rs`) that:
 - **HTTP Caching Strategy**: Multi-tier caching system for optimal performance
 - **WASM Optimization**: Aggressive size optimization for client-side bundles
 
-## WASM Bundle Optimization
+## WASM BUNDLE OPTIMIZATION
 
 The WebAssembly build process includes several standard optimization techniques to minimize bundle size:
 
@@ -195,7 +187,7 @@ Below information is  obtained from the actual implementation on the project and
 - **Better mobile experience**: Smaller bundles improve performance on slower connections
 - **Production ready**: Size is now within reasonable limits for web deployment
 
-## Caching
+## CACHING
 
 Deploy standard industry practices
 
@@ -212,15 +204,11 @@ Deploy standard industry practices
 
 - Centralized Error Handling (**Status**: Planned)
 
-Will add a middleware layer to catch errors, log them, and provide consistent user-friendly responses. Implementation is postponed until the app grows in complexity.
+ To add a middleware layer to catch errors, log them, and provide consistent user-friendly responses. Implementation is postponed until the app grows in complexity.
 
 - Modulized global layer (**Status**: Planned)
 
-This was planned out at the begginning with `tower` crate 's ServiceBuilder as a global layer which is then called into server.rs.
-
-However, refactoring this seperated out from server.rs run is more troublesome than expected.
-
-Until the project expands further, it is placed directly in server.rs.
+This was planned out at the begginning with `tower` crate 's ServiceBuilder as a global layer which is then called into server.rs. However, refactoring this seperated out from server.rs run is more troublesome than expected. Until the project expands further, it is placed directly in server.rs.
 
 ## Reference
 

src/app/components/nav.rs

@@ -38,7 +38,7 @@ pub fn Nav() -> impl IntoView {
     #[cfg(feature = "hydrate")]
     Effect::new(move |_| {
         use wasm_bindgen::JsCast;
-        use web_sys::{window, js_sys};
+        use web_sys::{js_sys, window};
 
         if let Some(window) = window() {
             let closure = wasm_bindgen::closure::Closure::wrap(Box::new(move || {
@@ -49,7 +49,7 @@ pub fn Nav() -> impl IntoView {
             let _ = js_sys::Reflect::set(
                 &window,
                 &"__nav_theme_toggle".into(),
-                closure.as_ref().unchecked_ref()
+                closure.as_ref().unchecked_ref(),
             );
             closure.forget();
         }

src/app/pages/homepage.rs

@@ -10,5 +10,3 @@ pub fn HomePage() -> impl IntoView {
         <p>"Anything that I learn and find interesting, I will write about it on my blog."</p>
     }
 }
-
-

src/server/db.rs

@@ -1,4 +1,4 @@
-pub mod pool;
 pub mod config;
-pub mod state;
 pub mod error;
+pub mod pool;
+pub mod state;

src/server/handlers/subscriber.rs

@@ -33,17 +33,15 @@ pub async fn subscribe_handler(
         })),
         Err(e) => {
             // Example: check for unique violation (already subscribed)
-            if let Some(db_err) = e.as_database_error() {
-                if let Some(code) = db_err.code() {
-                    if code == "23505" {
-                        // Unique violation in Postgres
-                        return Ok(Json(SubscribeResponse {
-                            status: "warning".to_string(),
-                            message: "You're already subscribed with this email address."
-                                .to_string(),
-                        }));
-                    }
-                }
+            if let Some(db_err) = e.as_database_error()
+                && let Some(code) = db_err.code()
+                && code == "23505"
+            {
+                // Unique violation in Postgres
+                return Ok(Json(SubscribeResponse {
+                    status: "warning".to_string(),
+                    message: "You're already subscribed with this email address.".to_string(),
+                }));
             }
             Err(axum::http::StatusCode::INTERNAL_SERVER_ERROR)
         }

src/server/middleware.rs

@@ -1,5 +1,5 @@
 pub mod cache;
+pub mod csrf;
 pub mod global_layer;
 pub mod governor;
 pub mod throttle;
-pub mod csrf;

src/server/middleware/csrf.rs

@@ -1,12 +1,12 @@
 use axum::{
+    body::Body,
     http::{Request, StatusCode},
     middleware::Next,
     response::Response,
-    body::Body,
 };
 use axum_extra::extract::cookie::CookieJar;
-use rand::RngCore;
 use base64::{Engine as _, engine::general_purpose};
+use rand::RngCore;
 
 const CSRF_HEADER: &str = "x-csrf-token";
 const CSRF_COOKIE: &str = "csrf_token";

src/server/middleware/global_layer/security_headers.rs

@@ -10,7 +10,7 @@ use axum::{
 
 pub async fn security_headers(req: Request<Body>, next: Next) -> Response {
     let mut res = next.run(req).await;
-    
+
     let headers: [(&str, &str); 5] = [
         ("x-content-type-options", "nosniff"),
         ("x-frame-options", "DENY"),