# Fymo

> Production-ready Python SSR framework for Svelte 5.

## Docs

- [Introduction](https://fymo.mintlify.app/introduction.md): A production-ready Python SSR framework for Svelte 5.
- [Quickstart](https://fymo.mintlify.app/quickstart.md): Install Fymo, run your first project, and generate a working CRUD resource.
- [The app/ directory](https://fymo.mintlify.app/app-directory.md): A map of where everything lives in a Fymo project.
- [Generators](https://fymo.mintlify.app/generators.md): Generate pages, remote modules, full CRUD resources, components, layouts, and broadcast channels, then destroy them just as safely.
- [Controllers and Routing](https://fymo.mintlify.app/controllers-and-routing.md): How a URL turns into a matched route, a controller call, and a rendered Svelte template.
- [Remote Functions](https://fymo.mintlify.app/remote-functions.md): Call type-annotated Python functions directly from Svelte components over a typed, devalue-encoded RPC layer.
- [Authentication](https://fymo.mintlify.app/auth.md): Identity resolvers, route and remote guards, and the client identity store, the mechanism Fymo gives you for owning your own auth.
- [Testing Your App](https://fymo.mintlify.app/testing-your-app.md): Simulate signed-in callers, prove user isolation with acting_as, and bootstrap storage and job providers when testing an app built on Fymo.
- [Jobs and Broadcasts](https://fymo.mintlify.app/jobs-and-broadcasts.md): Background task processing with pluggable job providers, and real-time updates pushed to the browser over server-sent events.
- [Storage and Media](https://fymo.mintlify.app/storage-and-media.md): The StorageProvider abstraction for where files live, and storage.expose for serving them over HTTP with byte-range support.
- [Assets, Fonts, and Static Files](https://fymo.mintlify.app/assets-fonts-and-static-files.md): How CSS, fonts, and images compile into your app, and how to serve files verbatim from app/static.
- [Configuration Reference](https://fymo.mintlify.app/configuration.md): Every key fymo.yml supports, its type, its default, and how ${VAR} interpolation resolves it.
- [Logging](https://fymo.mintlify.app/logging.md): Configure fymo's logging section in fymo.yml and see what gets logged automatically for requests and background jobs.
- [Production Deployment](https://fymo.mintlify.app/deployment.md): Running a Fymo app in production, from choosing a server to security headers, secrets, and health checks.
- [Upgrading](https://fymo.mintlify.app/upgrading.md): Every breaking change between v0.13 and current Fymo, the exact error each one prints, and the fix.
- [Development Setup](https://fymo.mintlify.app/development-setup.md): Clone the framework, install its Python and Node dependencies, and run a bundled example app against your local checkout.
- [Testing](https://fymo.mintlify.app/testing.md): How the framework's own test suite is organized, and how to run it.
- [Architecture Tour](https://fymo.mintlify.app/architecture-tour.md): A package-by-package tour of the fymo/ source tree, for anyone about to read or modify the framework itself.
- [Contribution Workflow](https://fymo.mintlify.app/contribution-workflow.md): Branch naming, commit style, and pull request scope conventions for contributing to Fymo.