# Unfurl Cloud Standard Library README

The Unfurl Cloud Standard library is a [TOSCA](https://github.com/oasis-open/tosca-community-contributions) library that provides building blocks and abstractions for deploying applications and services.
It allows you to create high-level blueprints that can work in a variety of environments and can easily be combined with other blueprints.

If you are familiar with TOSCA or Unfurl, using the Unfurl Cloud Standard library should be straightforward -- it is just a collection of type that you can use when you declare your templates or your own types. If you're not familiar with TOSCA, then take a look at our [application blueprint project template](https://unfurl.cloud/onecommons/project-templates/application-blueprint) for a step-by-step guide for building an application blueprint using this library.

## Usage in TOSCA service templates

You can use the types and templates defined here by import like any other TOSCA import -- declare it as a repository and then import individual files.

For example, in a YAML service template:

```yaml
    repositories:
      std:
        url: https://unfurl.cloud/onecommons/std.git
    imports:
      - file: generic_types.yaml
        repository: std

```

In a Python service template, the equivalent Python import statement would be:

`from tosca_repositories.std.generic_types import *`

## Usage on Unfurl Cloud

Unfurl Cloud uses this library to generate the catalog of types to choose when you create a resource for a deployment or for an environment in your dashboard.

This enables interoperability with applications blueprints that use this library -- and nearly all Unfurl Cloud's supported [blueprints](https://unfurl.cloud/blueprints) do.

You can customize which types library Unfurl Cloud uses for its types catalog by editing your dashboard's `unfurl.yaml` file.

## Overview and API documentation

See https://onecommons.pages.unfurl.cloud/std/