docit 0.2.1 → 0.3.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3fe9c345834352ce5e4219a291760ced965cdbad10084c28cbc2aabc2823a5b5
-  data.tar.gz: 86aa4599733b72c52fe66335c4581e4f69b408af1bbb00c0c2d5f42b1b7a51fe
+  metadata.gz: 3ac8acf7fd2b736bb2c89c63a63bca482239783457d7572d864e0257a3a2c6cd
+  data.tar.gz: 1605b07b832dc73f4e7f00e0840aa72267cbb60262e17baba6842134ee576e19
 SHA512:
-  metadata.gz: 9ad86a75a50a1a1177cf7cbde2bf49f12eb7cc36e1df9fd268ff2b6519c7b01efffc680aab2484a83f3dbdfb410740633a7cabbf8072d873403deafc6c14ccd3
-  data.tar.gz: 2fbf560890376ef66614e12f961496b77ab5bfb2e994ffaeb006cc2a5ddd9ef82128115cf7d1fba39a89a889b0aec8342d487525eedad276a9b8244a6ee574d3
+  metadata.gz: a72fa34e950fdf918daab680c287311401a4059fa3b8d0bf16a0ebcef210ed607b697d3ad58a3343bf7d105a2a11d717efd0f8ee239464a82f58ca5f934b1e79
+  data.tar.gz: 96516820d968faae672a4caa7b6c52c9d79356b6366d09edaa019badb2c6949c0b4087115e6f306f559904b5dbcb02b594c2e0e58e864458c0c460e381d4d894

data/CHANGELOG.md

@@ -1,5 +1,20 @@
 ## [Unreleased]
 
+## [0.3.0] - 2026-04-16
+
+### Added
+- Scalar API Reference as a second documentation UI alongside Swagger UI
+- New routes: `/api-docs/scalar` and `/api-docs/swagger` for direct access to each UI
+- `config.default_ui` option (`:scalar` or `:swagger`) to control which UI renders at the root `/api-docs` path
+- Navigation bar across both UIs for one-click switching between Scalar and Swagger
+- Modular renderer architecture (`Docit::UI::BaseRenderer`, `SwaggerRenderer`, `ScalarRenderer`) for easy extension
+
+### Changed
+- Default documentation UI is now Scalar (previously Swagger UI)
+- `config.description` now defaults to a welcome message instead of an empty string
+- Install generator template now documents the `default_ui` option
+- UI controller refactored from monolithic HTML generation to thin dispatcher with pluggable renderers
+
 ## [0.2.1] - 2026-04-11
 
 ### Fixed

data/README.md

@@ -5,6 +5,12 @@
 
 Decorator-style API documentation for Ruby on Rails. Write OpenAPI 3.0.3 docs with clean controller DSL macros, separate doc modules, or AI-assisted scaffolding for undocumented endpoints.
 
+### Scalar (default)
+![Scalar API Reference](docs/images/scalar_image.png)
+
+### Swagger
+![Swagger UI](docs/images/swagger_image.png)
+
 ## Table Of Contents
 
 - Getting started
@@ -32,6 +38,7 @@ Decorator-style API documentation for Ruby on Rails. Write OpenAPI 3.0.3 docs wi
   - [Supported providers](#supported-providers)
   - [What the AI generates](#what-the-ai-generates)
 - Runtime and development
+  - [Documentation UIs](#documentation-uis)
   - [How it works](#how-it-works)
   - [Mounting at a different path](#mounting-at-a-different-path)
   - [JSON spec only](#json-spec-only)
@@ -61,13 +68,13 @@ rails generate docit:install
 The install generator does everything in one step:
 
 1. Creates `config/initializers/docit.rb` with default settings
-2. Mounts the Swagger UI engine at `/api-docs` in your routes
+2. Mounts the documentation engine at `/api-docs` in your routes
 3. Asks how you'd like to set up your docs:
    - **AI automatic docs** — configure an AI provider, then Docit scans your routes and generates complete documentation for every endpoint
    - **Manual docs** — Docit scans your routes and creates scaffolded doc files with TODO placeholders, injects `use_docs` into controllers, and lets you fill in the details
    - **Skip** — just install the base config and set up docs later
 
-Visit `/api-docs` to see your interactive API documentation.
+Visit `/api-docs` to see your interactive API documentation (Scalar by default, Swagger UI also available at `/api-docs/swagger`).
 
 If you choose AI setup, Docit stores your provider config in `.docit_ai.yml` with restricted file permissions and adds that file to `.gitignore` when possible.
 
@@ -81,17 +88,20 @@ Docit.configure do |config|
   config.version     = "1.0.0"
   config.description = "Backend API documentation"
 
+  # Documentation UI: :scalar (default) or :swagger
+  config.default_ui  = :scalar
+
   # Authentication: pick one (or multiple):
   config.auth :bearer                              # Bearer token (JWT by default)
   config.auth :basic                               # HTTP Basic
   config.auth :api_key, name: "X-API-Key",         # API key in header
                          location: "header"
 
-  # Tag descriptions (shown in Swagger UI sidebar):
+  # Tag descriptions (shown in the documentation sidebar):
   config.tag "Users", description: "User account management"
   config.tag "Auth",  description: "Authentication endpoints"
 
-  # Server URLs (shown in Swagger UI server dropdown):
+  # Server URLs (shown in the server dropdown):
   config.server "https://api.example.com", description: "Production"
   config.server "https://staging.example.com", description: "Staging"
   config.server "http://localhost:3000", description: "Development"
@@ -467,11 +477,24 @@ For each undocumented endpoint, Docit:
 
 Do not use AI autodoc on controllers that contain secrets, proprietary business rules, or internal comments you do not want sent to an external provider.
 
+## Documentation UIs
+
+Docit ships with two documentation UIs, both reading from the same OpenAPI spec:
+
+| Path | UI | Notes |
+|------|------|-------|
+| `/api-docs` | Default (Scalar) | Configurable via `config.default_ui` |
+| `/api-docs/scalar` | Scalar API Reference | Modern UI with built-in API client, dark mode, code samples |
+| `/api-docs/swagger` | Swagger UI | Classic OpenAPI explorer |
+| `/api-docs/spec` | Raw JSON | OpenAPI 3.0.3 spec |
+
+Both UIs include a navigation bar to switch between them. Set `config.default_ui = :swagger` to make Swagger the default at `/api-docs`.
+
 ## How it works
 
 1. `swagger_doc` registers an **Operation** for each controller action in a global **Registry**
 2. When someone visits `/api-docs/spec`, Docit's **SchemaGenerator** combines all registered operations with your Rails routes (via **RouteInspector**) to produce an OpenAPI 3.0.3 JSON document
-3. The **Engine** serves Swagger UI at `/api-docs`, pointing it at the generated spec
+3. The **Engine** serves the configured documentation UI at `/api-docs`, pointing it at the generated spec
 
 The DSL is included in all controllers automatically via a Rails Engine initializer — no manual `include` needed if you're using `ActionController::API` or `ActionController::Base`.
 

data/app/controllers/docit/ui_controller.rb

@@ -4,10 +4,16 @@ require "json"
 
 module Docit
   class UiController < ActionController::Base
-    SWAGGER_UI_VERSION = "5.32.2"
-
     def index
-      render html: swagger_ui_html.html_safe, layout: false
+      render_ui(Docit.configuration.default_ui)
+    end
+
+    def swagger
+      render_ui(:swagger)
+    end
+
+    def scalar
+      render_ui(:scalar)
     end
 
     def spec
@@ -17,52 +23,23 @@ module Docit
 
     private
 
-    def swagger_ui_html
-      spec_url = "#{request.base_url}#{Docit::Engine.routes.url_helpers.spec_path}"
-      spec_url_json = JSON.generate(spec_url)
-      escaped_title = ERB::Util.html_escape(Docit.configuration.title)
+    RENDERERS = {
+      swagger: UI::SwaggerRenderer,
+      scalar: UI::ScalarRenderer
+    }.freeze
+
+    def render_ui(ui_name)
+      renderer = RENDERERS.fetch(ui_name).new(spec_url: spec_url, nav_paths: nav_paths)
+      render html: renderer.render.html_safe, layout: false
+    end
+
+    def spec_url
+      "#{request.base_url}#{Docit::Engine.routes.url_helpers.spec_path}"
+    end
 
-      <<~HTML
-        <!DOCTYPE html>
-        <html lang="en">
-        <head>
-          <meta charset="UTF-8">
-          <meta name="viewport" content="width=device-width, initial-scale=1.0">
-          <title>#{escaped_title}</title>
-          <link rel="stylesheet" href="https://unpkg.com/swagger-ui-dist@#{SWAGGER_UI_VERSION}/swagger-ui.css" />
-          <style>
-            html { box-sizing: border-box; overflow-y: scroll; }
-            *, *:before, *:after { box-sizing: inherit; }
-            body { margin: 0; background: #fafafa; }
-          </style>
-        </head>
-        <body>
-          <div id="swagger-ui"></div>
-          <script src="https://unpkg.com/swagger-ui-dist@#{SWAGGER_UI_VERSION}/swagger-ui-bundle.js"></script>
-          <script>
-            SwaggerUIBundle({
-              url: #{spec_url_json},
-              dom_id: '#swagger-ui',
-              presets: [
-                SwaggerUIBundle.presets.apis,
-                SwaggerUIBundle.SwaggerUIStandalonePreset
-              ],
-              layout: "BaseLayout",
-              deepLinking: true,
-              showExtensions: true,
-              showCommonExtensions: true,
-              requestInterceptor: function(req) {
-                var url = new URL(req.url);
-                url.protocol = window.location.protocol;
-                url.host = window.location.host;
-                req.url = url.toString();
-                return req;
-              }
-            })
-          </script>
-        </body>
-        </html>
-      HTML
+    def nav_paths
+      helpers = Docit::Engine.routes.url_helpers
+      { swagger: helpers.swagger_path, scalar: helpers.scalar_path }
     end
   end
 end

data/config/routes.rb

@@ -2,5 +2,7 @@
 
 Docit::Engine.routes.draw do
   root to: "ui#index"
+  get "swagger", to: "ui#swagger"
+  get "scalar", to: "ui#scalar"
   get "spec", to: "ui#spec", defaults: { format: :json }
 end

data/lib/docit/ai/autodoc_runner.rb

@@ -3,6 +3,8 @@
 module Docit
   module Ai
     class AutodocRunner
+      MAX_INVALID_OUTPUT_RETRIES = 2
+
       attr_reader :results
 
       def initialize(controller_filter: nil, dry_run: false, input: $stdin, output: $stdout)
@@ -50,7 +52,7 @@ module Docit
       end
 
       def check_base_setup!
-        if !(defined?(Rails) && Rails.respond_to?(:root) && Rails.root)
+        if defined?(Rails) == false || Rails.respond_to?(:root) == false || Rails.root.nil?
           raise Docit::Error, "Docit requires a Rails application. Run this command from your app root."
         end
 
@@ -82,20 +84,20 @@ module Docit
         @output.puts "Docit will send controller source code to #{config.provider.capitalize} to generate documentation."
         @output.puts "Review the endpoints first if they contain secrets or proprietary logic."
 
-        return if !(@input.respond_to?(:tty?) && @input.tty?)
-
-        loop do
-          @output.print "Continue? (y/n): "
-          choice = @input.gets.to_s.strip.downcase
-
-          case choice
-          when "y", "yes"
-            @output.puts ""
-            return
-          when "n", "no"
-            raise Docit::Error, "Autodoc cancelled."
-          else
-            @output.puts "Please enter y or n."
+        if @input.respond_to?(:tty?) && @input.tty?
+          loop do
+            @output.print "Continue? (y/n): "
+            choice = @input.gets.to_s.strip.downcase
+
+            case choice
+            when "y", "yes"
+              @output.puts ""
+              return
+            when "n", "no"
+              raise Docit::Error, "Autodoc cancelled."
+            else
+              @output.puts "Please enter y or n."
+            end
           end
         end
       end
@@ -115,17 +117,31 @@ module Docit
             @output.puts " skipped (controller source file not found)"
             next
           end
-
-          prompt = builder.build
           retries = 0
+          invalid_output_retries = 0
+          validation_error = nil
 
           begin
+            prompt = builder.build(validation_error: validation_error)
             doc_block = client.generate(prompt).strip
             doc_block = strip_markdown_fences(doc_block)
+            DocBlockValidator.new(
+              controller: gap[:controller],
+              action: gap[:action],
+              doc_block: doc_block
+            ).validate!
 
             generated[gap[:controller]] << doc_block
             @results[:generated] += 1
             @output.puts " done"
+          rescue Docit::Ai::InvalidDocBlockError => e
+            invalid_output_retries += 1
+            if invalid_output_retries <= MAX_INVALID_OUTPUT_RETRIES
+              validation_error = e.message
+              retry
+            end
+
+            @output.puts " failed (invalid doc DSL: #{e.message})"
           rescue Docit::Ai::RateLimitError => e
             retries += 1
             if retries <= max_retries
@@ -168,11 +184,11 @@ module Docit
 
       def inject_tags(generated)
         all_tags = generated.values.flatten.join("\n").scan(/tags\s+["']([^"']+)["']/).flatten
-        return unless all_tags.any?
-
-        injected = TagInjector.new(tags: all_tags).inject
-        injected.each { |tag| @output.puts "  Added tag \"#{tag}\" to config/initializers/docit.rb" }
-        @results[:tags] = injected
+        if all_tags.any?
+          injected = TagInjector.new(tags: all_tags).inject
+          injected.each { |tag| @output.puts "  Added tag \"#{tag}\" to config/initializers/docit.rb" }
+          @results[:tags] = injected
+        end
       end
 
       def strip_markdown_fences(text)

data/lib/docit/ai/configuration.rb

@@ -6,6 +6,11 @@ module Docit
   module Ai
     class Configuration
       CONFIG_FILE = ".docit_ai.yml"
+      GENERATED_FILE_COMMENT = <<~TEXT
+        # If you want to change the model and start Docit setup again,
+        # rerun: rails generate docit:install
+
+      TEXT
 
       PROVIDERS = %w[openai anthropic groq].freeze
 
@@ -51,11 +56,13 @@ module Docit
           config = new(provider: provider, model: model, api_key: api_key)
           raise Error, "Invalid configuration" if config.valid? == false
 
-          File.write(config_path, {
+          yaml = {
             "provider" => config.provider,
             "model" => config.model,
             "api_key" => config.api_key
-          }.to_yaml)
+          }.to_yaml
+
+          File.write(config_path, GENERATED_FILE_COMMENT + yaml)
           File.chmod(0o600, config_path)
 
           config

data/lib/docit/ai/doc_block_validator.rb

@@ -0,0 +1,48 @@
+# frozen_string_literal: true
+
+module Docit
+  module Ai
+    class InvalidDocBlockError < Error; end
+
+    class DocBlockValidator
+      def initialize(controller:, action:, doc_block:)
+        @controller = controller
+        @action = action.to_sym
+        @doc_block = doc_block
+      end
+
+      def validate!
+        doc_module = Module.new
+        doc_module.extend(Docit::DocFile)
+        doc_module.module_eval(@doc_block, "(generated Docit block)", 1)
+
+        validate_actions!(doc_module.actions)
+
+        operation = Docit::Operation.new(controller: @controller, action: @action)
+        operation.instance_eval(&doc_module[@action])
+
+        true
+      rescue SyntaxError, StandardError => e
+        raise InvalidDocBlockError, error_message_for(e)
+      end
+
+      private
+
+      def validate_actions!(actions)
+        return if actions == [@action]
+
+        raise InvalidDocBlockError, "Generated output did not define a doc block" if actions.empty?
+
+        action_list = actions.map { |action| ":#{action}" }.join(", ")
+        raise InvalidDocBlockError,
+              "Generated output must define only doc :#{@action}, got #{action_list}"
+      end
+
+      def error_message_for(error)
+        return error.message if error.is_a?(InvalidDocBlockError)
+
+        "#{error.class}: #{error.message}"
+      end
+    end
+  end
+end

data/lib/docit/ai/prompt_builder.rb

@@ -66,7 +66,7 @@ module Docit
         @gap = gap
       end
 
-      def build
+      def build(validation_error: nil)
         <<~PROMPT
           You are generating Docit DSL documentation for a Ruby on Rails API endpoint.
 
@@ -89,12 +89,18 @@ module Docit
           Rules:
           - Output ONLY the `doc :#{@gap[:action]} do ... end` block
           - No module wrapper, no explanation, no markdown fences
+          - Use exactly `doc :#{@gap[:action]} do ... end` for the requested action
+          - Use ONLY the DSL methods listed above
           - Infer parameters from the path (e.g., {id} → path parameter)
           - Infer request body from params usage in the controller
           - Infer response structure from render calls
+          - Inside `request_body` and `response` blocks, define nested data only with `property ..., type: :object` or `property ..., type: :array`
+          - Never call standalone helpers such as `object`, `array`, `string`, `integer`, `number`, or `boolean`
+          - Return valid Ruby that can be `instance_eval`'d as-is
           - Use realistic examples
           - Include appropriate error responses
           - Use the controller name to determine appropriate tags
+          #{validation_feedback(validation_error)}
         PROMPT
       end
 
@@ -114,10 +120,22 @@ module Docit
       end
 
       def controller_file_path
-        return nil if defined?(Rails) == false || Rails.respond_to?(:root) == false || Rails.root.nil?
+        return nil unless defined?(::Rails) && ::Rails.respond_to?(:root) && ::Rails.root
 
         relative = @gap[:controller].underscore
-        Rails.root.join("app", "controllers", "#{relative}.rb").to_s
+        ::Rails.root.join("app", "controllers", "#{relative}.rb").to_s
+      end
+
+      def validation_feedback(validation_error)
+        return "" if validation_error.nil? || validation_error.empty?
+
+        <<~FEEDBACK
+
+          Previous attempt failed Docit validation:
+          - #{validation_error}
+
+          Regenerate the block and fix that error.
+        FEEDBACK
       end
     end
   end

data/lib/docit/ai.rb

@@ -6,6 +6,7 @@ require_relative "ai/openai_client"
 require_relative "ai/anthropic_client"
 require_relative "ai/groq_client"
 require_relative "ai/gap_detector"
+require_relative "ai/doc_block_validator"
 require_relative "ai/prompt_builder"
 require_relative "ai/doc_writer"
 require_relative "ai/tag_injector"

data/lib/docit/configuration.rb

@@ -3,18 +3,31 @@
 module Docit
   # Holds global API documentation settings: metadata, authentication, tags, and servers.
   class Configuration
+    SUPPORTED_UIS = %i[scalar swagger].freeze
+
     attr_accessor :title, :version, :description, :base_url
+    attr_reader :default_ui
 
     def initialize
       @title = "API Documentation"
       @version = "1.0.0"
-      @description = ""
+      @description = "Welcome to the API documentation. Browse the endpoints below to get started."
       @base_url = "/"
+      @default_ui = :scalar
       @security_schemes = {}
       @tags = []
       @servers = []
     end
 
+    def default_ui=(value)
+      ui = value.to_sym
+      unless SUPPORTED_UIS.include?(ui)
+        raise ArgumentError, "Unsupported UI: #{value}. Must be one of: #{SUPPORTED_UIS.join(", ")}"
+      end
+
+      @default_ui = ui
+    end
+
     def auth(type, **options)
       case type.to_s.downcase
       when "basic"

data/lib/docit/ui/base_renderer.rb

@@ -0,0 +1,55 @@
+# frozen_string_literal: true
+
+module Docit
+  module UI
+    class BaseRenderer
+      attr_reader :spec_url, :title, :nav_paths
+
+      def initialize(spec_url:, nav_paths: {})
+        @spec_url = spec_url
+        @nav_paths = nav_paths
+        @title = ERB::Util.html_escape(Docit.configuration.title)
+      end
+
+      def render
+        raise NotImplementedError, "#{self.class}#render must be implemented"
+      end
+
+      private
+
+      def nav_bar(active:)
+        swagger_active = active == :swagger
+        scalar_active = active == :scalar
+
+        <<~HTML
+          <nav style="
+            display: flex; align-items: center; gap: 8px;
+            padding: 6px 16px;
+            background: #1a1a2e; color: #fff;
+            font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;
+            font-size: 13px; position: sticky; top: 0; z-index: 9999;
+          ">
+            <span style="font-weight: 600; margin-right: auto;">#{title}</span>
+            #{nav_link("Swagger", nav_paths[:swagger], active: swagger_active)}
+            #{nav_link("Scalar", nav_paths[:scalar], active: scalar_active)}
+          </nav>
+        HTML
+      end
+
+      def nav_link(label, path, active:)
+        escaped_path = ERB::Util.html_escape(path)
+        style = if active
+                  "color: #fff; text-decoration: none; padding: 4px 12px; border-radius: 4px; background: rgba(255,255,255,0.15); font-weight: 500;"
+                else
+                  "color: rgba(255,255,255,0.7); text-decoration: none; padding: 4px 12px; border-radius: 4px;"
+                end
+
+        %(<a href="#{escaped_path}" style="#{style}">#{label}</a>)
+      end
+
+      def spec_url_json
+        JSON.generate(spec_url)
+      end
+    end
+  end
+end

data/lib/docit/ui/scalar_renderer.rb

@@ -0,0 +1,38 @@
+# frozen_string_literal: true
+
+module Docit
+  module UI
+    class ScalarRenderer < BaseRenderer
+      def render
+        <<~HTML
+          <!DOCTYPE html>
+          <html lang="en">
+          <head>
+            <meta charset="UTF-8">
+            <meta name="viewport" content="width=device-width, initial-scale=1.0">
+            <title>#{title}</title>
+            <style>
+              body { margin: 0; }
+            </style>
+          </head>
+          <body>
+            #{nav_bar(active: :scalar)}
+            <script id="api-reference"></script>
+            <script>
+              document.getElementById('api-reference').dataset.configuration = JSON.stringify({
+                spec: { url: #{spec_url_json} },
+                theme: "elysiajs",
+                showSidebar: true,
+                hideDownloadButton: false,
+                hideModels: false,
+                searchHotKey: "k"
+              })
+            </script>
+            <script src="https://cdn.jsdelivr.net/npm/@scalar/api-reference"></script>
+          </body>
+          </html>
+        HTML
+      end
+    end
+  end
+end

data/lib/docit/ui/swagger_renderer.rb

@@ -0,0 +1,54 @@
+# frozen_string_literal: true
+
+module Docit
+  module UI
+    class SwaggerRenderer < BaseRenderer
+      VERSION = "5.32.2"
+
+      def render
+        <<~HTML
+          <!DOCTYPE html>
+          <html lang="en">
+          <head>
+            <meta charset="UTF-8">
+            <meta name="viewport" content="width=device-width, initial-scale=1.0">
+            <title>#{title}</title>
+            <link rel="stylesheet" href="https://unpkg.com/swagger-ui-dist@#{VERSION}/swagger-ui.css" />
+            <style>
+              html { box-sizing: border-box; overflow-y: scroll; }
+              *, *:before, *:after { box-sizing: inherit; }
+              body { margin: 0; background: #fafafa; }
+            </style>
+          </head>
+          <body>
+            #{nav_bar(active: :swagger)}
+            <div id="swagger-ui"></div>
+            <script src="https://unpkg.com/swagger-ui-dist@#{VERSION}/swagger-ui-bundle.js"></script>
+            <script>
+              SwaggerUIBundle({
+                url: #{spec_url_json},
+                dom_id: '#swagger-ui',
+                presets: [
+                  SwaggerUIBundle.presets.apis,
+                  SwaggerUIBundle.SwaggerUIStandalonePreset
+                ],
+                layout: "BaseLayout",
+                deepLinking: true,
+                showExtensions: true,
+                showCommonExtensions: true,
+                requestInterceptor: function(req) {
+                  var url = new URL(req.url);
+                  url.protocol = window.location.protocol;
+                  url.host = window.location.host;
+                  req.url = url.toString();
+                  return req;
+                }
+              })
+            </script>
+          </body>
+          </html>
+        HTML
+      end
+    end
+  end
+end

data/lib/docit/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Docit
-  VERSION = "0.2.1"
+  VERSION = "0.3.1"
 end

data/lib/docit.rb

@@ -12,6 +12,9 @@ require_relative "docit/doc_file"
 require_relative "docit/route_inspector"
 require_relative "docit/schema_generator"
 require_relative "docit/dsl"
+require_relative "docit/ui/base_renderer"
+require_relative "docit/ui/swagger_renderer"
+require_relative "docit/ui/scalar_renderer"
 
 # Docit is a decorator-style API documentation gem for Ruby on Rails.
 # It generates OpenAPI 3.0.3 specs from clean DSL macros on your controllers.

data/lib/generators/docit/install/templates/initializer.rb

@@ -1,15 +1,18 @@
 # frozen_string_literal: true
 
 Docit.configure do |config|
-  # The title shown in Swagger UI
+  # The title shown in the API documentation UI
   config.title = "<%= Rails.application.class.module_parent_name rescue 'My API' %>"
 
   # API version
   config.version = "1.0.0"
 
-  # Description shown in Swagger UI
+  # Description shown on the introduction page
   config.description = "API documentation powered by Docit"
 
+  # Documentation UI: :scalar (default) or :swagger
+  # config.default_ui = :scalar
+
   # Authentication scheme (options: :bearer, :basic, :api_key)
   # config.auth :bearer
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: docit
 version: !ruby/object:Gem::Version
-  version: 0.2.1
+  version: 0.3.1
 platform: ruby
 authors:
 - S13G
@@ -43,12 +43,15 @@ files:
 - Rakefile
 - app/controllers/docit/ui_controller.rb
 - config/routes.rb
+- docs/images/scalar_image.png
+- docs/images/swagger_image.png
 - lib/docit.rb
 - lib/docit/ai.rb
 - lib/docit/ai/anthropic_client.rb
 - lib/docit/ai/autodoc_runner.rb
 - lib/docit/ai/client.rb
 - lib/docit/ai/configuration.rb
+- lib/docit/ai/doc_block_validator.rb
 - lib/docit/ai/doc_writer.rb
 - lib/docit/ai/gap_detector.rb
 - lib/docit/ai/groq_client.rb
@@ -68,6 +71,9 @@ files:
 - lib/docit/route_inspector.rb
 - lib/docit/schema_definition.rb
 - lib/docit/schema_generator.rb
+- lib/docit/ui/base_renderer.rb
+- lib/docit/ui/scalar_renderer.rb
+- lib/docit/ui/swagger_renderer.rb
 - lib/docit/version.rb
 - lib/generators/docit/ai_setup/ai_setup_generator.rb
 - lib/generators/docit/install/install_generator.rb
@@ -80,7 +86,7 @@ licenses:
 metadata:
   homepage_uri: https://github.com/S13G/docit
   source_code_uri: https://github.com/S13G/docit
-  changelog_uri: https://github.com/S13G/docit/blob/main/CHANGELOG.md
+  changelog_uri: https://github.com/S13G/docit/blob/master/CHANGELOG.md
   documentation_uri: https://rubydoc.info/gems/docit
   bug_tracker_uri: https://github.com/S13G/docit/issues
   rubygems_mfa_required: 'true'