rails-saas-builder 0.9.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 64d5d9b5bed88acac2449b7eed3c55dae27a67d9ee4466182125fd0ece98e676
+  data.tar.gz: 115928cdba7390516837f6d9e169d4baa65d8f68c45021bb4ee9a4dd3e768632
+SHA512:
+  metadata.gz: 962b88b8300c90680851fd0c6f8754f5d840875ace281659b16fd2195832041a3acdcd2e91167e3bbf9f8fcda535d3112eb894acc1e7c7ab38c8322092e70514
+  data.tar.gz: f222b0912df9c0028afdcb282b18f9dda0674f83ebbba7f4f89a56350600106ad127884096141b82f81b8baeb28bfe364bd16d39c0c5a7e312b413c9cf51adc8

data/LICENSE

@@ -0,0 +1,15 @@
+Rails SaaS Builder (RSB)
+Copyright (C) 2026 Aleksandr Marchenko
+
+This program is free software: you can redistribute it and/or modify
+it under the terms of the GNU Lesser General Public License as published by
+the Free Software Foundation, either version 3 of the License, or
+(at your option) any later version.
+
+This program is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+GNU Lesser General Public License for more details.
+
+You should have received a copy of the GNU Lesser General Public License
+along with this program. If not, see <https://www.gnu.org/licenses/>.

data/README.md

@@ -0,0 +1,89 @@
+# Rails SaaS Builder
+
+Full-stack SaaS framework for Rails. Modular, extensible, production-ready.
+
+Rails SaaS Builder (RSB) is a collection of Rails engines that provide SaaS essentials out of the box. Built for Rails developers who need authentication with pluggable credentials, plan-based entitlements with usage tracking, an admin panel with role-based access control, and a dynamic settings system — all working together or independently. Use the umbrella gem for everything, or pick individual sub-gems for only what you need.
+
+## Quick Start
+
+Add to your Gemfile:
+
+```ruby
+gem "rails-saas-builder"
+```
+
+Then run:
+
+```bash
+bundle install
+rails generate rails_saas_builder:install
+rails db:migrate
+rails rsb:create_admin EMAIL=admin@example.com PASSWORD=changeme
+```
+
+Visit `/admin/login` to access the admin panel.
+Visit `/auth/session/new` to sign in as a user.
+
+## Modular Architecture
+
+RSB is composed of focused sub-gems. Use them all via `gem "rails-saas-builder"`, or pick only what you need.
+
+### Core Gems
+
+| Gem | Purpose |
+|-----|---------|
+| [rsb-settings](rsb-settings/) | Dynamic runtime settings with schema registry |
+| [rsb-auth](rsb-auth/) | Identity & authentication with pluggable credentials |
+| [rsb-entitlements](rsb-entitlements/) | Plans, entitlements, and usage tracking |
+| [rsb-admin](rsb-admin/) | Admin panel with dynamic RBAC |
+
+### Extension Gems
+
+| Gem | Purpose |
+|-----|---------|
+| [rsb-entitlements-stripe](rsb-entitlements-stripe/) | Stripe payment provider for rsb-entitlements |
+
+## Requirements
+
+- Ruby >= 3.2
+- Rails >= 8.0
+
+## Development
+
+Clone the repository and install dependencies:
+
+```bash
+git clone https://github.com/Rails-SaaS-Builder/rails-saas-builder.git
+cd rsb
+bundle install
+```
+
+Run the full test suite:
+
+```bash
+bundle exec rake test
+```
+
+Run a single gem's tests:
+
+```bash
+bundle exec rake test_gem GEM=rsb-auth
+```
+
+Run the linter:
+
+```bash
+bundle exec rubocop
+```
+
+## Contributing
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) for development setup, coding standards, and how to submit pull requests.
+
+## Security
+
+To report a security vulnerability, please see [SECURITY.md](SECURITY.md). Do not open public issues for security concerns.
+
+## License
+
+Rails SaaS Builder is licensed under the [GNU Lesser General Public License v3.0](LICENSE).

data/Rakefile

@@ -0,0 +1,47 @@
+# frozen_string_literal: true
+
+require 'bundler/setup'
+require 'rake/testtask'
+
+load File.expand_path('lib/tasks/release.rake', __dir__)
+
+SUB_GEMS = %w[rsb-settings rsb-auth rsb-entitlements rsb-entitlements-stripe rsb-admin].freeze
+
+desc 'Run tests for all sub-gems'
+task :test_subgems do
+  SUB_GEMS.each do |gem_dir|
+    puts "\n#{'=' * 60}"
+    puts "Testing #{gem_dir}"
+    puts '=' * 60
+    Dir.chdir(gem_dir) do
+      sh 'bundle install --quiet'
+      sh 'bundle exec rake test'
+    end
+  end
+end
+
+Rake::TestTask.new(:test_integration) do |t|
+  t.libs << 'test'
+  t.pattern = 'test/integration/**/*_test.rb'
+  t.verbose = false
+end
+
+desc 'Run tests for a single sub-gem: rake test_gem GEM=rsb-admin'
+task :test_gem do
+  gem_name = ENV['GEM'] || abort('Usage: rake test_gem GEM=rsb-admin')
+  abort("Unknown gem: #{gem_name}") unless SUB_GEMS.include?(gem_name)
+  Dir.chdir(gem_name) do
+    sh 'bundle install --quiet'
+    test_file = ENV['TEST']
+    if test_file
+      sh "bundle exec ruby -Itest #{test_file}"
+    else
+      sh 'bundle exec rake test'
+    end
+  end
+end
+
+desc 'Run all tests (sub-gems + integration)'
+task test: %i[test_subgems test_integration]
+
+task default: :test

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

@@ -0,0 +1,41 @@
+# frozen_string_literal: true
+
+module RailsSaasBuilder
+  class InstallGenerator < Rails::Generators::Base
+    desc 'Install Rails SaaS Builder: runs all sub-gem install generators.'
+
+    def install_settings
+      say 'Installing rsb-settings...', :green
+      generate 'rsb:settings:install'
+    end
+
+    def install_auth
+      say 'Installing rsb-auth...', :green
+      generate 'rsb:auth:install'
+    end
+
+    def install_entitlements
+      say 'Installing rsb-entitlements...', :green
+      generate 'rsb:entitlements:install'
+    end
+
+    def install_admin
+      say 'Installing rsb-admin...', :green
+      generate 'rsb:admin:install'
+    end
+
+    def print_post_install
+      say ''
+      say 'Rails SaaS Builder installed successfully!', :green
+      say ''
+      say 'Next steps:'
+      say '  1. rails db:migrate'
+      say '  2. rails rsb:create_admin EMAIL=admin@example.com PASSWORD=changeme'
+      say '  3. Visit /admin/login for the admin panel'
+      say '  4. Visit /auth/register for user registration'
+      say ''
+      say 'For documentation: https://github.com/Rails-SaaS-Builder/rails-saas-builder'
+      say ''
+    end
+  end
+end

data/lib/rails/saas/builder.rb

@@ -0,0 +1,3 @@
+# frozen_string_literal: true
+
+require 'rails_saas_builder'

data/lib/rails_saas_builder.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+require 'rsb/version'
+require 'rsb/settings'
+require 'rsb/auth'
+require 'rsb/entitlements'
+require 'rsb/admin'
+
+module RSB
+end

data/lib/rsb/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module RSB
+  VERSION = '0.9.1'
+end

data/lib/tasks/release.rake

@@ -0,0 +1,148 @@
+# frozen_string_literal: true
+
+require 'English'
+PUBLISH_ORDER = [
+  { name: 'rsb-settings',        dir: 'rsb-settings',        gemspec: 'rsb-settings.gemspec' },
+  { name: 'rsb-auth',            dir: 'rsb-auth',            gemspec: 'rsb-auth.gemspec' },
+  { name: 'rsb-entitlements',    dir: 'rsb-entitlements',    gemspec: 'rsb-entitlements.gemspec' },
+  { name: 'rsb-admin',           dir: 'rsb-admin',           gemspec: 'rsb-admin.gemspec' },
+  { name: 'rails-saas-builder',  dir: '.',                   gemspec: 'rails-saas-builder.gemspec' }
+].freeze
+
+VERSION_FILE = 'lib/rsb/version.rb'
+
+PKG_DIR = File.expand_path('pkg', __dir__.then { File.expand_path('../..', _1) })
+
+module ReleaseHelper
+  module_function
+
+  def root
+    File.expand_path('../..', __dir__)
+  end
+
+  def current_version
+    content = File.read(File.join(root, VERSION_FILE))
+    content.match(/VERSION\s*=\s*['"]([^'"]+)['"]/)[1]
+  end
+
+  def next_version(current, bump)
+    major, minor, patch = current.split('.').map(&:to_i)
+    case bump.to_s
+    when 'major' then "#{major + 1}.0.0"
+    when 'minor' then "#{major}.#{minor + 1}.0"
+    when 'patch' then "#{major}.#{minor}.#{patch + 1}"
+    else abort "Unknown bump type: #{bump}. Use patch, minor, or major."
+    end
+  end
+
+  def update_version_file(new_version)
+    full_path = File.join(root, VERSION_FILE)
+    content = File.read(full_path)
+    updated = content.gsub(/VERSION\s*=\s*['"][^'"]+['"]/, "VERSION = '#{new_version}'")
+    File.write(full_path, updated)
+    puts "  Updated #{VERSION_FILE} → #{new_version}"
+  end
+
+  def ensure_clean_git!
+    status = `git -C #{root} status --porcelain`.strip
+    abort 'Aborting: working tree is dirty. Commit or stash changes first.' unless status.empty?
+  end
+
+  def ensure_on_master!
+    branch = `git -C #{root} branch --show-current`.strip
+    abort "Aborting: not on master branch (currently on '#{branch}')." unless branch == 'master'
+  end
+
+  def ensure_tests_pass!
+    puts 'Running full test suite...'
+    return if system('bundle exec rake test', chdir: root)
+
+    abort 'Aborting: tests failed.'
+  end
+
+  def build_gem(gem_info)
+    FileUtils.mkdir_p(PKG_DIR)
+
+    gem_dir = File.join(root, gem_info[:dir])
+    gemspec = gem_info[:gemspec]
+
+    puts "  Building #{gem_info[:name]}..."
+    output = `cd #{gem_dir} && gem build #{gemspec} 2>&1`
+    abort "Failed to build #{gem_info[:name]}:\n#{output}" unless $CHILD_STATUS.success?
+
+    gem_file = output.match(/File:\s*(.+\.gem)/)[1].strip
+    source = File.join(gem_dir, gem_file)
+    dest = File.join(PKG_DIR, gem_file)
+    FileUtils.mv(source, dest)
+    puts "  Built #{dest}"
+    dest
+  end
+
+  def push_gem(gem_path)
+    name = File.basename(gem_path)
+    puts "  Pushing #{name}..."
+    abort "Failed to push #{name}." unless system("gem push #{gem_path}")
+    puts "  Pushed #{name}"
+  end
+
+  def build_all
+    puts "\nBuilding gems..."
+    PUBLISH_ORDER.map { |gem_info| build_gem(gem_info) }
+  end
+
+  def push_all(gem_paths)
+    puts "\nPushing gems to RubyGems.org..."
+    gem_paths.each { |path| push_gem(path) }
+  end
+end
+
+desc 'Build and push all gems to RubyGems.org (no version bump)'
+task :publish do
+  version = ReleaseHelper.current_version
+  puts "Publishing v#{version}..."
+
+  gem_paths = ReleaseHelper.build_all
+  ReleaseHelper.push_all(gem_paths)
+
+  puts "\nPublished v#{version} successfully!"
+end
+
+desc 'Bump version, build, push gems, tag and push git (default: patch)'
+task :release, [:bump] do |_t, args|
+  bump = args[:bump] || 'patch'
+  current = ReleaseHelper.current_version
+  new_version = ReleaseHelper.next_version(current, bump)
+
+  puts "Release: #{current} → #{new_version} (#{bump} bump)\n\n"
+
+  # Safety checks
+  ReleaseHelper.ensure_clean_git!
+  ReleaseHelper.ensure_on_master!
+  ReleaseHelper.ensure_tests_pass!
+
+  # Bump the single version file
+  puts "\nBumping version..."
+  ReleaseHelper.update_version_file(new_version)
+
+  # Git commit and tag
+  root = ReleaseHelper.root
+  puts "\nCommitting version bump..."
+  system("git -C #{root} add #{VERSION_FILE}")
+  system("git -C #{root} commit -m 'Release v#{new_version}'")
+  system("git -C #{root} tag -a v#{new_version} -m 'Release v#{new_version}'")
+
+  # Build and push gems
+  gem_paths = ReleaseHelper.build_all
+  ReleaseHelper.push_all(gem_paths)
+
+  # Push git
+  puts "\nPushing to origin..."
+  system("git -C #{root} push origin master")
+  system("git -C #{root} push origin v#{new_version}")
+
+  puts "\n#{'=' * 60}"
+  puts "Released v#{new_version} successfully!"
+  puts "  - #{PUBLISH_ORDER.size} gems pushed to RubyGems.org"
+  puts "  - Tagged v#{new_version} and pushed to origin"
+  puts '=' * 60
+end

metadata

@@ -0,0 +1,108 @@
+--- !ruby/object:Gem::Specification
+name: rails-saas-builder
+version: !ruby/object:Gem::Version
+  version: 0.9.1
+platform: ruby
+authors:
+- Aleksandr Marchenko
+bindir: bin
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rsb-admin
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 0.9.1
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 0.9.1
+- !ruby/object:Gem::Dependency
+  name: rsb-auth
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 0.9.1
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 0.9.1
+- !ruby/object:Gem::Dependency
+  name: rsb-entitlements
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 0.9.1
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 0.9.1
+- !ruby/object:Gem::Dependency
+  name: rsb-settings
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 0.9.1
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 0.9.1
+description: 'Wrapper gem that includes all RSB sub-gems: settings, auth, entitlements,
+  admin. Like how the rails gem wraps activerecord, actionpack, etc.'
+email:
+- alex@marchenko.me
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE
+- README.md
+- Rakefile
+- lib/generators/rails_saas_builder/install/install_generator.rb
+- lib/rails/saas/builder.rb
+- lib/rails_saas_builder.rb
+- lib/rsb/version.rb
+- lib/tasks/release.rake
+homepage: https://github.com/Rails-SaaS-Builder/rails-saas-builder
+licenses:
+- LGPL-3.0
+metadata:
+  source_code_uri: https://github.com/Rails-SaaS-Builder/rails-saas-builder
+  bug_tracker_uri: https://github.com/Rails-SaaS-Builder/rails-saas-builder/issues
+  changelog_uri: https://github.com/Rails-SaaS-Builder/rails-saas-builder/blob/master/CHANGELOG.md
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.2'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.6.8
+specification_version: 4
+summary: Full-stack SaaS framework for Rails
+test_files: []