Serverless Apps SDK

Este conteúdo não está disponível em sua língua ainda.

The Crowdin Serverless Apps SDK is a TypeScript toolkit for building apps that run on Crowdin infrastructure. You write the UI and register the modules the app appears in, and the CLI builds, previews, and publishes the bundle.

Because Crowdin hosts and runs them, serverless apps have no backend to deploy or maintain. They support UI modules such as project dashboards, editor panels, and menu extensions, and call the Crowdin API on behalf of the person using the app.

What the SDK Handles

User interface: A UI kit styled to match Crowdin, with React and Tailwind CSS preconfigured in the templates.
Crowdin API: A tokenless client. The Crowdin host runs each request under the session of the person using the app, within the scopes the manifest declares.
Modules: Registration through the matching prepare* function, at the top level of the bundle.
Translations: An i18n runtime that ships compiled catalogs with the bundle and loads them for the user’s locale.

Building a Serverless App

There are two ways to start: hand the work to an AI coding agent, or run the CLI yourself.

Help me build a Crowdin app. Do the following:
1. Install the Crowdin plugin with npx plugins add crowdin/skills.
2. Ask me what the app should do, then use the create-app skill to scaffold, develop, and publish it.
3. After publishing, open a preview so I can see the app inside Crowdin.

The agent signs in to Crowdin in your browser, and asks you to confirm before it registers the app in your organization. The published app is installed in your account. The manifest sets who can use it at first install, and you change that later in Crowdin Apps Permission Configuration.

Or run the serverless CLI yourself.

npm install --global @crowdin/serverless-apps-cli
crowdin-serverless-apps login
crowdin-serverless-apps create my-app
crowdin-serverless-apps dev
crowdin-serverless-apps preview
crowdin-serverless-apps publish

Read more about each step in the Quick Start.

Serverless Apps SDKTemplates, SDK guides, CLI commands, and API reference.

When to Build a Self-Hosted App Instead

Serverless apps cover the UI side of Crowdin. When your app needs server-side logic (for example, file processing, AI providers, custom MT engines, or webhook handling), build it as a self-hosted app. The same applies when your app combines an interface with server-side logic: self-hosted apps can include UI modules as well.

A self-hosted app also works with the Crowdin API differently: it makes calls as the account that installed it, not as the person using it.