Walkthroughs

Step-by-step guides for common workflows. The steps are the same in the browser and the desktop app, because both are clients of the same server. The first two build the terms the workspace applies. The rest take content through drafting, memory reuse and review.

Build the workspace terms store

Build a terms store so every draft and every check uses the same vocabulary.

Steps

1. In a project, import the terms with kapi terms import, then run kapi push:
   • Source: "dashboard" / Target: "tableau de bord" / Domain: "UI" / Status: "preferred"
   • Source: "login" / Target: "connexion" / Domain: "UI" / Status: "approved"
2. Open Context → Concepts in the sidebar and select "dashboard" to check its terms and status beside the list
3. Open your project and open a file in the editor
4. Select a block that contains one of your terms (for example "dashboard")
5. The context panel's Terms section shows the matching terms:
   • Source term with status badge
   • Target suggestion
   • Domain label
6. Use the suggested term for consistency
7. Repeat for other blocks containing managed terms

What you learned

• Bringing concepts with a domain and a lifecycle status into the workspace
• Automatic term detection in the editor context panel
• Using term suggestions for consistent wording

Import terms from CSV

Bulk-load terms from a spreadsheet export.

Steps

1. Prepare a CSV file with columns source_term, target_term, domain, definition and status; the languages are given when you import it

   source_term,target_term,domain,definition,status
   login,connexion,UI,Signing in to an account,approved
   password,mot de passe,security,The secret a user signs in with,preferred
   dashboard,tableau de bord,UI,The overview a user lands on,preferred
   settings,paramètres,UI,Where a user changes preferences,approved

2. In the project, import the file and push it:

   kapi terms import terms.csv -s en -t fr --header
   kapi push

3. Open Context → Concepts in the sidebar
4. The concepts appear in the list; a governed term arrives as a change-set waiting for review above it
5. Select a concept to verify its terms, statuses, and domain

What you learned

• CSV format for term import
• Bulk-loading terms into the workspace terms store
• Verifying imported concepts

Reuse from the content memory

Reuse approved wording to keep drafts consistent and reduce effort.

Steps

1. Open Context → Content memory in the sidebar
2. Click Add entry to add some memory entries:
   • Source: "Welcome to our website" / Target: "Bienvenue sur notre site" (en → fr)
   • Source: "Contact us" / Target: "Contactez-nous" (en → fr)
3. Open your project
4. Open a file, switch to the editor's file-wide operations and choose Recycle from memory
5. The system matches source blocks against the memory entries and fills in matches
6. Check the progress bar: matched blocks show as "translated"
7. Back in the editor, toggle the Context panel to see per-block memory match details:
   • Match score (100% for exact matches)
   • Match type (generalized, structural, or plain)
   • Source and target text
8. For partial matches, click Apply in the context panel to accept the suggestion
9. Edit the applied text if needed

What you learned

• Adding entries to the content memory
• Recycle from memory across an entire file
• Understanding match scores and match types
• Applying memory suggestions from the context panel

Translate a website from English to French

The steps run from project creation to file export.

Steps

1. Open Bowrain and go to the project list
2. Click New Project
3. Enter "Website" as the project name
4. Select English as the source language
5. Select French as the target language
6. Click Create; the project opens in the project view
7. Drag your HTML files onto the upload zone (or click Add Files)
8. Files appear in the file list with format detection and word counts
9. Click a file name to open it in the editor
10. The editor displays source blocks on the left and empty target cells on the right
11. Click a target cell and type the French text
12. Press Enter to save and move to the next block
13. Continue through all blocks, using the progress bar to track completion
14. Click Export in the toolbar to download the French HTML file

What you learned

• Creating a project with source and target languages
• Uploading files with format auto-detection
• Manual block-by-block translation
• Exporting files in their original format

Use AI to draft a JSON file

Let an AI provider produce the first draft, then review and refine it.

Steps

1. Create a new project with your JSON file (follow steps 1-8 above)
2. Open the file in the editor
3. Ensure a provider is configured (the workspace's credits, or a key under Settings → Providers)
4. Click AI draft in the toolbar
5. Wait for the provider to process all blocks; the progress bar updates in real time
6. Open the review session for the file
7. Approve, reject or edit each draft, or approve everything that passes the checks and the voice bar in one action
8. Export the finished file

What you learned

• Drafting a whole file with an AI provider
• Reviewing and refining machine-produced drafts
• Block status workflow (not started → translated → reviewed)

Multi-language project workflow

Carry a single source file into several target languages.

Steps

1. Create a new project with multiple target languages (for example French, German, Japanese)
2. Upload your source file
3. Open the file in the editor
4. The target locale selector in the toolbar shows "French" (the first target language)
5. Work through all blocks in French
6. Switch the target locale to German using the dropdown
7. The editor reloads with empty targets for German
8. Work through all blocks in German (or use AI draft for a first pass)
9. Switch to Japanese and repeat
10. Export the file for each target locale; each export produces the file with that locale's targets

What you learned

• Creating projects with multiple target languages
• Switching between target locales in the editor
• Independent progress per locale
• Per-locale file export