Configuration

Choose a theme, customize colors or stick with the defaults and go build. 🚀

General

Only used for presentational purposes.

Used in mailers and pages.


Theme

Your active theme: Hound

Theme FAQs

What is a theme?

A theme is a set of pre-built components and optional pages used to build a realistic Rails app. Themes make it easy to get a massive head start on the design and UX of your application but don't come with all the logic.

Refer to railsui.com/themes for a good reference for Rails UI themes and their intended use case. We're always working on adding more.

Can I change my theme? New

Yes, you can change your theme at any time. We strive to make this as easy as possible but it's not without some caveats.

Here's what happens when you change your theme:

  • Rails UI generated pages (app/views/rui) and images (app/assets/images/railsui) are replaced with the newly chosen theme's files.
    • Tip: To keep using any pages in the app/views/rui directory or images in the app/assets/images/railsui directory, copy these files to a backup location or elsewhere in your app before making changes. For best results, consider pages as code snippets for your app and treat them as read-only.
  • All CSS in app/assets/stylesheets/railsui is replaced with the newly chosen theme's CSS files and Tailwind CSS theme configurations.

Color

Rails UI includes two custom colors in addtion to Tailwind CSS 4's color palette: primary and secondary.

theme.css

app/assets/stylesheets/railsui/theme.css

@theme {
  --font-sans: "Inter", ui-sans-serif, system-ui, sans-serif,
    "Apple Color Emoji", "Segoe UI Emoji", "Segoe UI Symbol", "Noto Color Emoji";

  --color-primary-50: oklch(0.98 0.02 15); /* #fef2f2 */
  --color-primary-100: oklch(0.94 0.05 15); /* #fee2e2 */
  --color-primary-200: oklch(0.87 0.09 15); /* #fecaca */
  --color-primary-300: oklch(0.76 0.15 15); /* #fca5a5 */
  --color-primary-400: oklch(0.64 0.22 15); /* #f87171 */
  --color-primary-500: oklch(0.55 0.28 15); /* #ef4444 */
  --color-primary-600: oklch(0.42 0.30 15); /* #bd0906 */
  --color-primary-700: oklch(0.35 0.25 15); /* #991b1b */
  --color-primary-800: oklch(0.28 0.20 15); /* #7f1d1d */
  --color-primary-900: oklch(0.23 0.15 15); /* #651515 */
  --color-primary-950: oklch(0.15 0.10 15); /* #450a0a */

  --color-secondary-50: oklch(0.98 0.00 0); /* #fafafa */
  --color-secondary-100: oklch(0.94 0.00 0); /* #f0f0f0 */
  --color-secondary-200: oklch(0.86 0.00 0); /* #e0e0e0 */
  --color-secondary-300: oklch(0.78 0.00 0); /* #c8c8c8 */
  --color-secondary-400: oklch(0.68 0.00 0); /* #a8a8a8 */
  --color-secondary-500: oklch(0.59 0.00 0); /* #989898 */
  --color-secondary-600: oklch(0.49 0.00 0); /* #808080 */
  --color-secondary-700: oklch(0.40 0.00 0); /* #676767 */
  --color-secondary-800: oklch(0.29 0.00 0); /* #484848 */
  --color-secondary-900: oklch(0.22 0.00 0); /* #373737 */
  --color-secondary-950: oklch(0.09 0.00 0); /* #090909 */

  --animate-toast-from-right: toast-from-right 0.5s
    cubic-bezier(0.68, -0.55, 0.27, 1.55);
  --animate-toast-from-left: toast-from-left 0.5s
    cubic-bezier(0.68, -0.55, 0.27, 1.55);

  @keyframes toast-from-right {
    0% {
      transform: translateX(50%);
      opacity: 0%;
    }

    100% {
      transform: translateX(0);
      opacity: 100%;
    }
  }

  @keyframes toast-from-left {
    0% {
      transform: translateX(-50%);
      opacity: 0%;
    }

    100% {
      transform: translateX(0);
      opacity: 100%;
    }
  }
}

@layer base {
  *,
  ::after,
  ::before,
  ::backdrop,
  ::file-selector-button {
    border-color: var(--color-gray-200, currentColor);
  }
}

@plugin "@tailwindcss/typography";

/* Keep: Include Rails UI content paths */
@config "../../stylesheets/railsui/tailwind.config.js";

The contents of the app/assets/stylesheets/railsui/theme.css file is displayed above for Hound, your active theme. To customize this file, make a copy and update the @import path inside your main application CSS file to reference back to it. Use Tailwind's theme variables guide to extend this file.

I recommend this tool for generating unique colors. Hex colors are acceptable. For a wider gamut you could reach for okchl following in the footsteps of Tailwind CSS v4.

Best practices

To customize this file, make a copy and update the @import path inside your main application CSS file to reference back to it. Changing your Rails UI theme will override this file.


Pages

Prototype rapidly with ready-made pages that look great with the Hound theme.

Company or organization about page.

Marketing

SaaS-like pricing; 3 plans types by default.

Marketing

Admin dashboard for a CRM type of tool.

Admin

Projects index view

Admin

The detail view of a given project

Admin

A message view for inbound and outgoing messages within the app.

Admin

The detail view of a given message.

Admin

Assignments view for a current user account.

Admin

Calendar view for an example events page.

Admin

User view of all people in the app.

Admin

A profile view with activity for an individual user.

Admin

A global activity view for a team.

Admin

A settings view for the account.

Admin

Notification controls for a given account.

Admin

A billing page used to manage a subscription and seat count.

Admin

A team management view.

Admin

A view for managing integrations and their respective states.

Admin

Adding pages

Installed pages are found inside the app/views/rui/pages folder.

Best practices

Pages are a starting point. Copy them to other views you're working on and make changes there as opposed to directly inside the app/views/rui/pages directory. Treat this directory as read-only. Changing your Rails UI configuration will override the directory.

Saving will overwrite your existing configuration and pages while preserving your color settings. Any necessary dependencies will be installed, and the app will automatically restart.

Saving changes...

This could take a few moments