Project Overview

This is the Tint technical blog built with Jekyll and hosted on GitHub Pages at tech.tint.ai. It’s a static site generator that converts Markdown posts into a professional engineering blog.

Development Commands

Local Development

# Start the development server (runs Jekyll in Docker on http://localhost:4000)
make start

# Stop the development server
make stop

# View container logs
make logs

Direct Jekyll Commands (inside container)

# Build the site
jekyll build

# Serve with live reload
jekyll serve --host 0.0.0.0 --watch --force_polling --livereload

Architecture & Structure

Key Directories

• _posts/: Blog posts in YYYY-MM-DD-slug.md format
• _layouts/: HTML templates (default.html wraps all pages, post.html for blog posts)
• assets/images/: Hero images organized by post slug
• assets/css/: SCSS stylesheets (main.scss imports all partials)

Adding New Blog Posts

See README.md for detailed instructions on adding blog posts.

Critical requirements:

• The author field in post front matter must be an email address (e.g., author: user@tint.ai), NOT a display name
• Authors must be defined in _data/authors.yml before creating posts
• Two hero images are required: hero.png (main) and hero-social.png (1200x630px for social media)

Important Configuration

• _config.yml: Site metadata, plugins, and Jekyll settings
• Dockerfile: Ruby 3.1 Alpine container for consistent development environment
• CNAME: Custom domain configuration (tech.tint.ai)

Deployment

The site automatically deploys to GitHub Pages when changes are pushed to the main branch. No manual build step required.

Styling Guidelines

• Uses Inter and Red Hat Display fonts
• Card-based layout for blog post grid
• Responsive design with mobile-first approach
• Color scheme defined in _variables.scss

Common Tasks

• Update site metadata: Edit _config.yml
• Modify layout: Edit files in _layouts/
• Change styling: Edit SCSS files in assets/css/
• Add images: Place in assets/images/[post-slug]/