How microsoft/rayfin works
Rayfin is a managed backend platform whose repository includes its CLI, shared tooling, and TypeScript SDKs. The main builder workflow is to scaffold a project, configure its backend, then deploy or run it; SDKs provide application access to services such as data and storage. The README documents platform capabilities, while source excerpts show several CLI implementation details. Links for unsampled subsystems are limited to documented relationships.
Main entry points: root-command.ts CLI Commands · client.ts Rayfin Client · storage-config-generator.ts Storage Configuration · scaffold-pipeline.ts Project Scaffolding
Components 23
Builder CLI
- CLI Commands
packages/tools/cli/src/root-command.ts - Project Scaffolding
packages/tools/cli/src/utils/scaffold-pipeline.ts - Deploy and Manage
packages/tools/cli/src/commands/up - Local Development
packages/tools/common/src/workflows/dev - Storage Configuration
packages/tools/cli/src/utils/storage-config-generator.ts - Storage Apply
packages/tools/cli/src/utils/storage-apply.ts - Agent Integrations
packages/tools/cli/src/services/agent-files/manager.ts
Backend Services
- Connector Discovery
packages/tools/cli/src/services/connectors/discovery - Fabric Services
packages/tools/cli/src/services/fabric - Managed Backend
- Database
- Authentication
packages/tools/common/src/services/auth - Data APIs
packages/tools/common/src/services/data - Storage Service
packages/tools/common/src/services/storage - Hosting
packages/tools/common/src/services/static-hosting
Application SDKs
- Rayfin Client
packages/typescript-sdk/client/src/client.ts - Data SDK
packages/typescript-sdk/data/src/graphql/GraphQLQueryBuilder.ts - Storage SDK
packages/typescript-sdk/storage/src/StorageFolderClient.ts - Storage Schema
packages/typescript-sdk/core/src/analysis/storage-config-generator.ts - Auth SDK
packages/typescript-sdk/auth/src/Auth.ts - Functions SDK
packages/typescript-sdk/functions/src/FunctionClient.ts
Shared Tooling
- Template Engine
packages/tools/common/src/templates
Other components
- Builder
Connections 26
- Builder → CLI Commands: runs
README.md - CLI Commands → Project Scaffolding: scaffolds
packages/tools/cli/src/utils/scaffold-pipeline.ts - Project Scaffolding → Template Engine: instantiates
packages/tools/cli/src/utils/scaffold-pipeline.ts - Builder → Deploy and Manage: deploys with
README.md - Deploy and Manage → Managed Backend: provisions
README.md - Builder → Local Development: develops locally
README.md - CLI Commands → Storage Configuration: generates
- CLI Commands → Storage Apply: applies
- Storage Apply → Storage Configuration: reads config
packages/tools/cli/src/utils/apply-storage-config.ts - Storage Configuration → Storage Schema: analyzes folders
- CLI Commands → Connector Discovery: manages connectors
- CLI Commands → Agent Integrations: manages files
packages/tools/cli/src/services/agent-files/manager.ts - Connector Discovery → Fabric Services: queries catalog
packages/tools/cli/src/services/connectors/discovery/catalog-search-engine.ts - Managed Backend → Database: provides
README.md - Managed Backend → Authentication: provides
README.md - Managed Backend → Data APIs: provides
README.md - Managed Backend → Storage Service: provides
README.md - Managed Backend → Hosting: provides
README.md - Builder → Rayfin Client: uses
README.md - Rayfin Client → Data SDK: supports data access
- Rayfin Client → Storage SDK: supports storage access
- Rayfin Client → Auth SDK: supports authentication
- Rayfin Client → Functions SDK: supports functions
- Data SDK → Data APIs: queries
README.md - Storage SDK → Storage Service: operates on
README.md - Auth SDK → Authentication: authenticates
README.md