Link

# Simple link with defaults (blue, hover underline)
<%= rui_link("View Posts", "/posts") %>

# Positional (recommended) 
<%= rui_link("View Posts", "#", color: :primary) %>

# With block 
<%= rui_link("/posts", color: :primary) do %>
  View Posts
<% end %>

# Keyword (backward compatible) 
<%= rui_link(url: "/posts", text: "View Posts", color: :primary) %>

<%= rui_link("Underline", "#", variant: :underline) %>
<%= rui_link("No Underline", "#", variant: :no_underline) %>
<%= rui_link("Hover Underline", "#") %> 
<%= rui_link("Animated Underline", "#", variant: :animated_underline) %>

<nav class="space-y-1">
  <%= rui_link("Link", "/docs/link", variant: :nav) %>
  <%= rui_link("Button", "/docs/button", variant: :nav) %>
  <%= rui_link("Icon", "/docs/icon", variant: :nav) %>
</nav>

<nav class="space-y-1">
  <%= rui_link("Analytics", "/analytics", variant: :nav, color: :blue) %>
  <%= rui_link("Reports", "/reports", variant: :nav, color: :blue) %>
</nav>

<%= rui_link("Billing", "/billing", variant: :nav, color: :green, active: true) %>

<nav class="space-y-1">
  <%= rui_link("Dashboard", "/dashboard", variant: :nav) do |link| %>
    <% link.with_icon(:layout_dashboard) %>
  <% end %>
  <%= rui_link("Projects", "/projects", variant: :nav) do |link| %>
    <% link.with_icon(:folder) %>
  <% end %>
  <%= rui_link("Team", "/team", variant: :nav) do |link| %>
    <% link.with_icon(:users) %>
  <% end %>
</nav>

# Semantic colors 
<%= rui_link("Primary", "#", color: :primary) %>
<%= rui_link("Success", "#", color: :success) %>
<%= rui_link("Danger", "#", color: :danger) %>

# Tailwind colors 
<%= rui_link("Purple", "#", color: :purple) %>
<%= rui_link("Teal", "#", color: :teal) %>
<%= rui_link("Rose", "#", color: :rose) %>

<%= rui_link("Small Link", "#", size: :sm) %>
<%= rui_link("Base Link", "#", size: :base) %>
<%= rui_link("Large Link", "#", size: :lg) %>

<%= rui_link("Admin Panel", "/admin", if: admin?, color: :primary) %%>

<%= rui_link("Login", "/login", unless: user_signed_in?) %%>

<%= rui_link("Posts", posts_path, unless_current: true) %%>

<%= rui_link("Disabled", "#", disabled: true) %%>
<%= rui_link("Loading", "#", loading: true) %%>

# Automatic security (recommended) 
<%= rui_link("https://github.com", "Visit GitHub", external: true) %>
# Renders: <a href="..." target="_blank" rel="noopener noreferrer">Visit GitHub</a> 

# Or use target directly - security attributes added automatically 
<%= rui_link("https://example.com", "Example", target: "_blank") %>
# Also renders: rel="noopener noreferrer"

<%= rui_link("Download", "#", color: :primary) do |link| %>
  <% link.with_icon(:download) %>
<% end %>

<%= rui_link("Next", "#", color: :primary) do |link| %>
  <% link.with_icon(:arrow_right, position: :trailing) %>
<% end %>

<%= rui_link("Settings", "#", color: :primary) do |link| %>
  <% link.with_icon(:settings) %>
<% end %>

# Turbo Frame - load content into frame 
<%= rui_link("Edit", "/posts/1/edit", turbo_frame: "post_modal") %>

# Turbo Method - DELETE, PATCH, PUT 
<%= rui_link("Delete", "/posts/1",
  turbo_method: :delete,
  turbo_confirm: "Are you sure?",
  color: :danger) %>

# Turbo Stream - stream updates 
<%= rui_link("Load More", "/posts", turbo_stream: true) %>

# Turbo Prefetch - instant navigation (Turbo 8+) 
<%= rui_link("Posts", "/posts", turbo_prefetch: true) %>

# Turbo Action - replace instead of advance 
<%= rui_link("Refresh", "/posts", turbo_action: :replace) %>

# posts/index.html.erb - Post List with Turbo Frame 
<turbo-frame id="posts-list">
  <% @posts.each do |post| %>
    <div class="post-card border rounded-lg p-4 mb-4">
      <h3 class="text-lg font-bold"><%= post.title %></h3>
      <p class="text-zinc-600 mb-3"><%= post.excerpt %></p>

      <div class="flex gap-2">
        # Edit in modal - loads into "modal" frame 
        <%= rui_link("Edit", edit_post_path(post),
          turbo_frame: "modal",
          color: :primary) do |link|
          link.with_icon(:edit)
        end %>

        # Quick publish/unpublish with Turbo Method 
        <% if post.published? %>
          <%= rui_link("Unpublish", unpublish_post_path(post),
            turbo_method: :patch,
            turbo_confirm: "Unpublish this post?",
            color: :warning) do |link|
            link.with_icon(:eye_off)
          end %>
        <% else %>
          <%= rui_link("Publish", publish_post_path(post),
            turbo_method: :patch,
            color: :success) do |link|
            link.with_icon(:send)
          end %>
        <% end %>

        # Delete with confirmation 
        <%= rui_link("Delete", post_path(post),
          turbo_method: :delete,
          turbo_confirm: "Delete '#{post.title}'? This cannot be undone.",
          color: :danger) do |link|
          link.with_icon(:trash_2)
        end %>

        # View with prefetch for instant navigation 
        <%= rui_link("View", post_path(post),
          turbo_prefetch: true,
          variant: :outline,
          color: :blue) do |link|
          link.with_icon(:eye)
        end %>
      </div>
    </div>
  <% end %>

  # Load more with Turbo Stream 
  <% if @next_page %>
    <%= rui_link("Load More Posts", posts_path(page: @next_page),
      turbo_stream: true,
      variant: :outline,
      full_width: true) do |link|
      link.with_icon(:chevron_down, position: :trailing)
    end %>
  <% end %>
</turbo-frame>

# Modal frame for editing 
<turbo-frame id="modal" class="fixed inset-0 bg-black/50 hidden">
  <%# Edit form loads here when clicking Edit %>
</turbo-frame>

# posts_controller.rb
class PostsController < ApplicationController
  def publish
    @post = Post.find(params[:id])
    @post.update(published: true)

    # Turbo will automatically update the UI
    redirect_to posts_path, notice: "Post published!"
  end

  def unpublish
    @post = Post.find(params[:id])
    @post.update(published: false)

    redirect_to posts_path, notice: "Post unpublished!"
  end

  def destroy
    @post = Post.find(params[:id])
    @post.destroy

    # Turbo removes the post from the list automatically
    redirect_to posts_path, notice: "Post deleted!"
  end

  def index
    @posts = Post.page(params[:page])
    @next_page = @posts.next_page

    respond_to do |format|
      format.html  # Normal page load
      format.turbo_stream  # "Load More" appends to list
    end
  end
end

<%# Navigation with prefetch - feels instant %>
<nav class="flex gap-6">
  <%= rui_link("Home", "/",
    turbo_prefetch: true,
    unless_current: true) %>
  <%= rui_link("Blog", "/posts",
    turbo_prefetch: true,
    unless_current: true) %>
  <%= rui_link("About", "/about",
    turbo_prefetch: true,
    unless_current: true) %>
</nav>

<%# Post detail with previous/next navigation %>
<div class="post-navigation flex justify-between mt-8">
  <% if @post.previous %>
    <%= rui_link(post_path(@post.previous), turbo_prefetch: true) do |link|
      link.with_icon(:arrow_left)
      "← #{@post.previous.title}"
    end %>
  <% end %>

  <%= rui_link("All Posts", posts_path,
    turbo_prefetch: true,
    turbo_action: :replace) %>

  <% if @post.next %>
    <%= rui_link(post_path(@post.next), turbo_prefetch: true) do |link|
      "#{@post.next.title} →"
      link.with_icon(:arrow_right, position: :trailing)
    end %>
  <% end %>
</div>

# Descriptive link text (good)
<%= rui_link("View pricing plans", "/pricing") %>

# Icon-only link with title for accessibility
<%= rui_link("/settings", title: "Account Settings") do |link| %>
  <% link.with_icon(:settings) %>
<% end %>

# External link with automatic security attributes
<%= rui_link("https://github.com", "View on GitHub", external: true) %>
# Renders: rel="noopener noreferrer" target="_blank"

# Multilingual link
<%= rui_link("À propos", "/fr/about", hreflang: "fr") %>

# Disabled link (removed from tab order)
<%= rui_link("Admin Panel", "/admin", disabled: true) %>
# Renders: aria-disabled="true" tabindex="-1"