CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

Project Overview

This is a Jekyll-based static site about cryptocurrency investing, built with:

• Jekyll 4.2.1 (Ruby static site generator)
• Bootstrap CSS framework
• Reveal.js for presentations (in /slides)
• GitHub Pages deployment (domain: cryptoinvesting.art)

Essential Commands

Jekyll Development

# Install dependencies
bundle install

# Start development server (http://localhost:4000)
bundle exec jekyll serve

# Build static site (output to _site/)
bundle exec jekyll build

# Create new blog post
bundle exec jekyll post "Post Title"

# Create new page
bundle exec jekyll page "Page Title"

# Create new draft
bundle exec jekyll draft "Draft Title"

Slides Development (Reveal.js)

# Navigate to slides directory first
cd slides

# Install dependencies
npm install

# Start Reveal.js server
npm start

# Build presentations
npm run build

# Run tests
npm test

Architecture & Structure

Content Organization

• _posts/: Blog posts in Markdown (YYYY-MM-DD-title.md format)
• _data/: YAML/JSON data files for structured content
• _layouts/: Page templates (default, page, page_org, post)
• _includes/: Reusable components (dropcap.html, youtube.html, etc.)
• tokens/, exchanges/, referral-codes/: Category-specific content
• _site/: Generated static files (do not edit directly)

Key Configurations

• _config.yml: Site settings, plugin configuration, build options
• Jekyll plugins: feed, paginate, archives, sitemap, seo-tag, compose
• External services: Disqus comments (just2me2), formsubmit.io for forms

Layout System

• page: Default layout with transparent nav (white text), defined width
• page_org: Opaque nav (black text), typically for blog posts
• Posts can set transparent_nav: true to override
• Posts support trending property for featuring (higher value = more prominent)

Styling Guidelines

• Tables require Bootstrap classes: {:.table .table-responsive}
• Dropcaps: <span class="dropcap circle bg-yellow">X</span>
• YouTube embeds: `<iframe width="560" height="315" src="https://www.youtube.com/embed/VIDEO_ID" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>

`

• Clipboard copy buttons use class btn-copy with data-clipboard-text
• Icons from jam-icons.com

Content Guidelines

• Posts require at least one category (prefer single category)
• First 25 words of posts are important for SEO/search
• Token marketcaps use predefined tiers: $10M, $50M, $100M, $500M, $1B, etc.
• All forms submit via formsubmit.io

Development Workflow

1. Always run bundle exec jekyll serve for local development
2. Changes to _config.yml require server restart
3. Generated _site/ folder should not be committed
4. Use Jekyll Compose commands for creating content
5. Test responsive design - site uses Bootstrap responsive utilities

Useful Commands

Working with Screenshots

# Copy screenshots with spaces in filename using wildcards
cp /Users/junda/Desktop/Screenshot*2025-07-17*at*9.21.36*AM.png /path/to/destination.png

# Resize and convert to JPG in one command
sips -Z 1200 -s format jpeg -s formatOptions 85 image.png -o image.jpg