RubyGems - rails_onboarding - Versions diffs - 0.6.1 - Mend

rails_onboarding 0.6.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (148) hide show

data/app/views/rails_onboarding/onboarding/welcome.html.erb ADDED Viewed

@@ -0,0 +1,37 @@
+<div class="welcome-step">
+  <h1 class="step-heading">
+    <%= RailsOnboarding.configuration.welcome_heading %>
+  </h1>
+  <h2 class="step-subheading">
+    <%= RailsOnboarding.configuration.welcome_subheading %>
+  </h2>
+  <div class="welcome-features">
+    <h3>What you'll learn:</h3>
+    <ul class="feature-list" role="list">
+      <% RailsOnboarding.configuration.welcome_features.each do |feature| %>
+        <li class="feature-item">
+          <span class="feature-icon"><%= feature[:icon] %></span>
+          <span class="feature-text"><%= feature[:text] %></span>
+        </li>
+      <% end %>
+    </ul>
+  </div>
+  <div class="time-estimate">
+    <p class="estimate-text">
+      <strong>Estimated time:</strong> About 3-5 minutes
+    </p>
+  </div>
+  <div class="onboarding-actions">
+    <%= form_with url: rails_onboarding.next_onboarding_path, method: :post, local: true, class: "onboarding-form" do |form| %>
+      <%= form.submit "Let's Get Started! 🎉", class: "primary-action" %>
+    <% end %>
+  </div>
+  <div class="onboarding-actions">
+    <%= render 'step_navigation' %>
+  </div>
+</div>
+<%= render 'custom_footer' %>

data/app/views/rails_onboarding/onboarding_mailer/completion_email.html.erb ADDED Viewed

@@ -0,0 +1,109 @@
+<!DOCTYPE html>
+<html>
+  <head>
+    <meta content='text/html; charset=UTF-8' http-equiv='Content-Type' />
+    <style>
+      body {
+        font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif;
+        line-height: 1.6;
+        color: #333;
+        max-width: 600px;
+        margin: 0 auto;
+        padding: 20px;
+      }
+      .header {
+        text-align: center;
+        padding: 20px 0;
+        border-bottom: 2px solid #f0f0f0;
+      }
+      .celebration {
+        text-align: center;
+        font-size: 48px;
+        margin: 20px 0;
+      }
+      .content {
+        padding: 30px 0;
+      }
+      .achievement-badge {
+        background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
+        color: white;
+        padding: 20px;
+        border-radius: 10px;
+        text-align: center;
+        margin: 20px 0;
+      }
+      .cta-button {
+        display: inline-block;
+        padding: 12px 24px;
+        background-color: #10B981;
+        color: white;
+        text-decoration: none;
+        border-radius: 6px;
+        margin: 20px 0;
+      }
+      .footer {
+        text-align: center;
+        padding: 20px 0;
+        border-top: 2px solid #f0f0f0;
+        color: #666;
+        font-size: 14px;
+      }
+    </style>
+  </head>
+  <body>
+    <div class="header">
+      <h1>🎊 <%= t('rails_onboarding.mailer.completion.heading', default: 'Congratulations!') %></h1>
+    </div>
+    <div class="celebration">
+      🎉 ✨ 🚀
+    </div>
+    <div class="content">
+      <p><%= t('rails_onboarding.mailer.completion.greeting', default: 'Hi there!', name: @user.respond_to?(:name) ? @user.name : 'there') %></p>
+      <div class="achievement-badge">
+        <h2 style="margin: 0; color: white;">
+          <%= t('rails_onboarding.mailer.completion.badge_title', default: '✓ Onboarding Complete!') %>
+        </h2>
+        <p style="margin: 10px 0 0 0; color: white; opacity: 0.9;">
+          <%= t('rails_onboarding.mailer.completion.completed_at',
+            default: 'Completed on',
+            date: @completed_at&.strftime('%B %d, %Y') || Date.today.strftime('%B %d, %Y')) %>
+        </p>
+      </div>
+      <p>
+        <%= t('rails_onboarding.mailer.completion.intro',
+          default: "You've successfully completed your onboarding! You now have access to all features and can explore everything we have to offer.") %>
+      </p>
+      <p>
+        <%= t('rails_onboarding.mailer.completion.next_steps',
+          default: "Here's what you can do next:") %>
+      </p>
+      <ul>
+        <li><%= t('rails_onboarding.mailer.completion.step_1', default: 'Explore all available features') %></li>
+        <li><%= t('rails_onboarding.mailer.completion.step_2', default: 'Customize your settings and preferences') %></li>
+        <li><%= t('rails_onboarding.mailer.completion.step_3', default: 'Connect with other users') %></li>
+        <li><%= t('rails_onboarding.mailer.completion.step_4', default: 'Check out our help center for tips and tricks') %></li>
+      </ul>
+      <p>
+        <%= t('rails_onboarding.mailer.completion.encouragement',
+          default: "We're excited to have you as part of our community. If you need any help, our support team is always here for you!") %>
+      </p>
+      <div style="text-align: center;">
+        <a href="<%= Rails.application.routes.url_helpers.root_url rescue '#' %>" class="cta-button">
+          <%= t('rails_onboarding.mailer.completion.cta', default: 'Start Exploring') %>
+        </a>
+      </div>
+    </div>
+    <div class="footer">
+      <p><%= t('rails_onboarding.mailer.completion.footer', default: 'Happy exploring!') %></p>
+    </div>
+  </body>
+</html>

data/app/views/rails_onboarding/onboarding_mailer/completion_email.text.erb ADDED Viewed

@@ -0,0 +1,29 @@
+<%= t('rails_onboarding.mailer.completion.heading', default: 'Congratulations!') %>
+<%= t('rails_onboarding.mailer.completion.greeting', default: 'Hi there!', name: @user.respond_to?(:name) ? @user.name : 'there') %>
+✓ <%= t('rails_onboarding.mailer.completion.badge_title', default: 'Onboarding Complete!') %>
+<%= t('rails_onboarding.mailer.completion.completed_at', default: 'Completed on', date: @completed_at&.strftime('%B %d, %Y') || Date.today.strftime('%B %d, %Y')) %>
+<%= t('rails_onboarding.mailer.completion.intro',
+  default: "You've successfully completed your onboarding! You now have access to all features and can explore everything we have to offer.") %>
+<% if @milestone_points && @milestone_points > 0 %>
+🏆 <%= t('rails_onboarding.mailer.completion.milestone', default: 'Achievement Unlocked!') %>
+<%= t('rails_onboarding.mailer.completion.points_earned', default: "You've earned %{points} milestone points!", points: @milestone_points) %>
+<% end %>
+<%= t('rails_onboarding.mailer.completion.next_steps', default: "Here's what you can do next:") %>
+- <%= t('rails_onboarding.mailer.completion.step_1', default: 'Explore all available features') %>
+- <%= t('rails_onboarding.mailer.completion.step_2', default: 'Customize your settings and preferences') %>
+- <%= t('rails_onboarding.mailer.completion.step_3', default: 'Connect with other users') %>
+- <%= t('rails_onboarding.mailer.completion.step_4', default: 'Check out our help center for tips and tricks') %>
+<%= t('rails_onboarding.mailer.completion.encouragement',
+  default: "We're excited to have you as part of our community. If you need any help, our support team is always here for you!") %>
+<%= t('rails_onboarding.mailer.completion.cta', default: 'Start Exploring') %>: <%= Rails.application.routes.url_helpers.root_url rescue '#' %>
+---
+<%= t('rails_onboarding.mailer.completion.footer', default: 'Happy exploring!') %>

data/app/views/rails_onboarding/onboarding_mailer/reminder_email.html.erb ADDED Viewed

@@ -0,0 +1,99 @@
+<!DOCTYPE html>
+<html>
+  <head>
+    <meta content='text/html; charset=UTF-8' http-equiv='Content-Type' />
+    <style>
+      body {
+        font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif;
+        line-height: 1.6;
+        color: #333;
+        max-width: 600px;
+        margin: 0 auto;
+        padding: 20px;
+      }
+      .header {
+        text-align: center;
+        padding: 20px 0;
+        border-bottom: 2px solid #f0f0f0;
+      }
+      .content {
+        padding: 30px 0;
+      }
+      .progress-bar {
+        background-color: #f0f0f0;
+        border-radius: 10px;
+        height: 20px;
+        margin: 20px 0;
+        overflow: hidden;
+      }
+      .progress-fill {
+        background-color: #10B981;
+        height: 100%;
+        transition: width 0.3s ease;
+      }
+      .cta-button {
+        display: inline-block;
+        padding: 12px 24px;
+        background-color: #4F46E5;
+        color: white;
+        text-decoration: none;
+        border-radius: 6px;
+        margin: 20px 0;
+      }
+      .footer {
+        text-align: center;
+        padding: 20px 0;
+        border-top: 2px solid #f0f0f0;
+        color: #666;
+        font-size: 14px;
+      }
+    </style>
+  </head>
+  <body>
+    <div class="header">
+      <h1>🚀 <%= t('rails_onboarding.mailer.reminder.heading', default: 'Complete Your Onboarding') %></h1>
+    </div>
+    <div class="content">
+      <p><%= t('rails_onboarding.mailer.reminder.greeting', default: 'Hi there!', name: @user.respond_to?(:name) ? @user.name : 'there') %></p>
+      <p>
+        <%= t('rails_onboarding.mailer.reminder.intro',
+          default: "We noticed you started your onboarding journey but haven't finished it yet. You're doing great so far!") %>
+      </p>
+      <p>
+        <strong><%= t('rails_onboarding.mailer.reminder.progress',
+          default: 'Your Progress',
+          progress: @progress) %>:</strong> <%= @progress %>%
+      </p>
+      <div class="onboarding-progress-bar">
+        <div class="onboarding-progress-fill" style="width: <%= @progress %>%;"></div>
+      </div>
+      <% if @current_step %>
+        <p>
+          <%= t('rails_onboarding.mailer.reminder.current_step',
+            default: 'You left off at',
+            step: @current_step.to_s.titleize) %>: <strong><%= @current_step.to_s.titleize %></strong>
+        </p>
+      <% end %>
+      <p>
+        <%= t('rails_onboarding.mailer.reminder.encouragement',
+          default: "You're almost there! Complete your onboarding to unlock all features and get the most out of your experience.") %>
+      </p>
+      <div style="text-align: center;">
+        <a href="<%= @onboarding_url %>" class="cta-button">
+          <%= t('rails_onboarding.mailer.reminder.cta', default: 'Continue Onboarding') %>
+        </a>
+      </div>
+    </div>
+    <div class="footer">
+      <p><%= t('rails_onboarding.mailer.reminder.footer', default: 'See you soon!') %></p>
+    </div>
+  </body>
+</html>

data/app/views/rails_onboarding/onboarding_mailer/reminder_email.text.erb ADDED Viewed

@@ -0,0 +1,20 @@
+<%= t('rails_onboarding.mailer.reminder.heading', default: 'Complete Your Onboarding') %>
+<%= t('rails_onboarding.mailer.reminder.greeting', default: 'Hi there!', name: @user.respond_to?(:name) ? @user.name : 'there') %>
+<%= t('rails_onboarding.mailer.reminder.intro',
+  default: "We noticed you started your onboarding journey but haven't finished it yet. You're doing great so far!") %>
+<%= t('rails_onboarding.mailer.reminder.progress', default: 'Your Progress', progress: @progress) %>: <%= @progress %>%
+<% if @current_step %>
+<%= t('rails_onboarding.mailer.reminder.current_step', default: 'You left off at', step: @current_step.to_s.titleize) %>: <%= @current_step.to_s.titleize %>
+<% end %>
+<%= t('rails_onboarding.mailer.reminder.encouragement',
+  default: "You're almost there! Complete your onboarding to unlock all features and get the most out of your experience.") %>
+<%= t('rails_onboarding.mailer.reminder.cta', default: 'Continue Onboarding') %>: <%= @onboarding_url %>
+---
+<%= t('rails_onboarding.mailer.reminder.footer', default: 'See you soon!') %>

data/app/views/rails_onboarding/onboarding_mailer/step_completed_email.html.erb ADDED Viewed

@@ -0,0 +1,105 @@
+<!DOCTYPE html>
+<html>
+  <head>
+    <meta content='text/html; charset=UTF-8' http-equiv='Content-Type' />
+    <style>
+      body {
+        font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif;
+        line-height: 1.6;
+        color: #333;
+        max-width: 600px;
+        margin: 0 auto;
+        padding: 20px;
+      }
+      .header {
+        text-align: center;
+        padding: 20px 0;
+        border-bottom: 2px solid #f0f0f0;
+      }
+      .content {
+        padding: 30px 0;
+      }
+      .progress-bar {
+        background-color: #f0f0f0;
+        border-radius: 10px;
+        height: 20px;
+        margin: 20px 0;
+        overflow: hidden;
+      }
+      .progress-fill {
+        background-color: #10B981;
+        height: 100%;
+        transition: width 0.3s ease;
+      }
+      .step-badge {
+        background-color: #EEF2FF;
+        color: #4F46E5;
+        padding: 10px 20px;
+        border-radius: 6px;
+        display: inline-block;
+        margin: 10px 0;
+        font-weight: 600;
+      }
+      .cta-button {
+        display: inline-block;
+        padding: 12px 24px;
+        background-color: #4F46E5;
+        color: white;
+        text-decoration: none;
+        border-radius: 6px;
+        margin: 20px 0;
+      }
+      .footer {
+        text-align: center;
+        padding: 20px 0;
+        border-top: 2px solid #f0f0f0;
+        color: #666;
+        font-size: 14px;
+      }
+    </style>
+  </head>
+  <body>
+    <div class="header">
+      <h1>✅ <%= t('rails_onboarding.mailer.step_completed.heading', default: 'Step Completed!') %></h1>
+    </div>
+    <div class="content">
+      <p><%= t('rails_onboarding.mailer.step_completed.greeting', default: 'Hi there!', name: @user.respond_to?(:name) ? @user.name : 'there') %></p>
+      <p>
+        <%= t('rails_onboarding.mailer.step_completed.intro', default: 'Great job completing another step in your onboarding journey!') %>
+      </p>
+      <% if @step %>
+        <div style="text-align: center;">
+          <span class="step-badge">
+            <%= @step.to_s.titleize %>
+          </span>
+        </div>
+      <% end %>
+      <p>
+        <strong><%= t('rails_onboarding.mailer.step_completed.progress', default: 'Your Progress') %>:</strong> <%= @progress %>%
+      </p>
+      <div class="onboarding-progress-bar">
+        <div class="onboarding-progress-fill" style="width: <%= @progress %>%;"></div>
+      </div>
+      <p>
+        <%= t('rails_onboarding.mailer.step_completed.encouragement',
+          default: "Keep up the great work! Each step brings you closer to unlocking all features and getting the most out of your experience.") %>
+      </p>
+      <div style="text-align: center;">
+        <a href="<%= Rails.application.routes.url_helpers.rails_onboarding_onboarding_url rescue '#' %>" class="cta-button">
+          <%= t('rails_onboarding.mailer.step_completed.cta', default: 'Continue Onboarding') %>
+        </a>
+      </div>
+    </div>
+    <div class="footer">
+      <p><%= t('rails_onboarding.mailer.step_completed.footer', default: 'Keep going!') %></p>
+    </div>
+  </body>
+</html>

data/app/views/rails_onboarding/onboarding_mailer/step_completed_email.text.erb ADDED Viewed

@@ -0,0 +1,19 @@
+<%= t('rails_onboarding.mailer.step_completed.heading', default: 'Step Completed!') %>
+<%= t('rails_onboarding.mailer.step_completed.greeting', default: 'Hi there!', name: @user.respond_to?(:name) ? @user.name : 'there') %>
+<%= t('rails_onboarding.mailer.step_completed.intro', default: 'Great job completing another step in your onboarding journey!') %>
+<% if @step %>
+✓ <%= @step.to_s.titleize %>
+<% end %>
+<%= t('rails_onboarding.mailer.step_completed.progress', default: 'Your Progress') %>: <%= @progress %>%
+<%= t('rails_onboarding.mailer.step_completed.encouragement',
+  default: "Keep up the great work! Each step brings you closer to unlocking all features and getting the most out of your experience.") %>
+<%= t('rails_onboarding.mailer.step_completed.cta', default: 'Continue Onboarding') %>: <%= @onboarding_url rescue '#' %>
+---
+<%= t('rails_onboarding.mailer.step_completed.footer', default: 'Keep going!') %>

data/app/views/rails_onboarding/onboarding_mailer/welcome_email.html.erb ADDED Viewed

@@ -0,0 +1,74 @@
+<!DOCTYPE html>
+<html>
+  <head>
+    <meta content='text/html; charset=UTF-8' http-equiv='Content-Type' />
+    <style>
+      body {
+        font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif;
+        line-height: 1.6;
+        color: #333;
+        max-width: 600px;
+        margin: 0 auto;
+        padding: 20px;
+      }
+      .header {
+        text-align: center;
+        padding: 20px 0;
+        border-bottom: 2px solid #f0f0f0;
+      }
+      .content {
+        padding: 30px 0;
+      }
+      .cta-button {
+        display: inline-block;
+        padding: 12px 24px;
+        background-color: #4F46E5;
+        color: white;
+        text-decoration: none;
+        border-radius: 6px;
+        margin: 20px 0;
+      }
+      .footer {
+        text-align: center;
+        padding: 20px 0;
+        border-top: 2px solid #f0f0f0;
+        color: #666;
+        font-size: 14px;
+      }
+    </style>
+  </head>
+  <body>
+    <div class="header">
+      <h1>🎉 <%= t('rails_onboarding.mailer.welcome.heading', default: 'Welcome!') %></h1>
+    </div>
+    <div class="content">
+      <p><%= t('rails_onboarding.mailer.welcome.greeting', default: 'Hi there!', name: @user.respond_to?(:name) ? @user.name : 'there') %></p>
+      <p>
+        <%= t('rails_onboarding.mailer.welcome.intro',
+          default: "We're excited to have you on board! We've prepared a quick onboarding process to help you get started and make the most of your experience.") %>
+      </p>
+      <p>
+        <%= t('rails_onboarding.mailer.welcome.description',
+          default: "The onboarding process will guide you through the essential features and help you set up your account. It only takes a few minutes!") %>
+      </p>
+      <div style="text-align: center;">
+        <a href="<%= @onboarding_url %>" class="cta-button">
+          <%= t('rails_onboarding.mailer.welcome.cta', default: 'Get Started') %>
+        </a>
+      </div>
+      <p>
+        <%= t('rails_onboarding.mailer.welcome.help',
+          default: "If you have any questions or need assistance, don't hesitate to reach out. We're here to help!") %>
+      </p>
+    </div>
+    <div class="footer">
+      <p><%= t('rails_onboarding.mailer.welcome.footer', default: 'Thank you for joining us!') %></p>
+    </div>
+  </body>
+</html>

data/app/views/rails_onboarding/onboarding_mailer/welcome_email.text.erb ADDED Viewed

@@ -0,0 +1,17 @@
+<%= t('rails_onboarding.mailer.welcome.heading', default: 'Welcome!') %>
+<%= t('rails_onboarding.mailer.welcome.greeting', default: 'Hi there!', name: @user.respond_to?(:name) ? @user.name : 'there') %>
+<%= t('rails_onboarding.mailer.welcome.intro',
+  default: "We're excited to have you on board! We've prepared a quick onboarding process to help you get started and make the most of your experience.") %>
+<%= t('rails_onboarding.mailer.welcome.description',
+  default: "The onboarding process will guide you through the essential features and help you set up your account. It only takes a few minutes!") %>
+<%= t('rails_onboarding.mailer.welcome.cta', default: 'Get Started') %>: <%= @onboarding_url %>
+<%= t('rails_onboarding.mailer.welcome.help',
+  default: "If you have any questions or need assistance, don't hesitate to reach out. We're here to help!") %>
+---
+<%= t('rails_onboarding.mailer.welcome.footer', default: 'Thank you for joining us!') %>

data/app/views/rails_onboarding/shared/_flash.html.erb ADDED Viewed

@@ -0,0 +1,25 @@
+<div id="flash-messages" class="flash-container">
+  <% if defined?(notice) && notice %>
+    <div class="onboarding-flash flash-notice" role="alert">
+      <span class="flash-icon">✓</span>
+      <span class="flash-message"><%= notice %></span>
+      <button class="flash-close" onclick="this.parentElement.remove()" aria-label="Dismiss">×</button>
+    </div>
+  <% end %>
+  <% if defined?(alert) && alert %>
+    <div class="onboarding-flash flash-alert" role="alert">
+      <span class="flash-icon">⚠</span>
+      <span class="flash-message"><%= alert %></span>
+      <button class="flash-close" onclick="this.parentElement.remove()" aria-label="Dismiss">×</button>
+    </div>
+  <% end %>
+  <% if defined?(error) && error %>
+    <div class="onboarding-flash flash-error" role="alert">
+      <span class="flash-icon">✕</span>
+      <span class="flash-message"><%= error %></span>
+      <button class="flash-close" onclick="this.parentElement.remove()" aria-label="Dismiss">×</button>
+    </div>
+  <% end %>
+</div>

data/app/views/rails_onboarding/shared/_milestone_badge.html.erb ADDED Viewed

@@ -0,0 +1,22 @@
+<%#
+  Milestone badge partial for showing milestone achievements
+  Usage: <%= render 'rails_onboarding/shared/milestone_badge', milestone: milestone_config, achieved: true/false %>
+%>
+<div class="milestone-badge <%= 'onboarding-achieved' if achieved %> <%= 'onboarding-locked' unless achieved %>">
+  <div class="onboarding-badge-icon">
+    <%= milestone[:icon] %>
+    <% unless achieved %>
+      <div class="lock-overlay">🔒</div>
+    <% end %>
+  </div>
+  <div class="onboarding-badge-content">
+    <div class="onboarding-badge-title"><%= milestone[:title] %></div>
+    <div class="badge-points">+<%= milestone[:points] %></div>
+  </div>
+  <% if achieved %>
+    <div class="achievement-check">✅</div>
+  <% end %>
+</div>

data/app/views/rails_onboarding/shared/_milestone_celebration.html.erb ADDED Viewed

@@ -0,0 +1,44 @@
+<%# Host applications render this partial from their own views, so the path is
+    resolved through the engine's mount proxy rather than assumed. %>
+<div class="milestone-celebration-overlay is-hidden"
+     data-controller="milestone-celebration"
+     data-milestone-celebration-milestone-value="<%= milestone.to_json %>"
+     data-milestone-celebration-milestones-path-value="<%= rails_onboarding.milestones_path %>">
+  <div class="celebration-backdrop" data-action="click->milestone-celebration#dismiss"></div>
+  <div class="celebration-modal">
+    <div class="celebration-content">
+      <!-- Confetti animation container -->
+      <div class="confetti-container" data-milestone-celebration-target="confetti"></div>
+      <!-- Achievement announcement -->
+      <div class="achievement-announcement">
+        <div class="achievement-icon-container">
+          <div class="achievement-icon-glow"></div>
+          <div class="achievement-icon"><%= milestone[:icon] %></div>
+        </div>
+        <h2 class="achievement-title">Milestone Achieved!</h2>
+        <h3 class="milestone-name"><%= milestone[:title] %></h3>
+        <p class="milestone-description"><%= milestone[:description] %></p>
+        <div class="points-earned">
+          <span class="points-label">You earned</span>
+          <span class="points-value">+<%= milestone[:points] %></span>
+          <span class="points-label">points!</span>
+        </div>
+      </div>
+      <!-- Action buttons -->
+      <div class="celebration-actions">
+        <button class="onboarding-btn onboarding-btn-primary" data-action="click->milestone-celebration#dismiss">
+          Continue
+        </button>
+        <button class="onboarding-btn onboarding-btn-secondary" data-action="click->milestone-celebration#viewAllMilestones">
+          View All Achievements
+        </button>
+      </div>
+    </div>
+  </div>
+</div>

data/app/views/rails_onboarding/shared/_onboarding_banner.html.erb ADDED Viewed

@@ -0,0 +1,48 @@
+<%# Onboarding chrome for host-app pages. Render it unconditionally from the
+    host layout - it guards itself and renders nothing once onboarding is
+    done, skipped, or not required:
+      render "rails_onboarding/shared/onboarding_banner"
+    (No ERB delimiters around the example above: an ERB comment ends at the
+    first "%" + ">" sequence, so embedding a tag here would cut the comment
+    short and leak the rest of it into the page.)
+    Self-contained on purpose: it runs inside host actions that never set the
+    engine's @current_step/@progress ivars, so everything is derived from
+    current_user. %>
+<%# The raw engine root carries a trailing slash ("/onboarding/") like any
+    mounted engine root; chomp for a canonical link target and a
+    segment-aware engine-page check. %>
+<% onboarding_root = rails_onboarding.onboarding_path.chomp("/") %>
+<% on_engine_page = request.path == onboarding_root ||
+     request.path.start_with?("#{onboarding_root}/") %>
+<% if defined?(current_user) &&
+      current_user.respond_to?(:needs_onboarding?) &&
+      current_user.needs_onboarding? &&
+      !on_engine_page &&
+      (step = current_user.current_onboarding_step) %>
+  <div class="onboarding-banner" role="status">
+    <div class="onboarding-banner-progress">
+      <div class="onboarding-progress-bar">
+        <div class="onboarding-progress-fill" style="--onboarding-progress-width: <%= current_user.onboarding_progress %>%"></div>
+      </div>
+      <span class="onboarding-banner-step">
+        Step <%= RailsOnboarding.configuration.step_index(step[:name]).to_i + 1 %>
+        of <%= RailsOnboarding.configuration.total_steps %>:
+        <strong><%= step[:icon] %> <%= step[:title] %></strong>
+      </span>
+    </div>
+    <div class="onboarding-banner-actions">
+      <%# For :path steps, /onboarding re-checks complete_if and either
+          advances or routes back to the step's page - so "Continue" is
+          always the right link. %>
+      <%= link_to "Continue setup →", onboarding_root,
+                  class: "onboarding-banner-continue" %>
+      <% if step[:skippable] %>
+        <%= button_to "Skip this step", rails_onboarding.skip_onboarding_path,
+                      method: :post, class: "onboarding-banner-skip" %>
+      <% end %>
+    </div>
+  </div>
+<% end %>