The way you can call our sdk through different languages may vary but the commands will be pretty much the same:
Init
Adds an empty localesync.config.json file and a ‘hello world’ translation_fallback.json
Gen
Generates your language files from your translation_fallback.json
Upload
Uploads your translation_fallback.json content to the server, upserting all languages and strings
Download
Downloads a translation_fallback.json from server, overriding your current file, it will contain the data from the server and all downloaded strings will be in the object format
Sync
It calls upload, download and gen, following this order. It can be helpful on CI/CD pipelines, but be careful with possible overridings
{"docsConfig":{"$schema":"https://mintlify.com/docs.json","theme":"mint","name":"Locale Sync","colors":{"primary":"#F465F6","light":"#F465F6","dark":"#2C1434"},"favicon":"/favicon.svg","logo":{"light":"https://mintcdn.com/avcoding/xowKhuQtcdkiOVCd/logo/light.svg?fit=max\u0026auto=format\u0026n=xowKhuQtcdkiOVCd\u0026q=85\u0026s=f9696e325637bbcc402693aa79eb7362","dark":"https://mintcdn.com/avcoding/xowKhuQtcdkiOVCd/logo/dark.svg?fit=max\u0026auto=format\u0026n=xowKhuQtcdkiOVCd\u0026q=85\u0026s=8d89ed45c8bbac19055b54d1fc42bb7e"},"api":{"playground":{"display":"interactive"},"mdx":{"server":"https://api.localesync.com","auth":{"method":"key","name":"Repository-token"}}},"background":{"decoration":null,"color":{"light":null,"dark":"#131112"}},"navbar":{"links":[{"label":"Support","href":"mailto:hi@localesync.com"}],"primary":{"type":"button","label":"Dashboard","href":"https://app.localesync.com"}},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"avcoding","hasAudioNarration":false,"actualSubdomain":"avcoding","customDomains":["docs.localesync.com"],"gitSource":{"type":"github","owner":"viniciusamelio","repo":"locale-sync-docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"entitlements":{},"buildId":"6ae920dd0330fbfc0d0ee9ef:success","clientVersion":"0.0.4205","searchFilterCounts":[{"language":"default","tag":"Documentation","count":7},{"language":"default","tag":"API Reference","count":3},{"language":"default","tag":"Get Started","count":3},{"language":"default","tag":"SDK's","count":3},{"language":"default","tag":"Endpoints","count":2},{"language":"default","tag":"API Documentation","count":1},{"language":"default","tag":"Server Side","count":1}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"sdk/commands","slug":"/sdk/commands","pageMetadata":{"title":"Commands","description":"SDK commands","href":"/sdk/commands"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"SDK commands\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={p:`p`,strong:`strong`,..._provideComponents(),...props.components},{Heading}=_components;if(!Heading)_missingMdxReference(`Heading`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`The way you can call our sdk through different languages may vary but the commands will be pretty much the same:`}),`\n`,_jsx(Heading,{level:`2`,id:`init`,children:`Init`}),`\n`,_jsxs(_components.p,{children:[`Adds an empty `,_jsx(_components.strong,{children:`localesync.config.json`}),` file and a ‘hello world’ `,_jsx(_components.strong,{children:`translation_fallback.json`})]}),`\n`,_jsx(Heading,{level:`2`,id:`gen`,children:`Gen`}),`\n`,_jsxs(_components.p,{children:[`Generates your language files from your `,_jsx(_components.strong,{children:`translation_fallback.json`})]}),`\n`,_jsx(Heading,{level:`2`,id:`upload`,children:`Upload`}),`\n`,_jsxs(_components.p,{children:[`Uploads your `,_jsx(_components.strong,{children:`translation_fallback.json`}),` content to the server, upserting all languages and strings`]}),`\n`,_jsx(Heading,{level:`2`,id:`download`,children:`Download`}),`\n`,_jsxs(_components.p,{children:[`Downloads a `,_jsx(_components.strong,{children:`translation_fallback.json`}),` from server, overriding your current file, it will contain the data from the server and all downloaded strings will be in the object format`]}),`\n`,_jsx(Heading,{level:`2`,id:`sync`,children:`Sync`}),`\n`,_jsx(_components.p,{children:`It calls upload, download and gen, following this order. It can be helpful on CI/CD pipelines, but be careful with possible overridings`})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Commands","description":"SDK commands","href":"/sdk/commands"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Init","slug":"init","depth":2,"children":[]},{"title":"Gen","slug":"gen","depth":2,"children":[]},{"title":"Upload","slug":"upload","depth":2,"children":[]},{"title":"Download","slug":"download","depth":2,"children":[]},{"title":"Sync","slug":"sync","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"avcoding","siteName":"Locale Sync","title":"Commands - Locale Sync","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-01-07T02:45:44.685Z","originalFileLocation":"sdk/commands.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"SDK commands\">\u003cmeta data-mint-head name=\"application-name\" content=\"Locale Sync\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/avcoding/BNxI0WnNXgv4h4O5/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/avcoding/BNxI0WnNXgv4h4O5/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/avcoding/BNxI0WnNXgv4h4O5/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/avcoding/BNxI0WnNXgv4h4O5/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/avcoding/BNxI0WnNXgv4h4O5/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/avcoding/BNxI0WnNXgv4h4O5/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/avcoding/BNxI0WnNXgv4h4O5/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/avcoding/BNxI0WnNXgv4h4O5/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/avcoding/BNxI0WnNXgv4h4O5/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Commands - Locale Sync\">\u003cmeta data-mint-head property=\"og:description\" content=\"SDK commands\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Locale Sync\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.localesync.com/sdk/commands\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://avcoding.mintlify.site/_mintlify/api/og/v2?division=SDK%27s\u0026amp;title=Commands\u0026amp;description=SDK+commands\u0026amp;theme=3a3025d6884435da922b211e\u0026amp;signature=a7ec1114e28ed76d5f8df3e6ddac810f605df08a3bda7e3c4c49d954cd5fb8d6\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Commands - Locale Sync\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"SDK commands\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://avcoding.mintlify.site/_mintlify/api/og/v2?division=SDK%27s\u0026amp;title=Commands\u0026amp;description=SDK+commands\u0026amp;theme=3a3025d6884435da922b211e\u0026amp;signature=a7ec1114e28ed76d5f8df3e6ddac810f605df08a3bda7e3c4c49d954cd5fb8d6\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/avcoding/BNxI0WnNXgv4h4O5/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Locale Sync\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#F465F6\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.localesync.com/sdk/commands\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/sdk/commands.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.localesync.com/#organization\",\"name\":\"Locale Sync\",\"url\":\"https://docs.localesync.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/avcoding/xowKhuQtcdkiOVCd/logo/light.svg?fit=max\u0026auto=format\u0026n=xowKhuQtcdkiOVCd\u0026q=85\u0026s=f9696e325637bbcc402693aa79eb7362\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.localesync.com#website\",\"name\":\"Locale Sync\",\"url\":\"https://docs.localesync.com\",\"publisher\":{\"@id\":\"https://docs.localesync.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.localesync.com/sdk/commands#webpage\",\"url\":\"https://docs.localesync.com/sdk/commands\",\"name\":\"Commands\",\"description\":\"SDK commands\",\"dateModified\":\"2026-01-07T02:45:44.685Z\",\"isPartOf\":{\"@id\":\"https://docs.localesync.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.localesync.com/sdk/commands#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.localesync.com/sdk/commands#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Locale Sync\",\"item\":\"https://docs.localesync.com\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Commands\",\"item\":\"https://docs.localesync.com/sdk/commands\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.localesync.com/sdk/commands#article\",\"headline\":\"Commands\",\"name\":\"Commands\",\"description\":\"SDK commands\",\"url\":\"https://docs.localesync.com/sdk/commands\",\"mainEntityOfPage\":{\"@id\":\"https://docs.localesync.com/sdk/commands#webpage\"},\"dateModified\":\"2026-01-07T02:45:44.685Z\",\"publisher\":{\"@id\":\"https://docs.localesync.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.localesync.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Locale Sync\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Locale Sync\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/sdk/commands.md","siteName":"Locale Sync","nav":{"global":null,"tabs":[{"tab":"Documentation","groups":[{"group":"Get Started","pages":[{"title":"Introduction","href":"/introduction"},{"title":"Config file","href":"/config/config-file"},{"title":"Translation fallback","description":"Your translation base file","href":"/config/translation-fallback"}]},{"group":"SDK's","pages":[{"title":"Commands","href":"/sdk/commands"},{"title":"Flutter","description":"Flutter SDK","href":"/sdk/flutter"},{"title":"Typescript","href":"/sdk/typescript"}]},{"group":"Server Side","pages":[{"title":"Web Hooks","href":"/server-side/web-hooks"}]}]},{"tab":"API Reference","pages":[{"title":"API Reference","href":"/api-reference/introduction"}]}]},"basePath":"","title":"Commands - Locale Sync","deploymentId":"dpl_FZMKUpaaKiVETbfqhoUe4sPFDTmY","buildId":"dpl_FZMKUpaaKiVETbfqhoUe4sPFDTmY","dynamics":[],"chunks":[]}