A Rails 8 blog engine with analytics dashboard, newsletter integration, and content management.

• Ruby 3.4.7
• Rails 8.1.1
• PostgreSQL 14+
• LibVips (image processing)

# Install dependencies
bundle install

# Setup database
bundle exec rails db:prepare

# Start server
bundle exec rails s

# Start environment
docker compose -f docker-compose.yml -f docker-compose.dev.yml up -d

# View logs
docker compose -f docker-compose.yml -f docker-compose.dev.yml logs -f web

# Run migrations
docker compose -f docker-compose.yml -f docker-compose.dev.yml exec web bundle exec rails db:migrate

# Stop
docker compose -f docker-compose.yml -f docker-compose.dev.yml down

Copy .env.example to .env and configure:

cp .env.example .env

Required environment variables:

• POSTGRES_USER - Database username
• POSTGRES_PASSWORD - Database password
• POSTGRES_DB - Database name
• SECRET_KEY_BASE - Rails secret (generate with rails secret)
• RAILS_MASTER_KEY - For credentials decryption

# Run all tests
bundle exec rspec

# Run specific test
bundle exec rspec spec/path/to_spec.rb:LINE_NUMBER

# Deploy
./bin/deploy-docker-compose

# Manual start
docker compose --env-file .env.production up -d

# View logs
docker compose --env-file .env.production logs -f web

bundle exec cap production deploy

Database migrations run automatically during deployment.

• Content: Rich text editor (Trix/ActionText), draft system, tag management
• Analytics: Visit tracking, newsletter conversion funnel, device/browser stats
• SEO: Structured data, XML sitemaps, meta tags
• Security: Bot detection, spam filtering, CSRF protection

• Rails 8.1 with PostgreSQL
• Bootstrap 5.3 + Stimulus JS
• Propshaft + Dartsass
• ActionText + ActiveStorage
• Chartkick for analytics
• Devise authentication
• RSpec for testing

• Follow Rails conventions (snake_case methods, CamelCase classes)
• Add frozen_string_literal: true to Ruby files
• Protect views against nil with || [] or || {} patterns
• Use Stimulus for JavaScript behavior

MIT License - see LICENSE for details.