{ Personal } is a free, responsive Jekyll theme with a minimal aesthetic — perfect for your personal blog and portfolio. Tell your story with a beautiful timeline and share your thoughts through an elegant blog.

🔗 Live Demo

1. Fork this repository
2. Rename the forked repository to yourusername.github.io
3. Update _config.yml:

   url: "https://yourusername.github.io"
   baseurl: ""

4. Commit your changes — once the GitHub Action succeeds, your site will be live at https://yourusername.github.io

No need to install Ruby or dependencies locally:

docker-compose up --build

The site will be available at http://localhost:4000.

Prerequisites:

• Ruby 3.1.1 (use rbenv or rvm for version management)
• Bundler

Installation:

# Install dependencies
bundle install

# Start the development server with live reload
bundle exec jekyll serve --watch --livereload

The site will be available at http://localhost:4000.

All site configuration is managed through _config.yml. Key settings include:

• 🎨 Modern, minimal aesthetic with white-on-black text
• 🌗 Dark mode with a theme toggle button — preference saved in localStorage
• 📱 Fully responsive — looks great on mobile, tablet, and desktop
• 🖼️ Customizable header with dynamic text and profile image

• 📅 Tell your story with a sleek timeline
• 🖼️ Add images, dates, and descriptions for each milestone

• ✍️ Full-featured blog with archive page
• 🏷️ Hashtags and categories support
• 💬 Comments integration (Cusdis) with dark/light theme sync
• 🔗 Social share buttons (X, Facebook, LinkedIn, Reddit, Hacker News, and more)
• 🎨 Syntax highlighting for code blocks
• 📊 Mermaid diagram support
• 📡 RSS feed

• 📈 Google Analytics integration
• 🗺️ Automatic sitemap generation
• 🔍 SEO-friendly meta tags

• 🍪 Cookie consent banner
• 🛡️ Email harvesting protection

Detailed documentation is available as blog posts on the demo site.

This project uses Conventional Commits to generate release notes automatically.

To enforce conventional commits locally, run:

sh .githooks/setup.sh

This will configure git to validate your commit messages before each commit.

<type>[optional scope]: <description>

Allowed types: feat, fix, docs, style, refactor, perf, test, build, ci, chore, revert

Examples:

feat: add dark mode support
fix(comments): resolve Cusdis loading issue
docs: update installation instructions

This theme is a fork of Timeline, which is a mashup of:

• Grayscale by Start Bootstrap
• Agency Jekyll Theme

This project is licensed under the Apache License 2.0 — see the LICENSE file for details.