@useorbital/client-sdk NPM

Orbital SDK

This package enables in-app recruitment for your discoveries via Orbital

Documentation

You can find the SDK documentation in the Orbital Docs

Usage Examples

In order to initialize the Orbital SDK you'll need to provide your Space ID. You can find your specific Space ID within Orbital under Settings > Installation

Javascript / Typescript

import orbital from '@useorbital/client-sdk'

const orbitalSdk = await orbital('your-space-id')

React

import orbital, { OrbitalSdk } from '@useorbtial/client-sdk'
import { createContext, useContext, useState, useEffect, PropsWithChildren } from 'react'

const OrbitalContext = createContext<OrbitalSdk | undefined>(undefined)

function OrbitalProvider({ children, spaceId }: PropsWithChildren<{ spaceId: string }>) {
    const [sdk, setSdk] = useState<OrbitalSdk | undefined>(undefined)

    useEffect(() => {
        orbital(spaceId).then(setSdk)
    }, [spaceId])

    return (
      <OrbitalContext.Provider value={sdk} >
          {children}
      </OrbitalContext.Provider>
    )
}

function useOrbital(): OrbitalSdk | undefined {
    return useContext(OrbitalContext)
}

React with SSR

The Orbital SDK requires access to the window object on import. If server side rendering (SSR) is used this is usually only possible on the client. If you are using, you'll need to make sure to only import the Orbital SDK in client code.

import { OrbitalSdk } from '@useorbtial/client-sdk'
import { createContext, useContext, useState, useEffect, PropsWithChildren } from 'react'

const OrbitalContext = createContext<OrbitalSdk | undefined>(undefined)

function OrbitalProvider({ children, spaceId }: PropsWithChildren<{ spaceId: string }>) {
    const [sdk, setSdk] = useState<OrbitalSdk | undefined>(undefined)

    useEffect(() => {
        import('@useorbtial/client-sdk')
          .then(({ default: orbital }) => orbital(spaceId))
          .then(setSdk)
    }, [spaceId])

    return (
      <OrbitalContext.Provider value={sdk} >
          {children}
      </OrbitalContext.Provider>
    )
}

function useOrbital(): OrbitalSdk | undefined {
    return useContext(OrbitalContext)
}