Skip to content
Nitro Kitv2.0.0.alpha.4

Search gallery…

IntroductionGalleryAgent guideGalleryHuman guideGalleryColorsFoundations · ThemeTypographyFoundations · ThemeSpacing & sizingFoundations · ThemeEffectsFoundations · ThemeButtonComponents · ActionsButton groupComponents · ActionsButton toComponents · ActionsAppearance pickerComponents · FormsCheckboxComponents · FormsCheckbox groupComponents · FormsComboboxComponents · FormsControl groupComponents · FormsDropzoneComponents · FormsFieldComponents · FormsField groupComponents · FormsFieldsetComponents · FormsInputComponents · FormsLabelComponents · FormsRadio buttonComponents · FormsRadio button groupComponents · FormsRich text areaComponents · FormsSelectComponents · FormsSwitchComponents · FormsTextareaComponents · FormsCommand paletteComponents · OverlaysDialogComponents · OverlaysDropdownComponents · OverlaysSheetComponents · OverlaysTooltipComponents · OverlaysAlertComponents · FeedbackEmpty stateComponents · FeedbackToastComponents · FeedbackAccordionComponents · Data displayAvatarComponents · Data displayAvatar stackComponents · Data displayBadgeComponents · Data displayDetails tableComponents · Data displayIconComponents · Data displayProgressive imageComponents · Data displayStat gridComponents · Data displayTableComponents · Data displayTypesetComponents · Data displayPaginationComponents · NavigationPagination barComponents · NavigationTabsComponents · NavigationToolbarComponents · NavigationCardComponents · LayoutContainerComponents · LayoutFlexComponents · LayoutGridComponents · LayoutApplication navigationComponents · ApplicationApplication shellComponents · ApplicationAuthentication shellComponents · ApplicationDanger zoneComponents · ApplicationData sectionComponents · ApplicationForm sectionComponents · ApplicationPage headerComponents · ApplicationSettings layoutComponents · ApplicationSign inCompositions · Access & onboardingPassword resetCompositions · Access & onboardingEmail verificationCompositions · Access & onboardingInvitation acceptanceCompositions · Access & onboardingAccount creationCompositions · Access & onboardingAccount securityCompositions · Access & onboardingWorkspace onboardingCompositions · Access & onboardingBranched onboardingCompositions · Access & onboardingWorkspace dashboardCompositions · Workspace & organizationWorkspace settingsCompositions · Workspace & organizationWorkspace usersCompositions · Workspace & organizationTeam managementCompositions · Workspace & organizationAPI credentialsCompositions · Workspace & organizationOrganization overviewCompositions · Workspace & organizationOrganization settingsCompositions · Workspace & organizationTeam activityCompositions · Workspace & organizationTeam memberCompositions · Workspace & organizationSubscription billingCompositions · Billing & commerceCheckout and paymentCompositions · Billing & commerceCheckout resultsCompositions · Billing & commerceData resource overviewCompositions · Data & operationsData resource activityCompositions · Data & operationsData resource settingsCompositions · Data & operationsProduct resource lifecycleCompositions · Data & operationsAPI webhooksCompositions · Data & operationsIntegration managementCompositions · Data & operationsFile uploadsCompositions · Data & operationsActivity and audit logCompositions · Data & operationsChangelogCompositions · Product & supportHelp centerCompositions · Product & supportSystem status and errorsCompositions · Product & supportProduct landingCompositions · MarketingPublic pricingCompositions · MarketingProduct featuresCompositions · MarketingPublic contactCompositions · MarketingSidebar operations applicationCompositions · Complete applicationsTopbar media applicationCompositions · Complete applicationsHybrid account applicationCompositions · Complete applications

No destinations found.

  • Introduction
  • Agent guide
  • Human guide
  • Foundations
    • Colors
    • Typography
    • Spacing & sizing
    • Effects
  • Actions
    • Button
    • Button group
    • Button to
  • Forms
    • Appearance picker
    • Checkbox
    • Checkbox group
    • Combobox
    • Control group
    • Dropzone
    • Field
    • Field group
    • Fieldset
    • Input
    • Label
    • Radio button
    • Radio button group
    • Rich text area
    • Select
    • Switch
    • Textarea
  • Overlays
    • Command palette
    • Dialog
    • Dropdown
    • Sheet
    • Tooltip
  • Feedback
    • Alert
    • Empty state
    • Toast
  • Data display
    • Accordion
    • Avatar
    • Avatar stack
    • Badge
    • Details table
    • Icon
    • Progressive image
    • Stat grid
    • Table
    • Typeset
  • Navigation
    • Pagination
    • Pagination bar
    • Tabs
    • Toolbar
  • Layout
    • Card
    • Container
    • Flex
    • Grid
  • Application
    • Application navigation
    • Application shell
    • Authentication shell
    • Danger zone
    • Data section
    • Form section
    • Page header
    • Settings layout
  • Access & onboarding
    • Sign in
    • Password reset
    • Email verification
    • Invitation acceptance
    • Account creation
    • Account security
    • Workspace onboarding
    • Branched onboarding
  • Workspace & organization
    • Workspace dashboard
    • Workspace settings
    • Workspace users
    • Team management
    • API credentials
    • Organization overview
    • Organization settings
    • Team activity
    • Team member
  • Billing & commerce
    • Subscription billing
    • Checkout and payment
    • Checkout results
  • Data & operations
    • Data resource overview
    • Data resource activity
    • Data resource settings
    • Product resource lifecycle
    • API webhooks
    • Integration management
    • File uploads
    • Activity and audit log
  • Product & support
    • Changelog
    • Help center
    • System status and errors
  • Marketing
    • Product landing
    • Public pricing
    • Product features
    • Public contact
  • Complete applications
    • Sidebar operations application
    • Topbar media application
    • Hybrid account application

Tabs

Keyed tab and panel pairs with automatic or manual keyboard activation.

Source
app/components/nitro_kit/tabs.rb
API
NitroKit::Tabs.new(id:, default:) { |tabs| tabs.tab(key, label) { panel } }

Anatomy

Each declaration owns its panel; all panels remain readable until Stimulus enhances the APG tab behavior, and inactive content remains available to find in page.

Settings sections

Workspace name and regional preferences.
Manage roles, invitations, and access.
Review plan, payment method, and invoices.
Viewport640 px · sm
Rubytest/dummy/app/components/gallery/components/tabs_page.rb
render NitroKit::Tabs.new(
  id: "gallery-tabs-settings",
  default: :members,
  label: "Workspace settings"
) do |tabs|
  tabs.tab(:general, "General") { "Workspace name and regional preferences." }
  tabs.tab(:members, "Members") { "Manage roles, invitations, and access." }
  tabs.tab(:billing, "Billing") { "Review plan, payment method, and invoices." }
end

Orientation and activation

Horizontal and vertical tablists expose automatic or manual keyboard activation after enhancement.

Vertical manual tabs

Name, photo, and public account details.
Password, recovery codes, and active sessions.
Email and workspace notification preferences.
Legacy authentication is unavailable for new workspaces.
Viewport640 px · sm
Rubytest/dummy/app/components/gallery/components/tabs_page.rb
render NitroKit::Tabs.new(
  id: "gallery-tabs-vertical-manual",
  default: :security,
  label: "Account controls",
  orientation: :vertical,
  activation: :manual
) do |tabs|
  tabs.tab(:profile, "Profile") { "Name, photo, and public account details." }
  tabs.tab(:security, "Security") { "Password, recovery codes, and active sessions." }
  tabs.tab(:notifications, "Notifications") { "Email and workspace notification preferences." }
  tabs.tab(:legacy, "Legacy authentication", disabled: true) do
    "Legacy authentication is unavailable for new workspaces."
  end
end

Horizontal manual tabs

Seats, storage, and API request volume.
Plan limits and overage behavior.
Monthly usage totals for the past year.
Viewport640 px · sm
Rubytest/dummy/app/components/gallery/components/tabs_page.rb
render NitroKit::Tabs.new(
  id: "gallery-tabs-horizontal-manual",
  default: :usage,
  label: "Plan usage",
  activation: :manual
) do |tabs|
  tabs.tab(:usage, "Usage") { "Seats, storage, and API request volume." }
  tabs.tab(:limits, "Limits") { "Plan limits and overage behavior." }
  tabs.tab(:history, "History") { "Monthly usage totals for the past year." }
end

Single tab

Release 1842 is operational in the EU region.
Viewport640 px · sm
Rubytest/dummy/app/components/gallery/components/tabs_page.rb
render NitroKit::Tabs.new(id: "gallery-tabs-one", label: "Release information") do |tabs|
  tabs.tab(:summary, "Summary") { "Release 1842 is operational in the EU region." }
end

Content pressure

Many tabs, long labels, long panel copy, and disabled choices retain deterministic relationships.

Many long tabs

Workspace identity and ownership.

Dates use the workspace locale while audit timestamps retain their original UTC value. Individual members may choose a different display time zone without changing stored events.

Roles, invitations, and deactivation.
Sessions, recovery, and authentication policies.
Connected services and delivery status.
Plan, payment method, and invoice history.
Legacy provisioning is no longer available.
Viewport640 px · sm
Rubytest/dummy/app/components/gallery/components/tabs_page.rb
render NitroKit::Tabs.new(
  id: "gallery-tabs-pressure",
  default: :regional_preferences,
  label: "Extended workspace administration"
) do |tabs|
  tabs.tab(:general, "General") { "Workspace identity and ownership." }
  tabs.tab(:regional_preferences, "Regional preferences and time-zone behavior") do
    p do
      "Dates use the workspace locale while audit timestamps retain their original UTC value. " \
        "Individual members may choose a different display time zone without changing stored events."
    end
  end
  tabs.tab(:members, "Members") { "Roles, invitations, and deactivation." }
  tabs.tab(:security, "Security") { "Sessions, recovery, and authentication policies." }
  tabs.tab(:integrations, "Integrations") { "Connected services and delivery status." }
  tabs.tab(:billing, "Billing") { "Plan, payment method, and invoice history." }
  tabs.tab(:legacy, "Legacy provisioning", disabled: true) do
    "Legacy provisioning is no longer available."
  end
end

Settings composition

A complete settings surface nests forms, cards, status, tables, and grouped actions in panels.

Workspace administration

Workspace profile

Used for reports and scheduled notifications.

Members

Workspace member access
MemberRoleStatus
Ada LovelaceOwnerActive
Grace HopperAdminActive
Katherine JohnsonMemberInvited
Invite member

Team plan

Current plan

USD 49.00 monthly · renews August 1, 2026

Change planView invoices
Viewport640 px · sm
Rubytest/dummy/app/components/gallery/components/tabs_page.rb
render NitroKit::Tabs.new(
  id: "gallery-tabs-administration",
  default: :profile,
  label: "Workspace administration",
  orientation: :vertical,
  activation: :manual
) do |tabs|
  tabs.tab(:profile, "Profile") { render_profile_settings }
  tabs.tab(:members, "Members") { render_member_settings }
  tabs.tab(:billing, "Billing") { render_billing_settings }
end

Component contract

Constructor options, rendered root, closed vocabularies, and compound boundary for this component, exactly as shipped.

docs/component_contracts.md · NitroKit::Tabs

Constructor-specific options
  • required id:
  • default: nil, label: defaulting to I18n.t("nitro_kit.tabs.label"), orientation: :horizontal, activation: :automatic
Root and closed vocabulary
div[data-nk=tabs]; orientations horizontal vertical; activations automatic manual
Compound contract
Requires one or more uniquely keyed tabs with content and at least one enabled tab. An explicit default must be declared and enabled. Every panel remains available in the no-JavaScript baseline; Stimulus adds APG selection, hidden="until-found" inactive panels, find-in-page activation, roving focus, and keyboard activation after enhancement.

System rules for coding agents

Instructions for coding agents, repeated on every component page so one fetched page has enough context. Humans can usually skip this section.

test/dummy/app/components/gallery/agent_rules.rb

View agent instructions
  • Nitro Kit 2.0 is a gem-owned, Phlex-only UI system for Rails. Render components directly: render NitroKit::Button.new("Save", variant: :primary).
  • Compose Nitro components inside application-owned Phlex classes. Public initializers and declared slots are the component API; private methods are not.
  • Public options are explicit keywords, and enumerated options are closed vocabularies. Invalid names or values raise ArgumentError; this component's accepted options are in the contract above.
  • Pass native attributes through their typed boundary: html: for HTML, aria: for ARIA, and data: for application data. class and style are forbidden, including inside html:.
  • Nitro owns NitroKit::Component::RESERVED_DATA_ATTRIBUTES: data-nk, data-slot, data-variant, data-size, data-nk-escape, data-enhanced, data-state, data-disabled, data-required, data-orientation, data-presentation, data-placement, data-layout, data-side, data-field-type, data-dir, data-gap, data-align, data-justify, data-wrap, data-cols, data-mode, data-key. Do not pass them through data:. data-action, data-controller are additive and compose with Nitro behavior.
  • If an integration truly requires a class, use desperately_need_a_class:. It requires a non-blank String and marks the exception with data-nk-escape="class".
  • Every root emits data-nk; owned parts emit component-qualified data-slot values such as field-control or card-title. Select on those attributes, never on classes.
  • Customize components with documented --nk-* custom properties in an application stylesheet. Variables beginning with --_nk-* are private component mechanics.
  • Use NitroKit::Flex and NitroKit::Grid for layout. Parents own external placement and available width; components own their intrinsic geometry.
  • Preserve native elements and accessibility semantics. State is exposed through native semantics and ARIA first, and through data-state when styling or behavior also needs it.