I have localized the best short-linking platform in the world

As part of playing with Tolgee, I have tried translating dub.co, a well-established open-source company, into other languages! It took me 1 hour, and the results are astonishing!

---

In this tutorial, I’ll walk you through an easy and efficient approach to localization in a Next.js application using Tolgee - a platform designed for fast and autonomous translation management.

You will also learn how to integrate Tolgee with Dub.co, a popular link management platform allowing users to access and interact with the application in their preferred languages.

Prerequisites

To fully understand this tutorial, you need to have a basic understanding of React or Next.js.

You will also need to set up the following:

• Tolgee Project - an existing project with at least two language translations.
• Tolgee CLI - allows you to interact with the Tolgee platform from your computer using the command line.
• Docker - required for running Dub.co. It is an open-source platform that uses containerization to make it easier to create, deploy, and run applications.
• Docker Compose - a software application for defining and running multi-container Docker applications.
• Python (version 3.8 or higher): necessary for configuring some of Dub.co’s packages.

---

What is Tolgee?

Tolgee is a developer-friendly localization platform that allows you to translate your application into any language without modifying your code. It is designed for web applications but also supports mobile and desktop applications.

With Tolgee, you don't need to look for keys in your source code, edit localization files, or perform manual exporting data for translators. Tolgee offers in-context translation, a translation memory for keeping track of already translated strings, machine and auto translations, and many others.

Please help us with a star. ?

It would help us to create more articles like this ?

Star the Tolgee repository ⭐

---

How to set up Dub.co on your local computer

Dub.co is an open-source link management platform that allows marketing teams to add powerful analytics to their links, create short links, generate QR codes for links, and many more. It was created by Steven Tey (formerly of Vercel).

Follow these steps to set up Dub.co on your computer:

Clone the Dub.co GitHub repository by running the code snippet below.

git clone https://github.com/dubinc/dub.git

Navigate into the dub folder and install the project dependencies:

git clone https://github.com/dubinc/dub.git

Within the apps/web folder, rename the .env.example file to .env.

Create a new Tinybird account, and copy your Admin Auth Token into the .env file.

pnpm install

Navigate into the packages/tinybird directory and install the Tinybird CLI using the following command:

TINYBIRD_API_KEY=<your_admin_auth_token>

Execute the following command in your terminal and enter your Admin Auth Token when prompted to authenticate using the Tinybird CLI:

pip3 install tinybird-cli

Publish the Tinybird datasource and endpoints by running the code snippet below:

tb auth

Create an Upstash database and copy the following credentials from the REST API section to the .env file:

tb push

Navigate to the QStash tab and copy the following credentials into the .env file.

UPSTASH_REDIS_REST_URL=<your_rest_url>
UPSTASH_REDIS_REST_TOKEN=<your_rest_token>

Next, within the apps/web directory, run the following command to start the Docker Compose stack:

QSTASH_TOKEN=
QSTASH_CURRENT_SIGNING_KEY=
QSTASH_NEXT_SIGNING_KEY=

Generate the Prisma client and create its database tables using the following commands:

docker-compose up

Dub.co supports multiple authentication methods. Create a GitHub app and copy the URL below as its callback URL.

npx prisma generate
npx prisma db push

Finally, start the development server:

http://localhost:8888/api/auth/callback/github

You can access the web application by navigating to http://localhost:8888 in your browser, create a workspace, and get started. If you encounter any issues, refer to the complete installation guide for more detailed assistance.

---

How to configure Tolgee in a Next.js application

In this section, you'll learn how to add Tolgee to a Next.js application and configure it to support multiple languages, allowing users to access the app in their preferred language.

To implement localization in Next.js applications, you will need to install the Tolgee React SDK.

pnpm dev

Next, create a Tolgee Platform account and sign into your dashboard.

Add a new project by clicking the Project button and selecting your preferred languages for the project. For this application, we'll use five languages: English (as the base language), Chinese, Hindi, Spanish, and Arabic.

Click the profile icon in the top-right corner of your dashboard, then select Project API Keys to create an API key for your Tolgee project.

Create a .env.development.local and copy your API key into the file:

git clone https://github.com/dubinc/dub.git

Select Translations from the sidebar menu and add a new translation to the project.

You can create a translation key, add the content or string you need to translate, provide a description, and then save it.

Tolgee provides various machine translation options by default, allowing you to easily translate content into the available languages within your project.

Congratulations! You’ve successfully set up the Tolgee platform for translations within your application. Next, let’s configure Tolgee within the Dub.co project to easily generate translations directly in the application.

How to set up localization in Dub.co

In this section, I’ll guide you through configuring Tolgee to support client-server interactions within the Dub.co project.

First, install the Tolgee CLI package.

pnpm install

Run the following code snippet to sign into your Tolgee platform using your project API key.

TINYBIRD_API_KEY=<your_admin_auth_token>

Next, create an i18n folder within the apps/web directory. This folder will store the JSON files containing translations for the various languages available in the Tolgee platform project.

pip3 install tinybird-cli

Within the apps/web directory, fetch the language translations created in your Tolgee project by running the code snippet below:

tb auth

The code snippet above automatically populates the i18n folder with the various language translations created within the Tolgee platform.

tb push

Create a tolgee folder which will contain Tolgee configurations within the apps/web directory:

git clone https://github.com/dubinc/dub.git

Add a shared.ts file in the tolgee directory, then copy the following code snippet into the file:

pnpm install

The code snippet above configures Tolgee with default and fallback languages to enable localization within the application.

Next, create a client.tsx file in the tolgee directory, then copy the code snippet below into the file:

TINYBIRD_API_KEY=<your_admin_auth_token>

The client.tsx file serves the purpose of translating client components and also enables the in-context functionality for server-rendered components. The code snippet above defines the TolgeeNextProvider component, which wraps the entire Dub.co application, providing configurations needed to manage language changes and translations.

Create a custom locale.ts file in the tolgee folder and copy the following code snippet into it:

pip3 install tinybird-cli

Finally, create a server.tsx file in the tolgee folder, then copy the following code snippet into the file:

tb auth

The application utilizes the React server cache for sharing Tolgee instance across components in a single render. This allows the app to use the Tolgee instance anywhere in the server components.

Congratulations! You’ve successfully configured Tolgee and are now ready to start adding translations to various content within the application.

---

How to translate your application content with Tolgee

Here, you'll learn how to translate content within your web application and see how Tolgee enables easy in-app translation.

To get started, you need to wrap the entire Dub.co application with the TolgeeNextProvider component, defined in tolgee/client.tsx. Navigate to the apps/web/app folder, then go to the app.dub.co/(dashboard) directory, and update the layout.tsx file as shown below:

tb push

The code snippet above wraps the dashboard routes with the Tolgee provider, enabling language switching and localization throughout the application.

Tolgee provides two hooks to help you select and translate text within your application: useTolgee and useTranslate.

• The useTolgee hook returns the Tolgee instance, allowing you to subscribe to various events that will trigger re-renders when translating text.
• The useTranslate hook includes a translation function (t function) that renders the actual translations directly within the app.

Update the page.tsx file in the app.dub.co/(dashboard)/[slug] directory by adding the following code snippet:

"use client";
import { PageContent } from "@/ui/layout/page-content";
import WorkspaceLinksClient from "./page-client";
//?? Tolgee installations
import { useTolgee, useTranslate } from "@tolgee/react";
import { setUserLocale } from "tolgee/locale";


export default function WorkspaceLinks() {
  const { t } = useTranslate();
  const tolgee = useTolgee(["pendingLanguage"]);
  const language = tolgee.getPendingLanguage();

  return (
    <PageContent title="Links">
    {/**-- HTML input for selecting the preferred language --*/}
      <div className="flex w-full flex-col px-10">
        <p>Select Language</p>
        <select
          defaultValue={language}
          className="rounded-sm"
          name="locale"
         >



<p>The code snippet above displays an HTML <strong><select> tag that allows users to choose and switch between different languages. The <strong>{t("hello")}</strong> element uses Tolgee’s translation function to render a value of the "hello" key based on the selected language.

<p><img src="/static/imghw/default1.png" data-src="https://img.php.cn/upload/article/000/000/000/173093241088271.jpg" class="lazy" alt="I have localized the best short-linking platform in the world"></p>

<p>Finally, you can update the remaining content throughout the application to support language changes, allowing users to view all components in their selected language.</p>

<p><img src="/static/imghw/default1.png" data-src="https://img.php.cn/upload/article/000/000/000/173093241165470.jpg" class="lazy" alt="I have localized the best short-linking platform in the world"></p>

<p>Tolgee also provides an in-context translation feature, allowing you to translate strings directly within your application, whether in development or production, simply by clicking the text and holding the Alt or Option key.</p>

<p><img src="/static/imghw/default1.png" data-src="https://img.php.cn/upload/article/000/000/000/173093241362494.jpg" class="lazy" alt="I have localized the best short-linking platform in the world"></p>

<p>Congratulations! You've successfully completed the project for this tutorial.</p>

<p>The source code for this tutorial is available here:</p>

<p>https://github.com/JanCizmar/dub-with-tolgee</p>


<hr>

<h2>
  
  
  Conclusion
</h2>

<p>So far, you’ve learnt how to add localization to your software applications using Tolgee, implement support for multiple languages, and make language switching seamless within a real-world project.</p>

<p>Tolgee is a fast, developer-focused localization platform that allows you to provide context to your content and generate translations in seconds. It also supports multiple JavaScript frameworks, including Vue, Angular, and Svelte, and integrates with tools like Figma and a REST API for flexibility.</p>

<p>If you're looking to create a personalized experience for your users, Tolgee is an excellent choice. Feel free to contribute and star our GitHub repository, and join our Slack community to connect with others and engage with the team.</p><p>Thank you for reading!</p>


          

            
        

The above is the detailed content of I have localized the best short-linking platform in the world. For more information, please follow other related articles on the PHP Chinese website!