@translifycc/react
v0.2.6
Published
React language selector component for Translify
Downloads
1,122
Maintainers
Readme
@translifycc/react
React language selector component for Translify — add AI-powered translations to any React app in minutes.
Get your API key — 30 seconds
- Go to translify.cc/signup
- Enter email + password
- Your API key is on screen immediately — no email verification wait.
No credit card required. Free tier includes 50,000 chars/month.
Free tier: 50,000 unique characters/month. Cached translations are always free and never count against your limit.
| Plan | Price | Unique chars/month | |---------|--------|--------------------| | Free | $0 | 50,000 | | Starter | $25/mo | 500,000 | | Growth | $49/mo | 2,000,000 | | Pro | $99/mo | 10,000,000 |
How billing works: You're only charged for characters that hit OpenAI (first-time translations). Repeat translations served from cache are always free.
Install
npm install @translifycc/reactUsage
import { TranslifySelector } from '@translifycc/react';
export function Navbar() {
return (
<nav>
<Logo />
<TranslifySelector apiKey="YOUR_API_KEY" />
</nav>
);
}A language selector button appears. Users pick a language, the entire page translates. Their preference is saved — next visit is instant with zero API calls.
Props
| Prop | Type | Default | Description |
|--------------|--------|----------------------------|--------------------------------------|
| apiKey | string | required | Your Translify API key |
| apiBase | string | https://translify.cc | API base URL |
| domain | string | window.location.hostname | Your site domain |
| classNames | object | {} | Override class names for any element |
| labels | object | {} | Override UI text |
classNames keys
selector · trigger · triggerIcon · triggerLabel · triggerChevron · dropdown · dropdownHeader · option · optionActive · optionNative · optionName · optionRtl · restore · overlay · overlaySpinner · overlayTitle · overlaySub · toast
labels keys
trigger · dropdownHeader · restore · overlayTitle · overlaySub
Customisation
CSS variables (quickest)
.translify-selector {
--tlfy-primary: #7c3aed;
--tlfy-radius: 6px;
}Custom class names and labels
<TranslifySelector
apiKey="YOUR_API_KEY"
classNames={{
trigger: 'btn btn-outline',
dropdown: 'my-dropdown',
option: 'my-option',
optionActive: 'my-option--selected',
restore: 'my-restore',
}}
labels={{
trigger: 'Language',
dropdownHeader: 'Choose language',
restore: 'Back to English',
overlayTitle: 'Translating…',
overlaySub: 'First time only — instant on next visit.',
}}
/>Supported languages
Arabic · Chinese · Dutch · French · German · Hebrew · Hindi · Italian · Japanese · Korean · Persian · Polish · Portuguese · Russian · Spanish · Swedish · Turkish · Urdu
RTL languages (Arabic, Hebrew, Persian, Urdu) automatically set dir="rtl" on the <html> element — no extra config needed.
Links
License
MIT
