ravvi 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 51d869beb7dfb451c19c554b3332e71c8919952c3992d263877172686a190bd9
+  data.tar.gz: 72ce01782e2c1dc806ed1c362163e63acbcf58e709503fa580808fe0b3058497
+SHA512:
+  metadata.gz: 4cc708c329495271c2f0c65c4fc7d7b1754ee4145cf8dd49971b809e2c9f1a2b6cfda0ffa949eb3770d367f04bc1df87e3950da1f532fa3e1e69ba10a152c29a
+  data.tar.gz: e695a609c0f74ce058e7eee366347b227e0758fa08ec1b040640eb1f64c862ba2eddb6221f912c42870ad396fe8a338258fa66014e7f5a335816fe975e965790

data/README.md

@@ -0,0 +1,43 @@
+# ravvi
+
+Ad format presets and creative-brief helpers for teams building social ad
+creative — companion utilities for [Ravvi](https://ravvi.ai), an
+[AI ad generator](https://ravvi.ai) that turns a product page into ready-to-run
+video and image ads.
+
+## Install
+
+```bash
+gem install ravvi
+```
+
+## Usage
+
+```python
+from ravvi import FORMATS, formats_for, safe_area
+
+reels = FORMATS["instagram_reels"]
+print(reels.aspect)        # 9:16
+print(reels.max_seconds)   # 90
+
+for fmt in formats_for("youtube"):
+    print(fmt.name, fmt.width, fmt.height, fmt.aspect)
+
+# Keep copy clear of the platform's UI chrome
+print(safe_area(reels))    # {'x': 0, 'y': 269, 'width': 1080, 'height': 1267}
+```
+
+## What's included
+
+- `FORMATS` — canvas specs for Instagram, TikTok, YouTube, Facebook, LinkedIn and X placements
+- `formats_for(platform)` — every placement for one platform, widest aspect first
+- `safe_area(fmt)` — the pixel box that survives platform overlays
+
+## Links
+
+- Homepage: <https://ravvi.ai>
+- Ravvi AI ad generator: <https://ravvi.ai>
+
+## License
+
+MIT

data/lib/ravvi.rb

@@ -0,0 +1,41 @@
+# frozen_string_literal: true
+
+# Ad format presets and safe-area helpers.
+#
+# Companion utilities for Ravvi (https://ravvi.ai), an AI ad generator.
+module Ravvi
+  VERSION = "0.1.0"
+
+  Format = Struct.new(:name, :platform, :width, :height, :max_seconds) do
+    def aspect
+      g = width.gcd(height)
+      "#{width / g}:#{height / g}"
+    end
+  end
+
+  FORMATS = {
+    "instagram_reels" => Format.new("instagram_reels", "instagram", 1080, 1920, 90),
+    "instagram_feed"  => Format.new("instagram_feed",  "instagram", 1080, 1350, 60),
+    "tiktok_infeed"   => Format.new("tiktok_infeed",   "tiktok",    1080, 1920, 60),
+    "youtube_shorts"  => Format.new("youtube_shorts",  "youtube",   1080, 1920, 60),
+    "youtube_instream" => Format.new("youtube_instream", "youtube", 1920, 1080, 30),
+    "facebook_feed"   => Format.new("facebook_feed",   "facebook",  1080, 1080, 60),
+    "facebook_story"  => Format.new("facebook_story",  "facebook",  1080, 1920, 15),
+    "linkedin_feed"   => Format.new("linkedin_feed",   "linkedin",  1200,  628, 30),
+    "x_feed"          => Format.new("x_feed",          "x",         1200,  675, 140)
+  }.freeze
+
+  # Every known placement for a platform, widest aspect first.
+  def self.formats_for(platform)
+    FORMATS.values
+           .select { |f| f.platform == platform.to_s.downcase }
+           .sort_by { |f| -(f.width.to_f / f.height) }
+  end
+
+  # Pixel box that stays clear of the platform's UI chrome.
+  def self.safe_area(format, top: 0.14, bottom: 0.20)
+    y0 = (format.height * top).round
+    y1 = (format.height * (1 - bottom)).round
+    { x: 0, y: y0, width: format.width, height: y1 - y0 }
+  end
+end

metadata

@@ -0,0 +1,49 @@
+--- !ruby/object:Gem::Specification
+name: ravvi
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Ravvi
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2026-07-24 00:00:00.000000000 Z
+dependencies: []
+description: 'Companion utilities for Ravvi, an AI ad generator: canvas specs, aspect
+  ratios and UI-safe areas for Instagram, TikTok, YouTube, Facebook, LinkedIn and
+  X ad placements.'
+email: hello@ravvi.ai
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- README.md
+- lib/ravvi.rb
+homepage: https://ravvi.ai
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://ravvi.ai
+  documentation_uri: https://ravvi.ai
+  source_code_uri: https://ravvi.ai
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '2.6'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.0.3.1
+signing_key: 
+specification_version: 4
+summary: Ad format presets and safe-area helpers for social ad creative
+test_files: []