البداية السريعة

npm install ./siyak-js-0.1.0.tgz        # the file from the download above
# or, if you cloned the source:
npm install ../siyak/packages/siyak_js
# pnpm, yarn and bun take the same tarball path

import { init } from 'siyak-js';

const { t } = init({
  apiKey: process.env.SIYAK_KEY,   // sk_live_… or sk_test_…
  endpoint: process.env.SIYAK_URL, // printed on your API keys screen
  target: 'ar',                    // or 'ar-EG', 'he', 'ur'…
  source: 'en',                    // optional; the project's default is used when omitted
});

t('Your card expires soon', 'screen:checkout');
// first call → the source string, and a request queued in the background
// every call after that → بطاقتك تنتهي قريبًا

// Node.js, a CLI, or a server render: await the work.
const text = await siyak.translate('Continue', 'screen:checkout');

// A browser app usually wants neither await nor a spinner:
siyak.t('Continue');                 // instant, maybe source text
await siyak.flush();                 // then re-render once the batch lands