Official JavaScript interface to the Zeplin API. It works in both Node.js and web browser environments.
npm install @zeplin/sdk
or
yarn add @zeplin/sdk
To get started with the SDK, you can create a personal access token from the web app under Developer tab in your profile page.
You can use this token to make API calls for your own Zeplin account.
import { ZeplinApi, Configuration } from "@zeplin/sdk";
const zeplinClient = new ZeplinApi(new Configuration({ accessToken: "ACCESS_TOKEN" }));
const me = await zeplinClient.getCurrentUser();If you want to build an application for other Zeplin users, you can also create a Zeplin app the profile page.
Check out this example to see how you can implement an OAuth flow using the SDK.
The SDK exposes Zeplin API endpoints as methods. These methods are grouped into namespace objects by the type of object they interact with.
For example:
import { ZeplinApi, Configuration, ScreenNoteColorNameEnum } from "@zeplin/sdk";
const zeplinClient = new ZeplinApi(new Configuration({ accessToken: "ACCESS_TOKEN" }));
// Get colors in the styleguide
zeplinClient.colors.getStyleguideColors("STYLEGUIDE_ID");
// Add a note on the screen
zeplinClient.screens.createScreenNote("PROJECT_ID", "SCREEN_ID", {
content: "Çaylar filiz! :turkish_tea:",
position: { x: 0.1, y: 0.1 },
color: ScreenNoteColorNameEnum.DEEP_PURPLE
});
// Invite a member to the workspace
zeplinClient.organizations.inviteOrganizationMember("ORGANIZATION_ID", {
handle: "rooolan",
role: "editor"
});Check out the API documentation for complete list of endpoints and groups.
- Command-line app using personal access token
- Simple OAuth application
- Publishing screens and screen versions
The project is available as open source under the terms of the MIT License.
Ping us at dx@zeplin.io for any feedback or questions. You can also find us in the Zeplin Developer Slack group!