Edit

Create your first Fabric app

Fabric apps helps you build and ship backend services faster by providing ready-to-use infrastructure for authentication, data persistence, and static hosting. This quickstart shows you how to create your first app in Fabric.

Prerequisites

  • A Microsoft account with access to Microsoft Fabric.
  • A Fabric workspace where you have contributor or admin permissions.
  • Fabric app enabled by a tenant admin in settings. See Enable Fabric app in tenant admin settings.

Enable Fabric app in tenant admin settings

A Fabric tenant administrator must enable the Fabric app workload before users can create Rayfin items. If you are not a tenant admin, contact your organization's Fabric administrator to complete this step.

  1. Sign in to the Fabric admin portal.
  2. Navigate to Tenant settings.
  3. Under Fabric apps (preview), toggle the setting to Enabled.
  4. Choose whether to enable it for the entire organization or specific security groups.
  5. Select Apply.

Changes may take a few minutes to propagate. After the setting is enabled, users in the allowed scope can create Fabric apps in their workspaces.

Step 1: Sign in to the Fabric portal

Open Microsoft Fabric in your browser and sign in with your Microsoft account.

Step 2: Select a workspace

After signing in, select a workspace from the left navigation panel. If you do not have an existing workspace, create one:

  1. Select Workspaces in the left navigation.
  2. Select New workspace.
  3. Enter a name for the workspace and select Fabric capacity.

Step 3: Create a new Fabric app

  1. In the workspace view, select New item.
  2. Search for App in the item type list or scroll to find it.
  3. Select App item to open the creation dialog.
  4. Enter a name for your Fabric app (for example, my-rayfin-app).
  5. Select Create.

Step 4: Open, edit, and deploy your app

You can develop locally using Rayfin CLI.

  1. Open a terminal of your choice.

  2. Use the CLI command script shown in the portal and run in your terminal to download the app locally.

    Example

    npm create @microsoft/rayfin@latest -- "<appitemname>" --template todoapp --workspace <workspacename>

  3. Go to the project directory.

    cd <your project directory>

  4. Customize your app by editing the code directly or with the help of GitHub Copilot.

  5. Test local changes with your Fabric backend with the command.

    npm run dev

  6. Publish your changes with:

    npx rayfin up

    To deploy to another workspace, you can provide the --workspace parameter.

    npx rayfin up --workspace <workspacename>

    To switch between these two workspaces , run npx rayfin switch --workspace <workspace>.

Next steps

Related content

  • Last updated on