Isolate SPA build output from public files

Author: gildesmarais

.dockerignore

@@ -20,6 +20,4 @@ renovate.json
 spec/
 tmp/
 work/
-public/assets/
-public/frontend/
-public/index.html
+frontend/dist/

.gitignore

@@ -38,10 +38,7 @@
 
 # Ignore frontend build output and tooling caches
 /frontend/dist/
-/public/assets/
-/public/index.html
 /frontend/node_modules/
-/public/frontend
 /frontend/playwright-report/
 /frontend/test-results/
 

Dockerfile

@@ -93,7 +93,6 @@ COPY --chown=$USER:$USER Gemfile Gemfile.lock app.rb config.ru ./
 COPY --chown=$USER:$USER app ./app
 COPY --chown=$USER:$USER config ./config
 COPY --chown=$USER:$USER public ./public
-COPY --from=frontend-builder --chown=$USER:$USER /app/public/index.html ./public/index.html
-COPY --from=frontend-builder --chown=$USER:$USER /app/public/assets ./public/assets
+COPY --from=frontend-builder --chown=$USER:$USER /app/frontend/dist ./frontend/dist
 
 CMD ["bundle", "exec", "puma", "-C", "./config/puma.rb"]

README.md

@@ -20,7 +20,7 @@ html2rss-web converts arbitrary websites into RSS 2.0 feeds with a slim Ruby bac
 ## Architecture
 
 - **Backend:** Ruby + Roda, backed by the `html2rss` gem for extraction.
-- **Frontend:** Preact app built with Vite into `public/`.
+- **Frontend:** Preact app built with Vite into `frontend/dist` and served at `/`.
 - **Distribution:** Docker Compose by default; other deployments require manual wiring.
 - [Project notes](docs/README.md)
 
@@ -101,7 +101,7 @@ The OpenAPI file is generated from Ruby request specs only.
 | Command                 | Purpose                                      |
 | ----------------------- | -------------------------------------------- |
 | `npm run dev`           | Vite dev server with hot reload (port 4001). |
-| `npm run build`         | Build static assets into `public/`.          |
+| `npm run build`         | Build static assets into `frontend/dist/`.   |
 | `npm run test:run`      | Unit tests (Vitest).                         |
 | `npm run test:contract` | Contract tests with MSW.                     |
 

app.rb

@@ -31,6 +31,8 @@ class App < Roda
           </body>
         </html>
       HTML
+      FRONTEND_DIST_PATH = 'frontend/dist'
+      FRONTEND_INDEX_PATH = File.join(FRONTEND_DIST_PATH, 'index.html')
       def self.development? = EnvironmentValidator.development?
 
       def development? = self.class.development?
@@ -80,6 +82,10 @@ def development? = self.class.development?
       }
 
       plugin :json_parser
+      plugin :static,
+             ['/assets'],
+             root: FRONTEND_DIST_PATH,
+             headers: { 'Cache-Control' => 'public, max-age=31536000, immutable' }
       plugin :public
       plugin :head
       plugin :not_allowed
@@ -100,9 +106,8 @@ def development? = self.class.development?
       private
 
       def render_index_page(router)
-        index_path = 'public/index.html'
         router.response['Content-Type'] = 'text/html'
-        File.exist?(index_path) ? File.read(index_path) : FALLBACK_HTML
+        File.exist?(FRONTEND_INDEX_PATH) ? File.read(FRONTEND_INDEX_PATH) : FALLBACK_HTML
       end
     end
   end

docs/README.md

@@ -9,7 +9,7 @@ The only other file that belongs in `docs/` is the generated OpenAPI contract at
 ## System Snapshot
 
 - Backend: Ruby + Roda under the `Html2rss::Web` namespace.
-- Frontend: Preact + Vite, built into `public/`.
+- Frontend: Preact + Vite, built into `frontend/dist` and served at `/`.
 - Feed extraction: delegated to the `html2rss` gem.
 - Distribution: Docker Compose / Dev Container first.
 

frontend/vite.config.ts

@@ -20,7 +20,7 @@ export default defineConfig({
     exclude: ['msw/node'],
   },
   build: {
-    outDir: '../public',
-    emptyOutDir: false,
+    outDir: './dist',
+    emptyOutDir: true,
   },
 });