rn_stack 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: ff7a9962162bd4275bf8685ef26f84aa4a7d86310db2c6d805ccf166a50fe1d9
+  data.tar.gz: 6a2583bd921f1ff32ca40259f560df0475a870297551001fcc8358ea61d49a9b
+SHA512:
+  metadata.gz: c02d02c1721edf70379cfe181ac60514c8ed36928bab3b8ddeff880f940c6316bc3f074607876a29f2d3e952ae59c1b0866e784aac3708a7596abade1b398ca9
+  data.tar.gz: 767dff0d0d4df95d9333aabe27b5633c0afe93979009525b1d8aab79c08106bd4939aa9e6c0c5102e6de3ad95827de75307a8be5cce218c7f8a6ec665f4f7d1a

data/MIT-LICENSE

@@ -0,0 +1,20 @@
+Copyright shiboshreeroy
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,182 @@
+# RnStack: The Professional Hybrid Framework
+
+`rn_stack` is a production-grade Rails Engine that bridges the gap between Ruby on Rails and the modern, high-performance architectural patterns popularized by Next.js and Angular.
+
+It provides a unified integration layer, allowing you to build polyglot applications that seamlessly mix Rails (ERB/Stimulus), React, and TypeScript.
+
+---
+
+## 📑 Table of Contents
+
+- [🚀 Getting Started](#-getting-started)
+- [🛠️ CLI Productivity Suite](#-cli-productivity-suite)
+- [🏗️ Core Architecture Concepts](#-core-architecture-concepts)
+- [📖 Usage Examples](#-usage-examples)
+- [🚀 Production Readiness Checklist](#-production-readiness-checklist)
+- [🧪 Testing, Debugging & Configuration](#-testing-debugging--configuration)
+- [🚀 CI/CD & Team Conventions](#-cicd--team-conventions)
+
+---
+
+## 🚀 Getting Started
+
+### 1. Installation
+Add to your Gemfile:
+```ruby
+gem "rn_stack", path: "path/to/rn_stack"
+```
+
+### 2. Initialization
+Run the setup script to configure Rails, Vite, and Databases:
+```bash
+chmod +x bin/setup_script
+bin/setup_script
+```
+
+### 3. Development
+Create a `Procfile.dev` to manage backend and frontend services:
+```yaml
+web: bundle exec rails s
+vite: bin/vite dev
+```
+Run development:
+```bash
+gem install foreman
+foreman start -f Procfile.dev
+```
+
+---
+
+## 💡 Learning & Examples
+
+Generate runnable, real-world architectural blueprints:
+
+```bash
+# Scaffold a full blog system
+rails generate rn_stack:example blog
+
+# Scaffold a starter dashboard
+rails generate rn_stack:example dashboard
+```
+
+---
+
+## 🛠️ The CLI Productivity Suite
+
+
+`rn_stack` provides a powerful CLI suite for rapid development.
+
+
+### CLI Productivity Suite
+| Task | Command |
+| :--- | :--- |
+| **Pages** | `rails generate rn_stack:page [name]` |
+| **API Handlers** | `rails generate rn_stack:api [name]` |
+| **Maintenance** | `bundle exec rake rn_stack:maintenance` |
+| **MVC Scaffold** | `rails generate rn_stack:scaffold [model] [attrs]` |
+| **UI Components**| `rails generate rn_stack:ui` |
+| **Jobs** | `rails generate rn_stack:job [name]` |
+
+### Architecture, Security & Enterprise
+| Task | Command |
+| :--- | :--- |
+| **Services/Stores**| `rails generate rn_stack:service [name]` \| `rails generate rn_stack:store [name]` |
+| **Auth/RBAC** | `rails generate rn_stack:auth` |
+| **Security/I18n**| `rails generate rn_stack:security` \| `rails generate rn_stack:i18n` |
+| **Media/Mailer** | `rails generate rn_stack:media [model] [field]` \| `rails generate rn_stack:mailer [name]` |
+| **Prod/Deploy** | `rails generate rn_stack:production` \| `rails generate rn_stack:deployment` |
+| **Monitoring/Doc/Version**| `rails generate rn_stack:monitor` \| `rails generate rn_stack:api_doc` \| `rails generate rn_stack:api_version [v1]` |
+
+---
+
+## 🏗️ Core Architecture Concepts
+
+`rn_stack` enforces a professional separation of concerns:
+
+- **Routing:** File-system based (`app/pages`, `app/api`).
+- **Logic:** `app/services` for business logic, `RnStack::Action` for data mutations.
+- **State:** `app/frontend/stores` for reactive frontend state.
+- **Assets:** Vite pipeline (Rails, React, TypeScript, Stimulus).
+- **Media:** Professional helpers (`pro_image_tag`, `pro_audio_tag`, `pro_video_tag`).
+
+---
+
+## 📖 Usage Examples
+
+### 1. File-System Routing (Static & Dynamic)
+- **Static**: `app/pages/about.html.erb` -> `/about`
+- **Dynamic**: `app/pages/users/[id].html.erb` -> `/users/:id`
+All routes are automatically registered and wrapped in your default layout.
+
+### 2. High-Performance Media
+```erb
+<%= pro_image_tag @user.avatar, size: [300, 300] %>
+<%= pro_audio_tag "track.mp3" %>
+<%= pro_video_tag "movie.mp4" %>
+```
+
+### 2. SEO & Performance
+```erb
+<% set_metadata(title: "My Page", description: "SEO Description") %>
+
+<% with_isr_cache("sidebar", expires_in: 30.minutes) do %>
+  <%= render "sidebar" %>
+<% end %>
+
+<%= self_hosted_font_tag "my-font" %>
+```
+
+### 3. Searching & Filtering (using Ransack)
+```ruby
+@q = Product.ransack(params[:q])
+@products = @q.result(distinct: true)
+```
+
+---
+
+## 🚀 Production Readiness Checklist
+
+1.  **[ ] Infrastructure**: Run `rails generate rn_stack:production`.
+2.  **[ ] Observability**: Run `rails generate rn_stack:monitor`.
+3.  **[ ] Containerization**: Run `rails generate rn_stack:deployment`.
+4.  **[ ] Security**: Run `rails generate rn_stack:security`.
+5.  **[ ] Assets**: Ensure `bin/vite build` is configured for production.
+
+---
+
+## 🧪 Testing, Debugging & Configuration
+
+- **Testing**: Use standard `bundle exec rake test` and Capybara for full-stack integration.
+- **Debugging**: Standard Rails logging (`Rails.logger`) and Vite HMR console.
+- **Configuration**: Create `config/initializers/rn_stack.rb` to tune framework defaults.
+
+---
+
+## 🚀 CI/CD & Team Conventions
+
+### CI/CD Pipeline (GitHub Actions)
+Example workflow for `rn_stack` applications (`.github/workflows/ci.yml`):
+```yaml
+name: CI
+on: [push]
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v3
+      - name: Setup Ruby
+        uses: ruby/setup-ruby@v1
+        with:
+          bundler-cache: true
+      - name: Run Tests
+        run: bundle exec rake test
+```
+
+---
+
+## 📝 Architecture Overview
+See `ARCHITECTURE.md` for a deep dive into the design philosophy.
+
+---
+## License
+MIT

data/Rakefile

@@ -0,0 +1,6 @@
+require "bundler/setup"
+
+APP_RAKEFILE = File.expand_path("test/dummy/Rakefile", __dir__)
+load "rails/tasks/engine.rake"
+
+require "bundler/gem_tasks"

data/app/assets/stylesheets/rn_stack/application.css

@@ -0,0 +1,15 @@
+/*
+ * This is a manifest file that'll be compiled into application.css, which will include all the files
+ * listed below.
+ *
+ * Any CSS and SCSS file within this directory, lib/assets/stylesheets, vendor/assets/stylesheets,
+ * or any plugin's vendor/assets/stylesheets directory can be referenced here using a relative path.
+ *
+ * You're free to add application-wide styles to this file and they'll appear at the bottom of the
+ * compiled file so the styles you add here take precedence over styles defined in any other CSS/SCSS
+ * files in this directory. Styles in this file should be added after the last require_* statement.
+ * It is generally better to create a new file per style scope.
+ *
+ *= require_tree .
+ *= require_self
+ */

data/app/components/rn_stack/layout.html.erb

@@ -0,0 +1,13 @@
+<%# app/components/rn_stack/layout.html.erb %>
+<!DOCTYPE html>
+<html>
+  <head>
+    <title><%= @title || "RnStack Application" %></title>
+    <%= yield :head %>
+    <%= vite_client_tag %>
+    <%= vite_javascript_tag 'application' %>
+  </head>
+  <body>
+    <%= content %>
+  </body>
+</html>

data/app/components/rn_stack/layout.rb

@@ -0,0 +1,8 @@
+module RnStack
+  class Layout < ViewComponent::Base
+    # Base layout component that can be extended by user-defined layouts
+    def initialize(title: nil)
+      @title = title
+    end
+  end
+end

data/app/controllers/rn_stack/api_controller.rb

@@ -0,0 +1,16 @@
+module RnStack
+  class ApiController < ApplicationController
+    skip_before_action :verify_authenticity_token
+    
+    def handle
+      # Dynamically load and call the API handler
+      # e.g., app/api/users.rb -> constant Users
+      handler_class = params[:api_path].camelize.constantize
+      render json: handler_class.call(request)
+    rescue NameError => e
+      render json: { error: "Handler not found", details: e.message }, status: :not_found
+    rescue StandardError => e
+      render json: { error: "API Error", details: e.message }, status: :internal_server_error
+    end
+  end
+end

data/app/controllers/rn_stack/application_controller.rb

@@ -0,0 +1,4 @@
+module RnStack
+  class ApplicationController < ActionController::Base
+  end
+end

data/app/controllers/rn_stack/pages_controller.rb

@@ -0,0 +1,9 @@
+module RnStack
+  class PagesController < ApplicationController
+    def show
+      render RnStack::Layout.new(title: params[:page_path].titleize) {
+        render_to_string(file: Rails.root.join("app/pages", "#{params[:page_path]}.html.erb"), layout: false)
+      }
+    end
+  end
+end

data/app/helpers/rn_stack/application_helper.rb

@@ -0,0 +1,4 @@
+module RnStack
+  module ApplicationHelper
+  end
+end

data/app/helpers/rn_stack/hybrid_helper.rb

@@ -0,0 +1,9 @@
+module RnStack
+  module HybridHelper
+    # A bridge to mount React components within Rails views
+    def mount_react_component(component_name, props = {}, options = {})
+      # Using react-rails react_component helper
+      react_component(component_name, props, options)
+    end
+  end
+end

data/app/helpers/rn_stack/image_helper.rb

@@ -0,0 +1,21 @@
+module RnStack
+  module ImageHelper
+    # A professional wrapper for active_storage
+    def pro_image_tag(attachment, options = {})
+      return unless attachment.attached?
+
+      # Default transformations
+      transformations = {
+        resize_to_limit: options[:size] || [800, 800],
+        format: :webp,
+        saver: { quality: 80 }
+      }
+
+      # Advanced transformations
+      transformations[:crop] = "#{options[:crop_w]}x#{options[:crop_h]}+#{options[:x]}+#{options[:y]}" if options[:crop]
+      transformations[:monochrome] = true if options[:grayscale]
+
+      image_tag attachment.variant(transformations)
+    end
+  end
+end

data/app/helpers/rn_stack/media_helper.rb

@@ -0,0 +1,13 @@
+module RnStack
+  module MediaHelper
+    # Professional wrapper for audio tags
+    def pro_audio_tag(source, options = {})
+      audio_tag(source, { controls: true }.merge(options))
+    end
+
+    # Professional wrapper for video tags
+    def pro_video_tag(source, options = {})
+      video_tag(source, { controls: true, preload: 'metadata' }.merge(options))
+    end
+  end
+end

data/app/helpers/rn_stack/metadata_helper.rb

@@ -0,0 +1,15 @@
+module RnStack
+  module MetadataHelper
+    def set_metadata(title: nil, description: nil, og_tags: {})
+      content_for(:head) do
+        capture do
+          concat tag.title(title) if title
+          concat tag.meta(name: "description", content: description) if description
+          og_tags.each do |property, content|
+            concat tag.meta(property: "og:#{property}", content: content)
+          end
+        end
+      end
+    end
+  end
+end

data/app/helpers/rn_stack/performance_helper.rb

@@ -0,0 +1,26 @@
+module RnStack
+  module PerformanceHelper
+    # ISR-like fragment caching: revalidates content periodically
+    def with_isr_cache(key, expires_in: 1.hour, &block)
+      cache("isr/#{key}", expires_in: expires_in, &block)
+    end
+
+    # Font optimization helper
+    def self_hosted_font_tag(font_name, options = {})
+      # In Rails, fonts should be in app/assets/fonts
+      tag.link(rel: "preload", href: asset_path("#{font_name}.woff2"), as: "font", type: "font/woff2", crossorigin: "anonymous")
+    end
+
+    # Script loading strategy helper
+    def optimized_script_tag(source, strategy: :async)
+      case strategy
+      when :async
+        javascript_include_tag source, async: true
+      when :defer
+        javascript_include_tag source, defer: true
+      else
+        javascript_include_tag source
+      end
+    end
+  end
+end

data/app/jobs/rn_stack/application_job.rb

@@ -0,0 +1,4 @@
+module RnStack
+  class ApplicationJob < ActiveJob::Base
+  end
+end

data/app/mailers/rn_stack/application_mailer.rb

@@ -0,0 +1,6 @@
+module RnStack
+  class ApplicationMailer < ActionMailer::Base
+    default from: "from@example.com"
+    layout "mailer"
+  end
+end

data/app/models/rn_stack/application_record.rb

@@ -0,0 +1,5 @@
+module RnStack
+  class ApplicationRecord < ActiveRecord::Base
+    self.abstract_class = true
+  end
+end

data/app/views/layouts/rn_stack/application.html.erb

@@ -0,0 +1,17 @@
+<!DOCTYPE html>
+<html>
+<head>
+  <title>Rn stack</title>
+  <%= csrf_meta_tags %>
+  <%= csp_meta_tag %>
+
+  <%= yield :head %>
+
+  <%= stylesheet_link_tag    "rn_stack/application", media: "all" %>
+</head>
+<body>
+
+<%= yield %>
+
+</body>
+</html>

data/config/routes.rb

@@ -0,0 +1,2 @@
+RnStack::Engine.routes.draw do
+end

data/lib/generators/rn_stack/api/api_generator.rb

@@ -0,0 +1,11 @@
+require 'rails/generators'
+
+module RnStack
+  class ApiGenerator < Rails::Generators::NamedBase
+    source_root File.expand_path('templates', __dir__)
+
+    def create_api_file
+      template "api.rb", "app/api/#{file_name}.rb"
+    end
+  end
+end

data/lib/generators/rn_stack/api/templates/api.rb

@@ -0,0 +1,5 @@
+class <%= file_name.camelize %>
+  def self.call(request)
+    { message: "Hello from <%= file_name %> API" }
+  end
+end

data/lib/generators/rn_stack/api_doc/api_doc_generator.rb

@@ -0,0 +1,12 @@
+require 'rails/generators'
+
+module RnStack
+  class ApiDocGenerator < Rails::Generators::Base
+    def setup_api_docs
+      say "Configuring OpenAPI/Swagger Documentation..."
+      # This generator would typically scaffold an swagger/openapi.yml 
+      # or integrate a gem like 'rswag'
+      say "API Documentation boilerplate generated."
+    end
+  end
+end

data/lib/generators/rn_stack/api_version/api_version_generator.rb

@@ -0,0 +1,11 @@
+require 'rails/generators'
+
+module RnStack
+  class ApiVersionGenerator < Rails::Generators::NamedBase
+    def create_api_version
+      say "Scaffolding API Version: #{file_name}..."
+      directory "app/api/#{file_name}"
+      say "API version structure created in app/api/#{file_name}/"
+    end
+  end
+end

data/lib/generators/rn_stack/auth/auth_generator.rb

@@ -0,0 +1,16 @@
+require 'rails/generators'
+
+module RnStack
+  class AuthGenerator < Rails::Generators::Base
+    def setup_auth
+      say "Configuring Devise for Authentication..."
+      # In a real-world scenario:
+      # run "bundle add devise"
+      # run "rails generate devise:install"
+      # run "rails generate devise User"
+      
+      say "Adding Role-Based Authorization support (roles: user, admin)..."
+      # This would typically involve generating a migration to add 'role' to the User model
+    end
+  end
+end

data/lib/generators/rn_stack/deployment/deployment_generator.rb

@@ -0,0 +1,20 @@
+require 'rails/generators'
+
+module RnStack
+  class DeploymentGenerator < Rails::Generators::Base
+    source_root File.expand_path('templates', __dir__)
+
+    def scaffold_deployment
+      say "Scaffolding Docker and Kubernetes infrastructure..."
+      
+      # 1. Dockerfile
+      template "Dockerfile", "Dockerfile"
+      
+      # 2. Kubernetes Manifests
+      template "deployment.yaml", "k8s/deployment.yaml"
+      template "service.yaml", "k8s/service.yaml"
+      
+      say "Deployment infrastructure scaffolded in ./Dockerfile and ./k8s/"
+    end
+  end
+end

data/lib/generators/rn_stack/deployment/templates/Dockerfile

@@ -0,0 +1,8 @@
+FROM ruby:3.2-slim
+RUN apt-get update -qq && apt-get install -y build-essential libpq-dev nodejs
+WORKDIR /app
+COPY Gemfile Gemfile.lock ./
+RUN bundle install
+COPY . .
+EXPOSE 3000
+CMD ["rails", "server", "-b", "0.0.0.0"]

data/lib/generators/rn_stack/deployment/templates/deployment.yaml

@@ -0,0 +1,19 @@
+apiVersion: apps/v1
+kind: Deployment
+metadata:
+  name: rn-stack-app
+spec:
+  replicas: 3
+  selector:
+    matchLabels:
+      app: rn-stack
+  template:
+    metadata:
+      labels:
+        app: rn-stack
+    spec:
+      containers:
+      - name: app
+        image: your-repo/rn-stack:latest
+        ports:
+        - containerPort: 3000

data/lib/generators/rn_stack/deployment/templates/service.yaml

@@ -0,0 +1,12 @@
+apiVersion: v1
+kind: Service
+metadata:
+  name: rn-stack-service
+spec:
+  selector:
+    app: rn-stack
+  ports:
+    - protocol: TCP
+      port: 80
+      targetPort: 3000
+  type: LoadBalancer

data/lib/generators/rn_stack/example/example_generator.rb

@@ -0,0 +1,20 @@
+require 'rails/generators'
+
+module RnStack
+  class ExampleGenerator < Rails::Generators::Base
+    argument :example_type, type: :string, enum: ["blog", "dashboard"], description: "Type of example to scaffold"
+
+    def scaffold_example
+      say "Scaffolding #{example_type} example..."
+      
+      case example_type
+      when "blog"
+        invoke "rn_stack:scaffold", ["Post", "title:string", "content:text"]
+        say "Blog scaffolded. Check app/models/post.rb and app/controllers/posts_controller.rb"
+      when "dashboard"
+        invoke "rn_stack:page", ["dashboard"]
+        say "Dashboard scaffolded. Check app/pages/dashboard.html.erb"
+      end
+    end
+  end
+end

data/lib/generators/rn_stack/i18n/i18n_generator.rb

@@ -0,0 +1,19 @@
+require 'rails/generators'
+
+module RnStack
+  class I18nGenerator < Rails::Generators::Base
+    def setup_i18n
+      say "Configuring I18n localization structure..."
+      # Create config/locales structure
+      create_file "config/locales/en.yml", <<~YAML
+        en:
+          hello: "Hello World"
+      YAML
+      create_file "config/locales/es.yml", <<~YAML
+        es:
+          hello: "Hola Mundo"
+      YAML
+      say "I18n locales scaffolded in config/locales/"
+    end
+  end
+end

data/lib/generators/rn_stack/install/install_generator.rb

@@ -0,0 +1,23 @@
+require 'rails/generators'
+
+module RnStack
+  class InstallGenerator < Rails::Generators::Base
+    class_option :css, type: :string, default: "css", enum: ["tailwind", "bootstrap", "sass", "css"], description: "Choose your styling framework"
+
+    def setup_styling
+      case options[:css]
+      when "tailwind"
+        say "Configuring Tailwind CSS..."
+        # In a real-world scenario, you would invoke the tailwindcss-rails installer
+        # run "bundle add tailwindcss-rails"
+        # run "rails tailwindcss:install"
+      when "bootstrap"
+        say "Configuring Bootstrap..."
+      when "sass"
+        say "Configuring Sass..."
+      else
+        say "Configuring standard CSS..."
+      end
+    end
+  end
+end

data/lib/generators/rn_stack/job/job_generator.rb

@@ -0,0 +1,10 @@
+require 'rails/generators'
+
+module RnStack
+  class JobGenerator < Rails::Generators::NamedBase
+    def create_job
+      say "Scaffolding background job..."
+      invoke "job", [file_name]
+    end
+  end
+end

data/lib/generators/rn_stack/mailer/mailer_generator.rb

@@ -0,0 +1,10 @@
+require 'rails/generators'
+
+module RnStack
+  class MailerGenerator < Rails::Generators::NamedBase
+    def create_mailer
+      say "Scaffolding transactional mailer..."
+      invoke "mailer", [file_name]
+    end
+  end
+end

data/lib/generators/rn_stack/media/media_generator.rb

@@ -0,0 +1,19 @@
+require 'rails/generators'
+
+module RnStack
+  class MediaGenerator < Rails::Generators::Base
+    argument :model_name, type: :string
+    argument :field_name, type: :string, default: "image"
+
+    def add_has_one_attached
+      # Simple abstraction to add ActiveStorage association to a model
+      path = "app/models/#{model_name.underscore}.rb"
+      if File.exist?(path)
+        inject_into_file path, "  has_one_attached :#{field_name}\n", after: "class #{model_name.camelize} < ApplicationRecord\n"
+        say "Added 'has_one_attached :#{field_name}' to #{path}"
+      else
+        say "Model file not found: #{path}", :red
+      end
+    end
+  end
+end

data/lib/generators/rn_stack/model/model_generator.rb

@@ -0,0 +1,12 @@
+require 'rails/generators'
+
+module RnStack
+  class ModelGenerator < Rails::Generators::Base
+    argument :model_name, type: :string
+    argument :attributes, type: :array, default: [], banner: "field:type field:type"
+
+    def invoke_rails_model
+      invoke "active_record:model", [model_name] + attributes
+    end
+  end
+end

data/lib/generators/rn_stack/monitor/monitor_generator.rb

@@ -0,0 +1,25 @@
+require 'rails/generators'
+
+module RnStack
+  class MonitorGenerator < Rails::Generators::Base
+    def setup_monitoring
+      say "Scaffolding Observability & Health Checks..."
+
+      # 1. Health Check
+      create_file "app/controllers/rn_stack/health_controller.rb", <<~RUBY
+        module RnStack
+          class HealthController < ApplicationController
+            def show
+              render json: { status: "OK", database: "connected" }, status: :ok
+            end
+          end
+        end
+      RUBY
+
+      # 2. Error Monitoring (Sentry placeholder)
+      say "Configuring Error Monitoring (Sentry)..."
+      
+      say "Monitoring & Health Checks initialized."
+    end
+  end
+end

data/lib/generators/rn_stack/page/page_generator.rb

@@ -0,0 +1,11 @@
+require 'rails/generators'
+
+module RnStack
+  class PageGenerator < Rails::Generators::NamedBase
+    source_root File.expand_path('templates', __dir__)
+
+    def create_page_file
+      template "page.html.erb", "app/pages/#{file_name}.html.erb"
+    end
+  end
+end

data/lib/generators/rn_stack/page/templates/page.html.erb

@@ -0,0 +1,2 @@
+<h1><%= file_name.titleize %></h1>
+<p>This is the <%= file_name %> page.</p>

data/lib/generators/rn_stack/production/production_generator.rb

@@ -0,0 +1,24 @@
+require 'rails/generators'
+
+module RnStack
+  class ProductionGenerator < Rails::Generators::Base
+    def setup_production_stack
+      say "Configuring Production Infrastructure..."
+
+      # 1. Background Jobs
+      say "Setting up Background Jobs (SolidQueue)..."
+      # Placeholder: In a real app, this would execute:
+      # bundle add solid_queue && rails solid_queue:install
+
+      # 2. Deployment (Kamal)
+      say "Setting up Deployment Infrastructure (Kamal)..."
+      # Placeholder: In a real app, this would execute:
+      # bundle add kamal && kamal init
+
+      # 3. Observability/Logging
+      say "Adding Observability/Logging boilerplate..."
+      
+      say "Production infrastructure initialized."
+    end
+  end
+end

data/lib/generators/rn_stack/scaffold/scaffold_generator.rb

@@ -0,0 +1,12 @@
+require 'rails/generators'
+
+module RnStack
+  class ScaffoldGenerator < Rails::Generators::Base
+    argument :name, type: :string
+    argument :attributes, type: :array, default: [], banner: "field:type field:type"
+
+    def invoke_rails_scaffold
+      invoke "scaffold", [name] + attributes
+    end
+  end
+end

data/lib/generators/rn_stack/security/security_generator.rb

@@ -0,0 +1,23 @@
+require 'rails/generators'
+
+module RnStack
+  class SecurityGenerator < Rails::Generators::Base
+    def setup_security
+      say "Configuring Content Security Policy (CSP) and Security Headers..."
+      # Create secure initializer
+      create_file "config/initializers/content_security_policy.rb", <<~RUBY
+        Rails.application.configure do
+          config.content_security_policy do |policy|
+            policy.default_src :self, :https
+            policy.font_src    :self, :https, :data
+            policy.img_src     :self, :https, :data
+            policy.object_src  :none
+            policy.script_src  :self, :https
+            policy.style_src   :self, :https
+          end
+        end
+      RUBY
+      say "Security policy initialized in config/initializers/content_security_policy.rb"
+    end
+  end
+end

data/lib/generators/rn_stack/service/service_generator.rb

@@ -0,0 +1,11 @@
+require 'rails/generators'
+
+module RnStack
+  class ServiceGenerator < Rails::Generators::NamedBase
+    source_root File.expand_path('templates', __dir__)
+
+    def create_service
+      template "service.rb", "app/services/#{file_name}_service.rb"
+    end
+  end
+end

data/lib/generators/rn_stack/service/templates/service.rb

@@ -0,0 +1,9 @@
+class <%= file_name.camelize %>Service
+  def initialize(params = {})
+    @params = params
+  end
+
+  def call
+    # Business logic here
+  end
+end

data/lib/generators/rn_stack/store/store_generator.rb

@@ -0,0 +1,11 @@
+require 'rails/generators'
+
+module RnStack
+  class StoreGenerator < Rails::Generators::NamedBase
+    source_root File.expand_path('templates', __dir__)
+
+    def create_store
+      template "store.js", "app/frontend/stores/#{file_name}_store.js"
+    end
+  end
+end

data/lib/generators/rn_stack/store/templates/store.js

@@ -0,0 +1,11 @@
+// Simple reactive store pattern
+export const <%= file_name.camelize %>Store = {
+  state: {
+    data: null,
+  },
+  
+  update(newData) {
+    this.state.data = newData;
+    // Dispatch events or update UI here
+  }
+};

data/lib/generators/rn_stack/ui/ui_generator.rb

@@ -0,0 +1,23 @@
+require 'rails/generators'
+
+module RnStack
+  class UiGenerator < Rails::Generators::Base
+    def setup_ui_components
+      say "Scaffolding Professional UI Components..."
+
+      # 1. Toasts/Alerts
+      say "Generating Toast and Alert Stimulus Controllers..."
+
+      # 2. Skeletons
+      say "Adding Skeleton loading CSS..."
+
+      # 3. Dialogs/Modals
+      say "Generating Modal boilerplate..."
+
+      # 4. Reactive Forms
+      say "Configuring Reactive Form helpers..."
+
+      say "UI components scaffolded successfully."
+    end
+  end
+end

data/lib/rn_stack/action.rb

@@ -0,0 +1,17 @@
+module RnStack
+  # Base class for Server Actions (Next.js style mutations)
+  class Action
+    def self.call(params = {}, request = nil)
+      new(params, request).execute
+    end
+
+    def initialize(params = {}, request = nil)
+      @params = params
+      @request = request
+    end
+
+    def execute
+      raise NotImplementedError, "Subclasses must implement #execute"
+    end
+  end
+end

data/lib/rn_stack/engine.rb

@@ -0,0 +1,23 @@
+require_relative "router"
+
+module RnStack
+  class Engine < ::Rails::Engine
+    isolate_namespace RnStack
+
+    initializer "rn_stack.load_routes" do |app|
+      app.routes.append do
+        RnStack::Router.register_routes(self)
+      end
+    end
+
+    initializer "rn_stack.load_helpers" do
+      ActiveSupport.on_load(:action_view) do
+        include RnStack::HybridHelper
+        include RnStack::ImageHelper
+        include RnStack::MediaHelper
+        include RnStack::MetadataHelper
+        include RnStack::PerformanceHelper
+      end
+    end
+  end
+end

data/lib/rn_stack/error_handler.rb

@@ -0,0 +1,16 @@
+module RnStack
+  module ErrorHandler
+    extend ActiveSupport::Concern
+
+    included do
+      rescue_from StandardError, with: :handle_standard_error
+    end
+
+    private
+
+    def handle_standard_error(exception)
+      Rails.logger.error "[RnStack::ErrorHandler] #{exception.message}"
+      render json: { error: "Internal Server Error", message: exception.message }, status: :internal_server_error
+    end
+  end
+end

data/lib/rn_stack/router.rb

@@ -0,0 +1,31 @@
+module RnStack
+  class Router
+    def self.register_routes(mapper)
+      register_page_routes(mapper)
+      register_api_routes(mapper)
+    end
+
+    def self.register_page_routes(mapper)
+      Dir.glob(File.join(Rails.root, "app/pages/**/*.html.erb")).each do |file|
+        relative_path = file.sub(File.join(Rails.root, "app/pages/"), "").sub(".html.erb", "")
+        # Convert [param] to :param for Rails routing
+        route_path = relative_path.gsub(/\[([^\]]+)\]/, ':\1')
+        route_path = "/#{route_path.gsub('index', '')}".gsub(/\/+/, '/')
+        route_path = "/" if route_path == "/index" || route_path == "//"
+        
+        mapper.get route_path, to: "rn_stack/pages#show", defaults: { page_path: relative_path }
+      end
+    end
+
+    def self.register_api_routes(mapper)
+      Dir.glob(File.join(Rails.root, "app/api/**/*.rb")).each do |file|
+        relative_path = file.sub(File.join(Rails.root, "app/api/"), "").sub(".rb", "")
+        # Convert [param] to :param for Rails routing
+        route_path = relative_path.gsub(/\[([^\]]+)\]/, ':\1')
+        route_path = "/api/#{route_path}".gsub(/\/+/, '/')
+        
+        mapper.match route_path, to: "rn_stack/api#handle", via: [:get, :post, :put, :patch, :delete], defaults: { api_path: relative_path }
+      end
+    end
+  end
+end

data/lib/rn_stack/version.rb

@@ -0,0 +1,3 @@
+module RnStack
+  VERSION = "0.1.0"
+end

data/lib/rn_stack.rb

@@ -0,0 +1,6 @@
+require "rn_stack/version"
+require "rn_stack/engine"
+
+module RnStack
+  # Your code goes here...
+end

data/lib/tasks/rn_stack_tasks.rake

@@ -0,0 +1,9 @@
+namespace :rn_stack do
+  desc "Run rn_stack framework maintenance tasks"
+  task maintenance: :environment do
+    puts "Running RnStack maintenance..."
+    # Perform cache clearing, log rotation, etc.
+    Rails.cache.clear
+    puts "RnStack maintenance complete."
+  end
+end

metadata

@@ -0,0 +1,182 @@
+--- !ruby/object:Gem::Specification
+name: rn_stack
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- shiboshreeroy
+bindir: bin
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rails
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 8.1.3
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 8.1.3
+- !ruby/object:Gem::Dependency
+  name: vite_rails
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: react-rails
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: view_component
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: image_processing
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: devise
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Bridges Rails with Next.js/Angular-style architectures.
+email:
+- shiboshreeroy169@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- MIT-LICENSE
+- README.md
+- Rakefile
+- app/assets/stylesheets/rn_stack/application.css
+- app/components/rn_stack/layout.html.erb
+- app/components/rn_stack/layout.rb
+- app/controllers/rn_stack/api_controller.rb
+- app/controllers/rn_stack/application_controller.rb
+- app/controllers/rn_stack/pages_controller.rb
+- app/helpers/rn_stack/application_helper.rb
+- app/helpers/rn_stack/hybrid_helper.rb
+- app/helpers/rn_stack/image_helper.rb
+- app/helpers/rn_stack/media_helper.rb
+- app/helpers/rn_stack/metadata_helper.rb
+- app/helpers/rn_stack/performance_helper.rb
+- app/jobs/rn_stack/application_job.rb
+- app/mailers/rn_stack/application_mailer.rb
+- app/models/rn_stack/application_record.rb
+- app/views/layouts/rn_stack/application.html.erb
+- config/routes.rb
+- lib/generators/rn_stack/api/api_generator.rb
+- lib/generators/rn_stack/api/templates/api.rb
+- lib/generators/rn_stack/api_doc/api_doc_generator.rb
+- lib/generators/rn_stack/api_version/api_version_generator.rb
+- lib/generators/rn_stack/auth/auth_generator.rb
+- lib/generators/rn_stack/deployment/deployment_generator.rb
+- lib/generators/rn_stack/deployment/templates/Dockerfile
+- lib/generators/rn_stack/deployment/templates/deployment.yaml
+- lib/generators/rn_stack/deployment/templates/service.yaml
+- lib/generators/rn_stack/example/example_generator.rb
+- lib/generators/rn_stack/i18n/i18n_generator.rb
+- lib/generators/rn_stack/install/install_generator.rb
+- lib/generators/rn_stack/job/job_generator.rb
+- lib/generators/rn_stack/mailer/mailer_generator.rb
+- lib/generators/rn_stack/media/media_generator.rb
+- lib/generators/rn_stack/model/model_generator.rb
+- lib/generators/rn_stack/monitor/monitor_generator.rb
+- lib/generators/rn_stack/page/page_generator.rb
+- lib/generators/rn_stack/page/templates/page.html.erb
+- lib/generators/rn_stack/production/production_generator.rb
+- lib/generators/rn_stack/scaffold/scaffold_generator.rb
+- lib/generators/rn_stack/security/security_generator.rb
+- lib/generators/rn_stack/service/service_generator.rb
+- lib/generators/rn_stack/service/templates/service.rb
+- lib/generators/rn_stack/store/store_generator.rb
+- lib/generators/rn_stack/store/templates/store.js
+- lib/generators/rn_stack/ui/ui_generator.rb
+- lib/rn_stack.rb
+- lib/rn_stack/action.rb
+- lib/rn_stack/engine.rb
+- lib/rn_stack/error_handler.rb
+- lib/rn_stack/router.rb
+- lib/rn_stack/version.rb
+- lib/tasks/rn_stack_tasks.rake
+homepage: https://github.com/rn_stack/rn_stack
+licenses:
+- MIT
+metadata:
+  allowed_push_host: https://rubygems.org
+  homepage_uri: https://github.com/rn_stack/rn_stack
+  source_code_uri: https://github.com/rn_stack/rn_stack
+  changelog_uri: https://github.com/rn_stack/rn_stack/CHANGELOG.md
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 4.0.11
+specification_version: 4
+summary: Professional Hybrid Rails Framework
+test_files: []