Skip to main content
Stringhive Quick Start

Quick Start

From zero to translated in about five minutes.

1. Create a Hive

A Hive is a project workspace. Create one for each app or product you want to localize.

  1. Sign in and click New Hive on the dashboard
  2. Give it a name and a slug (the slug is used in API calls, so keep it URL-friendly)
  3. Pick your source locale, for example en
  4. Add the target locales you want to translate into, for example de, fr, es

Your source locale is locked once you add strings. Pick it carefully.

2. Add your strings

Strings are the translation keys inside your Hive. There are two ways to get them in:

Import a file. Head to your Hive, click Import, and upload a JSON or PHP file:

{
  "welcome.title": "Welcome to our app",
  "welcome.subtitle": "Get started in seconds",
  "nav.home": "Home",
  "nav.settings": "Settings"
}

Add manually. Click New String in the Hive view, enter a key and source value.

3. Translate

Open the Workflow for a target locale. You'll see a queue of untranslated strings. Click one, type your translation, and hit Save & Next to move through the queue.

If you have a machine translation provider set up, there'll be an MT button that fills in a suggestion for you to review.

4. Export or sync via the API

Once your strings are translated, pull them back into your app:

# Laravel SDK
php artisan stringhive:pull my-app

# Node SDK
npx stringhive pull my-app

# Raw API
curl https://www.stringhive.com/api/hives/my-app/export \
  -H "Authorization: Bearer YOUR_TOKEN"

That's the loop. Next, read Core Concepts to understand how hives, strings, and translations fit together — or go straight to the API reference if you're integrating programmatically.

Previous Introduction Next Hives