fluid-framework

fluid-framework

The fluid-framework package bundles a collection of Fluid Framework client libraries for easy use when paired with a corresponding service client package (e.g. @fluidframework/azure-client, @fluidframework/tinylicious-client, or @fluidframework/odsp-client (BETA)).

This package reexports these APIs from other Fluid client packages reducing the number of direct package dependencies needed. There are some packages there are not included as part of this fluid-framework package which users may want to use with this package:

• A service client (e.g. @fluidframework/azure-client, @fluidframework/odsp-client (BETA), or @fluidframework/tinylicious-client for local development) to allow connecting to a Fluid service.
• Fluid Framework developer tools.
• @fluidframework/app-insights-logger: to route Fluid telemetry to Azure App Insights.

Contents

The fluid-framework package consists primarily of two portions: the IFluidContainer and a selection of distributed data structures (DDSes).

IFluidContainer

The IFluidContainer interface is one of the types returned by calls to createContainer() and getContainer() on the service clients such as AzureClient. It includes functionality to retrieve the Fluid data contained within, as well as to inspect the state of the collaboration session connection.

DDS packages

You'll use one or more DDS data structures in your container to model your collaborative data. The fluid-framework package offers the following data structures:

1. SharedTree
2. SharedMap, a map-like data structure for storing key/value pair data
   • Note: as of version 2.0, SharedMap is now marked legacy. Please use SharedTree for any new development.

Tutorial

Check out the Hello World tutorial using fluid-framework.

Using Fluid Framework libraries

When taking a dependency on a Fluid Framework library, we recommend using a ^ (caret) version range, such as ^1.3.4. While Fluid Framework libraries may use different ranges with interdependencies between other Fluid Framework libraries, library consumers should always prefer ^.

Installation

To get started, install the package by running the following command:

npm i fluid-framework

API Documentation

API documentation for fluid-framework is available at https://fluidframework.com/docs/apis/fluid-framework.

Contribution Guidelines

There are many ways to contribute to Fluid.

• Participate in Q&A in our GitHub Discussions.
• Submit bugs and help us verify fixes as they are checked in.
• Review the source code changes.
• Contribute bug fixes.

Detailed instructions for working in the repo can be found in the Wiki.

This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact [e-mail] with any additional questions or comments.

This project may contain Microsoft trademarks or logos for Microsoft projects, products, or services. Use of these trademarks or logos must follow Microsoft’s Trademark & Brand Guidelines. Use of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.

Help

Not finding what you're looking for in this README? Check out our GitHub Wiki or fluidframework.com.

Still not finding what you're looking for? Please file an issue.

Thank you!

Trademark

This project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.

Use of these trademarks or logos must follow Microsoft's Trademark & Brand Guidelines.

Use of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.