kubeskills/reflex-frontend repository overview

⁠🌐 kubeskills/reflex-frontend

A minimal, high-performance NGINX image serving the statically exported frontend of a Reflex⁠ app. Built for Kubernetes deployments and SPA-friendly routing.

⁠🔹 Features

• Serves precompiled HTML/JS/CSS from Reflex export
• Compatible with Traefik, NGINX Ingress, or Gateway API
• Supports single-page app fallback (index.html)
• Lightweight and production-ready (based on nginx:alpine)

⁠📁 Static File Layout

• index.html: app entrypoint
• 404.html: custom not-found page
• sitemap.xml, favicon.ico, and _next/ assets
• __spa-fallback.html: used as base fallback for Reflex SPA routing

⁠🛠️ Ports

• 80 — default HTTP port served by NGINX

⁠🐳 Example docker run

docker run -p 8080:80 kubeskills/reflex-frontend:latest

Visit: http://localhost:8080⁠

⁠☸️ Kubernetes Deployment Example

apiVersion: apps/v1
kind: Deployment
metadata:
  name: reflex-frontend
spec:
  replicas: 2
  selector:
    matchLabels:
      app: reflex-frontend
  template:
    metadata:
      labels:
        app: reflex-frontend
    spec:
      containers:
        - name: frontend
          image: kubeskills/reflex-frontend:latest
          ports:
            - containerPort: 80
          resources:
            requests:
              cpu: 50m
              memory: 64Mi
            limits:
              cpu: 100m
              memory: 128Mi

⁠✅ Built With

• Reflex⁠ frontend export
• NGINX⁠ alpine variant
• Single-page app compatible via HTML5 fallback