@translifycc/angular
v0.2.6
Published
Angular language selector component for Translify
Downloads
1,058
Maintainers
Readme
@translifycc/angular
Angular language selector component for Translify — add AI-powered translations to any Angular app in minutes. Compatible with Angular 15–19.
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/angularUsage
Standalone component (Angular 15+)
// app.component.ts
import { Component } from '@angular/core';
import { TranslifySelectorComponent } from '@translifycc/angular';
@Component({
standalone: true,
imports: [TranslifySelectorComponent],
template: `
<nav>
<translify-selector apiKey="YOUR_API_KEY" />
</nav>
`
})
export class AppComponent {}NgModule-based app
// app.module.ts
import { NgModule } from '@angular/core';
import { TranslifyModule } from '@translifycc/angular';
@NgModule({
imports: [TranslifyModule],
})
export class AppModule {}<!-- any template -->
<translify-selector apiKey="YOUR_API_KEY" domain="myapp.com" />Inputs
| Input | 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
trigger · dropdown · dropdownHeader · option · optionActive · optionNative · optionName · optionRtl · restore · overlay · overlaySpinner · overlayTitle · overlaySub · toast
labels keys
trigger · dropdownHeader · restore · overlayTitle · overlaySub
Customisation
<translify-selector
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.'
}"
/>Angular version compatibility
| Version | Support | |------------|-----------------------| | Angular 15 | ✅ Standalone + NgModule | | Angular 16 | ✅ Standalone + NgModule | | Angular 17 | ✅ Standalone + NgModule | | Angular 18 | ✅ Standalone + NgModule | | Angular 19 | ✅ Standalone + NgModule |
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
