microsoft/awesome-rayfin

microsoft/awesome-rayfin

Description: Community-driven templates for Rayfin

Language: TypeScript

License: MIT

Stars: 51

Forks: 9

Open issues: 8

Created: 2026-05-22T21:28:57Z

Pushed: 2026-06-05T22:05:39Z

Default branch: main

Fork: no

Archived: no

README:

---

npm create @microsoft/rayfin -- --template https://github.com/microsoft/awesome-rayfin

What is Rayfin?

Project Rayfin is a modern Backend-as-a-Service (BaaS) platform that helps teams build and ship applications faster. Define your data model with TypeScript decorators, and Rayfin handles the backend — auth, data API, storage, and hosting.

npm create @microsoft/rayfin@latest # scaffold from an official template
npx rayfin up # deploy and run

Using This Gallery

Point the Rayfin CLI at this repo to scaffold any template from the gallery:

npm create @microsoft/rayfin -- --template https://github.com/microsoft/awesome-rayfin

# OR from a local clone
npm create @microsoft/rayfin -- --template ./awesome-rayfin

The CLI reads rayfin-template.yml at the repo root and presents an interactive picker when multiple templates are available.

---

📦 Templates

| Template | Description | Auth | Data | Stack | |----------|-------------|:----:|:----:|-------| | [Field Technician App](./templates/field-technician) | Field service management app with role-based dashboards for dispatchers and technicians, job tracking, customer lookup, and dual-mode auth (local password + Fabric) | ✅ | ✅ | React, Vite, Tailwind | | [IBCS Trainer](./templates/ibcs-trainer) | HTML5 Canvas platformer that teaches IBCS chart rules level by level, embedded in a Fabric-authenticated Rayfin app; each play-through is persisted to a typed GameStats entity | ✅ | ✅ | React, Vite, Tailwind | | [Slide Deck](./templates/slide-deck) | Interactive slide deck presenter with sessions, live slide tracking, and audience chat | ✅ | ✅ | React, Vite, Tailwind | | [[Experimental] Todo app with full local dev](./templates/todo-local-experimental) | End-to-end todo CRUD with username/password auth, a Rayfin data model, and Docker local development — a working starter that exercises the full data path without Fabric | ✅ | ✅ | React, Vite, Tailwind |

> Adding a template? See the [Contributing Guide](CONTRIBUTING.md).

---

📚 Resources

Packages

| Package | Description | |---------|-------------| | @microsoft/rayfin-core | Entity decorators, schema definitions, and core types | | @microsoft/rayfin-client | Typed data client for querying and mutating entities | | @microsoft/rayfin-cli | CLI for scaffolding, deploying, and managing Rayfin apps | | @microsoft/create-rayfin | npm create initializer for scaffolding new projects |

Key Concepts

• Data Modeling — Define entities with @entity(), @text(), @boolean(), @date(), and other decorators from @microsoft/rayfin-core
• Authentication — Fabric Entra SSO in production, mock email/password locally
• Typed Data Access — Schema-driven GraphQL client with compile-time type checking
• Static Hosting — Deploy frontends with rayfin up staticapp deploy

---

🌊 Community

We welcome community-contributed templates! See the [Contributing Guide](CONTRIBUTING.md) for how to submit your own template to this gallery.

---

Trademarks

This project may contain trademarks or logos for projects, products, or services. Authorized use of Microsoft trademarks or logos must follow the Microsoft Trademark and Brand Guidelines. Use of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship. Any use of third-party trademarks or logos is subject to those third parties' policies.

License

[MIT](LICENSE)