npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

contentful-ui-extensions-sdk

v4.29.3

Published

A JavaScript library to develop custom apps for Contentful

Downloads

33,620

Readme

App SDK

The App SDK (formerly known as UI Extensions SDK) is a JavaScript library that allows developers to create custom Contentful Apps for the Contentful Web App. Every Contentful App has to include the library in its source.

Resources

Getting help

Technical questions, feedback or feature request can be provided directly through the Github issues for this repository. However, if you are a paying customer or at any point business sensitive information needs to be discussed, then the conversation should be handled via our support system.

Development

Publishing

A new package version is automatically published to npm using semantic-release.

To manually publish the package, run npm run publish-all.

This repository is published as two packages with identical data. We recommend using @contentful/app-sdk.

  • @contentful/app-sdk
  • contentful-ui-extensions-sdk

Canary releases

This package has two main development streams: latest and canary.

The default and stable releases are always published under the latest tag (as per npm convention). The release under the canary tag is to be considered unstable and potentially breaking. You should not rely on it in production.

To start a new alpha version of the package follow these steps:

  1. Checkout the canary branch.
  2. Reset canary to the latest main: git reset --hard origin/main
  3. Create a new branch with your changes from canary
  4. Create a PR that merges into canary.

File Structure

docs

Former home of the documentation and reference for this library. This is now deprecated and you should use links above.

lib

Includes the files constituting the SDK and the associated types.

Top level files are split by feature. Most of them map 1-to-1 to an API (keep reading for the outliers). When APIs are considered too small to be in a separate file, they are part of the api file.

  • channel and signal abstract the communication between an App and the host;
  • locations exports available location where you can run App;
  • initialize creates an initializer to start an App within Contentful's App Framework.

All the typings are in the types folder and they map 1-to-1 APIs, when they make sense. The entities file maps Contentful entities in TypeScript. utils includes utility types, meant to save on characters to type.

scripts

Includes utility tools for maintainers.

test

Includes unit tests (run by mocha)