Skip to content
Sillo

Frontend (SPA)

Serving static files and SPAs with Sillo.

Frontend (SPA)

Section titled “Frontend (SPA)”

Sillo no longer includes a built-in FrontendApp or app.frontend() helper.

For serving static files and single-page applications, use one of the following approaches:

Using a reverse proxy

Section titled “Using a reverse proxy”

The recommended production setup is to serve static assets from a reverse proxy or CDN in front of the Sillo application:

Terminal window
# nginx example
location / {
    proxy_pass http://127.0.0.1:8000;
}


location /static/ {
    alias /path/to/dist/;
    expires 1y;
}

Using StaticFiles

Section titled “Using StaticFiles”

For development or simple deployments, mount Starlette’s StaticFiles directly:

from starlette.staticfiles import StaticFiles


app = SilloApp()
app.mount("/static", StaticFiles(directory="dist"), name="static")

Custom ASGI middleware

Section titled “Custom ASGI middleware”

For SPA fallback routing, write a small ASGI middleware or mount a custom BaseRouter subclass. This gives you full control over caching, fallback behaviour, and security headers.

Getting Started

Introduction Philosophy FAQ Coming from FastAPI & Django What's in the Box Installation Request Lifecycle

Core Concepts

Configuration Environment & .env Routing Routers & Sub-Apps Handlers Middleware Dependency Injection URL Normalization Request Information Handling Inputs Request Parameters Headers Cookies File Uploads Content Negotiation Sending Responses JSON Serialization Streaming Responses Pagination Error Handling

Building an Application

Creating a Project Project Structure The Console Database & Migrations Users & Authentication Background Work Testing Deployment

Validation

Overview Parameters Request Bodies Forms & File Uploads Response Models Validation Errors Generated Docs

Deep Dive

Startup & Shutdown Concurrency & Thread Pool Caching Storage Event System OpenAPI Overview Documentation UI OpenAPI Parameters OpenAPI Request Schemas OpenAPI Response Models OpenAPI Auth Docs OpenAPI Customization Background Work Overview Background Tasks Queues Jobs Scheduler Event Dispatcher WebSockets Overview WebSocket Events Static Files Frontend (SPA) HTTP Client Mail Service Console Commands

Helpers

Overview Async Crypto Deprecation Files Hashing HTML JWT Network Retry Strings Text

Authentication & Authorization

Overview Users & User Models Password Hashing Protecting Routes Permissions JWT Authentication Session Authentication API Keys

OAuth2 & Social Login

OAuth2 Overview OAuth Providers Persisting the Login OAuth in OpenAPI The Security Model

Security

Security Headers CORS CSRF Protection Rate Limiting Session Management