html2rss
diff --git a/‎.github/copilot-instructions.md‎
Lines changed: 15 additions & 0 deletions b/‎.github/copilot-instructions.md‎
Lines changed: 15 additions & 0 deletions
diff --git a/‎app.rb‎
Lines changed: 48 additions & 14 deletions b/‎app.rb‎
Lines changed: 48 additions & 14 deletions
diff --git a/‎app/app_routes.rb‎
Lines changed: 0 additions & 73 deletions b/‎app/app_routes.rb‎
Lines changed: 0 additions & 73 deletions
diff --git a/‎app/auto_source.rb‎
Lines changed: 2 additions & 0 deletions b/‎app/auto_source.rb‎
Lines changed: 2 additions & 0 deletions
diff --git a/‎app/auto_source_routes.rb‎
Lines changed: 0 additions & 192 deletions b/‎app/auto_source_routes.rb‎
Lines changed: 0 additions & 192 deletions
@@ -43,6 +43,16 @@ Search these pages before using them. Find examples, plugins, UI components, and
 - ✅ **CSS**: Use frontend styles in `frontend/public/styles.css`. Water.css for fallback.
 - ✅ **Specs**: RSpec for Ruby, build tests for frontend.
 
+## Roda Large Applications Structure
+
+This project follows [Roda Large Applications conventions](https://roda.jeremyevans.net/rdoc/files/doc/conventions_rdoc.html#label-Large+Applications):
+
+- **Use `hash_branches` plugin** (not `hash_branch_view_subdir` since we have no views)
+- **Route modules** go in `routes/` directory (one file per prefix)
+- **Helper modules** go in `helpers/` directory with `module_function`
+- **Core app modules** stay in `app/` directory
+- **Load routes/helpers** with `Dir['routes/*.rb'].each { |f| require_relative f }`
+
 ## Don't
 
 - ❌ Don't depend on JS for core flows.
@@ -77,6 +87,11 @@ Search these pages before using them. Find examples, plugins, UI components, and
 - `HEALTH_CHECK_USERNAME`, `HEALTH_CHECK_PASSWORD`
 - `SENTRY_DSN` (optional)
 
+### Verification Steps
+- Run `ruby -c app.rb` to check syntax
+- Run `bundle exec rspec` to verify tests
+- Check `bundle install` removes unused dependencies
+
 ## Style
 
 - Add `# frozen_string_literal: true`
 
@@ -7,17 +7,14 @@
 require 'html2rss'
 require_relative 'app/environment_validator'
 require_relative 'app/roda_config'
-require_relative 'app/app_routes'
 require_relative 'app/auth'
 require_relative 'app/auto_source'
 require_relative 'app/feeds'
 require_relative 'app/health_check'
-require_relative 'app/api_routes'
-require_relative 'app/response_helpers'
-require_relative 'app/static_file_helpers'
+require_relative 'app/response_context'
+require_relative 'app/request_context'
+require_relative 'app/base_route_handler'
 require_relative 'app/xml_builder'
-require_relative 'app/auto_source_routes'
-require_relative 'app/health_check_routes'
 require_relative 'app/security_logger'
 
 module Html2rss
@@ -27,12 +24,6 @@ module Web
     #
     # It is built with [Roda](https://roda.jeremyevans.net/).
     class App < Roda
-      include ApiRoutes
-      include ResponseHelpers
-      include StaticFileHelpers
-      include AutoSourceRoutes
-      include HealthCheckRoutes
-
       CONTENT_TYPE_RSS = 'application/xml'
 
       def self.development? = ENV['RACK_ENV'] == 'development'
@@ -45,10 +36,53 @@ def development? = self.class.development?
       # Configure Roda app
       RodaConfig.configure(self)
 
+      # Load hash_branches plugin for Large Applications
+      plugin :hash_branches
+
+      # Load all route files
+      Dir['routes/*.rb'].each { |f| require_relative f }
+
       @show_backtrace = development? && !ENV['CI']
 
-      # Define all routes
-      AppRoutes.define_routes(self)
+      # Load all routes
+      AppRoutes.load_routes(self)
+
+      route do |r|
+        r.public
+        r.hash_branches('')
+
+        r.root do
+          # Handle root path
+          index_path = 'public/frontend/index.html'
+          response['Content-Type'] = 'text/html'
+
+          if File.exist?(index_path)
+            File.read(index_path)
+          else
+            fallback_html
+          end
+        end
+      end
+
+      def fallback_html
+        <<~HTML
+          <!DOCTYPE html>
+          <html>
+          <head>
+            <title>html2rss-web</title>
+            <link rel="stylesheet" href="/water.css">
+          </head>
+          <body>
+            <h1>html2rss-web</h1>
+            <p>Convert websites to RSS feeds</p>
+            <p>API available at <code>/api/</code></p>
+          </body>
+          </html>
+        HTML
+      end
+
+      # Load all helper files
+      Dir['helpers/*.rb'].each { |f| require_relative f }
     end
   end
 end
@@ -127,6 +127,8 @@ def create_empty_feed_warning(url, strategy)
       end
 
       def call_strategy(url, strategy) # rubocop:disable Metrics/MethodLength
+        return error_feed('URL parameter required') if url.nil? || url.empty?
+
         global_config = LocalConfig.global
 
         config = {