# Fabricator

> Fabricator is a desktop workbench for building Rayfin apps: chat with GitHub Copilot to build them, watch them run live, and deploy them to Microsoft Fabric.

These docs cover the Fabricator desktop app: a Tauri workbench for building Rayfin apps by chatting with GitHub Copilot, previewing them live, and deploying them to Microsoft Fabric. Fabricator is not an API or SDK. For Rayfin's own SDK and CLI APIs, use https://rayfin.ai/llms.txt.

## How to use these docs as an agent

- Append `.md` to any documentation route to get that page as clean Markdown. Example: https://spatney.github.io/rayfin-fabricator/docs/start/install -> https://spatney.github.io/rayfin-fabricator/docs/start/install.md
- [AGENTS.md](https://spatney.github.io/rayfin-fabricator/AGENTS.md) contains the short operating brief for agents helping someone use Fabricator.
- Every page carries `app_version` and `last_updated` in frontmatter.

Documented for Fabricator 1.20.1.

## Bulk downloads

Prefer a section bundle over the full corpus unless you genuinely need everything.

- [llms-full.txt](https://spatney.github.io/rayfin-fabricator/llms-full.txt): every page in one file, 306.8 KB (~78k tokens)

- [Overview](https://spatney.github.io/rayfin-fabricator/llms-full/docs.txt): 1 page, 4.0 KB (~1k tokens)
- [Start](https://spatney.github.io/rayfin-fabricator/llms-full/start.txt): 5 pages, 29.1 KB (~7k tokens)
- [Build](https://spatney.github.io/rayfin-fabricator/llms-full/build.txt): 9 pages, 70.5 KB (~18k tokens)
- [Ship](https://spatney.github.io/rayfin-fabricator/llms-full/ship.txt): 4 pages, 25.1 KB (~6k tokens)
- [What are team workspaces?](https://spatney.github.io/rayfin-fabricator/llms-full/team.txt): 10 pages, 60.0 KB (~15k tokens)
- [Troubleshooting overview](https://spatney.github.io/rayfin-fabricator/llms-full/troubleshooting.txt): 9 pages, 81.5 KB (~21k tokens)
- [Reference](https://spatney.github.io/rayfin-fabricator/llms-full/reference.txt): 7 pages, 38.5 KB (~10k tokens)

# Docs

- [What is Fabricator?](https://spatney.github.io/rayfin-fabricator/docs): Fabricator is a desktop workbench for building Rayfin apps with Copilot, live preview, and Microsoft Fabric deploys.

- **Get started**
- [Install Fabricator](https://spatney.github.io/rayfin-fabricator/docs/start/install): Download Fabricator for Windows or macOS, handle platform prompts, and understand app updates.
- [Set up and sign in](https://spatney.github.io/rayfin-fabricator/docs/start/setup): Use Fabricator setup the first time you open it: check tools, sign in to GitHub Copilot and the Azure CLI, and enter the app.
- [Manage your accounts](https://spatney.github.io/rayfin-fabricator/docs/start/accounts): See which GitHub Copilot, Microsoft Fabric, Azure CLI and GitHub accounts Fabricator uses, and add, switch between or sign out of them.
- [Build your first app](https://spatney.github.io/rayfin-fabricator/docs/start/first-app): Create a project, deploy it to Fabric, prompt Copilot, preview the result, and iterate.
- [Tour the workbench](https://spatney.github.io/rayfin-fabricator/docs/start/tour): Find Home, project tabs, chat, preview, code, model, Advisor, accounts, settings, the status bar and Ray.

- **Build**
- [Create and manage projects](https://spatney.github.io/rayfin-fabricator/docs/build/projects): Start a new Rayfin app, open an existing project, clone from GitHub, switch between projects, and rename or remove projects from Fabricator.
- [Chat with Copilot](https://spatney.github.io/rayfin-fabricator/docs/build/chat): Use Fabricator's built-in GitHub Copilot agent to change your app, review its work log and diffs, steer a turn, and recover sign-in.
- [Prompt ideas](https://spatney.github.io/rayfin-fabricator/docs/build/prompt-ideas): Copy prompts for starting Rayfin apps, adding data and access rules, building semantic-model dashboards, improving visuals, and fixing issues.
- [Live preview](https://spatney.github.io/rayfin-fabricator/docs/build/preview): Use the preview pane to watch local changes during Copilot turns, check the deployed app, switch Fabric shell views, and handle busy preview ports.
- [Design mode](https://spatney.github.io/rayfin-fabricator/docs/build/design): Use Design mode to select elements in the preview, queue visual changes, preview themes, and send the changes to Copilot as one request.
- [Code and history](https://spatney.github.io/rayfin-fabricator/docs/build/code-and-history): Browse project files, open the folder in VS Code, inspect diffs, and restore earlier git snapshots from Fabricator's Code view.
- [Blueprint: architecture and data models](https://spatney.github.io/rayfin-fabricator/docs/build/data-model): Use Blueprint to see what your app is made of, what it connects to and which identity each connection uses, plus its Rayfin data model and Fabric semantic models.
- [Skills](https://spatney.github.io/rayfin-fabricator/docs/build/skills): Choose the skills Copilot follows while it builds your Rayfin app, see what each one teaches, and add custom skills for your own guidance.
- [Secrets](https://spatney.github.io/rayfin-fabricator/docs/build/secrets): Add API keys, passwords and connection strings that your app's Rayfin functions read on the server, without putting their values in your code.

- **Ship**
- [Deploy to Microsoft Fabric](https://spatney.github.io/rayfin-fabricator/docs/ship/deploy): Deploy your app to a Fabric workspace with one click, understand automatic redeploys after chat turns, and manage deployments across workspaces.
- [Share your app](https://spatney.github.io/rayfin-fabricator/docs/ship/share): Give people in your Microsoft Entra tenant access to a deployed app by email, including Build access to semantic models the app reads from other workspaces.
- [Check app health with the Advisor](https://spatney.github.io/rayfin-fabricator/docs/ship/advisor): Use the Advisor's grade, quick checks and read-only Copilot deep review to find security, data and quality issues, then fix, verify, dismiss or mute them.
- [Keep Rayfin up to date](https://spatney.github.io/rayfin-fabricator/docs/ship/rayfin-versions): Know when a project's Rayfin CLI and SDK are out of date, and let Copilot upgrade them together while keeping the app building.

- **Team workspaces**
- [What are team workspaces?](https://spatney.github.io/rayfin-fabricator/docs/team): Build Rayfin apps with teammates in a private GitHub repository, with personal previews and a pipeline that publishes to Fabric.
- [Before you start](https://spatney.github.io/rayfin-fabricator/docs/team/prerequisites): Check the GitHub, Azure, Fabric, and Rayfin requirements before creating or joining a team workspace.
- [Create a team workspace](https://spatney.github.io/rayfin-fabricator/docs/team/create): Create the private repository, Fabric workspaces, deploy identities, OIDC trust, pipeline, and first verification run.
- [Invite your team](https://spatney.github.io/rayfin-fabricator/docs/team/members): Invite teammates by GitHub username, grant Fabric app access with work email, and manage member and app access lists.
- [Work on a team app](https://spatney.github.io/rayfin-fabricator/docs/team/work-on-an-app): Open a team app, work on your own branch, preview changes locally and in Fabric, and bring in teammates' published changes.
- [Publish changes](https://spatney.github.io/rayfin-fabricator/docs/team/publish): Publish a team app by saving work, checking the preview, waiting for review when required, merging, and deploying the published app.
- [Use the workspace overview](https://spatney.github.io/rayfin-fabricator/docs/team/overview): Use the app-centered workspace overview to inspect apps, working copies, previews, published deployments, data, connections, and pipeline health.
- [Move an existing app into a team workspace](https://spatney.github.io/rayfin-fabricator/docs/team/move-an-app): Copy a local Rayfin project into a team workspace as a new team app without changing the original local project.
- [Information for administrators](https://spatney.github.io/rayfin-fabricator/docs/team/administrators): Review the Entra ID, Fabric, GitHub, and GitHub Actions resources that Fabricator creates for team workspaces.
- [Team workspace limitations](https://spatney.github.io/rayfin-fabricator/docs/team/limitations): Understand current team workspace limits for GitHub plans, github.com, Rayfin versions, secrets, and the experiment toggle.

- **Troubleshooting**
- [Troubleshooting overview](https://spatney.github.io/rayfin-fabricator/docs/troubleshooting): Start here when Fabricator is not working, then jump to the symptom that matches what you see.
- [Ask Help](https://spatney.github.io/rayfin-fabricator/docs/troubleshooting/help): Open the built-in Help assistant to find out why something failed, using your own activity history, the documentation, and the version of Fabricator you are running.
- [Install and update problems](https://spatney.github.io/rayfin-fabricator/docs/troubleshooting/install-and-updates): Fix Windows SmartScreen warnings, macOS quarantine errors, and in-app update prompts or failures.
- [Setup and sign-in problems](https://spatney.github.io/rayfin-fabricator/docs/troubleshooting/setup-and-sign-in): Fix setup tool checks, GitHub Copilot sign-in, account switching, Azure CLI sign-in, and Fabric sign-in.
- [Chat and Copilot problems](https://spatney.github.io/rayfin-fabricator/docs/troubleshooting/chat): Fix Copilot chat errors, stuck turns, new engine sessions, Copilot credit use, and Rayfin dependency failures.
- [Preview problems](https://spatney.github.io/rayfin-fabricator/docs/troubleshooting/preview): Fix blank, stale, or stuck previews, busy live-preview ports, preview sign-in prompts, and old preview surfaces.
- [Deploy and Fabric problems](https://spatney.github.io/rayfin-fabricator/docs/troubleshooting/deploy): Fix failed deploys, stopped automatic redeploys, Fabric authentication, semantic model reads, Rayfin CLI errors, and sharing access.
- [Team workspace problems](https://spatney.github.io/rayfin-fabricator/docs/troubleshooting/team): Fix team workspace setup, GitHub CLI, pipeline, publish, preview, invitation, and Repair problems.
- [Report a problem](https://spatney.github.io/rayfin-fabricator/docs/troubleshooting/report-a-problem): Create a useful Fabricator bug report with diagnostics, logs, version details, and privacy checks.

- **Reference**
- [Frequently asked questions](https://spatney.github.io/rayfin-fabricator/docs/reference/faq): Answers to common questions about Fabricator: who makes it, what it costs, which accounts it needs, where your data goes, and which platforms it supports.
- [How Fabricator works](https://spatney.github.io/rayfin-fabricator/docs/reference/how-it-works): How Fabricator connects the GitHub Copilot agent, the Rayfin CLI, git and Microsoft Fabric into a single build, preview and ship loop.
- [Settings](https://spatney.github.io/rayfin-fabricator/docs/reference/settings): Every option in Fabricator's Settings: accounts, setup, workspace folder, theme, text size, diagnostics, experiments and the About section.
- [Privacy and telemetry](https://spatney.github.io/rayfin-fabricator/docs/reference/privacy): What usage data Fabricator sends, what it never sends, and what stays on your device.
- [Files and folders](https://spatney.github.io/rayfin-fabricator/docs/reference/files): Where Fabricator keeps your projects, app data, chat history, Advisor reports, logs and caches on Windows and macOS.
- [System requirements](https://spatney.github.io/rayfin-fabricator/docs/reference/requirements): Operating systems, tools, accounts, Fabric access, and network access required by Fabricator.
- [Glossary](https://spatney.github.io/rayfin-fabricator/docs/reference/glossary): Plain-language definitions of the terms used in Fabricator and these docs, from Rayfin and Fabric capacity to working copies and deploy identities.