ruby_native 0.10.8 → 0.10.10

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a84e26b885c93151197f1ae505a45b9cb99d8f3049df4b89dce036c431411a51
-  data.tar.gz: cba347806df4afc1f3e21c1b0201e616148633632c712eb44c432166b43f1115
+  metadata.gz: 1bb5b7670bd2d4d61029b914d26318ed49b9238dd285830a96804dc249be2402
+  data.tar.gz: 13f7f057b4be15c33e5c1c5fdade61102dd153a7a1aaba3c789d67bd730f950b
 SHA512:
-  metadata.gz: 7add53e3f05dc87ff5688b0b5714cb627c0a60facc70dde3322cf898d7d5128ffef60b64eca922fefee35441775e1b0ee18108499a795603081cd841ff4e0d70
-  data.tar.gz: 91bc86d031b25887d4c321ce50dbc10227ecc89f84c9fc2b695091289c1d128a10cecd398e19d5f0928ac40a03c6fac4884d815a21319b370ebe670684dfe561
+  metadata.gz: ae5949c2f376250485552b39960c5ba5b02d2618a0d15572ca53ac551ce1fc17c8bd418eadd138a9d51dfd3746737193f4f2916befc44bb697b4e32ea362ade3
+  data.tar.gz: 7248a218a8a196571628e8233bb687ac73ba51281eb23d24ffbd31b21be94e82ecf7e2e5ba410af36bfc0b43aab8c8b1b7d4b2ef1ae370c3512bb33d5f230909

data/lib/generators/ruby_native/templates/CLAUDE.md

@@ -81,6 +81,27 @@ background_color:
 
 Match these to your CSS framework's dark mode colors. For Bootstrap, `#212529` is `--bs-body-bg` in dark mode.
 
+### Navbar branding
+
+Replace the navigation bar's text title with a centered logo and set your own bar colors. This is global chrome: the same bar on every screen.
+
+```yaml
+appearance:
+  navbar:
+    logo: "<%= image_url('logo.png') %>"
+    background_color: "#3B3F54"
+    foreground_color: "#FFFFFF"
+    status_bar: light
+```
+
+`config/ruby_native.yml` is evaluated as ERB, so `logo` can be any Rails expression that returns a URL. Use `image_url` for a local asset: the URL is fingerprinted, so the app caches the logo and re-downloads it only when the image changes. A full URL works too, so the logo can live on a CDN:
+
+```yaml
+    logo: "https://cdn.example.com/logo.png"
+```
+
+`background_color` and `foreground_color` each accept a hex string or a `{ light:, dark: }` object. `status_bar` sets the status bar content to `light` (white) or `dark` to match your bar; omit it to let the system decide.
+
 ## View helpers
 
 Use these in your layouts and views:

data/lib/generators/ruby_native/templates/ruby_native.yml

@@ -34,6 +34,28 @@ appearance:
   # Default: false (portrait-only).
   # landscape: true
 
+  # Brand the navigation bar across the whole app: a centered logo in place of
+  # the page title, plus your own bar colors.
+  # https://rubynative.com/docs/appearance#navbar-branding
+  # navbar:
+  #   # Centered logo, shown instead of the page title. Set this to an image URL.
+  #   # For a local asset, point it at image_url wrapped in ERB so the URL is
+  #   # fingerprinted (the app re-downloads only when the image changes). The
+  #   # docs page above has the exact snippet to copy.
+  #   logo: "https://cdn.example.com/logo.png"
+  #
+  #   # Bar background color.
+  #   # Accepts a hex string, or { light:, dark: } for dark mode support.
+  #   background_color: "#3B3F54"
+  #
+  #   # Title and bar-button color.
+  #   # Accepts a hex string, or { light:, dark: } for dark mode support.
+  #   foreground_color: "#FFFFFF"
+  #
+  #   # Status bar content, to match your bar. Options: light (white) or dark.
+  #   # Omit to let the system decide.
+  #   status_bar: light
+
 # Configure the native tab bar on the bottom of the screen.
 # https://rubynative.com/docs/tabs
 tabs:

data/lib/ruby_native/helper.rb

@@ -126,6 +126,22 @@ module RubyNative
         end
       end
 
+      # Adds a native share button to the nav bar. Tapping it opens the
+      # platform share sheet for `url:` (defaults to the current page on the
+      # web side) so it works even where embedded web views don't support
+      # `navigator.share`. Icons follow the same rules as the other navbar
+      # buttons: `icon:` applies to every platform and `icons:` ({ ios:,
+      # android: }) overrides per platform.
+      def share_button(url: nil, title: "Share", icon: "square.and.arrow.up", icons: nil, position: :trailing)
+        resolved = RubyNative::Helper.resolve_icon(icon: icon, icons: icons, platform: @context.try(:native_platform))
+        data = { native_button: "", native_share: "" }
+        data[:native_title] = title if title
+        data[:native_icon] = resolved if resolved
+        data[:native_position] = position.to_s
+        data[:native_share_url] = url if url
+        @items << @context.tag.div(data: data)
+      end
+
       def submit_button(title: "Save", click: "[type='submit']")
         @items << @context.tag.div(data: {
           native_submit_button: "",
@@ -155,6 +171,19 @@ module RubyNative
         @items << @context.tag.div(data: data)
       end
 
+      # Adds a share entry to a navbar button's dropdown menu. Selecting it
+      # opens the platform share sheet for `url:` (defaults to the current
+      # page on the web side). Icons follow the same `icon:`/`icons:` rules
+      # as the other menu items.
+      def share_item(title = "Share", url: nil, icon: "square.and.arrow.up", icons: nil, selected: false)
+        resolved = RubyNative::Helper.resolve_icon(icon: icon, icons: icons, platform: @context.try(:native_platform))
+        data = { native_menu_item: "", native_title: title, native_share: "" }
+        data[:native_share_url] = url if url
+        data[:native_icon] = resolved if resolved
+        data[:native_selected] = "" if selected
+        @items << @context.tag.div(data: data)
+      end
+
       def to_html
         @context.safe_join(@items)
       end

data/lib/ruby_native/version.rb

@@ -1,3 +1,3 @@
 module RubyNative
-  VERSION = "0.10.8"
+  VERSION = "0.10.10"
 end

data/lib/ruby_native.rb

@@ -1,3 +1,4 @@
+require "erb"
 require "ruby_native/version"
 require "ruby_native/helper"
 require "ruby_native/native_version"
@@ -37,7 +38,7 @@ module RubyNative
     path = Rails.root.join("config", "ruby_native.yml")
     return unless path.exist?
 
-    self.config = YAML.load_file(path).deep_symbolize_keys
+    self.config = YAML.load(render_config(path)).deep_symbolize_keys
     self.config[:app] ||= {}
     self.config[:app][:entry_path] ||= self.config.dig(:tabs, 0, :path) || "/"
     self.config[:auth] ||= {}
@@ -46,6 +47,23 @@ module RubyNative
     backfill_error_icons
   end
 
+  # config/ruby_native.yml is rendered as ERB before it is parsed, so a
+  # developer can interpolate Rails helpers into it. The motivating case is the
+  # navbar logo: `logo: "<%= image_url("logo.png") %>"` resolves to a
+  # fingerprinted asset URL the native app downloads and caches, and because the
+  # digest changes whenever the asset changes, the cache busts itself. A full
+  # URL (a CDN, say) works just as well; the app only ever sees a URL to fetch.
+  #
+  # The template renders against the controller helper proxy, so `image_url` and
+  # friends behave exactly as they do in a view. With no request or asset host
+  # they degrade to a relative path -- asset helpers never raise "missing host"
+  # the way routing helpers do -- and the native app resolves any relative URL
+  # against the base URL it already fetched the config from.
+  def self.render_config(path)
+    helpers = ActionController::Base.helpers
+    ERB.new(path.read, trim_mode: "-").result(helpers.instance_eval { binding })
+  end
+
   # Mirrors per-platform `icons:` into the legacy flat `icon:` field so native
   # binaries that only read `tab.icon` keep rendering an icon. Explicit `icon:`
   # wins; otherwise falls back to `icons.ios`, then `icons.android`.

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: ruby_native
 version: !ruby/object:Gem::Version
-  version: 0.10.8
+  version: 0.10.10
 platform: ruby
 authors:
 - Joe Masilotti