Skip to content

A component library to help you build your travel product using the Duffel API

Notifications You must be signed in to change notification settings

duffelhq/duffel-components

Repository files navigation

@duffel/components

This package is a component library to help you build your travel product using the Duffel API.

Getting started

There are 3 different ways to integrate the components into your website. This will depend on which technology you are using. We'll use the ancillaries component as an example, but the same steps will apply for other components.

Integrating React component

  1. Install the package:

    yarn add @duffel/components
    # -- or --
    npm i @duffel/components
  2. Import the component from @duffel/components

    import { DuffelAncillaries } from "@duffel/components";
  3. Render the component with the desired props

    <DuffelAncillaries
      offer_id="fixture_off_1"
      services={["bags", "seats"]}
      passengers={[...]}
      onPayloadReady={console.log}
    />

Integrating HTML custom element

If you are not using React but still in a node environment, you can:

  1. Install the package:

    yarn add @duffel/components
    # -- or --
    npm i @duffel/components
  2. Import the component render function and event listeners from @duffel/components/custom-elements

    import {
      renderDuffelAncillariesCustomElement,
      onDuffelAncillariesPayloadReady,
    } from "@duffel/components/custom-elements";
  3. Include the custom element in your HTML

    <duffel-ancillaries></duffel-ancillaries>
  4. Call the render function with the right properties to render the custom element:

    renderDuffelAncillariesCustomElement({
      offer_id: "fixture_off_1",
      services: ["bags", "seats"],
      passengers: [...],
    });
  5. Set up listeners for events triggered by the component:

    onDuffelAncillariesPayloadReady((data, metadata) => {
      console.table(data);
      console.table(metadata);
    });

Integrating custom element without node

If you are not in a node environment and can't rely on npm to install the package, we make it available through our CDN. Here's how to integrate it:

  1. Include a script tag

    <!--
      Replace VERSION with the desired version.
      You can find them all on https://www.npmjs.com/package/@duffel/components?activeTab=versions
    
      Replace COMPONENT with the desired component you'd like to use.
      You can find the components available in the `./cdn-dist` directory after running `yarn build-and-publish --dry-run`
    
      For example, for the duffel ancillaries component on version 3.3.1, use:
      https://assets.duffel.com/components/3.3.1/duffel-ancillaries.js
    -->
    
    <script src="https://assets.duffel.com/components/VERSION/COMPONENT.js"></script>
  2. Include the custom element tag in your HTML:

    <duffel-ancillaries></duffel-ancillaries>
  3. Render the component with the required data. You can safely call this function as many times as you want, e.g., when your passenger data changes.

    const duffelAncillariesElement = document.querySelector("duffel-ancillaries");
    
    duffelAncillariesElement.render({
      offer_id: "fixture_off_1",
      services: ["bags", "seats"],
      passengers: [...],
    });
  4. Listen to the 'onPayloadReady' event on the component. event.detail.data contains the payload you need to send to Duffel's API to create an order.

    const duffelAncillariesElement =
      document.querySelector("duffel-ancillaries");
    
    duffelAncillariesElement.addEventListener("onPayloadReady", (event) =>
      console.log("onPayloadReady\n", event.detail),
    );

FAQ

Are there integration guides?

More guides are coming soon.

The examples folder is a great way to get started quickly and see fully functioning examples for every component.

What components are available through npm?

The list of React components can be found in src/index.ts. If you are using custom elements, you can find all render functions and event listeners in src/custom-elements.ts.

What components are available through the CDN?

Please check entryPoints in config/esbuild.base.config.js. It lists all the components we'll build and upload to the CDN.