Fluently User Guide

Welcome to Fluently! This guide will help you get started with managing your application translations efficiently and collaboratively.

Getting Started

What is Fluently?

Fluently is a translation management platform that helps you organize, translate, and maintain your application’s text content across multiple languages. Whether you’re launching globally or just adding a second language, Fluently streamlines your internationalization workflow.

Key Benefits

Account Setup

Creating Your Account

  1. Sign Up: Visit the Fluently homepage and click “Sign Up”
  2. Email Verification: Check your email and verify your account
  3. Choose Your Plan: Select a plan that fits your project needs (Not Yet, only Solo plan available)
  4. Complete User Profile: Set up your user profile with basic information
  5. Complete Account: Fill in your profile details (name and timezone)

Inviting Team Members

  1. Go to Users
  2. Click “Invite User”
  3. Enter their email address
  4. They’ll receive an invitation email to join your account
  5. You can assign roles, even before the invitation is accepted

Creating Your First Project

Project Setup

  1. Create Project: Click “New Project” from projects page
  2. Project Details:
  1. Select Languages:
  1. Save: Your project is created with a unique API key for developers

Understanding Project Structure

Your project organizes translations in a tree structure:

📁 Your Project
├── 📁 common
│   ├── 📄 navigation
│   ├── 📄 buttons
│   └── 📄 errors
├── 📁 pages
│   ├── 📁 auth
│   │   ├── 📄 login
│   │   └── 📄 signup
│   └── 📁 dashboard
│       └── 📄 welcome
└── 📄 app_name

Adding Translations

Method 1: File Upload

Perfect for importing existing translations or bulk uploads:

  1. Prepare Your Files:
  1. Import Process:
  1. File Processing:

Example YAML file structure:

# en.yml
welcome:
  title: "Welcome to our app"
  subtitle: "Get started today"
navigation:
  home: "Home"
  about: "About"
  contact: "Contact"

Method 2: Manual Entry

Perfect for adding new content or making quick edits:

  1. Navigate: Browse to the folder where you want to add content
  2. Add Translation: Click “New Translation”
  3. Enter Key: Type the translation key (e.g., “welcome.title”)
  4. Add Content: Enter text for each language
  5. Save: Content is automatically saved as you type

Method 3: In-Context Editing

Edit translations while viewing them in their organized structure:

  1. Browse Structure: Navigate through your folder hierarchy
  2. Click to Edit: Click on any translation to start editing
  3. Multi-Language View: See all language versions side by side
  4. Real-Time Save: Changes are saved automatically

Translation Workflow

Understanding Translation States

Each translation has a clear status indicated by color-coded icons:

Draft vs. Verified Content

Fluently uses a two-stage system for quality control:

  1. Draft Stage:
  1. Verified Stage:

Verification Process

For Translators:

  1. Enter or edit translation content
  2. Review for accuracy and context
  3. Click “Verify” when satisfied

For Reviewers:

  1. Review draft translations
  2. Make any necessary edits
  3. Click “Verify” to approve
  4. Content becomes available for export

Collaboration Tips

  1. Clear Communication: Use project descriptions and comments
  2. Consistent Style: Establish translation guidelines for your team
  3. Regular Reviews: Schedule periodic review sessions
  4. Progress Tracking: Use the dashboard to monitor completion
  5. Quality Gates: Don’t rush the verification process

Search and Navigation

Finding Translations

Quick Search:

Browse Structure:

Filter by Status: (Upcoming)

Exporting Translations

Download Your Translations

  1. Access Downloads: Go to Project Settings → Downloads
  2. Select Languages: Choose which languages to export
  3. Choose Format: YAML or JSON
  4. Download: Files are generated and downloaded automatically

API Integration (in development)

For developers integrating with your application:

  1. API Key: Found in Project Settings
  2. Endpoint: GET /api/v1/projects/:id/translations
  3. Response: Nested JSON with all verified translations
  4. Integration: Use in your application’s i18n system

Example API Response:

{
  "en": {
    "welcome": {
      "title": "Welcome to our app",
      "subtitle": "Get started today"
    }
  },
  "de": {
    "welcome": {
      "title": "Willkommen in unserer App",
      "subtitle": "Starten Sie noch heute"
    }
  }
}

Project Management

Dashboard Overview

Your project dashboard shows (in development):

Project Settings

General Settings:

Team Management:

Integration (in development):

Progress Tracking

Completion Metrics:

Visual Indicators:

Best Practices

Translation Quality

  1. Context is King: Understand where text appears in your app
  2. Consistency: Use the same terms throughout your project
  3. Length Considerations: Some languages are longer/shorter than others
  4. Cultural Sensitivity: Consider local customs and preferences
  5. Test Everything: Preview translations in your actual application

Project Organization

  1. Logical Structure: Group related content in folders
  2. Clear Naming: Use descriptive names for files and keys
  3. Avoid Duplication: Reuse common translations across sections
  4. Regular Cleanup: Remove unused translations periodically
  5. Version Control: Keep track of major changes

Team Workflow

  1. Define Roles: Clear responsibilities for each team member
  2. Set Standards: Establish style guides and conventions
  3. Regular Check-ins: Schedule team reviews and updates
  4. Quality Gates: Don’t rush the verification process
  5. Backup Plans: Keep copies of important translations

Troubleshooting

Common Issues

“My translations aren’t showing up”

“File upload failed”

“Can’t find a translation”

“Team member can’t access project”

Getting Help

In-App Support:

Contact Support:

Tips for Success

Starting Your Translation Project

  1. Start Small: Begin with your most important content
  2. Pick One Language: Focus on one additional language first
  3. Involve Native Speakers: Get local team members involved
  4. Test Early: Preview translations in your app frequently
  5. Iterate: Expect to refine translations over time

Scaling Your Translation Efforts

  1. Build a Glossary: Maintain consistent terminology
  2. Create Style Guides: Document tone and voice preferences
  3. Automate Where Possible: Use auto-translation for first drafts
  4. Monitor Quality: Regular reviews maintain high standards
  5. Plan for Updates: Translation is ongoing, not one-time

Long-term Success

  1. Regular Maintenance: Keep translations up to date
  2. User Feedback: Listen to feedback from international users
  3. Performance Tracking: Monitor how translations affect user engagement
  4. Continuous Improvement: Refine processes based on experience
  5. Team Development: Invest in translator training and tools

Need more help? Contact our support team or check out our video tutorials and FAQ section.

Happy translating!