vectra-client 1.0.0 → 1.0.1

data/docs/assets/style.css

@@ -4,34 +4,34 @@
 
 /* CSS Custom Properties */
 :root {
-  /* Color Palette - Clean Green Accent */
-  --tma-color-bg-primary: #0a0a0f;
-  --tma-color-bg-secondary: #111118;
-  --tma-color-bg-tertiary: #1a1a22;
-  --tma-color-bg-elevated: #222230;
-  --tma-color-bg-hover: #2a2a3a;
+  /* Color Palette - Deep Navy + Coral Accent */
+  --tma-color-bg-primary: #0c1a3f;
+  --tma-color-bg-secondary: #111f4b;
+  --tma-color-bg-tertiary: #17265c;
+  --tma-color-bg-elevated: #1f2f70;
+  --tma-color-bg-hover: #24367d;
   
-  /* Accent Colors - Based on #05df72 */
-  --tma-color-accent-primary: #05df72;
-  --tma-color-accent-light: #2ee889;
-  --tma-color-accent-dark: #04b85e;
-  --tma-color-accent-muted: rgba(5, 223, 114, 0.15);
+  /* Accent Colors - Based on logo (#e19e96) */
+  --tma-color-accent-primary: #e19e96;
+  --tma-color-accent-light: #f1b4aa;
+  --tma-color-accent-dark: #c46f63;
+  --tma-color-accent-muted: rgba(225, 158, 150, 0.16);
   
   /* Text Colors */
   --tma-color-text-primary: #f4f4f5;
-  --tma-color-text-secondary: #a1a1aa;
-  --tma-color-text-muted: #71717a;
-  --tma-color-text-accent: #05df72;
+  --tma-color-text-secondary: #c1c2d0;
+  --tma-color-text-muted: #8b8ca0;
+  --tma-color-text-accent: #e19e96;
   
   /* Border Colors */
   --tma-color-border: rgba(255, 255, 255, 0.08);
-  --tma-color-border-hover: rgba(5, 223, 114, 0.4);
+  --tma-color-border-hover: rgba(225, 158, 150, 0.6);
   
   /* Shadows */
   --tma-shadow-sm: 0 1px 2px rgba(0, 0, 0, 0.4);
   --tma-shadow-md: 0 4px 12px rgba(0, 0, 0, 0.5);
   --tma-shadow-lg: 0 8px 32px rgba(0, 0, 0, 0.6);
-  --tma-shadow-glow: 0 0 30px rgba(5, 223, 114, 0.2);
+  --tma-shadow-glow: 0 0 30px rgba(225, 158, 150, 0.35);
   
   /* Typography */
   --tma-font-family-primary: 'Inter', -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;
@@ -98,7 +98,7 @@ body {
   left: 0;
   right: 0;
   height: var(--tma-header-height);
-  background: rgba(10, 10, 15, 0.95);
+  background: rgba(12, 26, 63, 0.96);
   backdrop-filter: blur(12px);
   border-bottom: 1px solid var(--tma-color-border);
   z-index: 1000;
@@ -119,15 +119,16 @@ body {
   align-items: center;
   gap: var(--tma-spacing-sm);
   text-decoration: none;
-  font-size: 1.5rem;
-  font-weight: 800;
-  color: var(--tma-color-accent-primary);
-  letter-spacing: -0.02em;
+  color: var(--tma-color-text-primary);
 }
 
 .tma-nav__brand::before {
-  content: '◆';
-  font-size: 1.2rem;
+  content: '';
+}
+
+.tma-nav__logo {
+  width: 110px;
+  display: block;
 }
 
 .tma-nav__menu {
@@ -220,7 +221,7 @@ body {
   gap: var(--tma-spacing-sm);
   padding: var(--tma-spacing-xs) var(--tma-spacing-md);
   background: var(--tma-color-accent-muted);
-  border: 1px solid rgba(5, 223, 114, 0.3);
+  border: 1px solid rgba(225, 158, 150, 0.3);
   border-radius: 100px;
   font-size: 0.85rem;
   font-weight: 500;
@@ -696,6 +697,370 @@ code {
   color: var(--tma-color-text-secondary);
 }
 
+/* Comparison Table Styles */
+.tma-comparison {
+  padding: var(--tma-spacing-3xl) var(--tma-spacing-xl);
+  max-width: var(--tma-max-width);
+  margin: 0 auto;
+}
+
+.tma-comparison-table {
+  width: 100%;
+  border-collapse: collapse;
+  margin: var(--tma-spacing-xl) 0;
+  background: var(--tma-color-bg-secondary);
+  border-radius: var(--tma-radius-lg);
+  overflow: hidden;
+  border: 1px solid var(--tma-color-border);
+}
+
+.tma-comparison-table thead {
+  background: var(--tma-color-bg-tertiary);
+}
+
+.tma-comparison-table th {
+  padding: var(--tma-spacing-md) var(--tma-spacing-lg);
+  text-align: left;
+  font-weight: 600;
+  color: var(--tma-color-text-primary);
+  font-size: 0.9rem;
+  border-bottom: 2px solid var(--tma-color-border);
+}
+
+.tma-comparison-table th:first-child {
+  font-weight: 700;
+  color: var(--tma-color-accent-primary);
+}
+
+.tma-comparison-table td {
+  padding: var(--tma-spacing-md) var(--tma-spacing-lg);
+  border-bottom: 1px solid var(--tma-color-border);
+  color: var(--tma-color-text-secondary);
+  font-size: 0.9rem;
+}
+
+.tma-comparison-table tbody tr:hover {
+  background: var(--tma-color-bg-hover);
+}
+
+.tma-comparison-table tbody tr:last-child td {
+  border-bottom: none;
+}
+
+.tma-comparison-table .tma-check {
+  color: var(--tma-color-accent-primary);
+  font-weight: 600;
+}
+
+.tma-comparison-table .tma-partial {
+  color: #fbbf24;
+  font-weight: 500;
+}
+
+.tma-comparison-table .tma-cross {
+  color: var(--tma-color-text-muted);
+}
+
+/* Advantages Section */
+.tma-advantages {
+  padding: var(--tma-spacing-3xl) var(--tma-spacing-xl);
+  max-width: var(--tma-max-width);
+  margin: 0 auto;
+  background: var(--tma-color-bg-secondary);
+}
+
+.tma-advantages__grid {
+  display: grid;
+  grid-template-columns: repeat(auto-fit, minmax(300px, 1fr));
+  gap: var(--tma-spacing-lg);
+  margin-top: var(--tma-spacing-xl);
+}
+
+.tma-advantage-card {
+  padding: var(--tma-spacing-xl);
+  background: var(--tma-color-bg-tertiary);
+  border: 1px solid var(--tma-color-border);
+  border-radius: var(--tma-radius-lg);
+  border-left: 3px solid var(--tma-color-accent-primary);
+}
+
+.tma-advantage-card__title {
+  font-size: 1.1rem;
+  font-weight: 700;
+  margin-bottom: var(--tma-spacing-md);
+  color: var(--tma-color-text-primary);
+}
+
+.tma-advantage-card__list {
+  list-style: none;
+  padding: 0;
+}
+
+.tma-advantage-card__list li {
+  padding: var(--tma-spacing-xs) 0;
+  color: var(--tma-color-text-secondary);
+  font-size: 0.9rem;
+}
+
+.tma-advantage-card__list li::before {
+  content: '✓';
+  color: var(--tma-color-accent-primary);
+  font-weight: 700;
+  margin-right: var(--tma-spacing-sm);
+}
+
+/* Choose Section */
+.tma-choose {
+  padding: var(--tma-spacing-3xl) var(--tma-spacing-xl);
+  max-width: var(--tma-max-width);
+  margin: 0 auto;
+}
+
+.tma-choose__grid {
+  display: grid;
+  grid-template-columns: repeat(auto-fit, minmax(280px, 1fr));
+  gap: var(--tma-spacing-lg);
+  margin-top: var(--tma-spacing-xl);
+}
+
+.tma-choose-card {
+  padding: var(--tma-spacing-xl);
+  background: var(--tma-color-bg-secondary);
+  border: 1px solid var(--tma-color-border);
+  border-radius: var(--tma-radius-lg);
+}
+
+.tma-choose-card__title {
+  font-size: 1.1rem;
+  font-weight: 700;
+  margin-bottom: var(--tma-spacing-md);
+  color: var(--tma-color-accent-primary);
+}
+
+.tma-choose-card__list {
+  list-style: none;
+  padding: 0;
+}
+
+.tma-choose-card__list li {
+  padding: var(--tma-spacing-xs) 0;
+  color: var(--tma-color-text-secondary);
+  font-size: 0.9rem;
+  padding-left: var(--tma-spacing-md);
+  position: relative;
+}
+
+.tma-choose-card__list li::before {
+  content: '→';
+  position: absolute;
+  left: 0;
+  color: var(--tma-color-accent-primary);
+}
+
+/* Visual Charts Section */
+.tma-charts {
+  padding: var(--tma-spacing-3xl) var(--tma-spacing-xl);
+  max-width: var(--tma-max-width);
+  margin: 0 auto;
+  background: var(--tma-color-bg-secondary);
+}
+
+.tma-charts__grid {
+  display: grid;
+  grid-template-columns: repeat(auto-fit, minmax(400px, 1fr));
+  gap: var(--tma-spacing-2xl);
+  margin-top: var(--tma-spacing-xl);
+}
+
+.tma-chart-card {
+  padding: var(--tma-spacing-xl);
+  background: var(--tma-color-bg-tertiary);
+  border: 1px solid var(--tma-color-border);
+  border-radius: var(--tma-radius-lg);
+}
+
+.tma-chart-card__title {
+  font-size: 1.2rem;
+  font-weight: 700;
+  margin-bottom: var(--tma-spacing-lg);
+  color: var(--tma-color-text-primary);
+  text-align: center;
+}
+
+/* Bar Chart Styles */
+.tma-bar-chart {
+  margin-top: var(--tma-spacing-lg);
+}
+
+.tma-bar-chart__item {
+  margin-bottom: var(--tma-spacing-md);
+}
+
+.tma-bar-chart__label {
+  display: flex;
+  justify-content: space-between;
+  margin-bottom: var(--tma-spacing-xs);
+  font-size: 0.9rem;
+  color: var(--tma-color-text-secondary);
+}
+
+.tma-bar-chart__name {
+  font-weight: 600;
+  color: var(--tma-color-text-primary);
+}
+
+.tma-bar-chart__value {
+  color: var(--tma-color-text-secondary);
+}
+
+.tma-bar-chart__bar-container {
+  height: 28px;
+  background: var(--tma-color-bg-primary);
+  border-radius: var(--tma-radius-sm);
+  overflow: hidden;
+  border: 1px solid var(--tma-color-border);
+}
+
+.tma-bar-chart__bar {
+  height: 100%;
+  background: linear-gradient(90deg, var(--tma-color-accent-primary), var(--tma-color-accent-light));
+  border-radius: var(--tma-radius-sm);
+  transition: width var(--tma-transition-slow);
+  display: flex;
+  align-items: center;
+  padding: 0 var(--tma-spacing-sm);
+  color: #0a0a0f;
+  font-weight: 600;
+  font-size: 0.85rem;
+  min-width: fit-content;
+}
+
+.tma-bar-chart__bar--vectra {
+  background: linear-gradient(90deg, var(--tma-color-accent-primary), var(--tma-color-accent-light));
+}
+
+.tma-bar-chart__bar--langchain {
+  background: linear-gradient(90deg, #fbbf24, #fcd34d);
+}
+
+.tma-bar-chart__bar--pgvector {
+  background: linear-gradient(90deg, #60a5fa, #93c5fd);
+}
+
+.tma-bar-chart__bar--qdrant {
+  background: linear-gradient(90deg, #a78bfa, #c4b5fd);
+}
+
+/* Radar Chart Styles */
+.tma-radar-chart {
+  display: flex;
+  justify-content: center;
+  align-items: center;
+  margin: var(--tma-spacing-xl) 0;
+}
+
+.tma-radar-chart__container {
+  position: relative;
+  width: 300px;
+  height: 300px;
+}
+
+.tma-radar-chart__svg {
+  width: 100%;
+  height: 100%;
+  transform: rotate(-90deg);
+}
+
+.tma-radar-chart__axis {
+  stroke: var(--tma-color-border);
+  stroke-width: 1;
+}
+
+.tma-radar-chart__grid {
+  stroke: var(--tma-color-border);
+  stroke-width: 0.5;
+  fill: none;
+}
+
+.tma-radar-chart__area {
+  fill: var(--tma-color-accent-muted);
+  stroke: var(--tma-color-accent-primary);
+  stroke-width: 2;
+  opacity: 0.6;
+}
+
+.tma-radar-chart__point {
+  fill: var(--tma-color-accent-primary);
+  r: 4;
+}
+
+.tma-radar-chart__label {
+  font-size: 0.75rem;
+  fill: var(--tma-color-text-secondary);
+  text-anchor: middle;
+  transform: rotate(90deg);
+}
+
+.tma-radar-chart__labels {
+  position: absolute;
+  top: 0;
+  left: 0;
+  right: 0;
+  bottom: 0;
+  display: flex;
+  flex-direction: column;
+  justify-content: space-around;
+  padding: var(--tma-spacing-md);
+  pointer-events: none;
+}
+
+.tma-radar-chart__label-item {
+  font-size: 0.8rem;
+  color: var(--tma-color-text-secondary);
+  text-align: center;
+  font-weight: 500;
+}
+
+/* Responsive Charts */
+@media (max-width: 768px) {
+  .tma-charts__grid {
+    grid-template-columns: 1fr;
+  }
+  
+  .tma-radar-chart__container {
+    width: 250px;
+    height: 250px;
+  }
+}
+
+/* Responsive Comparison Table */
+@media (max-width: 1024px) {
+  .tma-comparison-table {
+    font-size: 0.85rem;
+  }
+  
+  .tma-comparison-table th,
+  .tma-comparison-table td {
+    padding: var(--tma-spacing-sm) var(--tma-spacing-md);
+  }
+}
+
+@media (max-width: 768px) {
+  .tma-comparison-table {
+    font-size: 0.75rem;
+  }
+  
+  .tma-comparison-table th,
+  .tma-comparison-table td {
+    padding: var(--tma-spacing-xs) var(--tma-spacing-sm);
+  }
+  
+  .tma-advantages__grid,
+  .tma-choose__grid {
+    grid-template-columns: 1fr;
+  }
+}
+
 /* ============================================
    Footer
    ============================================ */

data/docs/guides/getting-started.md

@@ -182,6 +182,21 @@ client.upsert(vectors: vectors)
 # => ValidationError: Inconsistent vector dimensions at index 1: expected 3, got 2
 ```
 
+## Rails Generator (vectra:index)
+
+For Rails apps, you can generate everything you need for a model with a single command:
+
+```bash
+rails generate vectra:index Product embedding dimension:1536 provider:qdrant
+```
+
+This will:
+
+- Create a **pgvector migration** when `provider=pgvector` (adds `embedding` vector column)
+- Generate a **model concern** (`ProductVector`) with `has_vector :embedding`
+- Update the **model** to include `ProductVector`
+- Append an entry to **`config/vectra.yml`** with index metadata (no API keys)
+
 ## Configuration
 
 Create a configuration file (Rails: `config/initializers/vectra.rb`):

data/docs/index.md

@@ -34,4 +34,12 @@ results = client.query(
 results.each do |match|
   puts "#{match['id']}: #{match['score']}"
 end
+
+# Hybrid search (semantic + keyword)
+results = client.hybrid_search(
+  index: 'docs',
+  vector: embedding,
+  text: 'ruby programming',
+  alpha: 0.7  # 70% semantic, 30% keyword
+)
 ```

data/examples/README.md

@@ -29,6 +29,24 @@ psql vectra_demo -c "CREATE EXTENSION vector;"
 
 ## Examples
 
+### Rails Quickstart (with generator)
+
+```bash
+# Generate Vectra index for Product model
+rails generate vectra:index Product embedding dimension:1536 provider:qdrant
+
+# Run migrations (if pgvector)
+rails db:migrate
+```
+
+Then in `app/models/product.rb`:
+
+```ruby
+class Product < ApplicationRecord
+  include ProductVector  # generated concern with has_vector :embedding
+end
+```
+
 ### 1. **Comprehensive Demo** (`comprehensive_demo.rb`)
 
 **⭐ START HERE** - Complete production-ready demonstration of all Vectra features.

data/lib/generators/vectra/index_generator.rb

@@ -0,0 +1,157 @@
+# frozen_string_literal: true
+
+require "rails/generators/base"
+
+module Vectra
+  module Generators
+    # Rails generator for creating a vectra-enabled index for a model.
+    #
+    # @example
+    #   rails generate vectra:index Product embedding dimension:1536 provider:qdrant
+    #
+    # This will:
+    # - Generate a pgvector migration (when provider=pgvector)
+    # - Create a model concern with `has_vector`
+    # - Update the model to include the concern
+    # - Append an entry to config/vectra.yml (no secrets)
+    class IndexGenerator < Rails::Generators::Base
+      argument :model_name, type: :string, banner: "ModelName"
+      argument :column_name, type: :string, default: "embedding", banner: "column_name"
+
+      class_option :dimension, type: :numeric, default: 1536,
+                               desc: "Vector dimension (e.g. 1536 for OpenAI)"
+      class_option :provider, type: :string, default: "qdrant",
+                              desc: "Vector provider (qdrant, pgvector, pinecone, weaviate, memory)"
+      class_option :index, type: :string, default: nil,
+                           desc: "Index/collection name (defaults to table name)"
+
+      def initialize(args = [], options = {}, config = {})
+        super
+        @model_name = args[0]&.to_s
+        @column_name = (args[1] || "embedding")&.to_s
+      end
+
+      def create_migration_for_pgvector
+        return unless provider_name == "pgvector"
+
+        timestamp = Time.now.utc.strftime("%Y%m%d%H%M%S")
+        file_name = "#{timestamp}_add_#{column_name.underscore}_to_#{table_name}.rb"
+        path = File.join("db/migrate", file_name)
+
+        migration_body = <<~RUBY
+          class Add#{column_name.camelize}To#{table_name.camelize} < ActiveRecord::Migration#{migration_version}
+            def change
+              add_column :#{table_name}, :#{column_name}, :vector, limit: #{dimension}
+            end
+          end
+        RUBY
+
+        create_file(path, migration_body)
+      end
+
+      def create_model_concern
+        path = File.join("app/models/concerns", "#{model_name.underscore}_vector.rb")
+
+        concern_body = <<~RUBY
+          # frozen_string_literal: true
+
+          module #{concern_module_name}
+            extend ActiveSupport::Concern
+
+            included do
+              include Vectra::ActiveRecord
+
+              has_vector :#{column_name},
+                         provider: :#{provider_name},
+                         index: "#{index_name}",
+                         dimension: #{dimension}
+            end
+          end
+        RUBY
+
+        create_file(path, concern_body)
+      end
+
+      def update_model_file
+        path = File.join("app/models", "#{model_name.underscore}.rb")
+
+        unless File.exist?(path)
+          create_file(
+            path,
+            <<~RUBY
+              # frozen_string_literal: true
+
+              class #{model_name.camelize} < ApplicationRecord
+                include #{concern_module_name}
+              end
+            RUBY
+          )
+          return
+        end
+
+        content = File.read(path)
+        return if content.include?("include #{concern_module_name}")
+
+        new_content = content.sub(/end\s*\z/, "  include #{concern_module_name}\nend\n")
+        File.write(path, new_content)
+      end
+
+      def update_vectra_config
+        path = File.join(destination_root || ".", "config", "vectra.yml")
+
+        existing = File.exist?(path) ? File.read(path) : ""
+        entry_key = "#{table_name}:"
+
+        return if existing.include?(entry_key)
+
+        header = +"# Vectra index configuration (do NOT store API keys here)\n"
+        header << "# Generated by vectra:index for #{model_name}\n\n"
+
+        config_body = <<~YAML
+          #{table_name}:
+            provider: #{provider_name}
+            index: #{index_name}
+            dimension: #{dimension}
+
+        YAML
+
+        FileUtils.mkdir_p(File.dirname(path))
+        File.write(path, "#{existing.presence || header}#{config_body}")
+      end
+
+      private
+
+      def model_name
+        @model_name || raise("Model name is required")
+      end
+
+      def column_name
+        @column_name || "embedding"
+      end
+
+      def table_name
+        model_name.underscore.pluralize
+      end
+
+      def provider_name
+        options[:provider].to_s
+      end
+
+      def index_name
+        (options[:index] || table_name).to_s
+      end
+
+      def dimension
+        options[:dimension].to_i
+      end
+
+      def concern_module_name
+        "#{model_name.camelize}Vector"
+      end
+
+      def migration_version
+        "[#{Rails::VERSION::MAJOR}.#{Rails::VERSION::MINOR}]"
+      end
+    end
+  end
+end

data/lib/vectra/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Vectra
-  VERSION = "1.0.0"
+  VERSION = "1.0.1"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: vectra-client
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 1.0.1
 platform: ruby
 authors:
 - Mijo Kristo
@@ -252,6 +252,11 @@ files:
 - docs/_site/robots.txt
 - docs/_site/sitemap.xml
 - docs/api/overview.md
+- docs/assets/favicon.svg
+- docs/assets/logo.svg
+- docs/assets/radme.png
+- docs/assets/readme-new.png
+- docs/assets/seo.png
 - docs/assets/style.css
 - docs/community/contributing.md
 - docs/examples/basic-usage.md
@@ -282,6 +287,7 @@ files:
 - examples/grafana-setup.md
 - examples/instrumentation_demo.rb
 - examples/prometheus-exporter.rb
+- lib/generators/vectra/index_generator.rb
 - lib/generators/vectra/install_generator.rb
 - lib/generators/vectra/templates/enable_pgvector_extension.rb
 - lib/generators/vectra/templates/vectra.rb