jackdaw 1.0.3 → 1.0.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 232d8c8859aea9921f207a071ccc7a4ae7e8fa6e41fbe0dbbcaaff4b01372627
-  data.tar.gz: ef1961fdcbf66820bfcbd503f9b751d8a32397c6e5194ba29511d88c567f271e
+  metadata.gz: 2ca507791f3ec7ecffc5ada817cdf5d2db4f5d7ac4b21e25142931285ceef0dc
+  data.tar.gz: d3ffd9be8b6c37b337a554725e662db4a77fafa78163f283aa948e3d6fd8ec8c
 SHA512:
-  metadata.gz: 754345778dd3b3980f736bb2e55ed6c1804cf99bec961ecee2fde42a96735ce87dab596b2470a56d94ef992c5ec8fe8608faaa1ce321003fca7090b3780df680
-  data.tar.gz: 45e130f32193d153a5cc75e4834b21eebd9d434e6215c075935f043c7661e8922cc71edce930ef46164d8c31a4d0923d471f828469278ca05c05c6ebc02afa68
+  metadata.gz: 3598cb14c96e229d9961270a6c10a495093082e7da614b87a92e2daf2da56c0a70f7cd57aeeb36477153a024af7b469eb7e2f7344b8bbb5d99efbc47f7c05055
+  data.tar.gz: a790cb63130eb2f3a575855e0b4a3b947840d6185af9c63825c892ed8ae47140c554dd627a0277e96aec6d2ca5a13f21f8f1c5eb7e1777243e0317a63e1c903f

data/CHANGELOG.md

@@ -5,6 +5,15 @@ All notable changes to Jackdaw will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.0.4] - 2026-01-08
+
+### Fixed
+- Fixed hot reload functionality in development server - browser now properly detects file changes and refreshes automatically
+- Improved live reload middleware to use build counter instead of timestamps for more reliable change detection
+- Fixed partial template changes not triggering rebuilds - changes to partials (e.g., `_nav.html.erb`, `_footer.html.erb`) now properly rebuild all affected pages
+- Fixed build statistics accumulating across multiple rebuilds - stats now reset correctly for each build
+- Added hot reload support for assets (CSS, JS, images) - changes to assets now trigger browser refresh with cache-busting
+
 ## [1.0.0] - 2026-01-06
 
 ### Added

data/exe/jackdaw

@@ -1,5 +1,4 @@
 #!/usr/bin/env ruby
-# encoding: UTF-8
 # frozen_string_literal: true
 
 # Set default external encoding to UTF-8

data/lib/jackdaw/builder.rb

@@ -15,6 +15,8 @@ module Jackdaw
 
     # Run full build
     def build
+      # Reset stats for this build
+      @stats = BuildStats.new
       start_time = Time.now
 
       # Clean if requested
@@ -137,9 +139,20 @@ module Jackdaw
       layout_file = File.join(project.templates_dir, 'layout.html.erb')
       return true if File.exist?(layout_file) && File.mtime(layout_file) > output_mtime
 
+      # Check if any partials are newer
+      return true if any_partial_newer?(output_mtime)
+
       false
     end
 
+    def any_partial_newer?(output_mtime)
+      # Get all partial files (starting with _)
+      partial_pattern = File.join(project.templates_dir, '_*.erb')
+      Dir.glob(partial_pattern).any? do |partial_file|
+        File.mtime(partial_file) > output_mtime
+      end
+    end
+
     def needs_asset_copy?(asset_file)
       # Always copy if clean build
       return true if @options[:clean]

data/lib/jackdaw/cli_helpers.rb

@@ -27,7 +27,12 @@ module Jackdaw
     end
 
     def header(text)
-      puts "\n#{COLORS[:bold]}#{COLORS[:magenta]}#{text}#{COLORS[:reset]}"
+      puts "#{COLORS[:bold]}#{COLORS[:magenta]}#{text}#{COLORS[:reset]}"
+    end
+
+    def version_banner
+      puts "🐦 #{colorize('Jackdaw', :bold)} #{colorize("v#{Jackdaw::VERSION}", :cyan)}"
+      puts ''
     end
   end
 end

data/lib/jackdaw/commands/build.rb

@@ -1,4 +1,3 @@
-# encoding: UTF-8
 # frozen_string_literal: true
 
 module Jackdaw
@@ -15,6 +14,7 @@ module Jackdaw
       def execute
         return handle_missing_project unless @project.exists?
 
+        version_banner
         header('🚀 Building your site...')
         info('Cleaning output directory...') if @options[:clean]
 

data/lib/jackdaw/commands/serve.rb

@@ -17,6 +17,8 @@ module Jackdaw
           exit 1
         end
 
+        version_banner
+
         server = Server.new(@project, @options)
         server.start
       rescue Interrupt

data/lib/jackdaw/server.rb

@@ -1,4 +1,3 @@
-# encoding: UTF-8
 # frozen_string_literal: true
 
 module Jackdaw
@@ -19,7 +18,7 @@ module Jackdaw
     # Start the server
     def start
       # Initial build
-      puts "\n#{colorize('🚀 Building site...', :magenta)}"
+      puts "#{colorize('🚀 Building site...', :magenta)}"
       stats = builder.build
       show_build_stats(stats)
 
@@ -31,7 +30,13 @@ module Jackdaw
       puts colorize('Press Ctrl+C to stop', :magenta)
       puts ''
 
-      Rack::Handler::Puma.run(rack_app, Port: port, Host: host, Silent: true)
+      # Build and start the Rack app
+      app = rack_app
+
+      # Notify that initial build is complete (sets counter to 1)
+      notify_reload if @livereload
+
+      Rack::Handler::Puma.run(app, Port: port, Host: host, Silent: true)
     end
 
     def livereload?
@@ -41,11 +46,16 @@ module Jackdaw
     private
 
     def rack_app
-      server = self
-      Rack::Builder.new do
-        use Rack::CommonLogger
-        use LiveReloadMiddleware, server if server.livereload?
-        run StaticFileServer.new(server.project)
+      static_server = StaticFileServer.new(project)
+
+      # Create the middleware instance if livereload is enabled
+      if @livereload
+        @livereload_middleware = LiveReloadMiddleware.new(static_server, self)
+        # Return an app that chains CommonLogger -> LiveReload -> StaticServer
+        Rack::CommonLogger.new(@livereload_middleware)
+      else
+        # No livereload, just CommonLogger -> StaticServer
+        Rack::CommonLogger.new(static_server)
       end
     end
 
@@ -89,8 +99,7 @@ module Jackdaw
     end
 
     def notify_reload
-      # In a real implementation, this would notify WebSocket clients
-      # For now, the LiveReloadMiddleware handles it with polling
+      @livereload_middleware&.update_build_time
     end
 
     def colorize(text, color)
@@ -138,7 +147,16 @@ module Jackdaw
       content = File.read(path)
       content_type = mime_type(path)
 
-      [200, { 'Content-Type' => content_type, 'Content-Length' => content.bytesize.to_s }, [content]]
+      headers = {
+        'Content-Type' => content_type,
+        'Content-Length' => content.bytesize.to_s,
+        # Disable caching in development for assets
+        'Cache-Control' => 'no-cache, no-store, must-revalidate',
+        'Pragma' => 'no-cache',
+        'Expires' => '0'
+      }
+
+      [200, headers, [content]]
     end
 
     def mime_type(path)
@@ -161,16 +179,17 @@ module Jackdaw
     RELOAD_SCRIPT = <<~JS
       <script>
         (function() {
-          let lastCheck = Date.now();
+          let lastBuild = null;
           setInterval(function() {
-            fetch('/__rhes_reload_check')
+            fetch('/__jackdaw_reload_check')
               .then(r => r.json())
               .then(data => {
-                if (data.lastBuild > lastCheck) {
+                if (lastBuild !== null && data.lastBuild > lastBuild) {
                   console.log('Jackdaw: Reloading page...');
-                  location.reload();
+                  // Force hard reload to bypass cache for CSS/JS changes
+                  window.location.reload(true);
                 }
-                lastCheck = Date.now();
+                lastBuild = data.lastBuild;
               })
               .catch(() => {});
           }, 1000);
@@ -181,16 +200,20 @@ module Jackdaw
     def initialize(app, server)
       @app = app
       @server = server
-      @last_build = Time.now
+      @build_count = 0
+    end
+
+    def update_build_time
+      @build_count += 1
     end
 
     def call(env)
       # Handle reload check endpoint
-      if env['PATH_INFO'] == '/__rhes_reload_check'
+      if env['PATH_INFO'] == '/__jackdaw_reload_check'
         return [
           200,
           { 'Content-Type' => 'application/json' },
-          [JSON.generate({ lastBuild: @last_build.to_f })]
+          [JSON.generate({ lastBuild: @build_count })]
         ]
       end
 
@@ -203,7 +226,6 @@ module Jackdaw
 
         if body.include?('</body>')
           body = body.sub('</body>', "#{RELOAD_SCRIPT}</body>")
-          @last_build = Time.now
           headers['Content-Length'] = body.bytesize.to_s
           response = [body]
         end

data/lib/jackdaw/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Jackdaw
-  VERSION = '1.0.3'
+  VERSION = '1.0.4'
 end

data/usejackdaw.com.site/Gemfile

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+source 'https://rubygems.org'
+
+# gem "rails"
+
+gem 'jackdaw', path: '..'

data/usejackdaw.com.site/Gemfile.lock

@@ -0,0 +1,93 @@
+PATH
+  remote: ..
+  specs:
+    jackdaw (1.0.4)
+      kramdown (~> 2.4)
+      kramdown-parser-gfm (~> 1.1)
+      listen (~> 3.9)
+      logger (~> 1.7)
+      parallel (~> 1.24)
+      puma (~> 6.4)
+      rack (~> 3.0)
+      rouge (~> 4.2)
+      thor (~> 1.3)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    ffi (1.17.3)
+    ffi (1.17.3-aarch64-linux-gnu)
+    ffi (1.17.3-aarch64-linux-musl)
+    ffi (1.17.3-arm-linux-gnu)
+    ffi (1.17.3-arm-linux-musl)
+    ffi (1.17.3-arm64-darwin)
+    ffi (1.17.3-x86-linux-gnu)
+    ffi (1.17.3-x86-linux-musl)
+    ffi (1.17.3-x86_64-darwin)
+    ffi (1.17.3-x86_64-linux-gnu)
+    ffi (1.17.3-x86_64-linux-musl)
+    kramdown (2.5.1)
+      rexml (>= 3.3.9)
+    kramdown-parser-gfm (1.1.0)
+      kramdown (~> 2.0)
+    listen (3.9.0)
+      rb-fsevent (~> 0.10, >= 0.10.3)
+      rb-inotify (~> 0.9, >= 0.9.10)
+    logger (1.7.0)
+    nio4r (2.7.5)
+    parallel (1.27.0)
+    puma (6.6.1)
+      nio4r (~> 2.0)
+    rack (3.2.4)
+    rb-fsevent (0.11.2)
+    rb-inotify (0.11.1)
+      ffi (~> 1.0)
+    rexml (3.4.4)
+    rouge (4.7.0)
+    thor (1.5.0)
+
+PLATFORMS
+  aarch64-linux-gnu
+  aarch64-linux-musl
+  arm-linux-gnu
+  arm-linux-musl
+  arm64-darwin
+  ruby
+  x86-linux-gnu
+  x86-linux-musl
+  x86_64-darwin
+  x86_64-linux-gnu
+  x86_64-linux-musl
+
+DEPENDENCIES
+  jackdaw!
+
+CHECKSUMS
+  ffi (1.17.3) sha256=0e9f39f7bb3934f77ad6feab49662be77e87eedcdeb2a3f5c0234c2938563d4c
+  ffi (1.17.3-aarch64-linux-gnu) sha256=28ad573df26560f0aedd8a90c3371279a0b2bd0b4e834b16a2baa10bd7a97068
+  ffi (1.17.3-aarch64-linux-musl) sha256=020b33b76775b1abacc3b7d86b287cef3251f66d747092deec592c7f5df764b2
+  ffi (1.17.3-arm-linux-gnu) sha256=5bd4cea83b68b5ec0037f99c57d5ce2dd5aa438f35decc5ef68a7d085c785668
+  ffi (1.17.3-arm-linux-musl) sha256=0d7626bb96265f9af78afa33e267d71cfef9d9a8eb8f5525344f8da6c7d76053
+  ffi (1.17.3-arm64-darwin) sha256=0c690555d4cee17a7f07c04d59df39b2fba74ec440b19da1f685c6579bb0717f
+  ffi (1.17.3-x86-linux-gnu) sha256=868a88fcaf5186c3a46b7c7c2b2c34550e1e61a405670ab23f5b6c9971529089
+  ffi (1.17.3-x86-linux-musl) sha256=f0286aa6ef40605cf586e61406c446de34397b85dbb08cc99fdaddaef8343945
+  ffi (1.17.3-x86_64-darwin) sha256=1f211811eb5cfaa25998322cdd92ab104bfbd26d1c4c08471599c511f2c00bb5
+  ffi (1.17.3-x86_64-linux-gnu) sha256=3746b01f677aae7b16dc1acb7cb3cc17b3e35bdae7676a3f568153fb0e2c887f
+  ffi (1.17.3-x86_64-linux-musl) sha256=086b221c3a68320b7564066f46fed23449a44f7a1935f1fe5a245bd89d9aea56
+  jackdaw (1.0.4)
+  kramdown (2.5.1) sha256=87bbb6abd9d3cebe4fc1f33e367c392b4500e6f8fa19dd61c0972cf4afe7368c
+  kramdown-parser-gfm (1.1.0) sha256=fb39745516427d2988543bf01fc4cf0ab1149476382393e0e9c48592f6581729
+  listen (3.9.0) sha256=db9e4424e0e5834480385197c139cb6b0ae0ef28cc13310cfd1ca78377d59c67
+  logger (1.7.0) sha256=196edec7cc44b66cfb40f9755ce11b392f21f7967696af15d274dde7edff0203
+  nio4r (2.7.5) sha256=6c90168e48fb5f8e768419c93abb94ba2b892a1d0602cb06eef16d8b7df1dca1
+  parallel (1.27.0) sha256=4ac151e1806b755fb4e2dc2332cbf0e54f2e24ba821ff2d3dcf86bf6dc4ae130
+  puma (6.6.1) sha256=b9b56e4a4ea75d1bfa6d9e1972ee2c9f43d0883f011826d914e8e37b3694ea1e
+  rack (3.2.4) sha256=5d74b6f75082a643f43c1e76b419c40f0e5527fcfee1e669ac1e6b73c0ccb6f6
+  rb-fsevent (0.11.2) sha256=43900b972e7301d6570f64b850a5aa67833ee7d87b458ee92805d56b7318aefe
+  rb-inotify (0.11.1) sha256=a0a700441239b0ff18eb65e3866236cd78613d6b9f78fea1f9ac47a85e47be6e
+  rexml (3.4.4) sha256=19e0a2c3425dfbf2d4fc1189747bdb2f849b6c5e74180401b15734bc97b5d142
+  rouge (4.7.0) sha256=dba5896715c0325c362e895460a6d350803dbf6427454f49a47500f3193ea739
+  thor (1.5.0) sha256=e3a9e55fe857e44859ce104a84675ab6e8cd59c650a49106a05f55f136425e73
+
+BUNDLED WITH
+  4.0.3

data/usejackdaw.com.site/site/assets/css/style.css

@@ -5,11 +5,29 @@
   box-sizing: border-box;
 }
 
+:root {
+  --primary: #3498db;
+  --primary-dark: #2980b9;
+  --secondary: #9b59b6;
+  --dark: #2c3e50;
+  --darker: #1a252f;
+  --light: #ecf0f1;
+  --accent: #e74c3c;
+  --success: #2ecc71;
+  --gradient: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
+  --gradient-alt: linear-gradient(135deg, #f093fb 0%, #f5576c 100%);
+  --shadow-sm: 0 2px 4px rgba(0,0,0,0.1);
+  --shadow-md: 0 4px 6px rgba(0,0,0,0.1);
+  --shadow-lg: 0 10px 15px rgba(0,0,0,0.1);
+  --shadow-xl: 0 20px 25px rgba(0,0,0,0.15);
+}
+
 body {
   font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, Oxygen, Ubuntu, Cantarell, sans-serif;
   line-height: 1.6;
   color: #333;
-  background: #fff;
+  background: linear-gradient(to bottom, #ffffff 0%, #f8f9fa 100%);
+  min-height: 100vh;
 }
 
 /* Container */
@@ -21,10 +39,14 @@ body {
 
 /* Navigation */
 .navbar {
-  background: #2c3e50;
+  background: var(--gradient);
   color: white;
   padding: 1rem 0;
-  box-shadow: 0 2px 4px rgba(0,0,0,0.1);
+  box-shadow: var(--shadow-lg);
+  position: sticky;
+  top: 0;
+  z-index: 100;
+  backdrop-filter: blur(10px);
 }
 
 .navbar .container {
@@ -41,38 +63,85 @@ body {
   display: flex;
   align-items: center;
   gap: 0.75rem;
+  transition: transform 0.3s ease;
+}
+
+.nav-brand a:hover {
+  transform: scale(1.05);
 }
 
 .nav-brand .logo {
   height: 40px;
   width: auto;
+  filter: drop-shadow(0 2px 4px rgba(0,0,0,0.2));
+  transition: transform 0.3s ease;
+}
+
+.nav-brand a:hover .logo {
+  transform: rotate(-10deg);
 }
 
 .nav-menu {
   display: flex;
   list-style: none;
   gap: 2rem;
+  align-items: center;
+  margin: 0;
 }
 
 .nav-menu a {
   color: white;
   text-decoration: none;
-  transition: color 0.2s;
+  transition: all 0.3s ease;
+  padding: 0.5rem 1rem;
+  border-radius: 6px;
+  position: relative;
+  font-weight: 500;
+  display: inline-block;
+}
+
+.nav-menu a::after {
+  content: '';
+  position: absolute;
+  bottom: 0;
+  left: 50%;
+  width: 0;
+  height: 2px;
+  background: #667eea;
+  transition: all 0.3s ease;
+  transform: translateX(-50%);
 }
 
 .nav-menu a:hover {
-  color: #3498db;
+  background: white;
+  color: #667eea;
+  transform: translateY(-2px);
+  box-shadow: 0 2px 8px rgba(0,0,0,0.15);
+}
+
+.nav-menu a:hover::after {
+  width: 80%;
 }
 
 .nav-menu .github {
-  background: #3498db;
+  background: white;
+  color: #667eea;
   padding: 0.5rem 1rem;
-  border-radius: 4px;
+  border-radius: 6px;
+  font-weight: 600;
+  box-shadow: 0 2px 8px rgba(0,0,0,0.15);
+}
+
+.nav-menu .github::after {
+  display: none;
 }
 
 .nav-menu .github:hover {
-  background: #2980b9;
-  color: white;
+  background: rgba(255,255,255,0.95);
+  color: #764ba2;
+  transform: translateY(-2px);
+  box-shadow: 0 4px 12px rgba(0,0,0,0.2);
+  text-shadow: none;
 }
 
 /* Main Content */
@@ -82,7 +151,26 @@ main {
 }
 
 .content {
-  max-width: 800px;
+  max-width: 1000px;
+  background: white;
+  padding: 2rem;
+  border-radius: 12px;
+  box-shadow: var(--shadow-md);
+  margin: 0 auto 2rem;
+}
+
+/* Hero Section */
+.hero {
+  text-align: center;
+  padding: 4rem 0;
+  margin-bottom: 3rem;
+}
+
+.hero img {
+  max-width: 300px;
+  height: auto;
+  margin: 0 auto 2rem;
+  filter: drop-shadow(0 10px 20px rgba(0,0,0,0.1));
 }
 
 /* Typography */
@@ -91,18 +179,41 @@ h1, h2, h3, h4, h5, h6 {
   margin-bottom: 1rem;
   line-height: 1.2;
   color: #2c3e50;
+  font-weight: 800;
 }
 
 h1 {
   font-size: 2.5rem;
-  border-bottom: 3px solid #3498db;
   padding-bottom: 0.5rem;
+  position: relative;
+}
+
+h1::after {
+  content: '';
+  position: absolute;
+  bottom: 0;
+  left: 0;
+  width: 100px;
+  height: 4px;
+  background: var(--gradient);
+  border-radius: 2px;
 }
 
 h2 {
   font-size: 2rem;
-  border-bottom: 2px solid #ecf0f1;
   padding-bottom: 0.5rem;
+  position: relative;
+}
+
+h2::after {
+  content: '';
+  position: absolute;
+  bottom: 0;
+  left: 0;
+  width: 60px;
+  height: 3px;
+  background: var(--gradient);
+  border-radius: 2px;
 }
 
 h3 {
@@ -111,34 +222,66 @@ h3 {
 
 p {
   margin-bottom: 1rem;
+  line-height: 1.8;
+}
+
+strong {
+  color: var(--dark);
+  font-weight: 600;
 }
 
 a {
-  color: #3498db;
+  color: var(--primary);
   text-decoration: none;
+  position: relative;
+  transition: color 0.3s ease;
 }
 
 a:hover {
-  text-decoration: underline;
+  color: var(--primary-dark);
+}
+
+/* Feature Lists */
+ul li strong {
+  background: var(--gradient);
+  -webkit-background-clip: text;
+  -webkit-text-fill-color: transparent;
+  background-clip: text;
 }
 
 /* Code */
 code {
-  background: #f8f9fa;
-  padding: 0.2rem 0.4rem;
-  border-radius: 3px;
+  background: linear-gradient(135deg, #f5f7fa 0%, #c3cfe2 100%);
+  padding: 0.2rem 0.6rem;
+  border-radius: 6px;
   font-family: 'Monaco', 'Menlo', 'Consolas', monospace;
   font-size: 0.9em;
   color: #e83e8c;
+  font-weight: 600;
+  box-shadow: 0 2px 4px rgba(0,0,0,0.1);
 }
 
 pre {
   background: #2c3e50;
   color: #ecf0f1;
-  padding: 1.5rem;
-  border-radius: 6px;
+  padding: 2rem;
+  border-radius: 12px;
   overflow-x: auto;
   margin: 1.5rem 0;
+  box-shadow: var(--shadow-lg);
+  position: relative;
+  border: 1px solid rgba(102, 126, 234, 0.3);
+}
+
+pre::before {
+  content: '';
+  position: absolute;
+  top: 0;
+  left: 0;
+  right: 0;
+  height: 4px;
+  background: var(--gradient);
+  border-radius: 12px 12px 0 0;
 }
 
 pre code {
@@ -146,6 +289,9 @@ pre code {
   color: inherit;
   padding: 0;
   font-size: 0.9rem;
+  box-shadow: none;
+  position: relative;
+  z-index: 1;
 }
 
 /* Tables */
@@ -153,21 +299,26 @@ table {
   width: 100%;
   border-collapse: collapse;
   margin: 1.5rem 0;
+  box-shadow: var(--shadow-md);
+  border-radius: 8px;
+  overflow: hidden;
 }
 
 th, td {
-  padding: 0.75rem;
-  border: 1px solid #dee2e6;
+  padding: 1rem;
+  border: 1px solid #e9ecef;
   text-align: left;
 }
 
 th {
-  background: #f8f9fa;
+  background: var(--gradient);
+  color: white;
   font-weight: 600;
 }
 
 tr:hover {
-  background: #f8f9fa;
+  background: linear-gradient(to right, #f8f9fa 0%, #e9ecef 100%);
+  transition: background 0.3s ease;
 }
 
 /* Lists */
@@ -178,47 +329,90 @@ ul, ol {
 
 li {
   margin-bottom: 0.5rem;
+  padding-left: 0.5rem;
+}
+
+ul li::marker {
+  color: var(--primary);
+  font-weight: bold;
 }
 
 /* Blockquotes */
 blockquote {
-  border-left: 4px solid #3498db;
-  padding-left: 1.5rem;
+  border-left: 4px solid var(--primary);
+  padding: 1rem 1.5rem;
   margin: 1.5rem 0;
-  color: #666;
+  background: linear-gradient(to right, #f8f9fa 0%, #ffffff 100%);
+  border-radius: 0 8px 8px 0;
+  box-shadow: var(--shadow-sm);
   font-style: italic;
+  color: #555;
 }
 
 /* Horizontal Rule */
 hr {
   border: none;
-  border-top: 2px solid #ecf0f1;
-  margin: 2rem 0;
+  height: 3px;
+  background: var(--gradient);
+  margin: 3rem 0;
+  border-radius: 2px;
 }
 
 /* Footer */
 .footer {
-  background: #2c3e50;
+  background: var(--gradient);
   color: white;
-  padding: 2rem 0;
+  padding: 3rem 0;
   margin-top: 4rem;
   text-align: center;
+  box-shadow: 0 -4px 6px rgba(0,0,0,0.1);
 }
 
 .footer a {
-  color: #3498db;
+  color: white;
+  text-decoration: underline;
+  transition: all 0.3s ease;
 }
 
 .footer a:hover {
-  color: #5dade2;
+  transform: translateY(-2px);
+  text-shadow: 0 2px 4px rgba(0,0,0,0.2);
 }
 
 .copyright {
   margin-top: 1rem;
-  color: #95a5a6;
+  color: rgba(255,255,255,0.8);
   font-size: 0.9rem;
 }
 
+/* Badges & Tags */
+.badge {
+  display: inline-block;
+  padding: 0.25rem 0.75rem;
+  background: var(--gradient);
+  color: white;
+  border-radius: 20px;
+  font-size: 0.85rem;
+  font-weight: 600;
+  box-shadow: var(--shadow-sm);
+  margin: 0.25rem;
+}
+
+/* Cards */
+.card {
+  background: white;
+  border-radius: 12px;
+  padding: 2rem;
+  box-shadow: var(--shadow-md);
+  transition: all 0.3s ease;
+  margin-bottom: 2rem;
+}
+
+.card:hover {
+  transform: translateY(-4px);
+  box-shadow: var(--shadow-xl);
+}
+
 /* Responsive */
 @media (max-width: 768px) {
   .navbar .container {
@@ -239,4 +433,32 @@ hr {
   h2 {
     font-size: 1.5rem;
   }
+  
+  .content {
+    padding: 1.5rem;
+  }
+  
+  .hero {
+    padding: 2rem 0;
+  }
+  
+  .hero img {
+    max-width: 200px;
+  }
+}
+
+/* Animations */
+@keyframes fadeIn {
+  from {
+    opacity: 0;
+    transform: translateY(20px);
+  }
+  to {
+    opacity: 1;
+    transform: translateY(0);
+  }
+}
+
+main {
+  animation: fadeIn 0.6s ease-out;
 }

data/usejackdaw.com.site/site/src/content.page.md

@@ -143,26 +143,12 @@ You can include HTML:
 The first paragraph becomes the excerpt:
 
 ```markdown
----
-title: My Post
----
 
 This paragraph is automatically used as the excerpt.
 
 This is regular content.
 ```
 
-Or set it manually:
-
-```markdown
----
-title: My Post
-excerpt: Custom excerpt here
----
-
-Content...
-```
-
 ## Nested Content
 
 Organize with directories:

data/usejackdaw.com.site/site/src/getting-started.page.md

@@ -150,10 +150,6 @@ jackdaw create blog "Building Fast Sites"
 3. **Edit the content** (`site/src/2026-01-06-building-fast-sites.blog.md`):
 
 ```markdown
----
-title: Building Fast Sites
-excerpt: Learn how to build lightning-fast static sites
----
 
 # Building Fast Sites
 

data/usejackdaw.com.site/site/src/index.page.md

@@ -1,12 +1,14 @@
-<div style="text-align: center; margin: 2rem 0;">
-  <img src="/jackdaw.png" alt="Jackdaw" style="max-width: 300px; height: auto;">
-</div>
+<div class="hero" markdown="1">
+
+<img src="/jackdaw.png" alt="Jackdaw">
+
+<p style="font-size: 1.3rem; color: #666; margin: 1rem 0;"><strong>Lightning-fast static site generator for Ruby</strong></p>
 
-# Jackdaw ⚡️
+</div>
 
-**Lightning-fast static site generator for Ruby**
+<div class="content" markdown="1">
 
-Jackdaw is a minimal, fast static site generator that emphasizes:
+Jackdaw is a minimal, fast static site generator that emphasises:
 
 - **Speed** - Build 600 files in under 1 second with parallel processing
 - **Convention over configuration** - Zero config required to get started
@@ -27,25 +29,33 @@ cd my-blog.site
 jackdaw serve
 ```
 
+</div>
+
+<div class="content" markdown="1">
+
 ## Why Jackdaw?
 
 ### ⚡️ Blazing Fast
+
 - Parallel processing for maximum speed
 - Incremental builds - only rebuild what changed
 - 693 files/second full build, 16,280 files/second incremental
 
 ### 🎯 Convention Over Configuration
+
 - No configuration files needed
 - Intuitive project structure
 - Smart defaults that just work
 
 ### 🛠 Great Developer Experience
+
 - Live reload development server
 - Helpful CLI commands
 - Clear error messages
 - Ruby 4.0 ready
 
 ### 📦 Everything Included
+
 - Markdown with GitHub-flavored syntax
 - Syntax highlighting with Rouge
 - Partials and layouts
@@ -53,6 +63,10 @@ jackdaw serve
 - Sitemap generation
 - SEO helpers
 
+</div>
+
+<div class="content" markdown="1">
+
 ## Key Features
 
 - **Markdown** - Write content in Markdown
@@ -65,6 +79,10 @@ jackdaw serve
 - **Sitemap** - SEO-friendly sitemap.xml
 - **Zero Config** - Convention over configuration
 
+</div>
+
+<div class="content" markdown="1">
+
 ## Learn More
 
 - [Installation](/installation.html) - Get Jackdaw up and running
@@ -73,6 +91,10 @@ jackdaw serve
 - [Templates](/templates.html) - Master templating
 - [Content](/content.html) - Write and organize content
 
+</div>
+
+<div class="content" markdown="1">
+
 ## Performance Benchmarks
 
 | Operation | Time | Files/Second |
@@ -81,6 +103,8 @@ jackdaw serve
 | Incremental build | 0.04s | 16,280 |
 | Cold start | 0.69s | 870 |
 
+</div>
+
 ## Open Source
 
 Jackdaw is MIT licensed and available on [GitHub](https://github.com/yourusername/jackdaw).

data/usejackdaw.com.site/site/templates/layout.html.erb

@@ -7,6 +7,26 @@
   <% if defined?(description) && description %>
     <meta name="description" content="<%= description %>">
   <% end %>
+  
+  <!-- Favicons -->
+  <link rel="apple-touch-icon" sizes="57x57" href="/favicon/apple-icon-57x57.png">
+  <link rel="apple-touch-icon" sizes="60x60" href="/favicon/apple-icon-60x60.png">
+  <link rel="apple-touch-icon" sizes="72x72" href="/favicon/apple-icon-72x72.png">
+  <link rel="apple-touch-icon" sizes="76x76" href="/favicon/apple-icon-76x76.png">
+  <link rel="apple-touch-icon" sizes="114x114" href="/favicon/apple-icon-114x114.png">
+  <link rel="apple-touch-icon" sizes="120x120" href="/favicon/apple-icon-120x120.png">
+  <link rel="apple-touch-icon" sizes="144x144" href="/favicon/apple-icon-144x144.png">
+  <link rel="apple-touch-icon" sizes="152x152" href="/favicon/apple-icon-152x152.png">
+  <link rel="apple-touch-icon" sizes="180x180" href="/favicon/apple-icon-180x180.png">
+  <link rel="icon" type="image/png" sizes="192x192"  href="/favicon/android-icon-192x192.png">
+  <link rel="icon" type="image/png" sizes="32x32" href="/favicon/favicon-32x32.png">
+  <link rel="icon" type="image/png" sizes="96x96" href="/favicon/favicon-96x96.png">
+  <link rel="icon" type="image/png" sizes="16x16" href="/favicon/favicon-16x16.png">
+  <link rel="manifest" href="/favicon/manifest.json">
+  <meta name="msapplication-TileColor" content="#667eea">
+  <meta name="msapplication-TileImage" content="/favicon/ms-icon-144x144.png">
+  <meta name="theme-color" content="#667eea">
+  
   <link rel="stylesheet" href="/css/style.css">
   <link rel="alternate" type="application/rss+xml" title="Jackdaw RSS" href="/feed.xml">
 </head>

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: jackdaw
 version: !ruby/object:Gem::Version
-  version: 1.0.3
+  version: 1.0.4
 platform: ruby
 authors:
 - Nigel Brookes-Thomas
@@ -51,6 +51,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '3.9'
+- !ruby/object:Gem::Dependency
+  name: logger
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.7'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.7'
 - !ruby/object:Gem::Dependency
   name: parallel
   requirement: !ruby/object:Gem::Requirement
@@ -131,12 +145,10 @@ executables:
 extensions: []
 extra_rdoc_files: []
 files:
-- ".DS_Store"
 - ".rubocop.yml"
 - CHANGELOG.md
 - README.md
 - Rakefile
-- TODO.md
 - benchmark.rb
 - exe/jackdaw
 - lib/jackdaw.rb
@@ -160,6 +172,8 @@ files:
 - lib/jackdaw/watcher.rb
 - sig/jackdaw.rbs
 - usejackdaw.com.site/.gitignore
+- usejackdaw.com.site/Gemfile
+- usejackdaw.com.site/Gemfile.lock
 - usejackdaw.com.site/site/assets/css/style.css
 - usejackdaw.com.site/site/assets/favicon/android-icon-144x144.png
 - usejackdaw.com.site/site/assets/favicon/android-icon-192x192.png

data/TODO.md

@@ -1,167 +0,0 @@
-# Jackdaw - Static Site Generator TODO
-
-## Project Overview
-A fast, incremental static site generator with folder-based organization using Thor for CLI.
-
----
-
-## Phase 1: Project Setup
-- [x] Add Thor gem dependency to gemspec
-- [x] Add development dependencies (rspec, rubocop, etc.)
-- [x] Create basic CLI structure in exe/jackdaw
-- [x] Set up Thor CLI class structure
-- [x] Add any additional dependencies (for markdown parsing, file watching, etc.)
-
-## Phase 2: Core File System Structure
-- [x] Define standard project structure (site/ directory)
-- [x] Create file watcher/tracker for incremental builds
-- [x] Implement directory scanner
-- [x] Create file type registry (.page, .post, etc.)
-- [x] Build metadata extractor from file structure (path, name, dates)
-- [x] Extract metadata from first heading as title (H1)
-- [x] Implement content type handlers
-  - [x] Page handler
-  - [x] Post handler
-  - [x] Asset handler
-
-## Phase 3: Template System
-- [x] Design template engine integration (ERB)
-- [x] Implement template loader from templates/ directory
-- [x] Create template context builder
-- [x] Add layout/partial support
-- [x] Implement template caching for performance
-
-## Phase 4: Content Processing
-- [x] Implement markdown parser integration
-- [x] Create content preprocessor pipeline
-- [x] Extract metadata from filename (dates, slugs)
-- [x] Extract title from first H1 in content
-- [x] Derive metadata from folder structure and hierarchy
-- [x] Implement content transformation pipeline
-- [x] Add syntax highlighting support (Rouge)
-
-## Phase 5: Build System
-- [x] Design dependency graph for incremental builds
-- [x] Implement file change detection
-- [x] Create build cache system
-- [x] Build output directory management (public/)
-- [x] Implement parallel processing for speed
-- [x] Add build statistics/reporting
-- [x] Create clean build option
-
-## Phase 6: CLI Commands - Build
-- [x] Implement `jackdaw build` command
-  - [x] Full build option
-  - [x] Incremental build (default)
-  - [x] Watch mode option (deferred to serve command)
-  - [x] Verbose/debug output
-  - [x] Clean option
-- [x] Add build configuration loading (skipped - convention over configuration)
-- [x] Implement error handling and reporting
-
-## Phase 7: CLI Commands - Serve
-- [x] Implement `jackdaw serve` command
-- [x] Choose and integrate web server (Puma with Rack)
-- [x] Add live reload support (polling-based with JavaScript)
-- [x] Implement file watching for auto-rebuild (Listen gem)
-- [x] Configure port and host options
-- [x] Add middleware for development (StaticFileServer + LiveReloadMiddleware)
-- [x] Beautiful CLI output with rebuild stats
-- [x] Graceful shutdown handling (Ctrl+C)
-
-## Phase 8: CLI Commands - Create
-- [x] Implement `jackdaw create <template> <name>` command
-- [x] Create template scaffolding system
-- [x] Add default built-in templates:
-  - [x] `page` template (basic page.html.erb)
-  - [x] `blog` template (blog post with date handling)
-- [x] Support arbitrary user-defined templates in templates/ directory
-- [x] Discover available templates from templates/ folder
-- [x] Add date/timestamp handling for posts (auto-prefix for blog/post/article/news)
-- [x] Allow users to add custom templates by creating template files
-- [x] Implement `jackdaw template list` command
-- [x] Add --dated and --no-date flags for override control
-- [x] Support nested paths (e.g., `jackdaw create page company/about`)
-- [x] Validate template existence before creating files
-- [x] Add Builder warnings for missing templates
-
-## Phase 9: Configuration System
-- [x] Skipped - Maintaining config-less, convention-over-configuration approach
-
-## Phase 10: Asset Handling
-- [x] Implement asset copying
-- [x] Keeping minimal - assets copied as-is for speed and simplicity
-
-## Phase 11: Performance Optimization
-- [x] Profile build performance
-- [x] Implement multi-threading for file processing (Parallel gem)
-- [x] Optimize file I/O operations (incremental builds with mtime checks)
-- [ ] Add memory usage optimization
-- [x] Benchmark against common static site generators
-  - Small (30 files): 164 files/sec clean, 5821 files/sec incremental
-  - Medium (150 files): 428 files/sec clean, 12343 files/sec incremental
-  - Large (600 files): 693 files/sec clean, 16280 files/sec incremental
-  - Incremental builds: 6-18x faster than clean builds
-- [x] Cache template compilation (ERB caching in Renderer)
-- [x] Optimize dependency graph traversal (mtime-based change detection)
-
-## Phase 12: Documentation
-- [x] Write comprehensive README with quickstart guide
-- [x] Document CLI commands and options (in README)
-- [x] Create project structure guide (in README)
-- [x] Write template documentation (in README)
-- [x] Add configuration reference (N/A - convention-based, no config needed)
-- [x] Add troubleshooting guide (in README)
-- [x] Consolidate all require statements to jackdaw.rb
-- [x] Add comprehensive code comments to jackdaw.rb and project.rb
-- [ ] Add code comments to remaining core files
-- [ ] Create example site (basic example already created by `jackdaw new`)
-
-## Phase 13: Testing
-- [x] Unit tests for core components (Project, FileTypes, Scanner)
-- [x] Unit tests for Renderer (21 tests)
-- [x] Integration tests for Builder (18 tests)
-- [x] End-to-end build tests (10 comprehensive workflow tests)
-- [x] Test helper infrastructure with fixtures
-- [x] Performance benchmarks (completed in Phase 11)
-- **Total: 99 passing tests, 0 failures**
-
-## Phase 14: Polish & Release
-- [x] Code cleanup and refactoring (reduced complexity in Build command)
-- [x] RuboCop compliance (all files passing, 0 offenses)
-- [x] Error message improvements (beautiful CLI output with colors)
-- [x] Add progress indicators (build stats, rebuild notifications)
-- [x] Version 1.0.0 release preparation
-  - [x] Updated version to 1.0.0
-  - [x] Created comprehensive CHANGELOG.md
-  - [x] Updated gemspec with proper metadata
-  - [x] All 99 tests passing
-- [ ] Publish to RubyGems (deferred)
-
-## Phase 15: Essential Web Features
-- [ ] RSS/Atom feed generation (for blog posts)
-- [ ] Sitemap.xml generation (for SEO)
-- [ ] SEO meta tag helpers (Open Graph, Twitter Cards)
-
----
-
-## Nice-to-Have Features (Future)
-- [ ] Search index generation (JSON for client-side search)
-- [ ] Git integration (simple deploy command wrapper)
-
-## Won't Implement (Against Project Philosophy)
-- ~~Multiple template engine support~~ - ERB is sufficient, adds complexity
-- ~~Image lazy loading helpers~~ - Can be done in templates/CSS
-- ~~i18n/l10n support~~ - Too complex, users can handle with folder structure
-- ~~CloudFlare/Netlify deployment helpers~~ - Too specific, manual deploy is simple enough
-
----
-
-## Technical Decisions to Make
-- [x] Template engine: ERB (built-in, fast, zero dependencies)
-- [x] Markdown parser: Kramdown (pure Ruby, no compilation issues)
-- [x] Server: Puma (fast, industry standard)
-- [x] File watching: Listen gem (reliable, cross-platform)
-- [ ] Config format: YAML vs TOML vs Ruby DSL? (may skip - convention over configuration)
-- [x] Incremental build strategy: Timestamp-based (mtime checks)
-- [x] Metadata approach: Convention-based (NO frontmatter, derive from structure/content)