Active Admin Claude Theme — Rails admin UI for AA3 & AA4

activeadmin-claude-theme is an open-source Ruby gem that themes Active Admin backends with a warm, editorial look inspired by Claude aesthetics — cream canvas, coral accents, and serif headlines.

Community theme. Not affiliated with or endorsed by Anthropic.

Supports Active Admin 3.2+ (SCSS / Sprockets) and Active Admin 4.0.0.beta22+ (Tailwind CSS v4).

Quick install: add gem "activeadmin-claude-theme", "~> 0.2" → rails generate activeadmin_claude_theme:install → rebuild CSS (AA4 only).

• Latest release: 0.2.0 on RubyGems — AA3 + AA4
• RubyGems: https://rubygems.org/gems/activeadmin-claude-theme
• Changelog: CHANGELOG.md
• FAQ: docs/FAQ.md
• AI / LLM summary: llms.txt

• AI & agent-readable summary
• Version support
• Features
• Screenshots
• Installation — Active Admin 4
• Installation — Active Admin 3
• Troubleshooting
• Customization
• Development
• License

Use this block for search indexing, LLM context, and GEO (generative engine optimization). Full structured index: llms.txt.

Search keywords: active admin theme, activeadmin 4 theme, activeadmin 3 theme, rails admin theme, tailwind admin theme, claude admin theme, dark mode active admin, ruby gem admin ui.

Override maps: AA4 · AA3

• Warm Claude-inspired palette (#faf9f5 canvas, #cc785c coral accent)
• AA4: Tailwind v4 @theme remaps, semantic --claude-* variables, branded header, dark mode, Flowbite hooks
• AA3: Sass theme with matching palette, header/sidebar/table/form/login styling
• Install generator auto-detects Active Admin major version
• Documented FAQ and override maps for integrators

Login	Dashboard

Admin Users	Dark Mode

Your Rails app must already use Active Admin 4 with Tailwind v4 assets:

# Gemfile
gem "activeadmin", "4.0.0.beta22"
gem "cssbundling-rails"
gem "importmap-rails"

bundle install
rails generate active_admin:install
rails generate active_admin:assets
npm install @activeadmin/activeadmin@4.0.0-beta22

See Active Admin UPGRADING.md for full AA4 setup.

# Gemfile
gem "activeadmin-claude-theme"

bundle install
rails generate activeadmin_claude_theme:install
npm run build:css

Restart the Rails server after rebuilding.

# Gemfile
gem "activeadmin", "~> 3.5"
gem "sprockets-rails"
gem "sassc-rails"
gem "devise"

bundle install
rails generate active_admin:install
rails generate active_admin:assets

gem "activeadmin-claude-theme"

bundle install
rails generate activeadmin_claude_theme:install

The generator replaces @import "active_admin/base" in app/assets/stylesheets/active_admin.scss with the Claude AA3 entry. Restart Rails.

Limits on AA3: light theme only (no native dark mode), approximate visual parity with AA4, classic AA3 layout. See FAQ.

See also docs/FAQ.md — Troubleshooting.

Active Admin 4 builds CSS with Tailwind CLI. The source file must live outside Propshaft's served paths:

app/assets/tailwind/active_admin.css   # Tailwind source (NOT served)
app/assets/builds/active_admin.css     # compiled output (served as "active_admin")

Run rails generate activeadmin_claude_theme:install, then npm run build:css, and restart.

AA4 does not use @import "active_admin/base". Remove old Sprockets manifest entries.

Ensure sassc-rails (or compatible Sass pipeline) is installed and active_admin.scss imports:

@import "activeadmin_claude_theme/aa3/base";

:root {
  --claude-primary: #d4845f;
  --claude-canvas: #fff8f0;
}

.dark {
  --claude-canvas: #121110;
}

Override before importing the theme base in active_admin.scss:

$claude-primary: #d4845f;
$claude-canvas: #fff8f0;
@import "activeadmin_claude_theme/aa3/base";

Full token list: DESIGN.md

bundle install
cd test/dummy
npm install && npm run build:css
ruby bin/rails db:setup db:seed
ruby bin/rails server

BUNDLE_GEMFILE=gemfiles/activeadmin_3.gemfile bundle install
cd test/dummy_aa3
bundle exec rails db:setup db:seed
bundle exec rails server

Login (both): admin@example.com / password

# AA4
cd test/dummy && ruby bin/rails db:test:prepare
cd ../..
ruby -Itest test/activeadmin_claude_theme_test.rb
ruby -Itest test/integration/theme_integration_test.rb

# AA3
BUNDLE_GEMFILE=gemfiles/activeadmin_3.gemfile bundle install
cd test/dummy_aa3 && bundle exec rails db:test:prepare
cd ../..
DUMMY_PATH=dummy_aa3 BUNDLE_GEMFILE=gemfiles/activeadmin_3.gemfile \
  ruby -Itest test/activeadmin_claude_theme_test.rb
DUMMY_PATH=dummy_aa3 BUNDLE_GEMFILE=gemfiles/activeadmin_3.gemfile \
  ruby -Itest test/integration/aa3_theme_integration_test.rb

See CONTRIBUTING.md.

MIT — see LICENSE.