Integrating with Quetzal without an existing localization system
Heads up: For Swift applications, no existing localization is required to localize with Quetzal. Swift has standardized localization patterns that will be adhered to.
Setting Up Localization
Quetzal hooks into your existing localization patterns, but it does not provide, install, or set this up for you.Before linking your codebase with Quetzal, you should begin by setting up a localization system and translating a few strings to test.Quetzal will take it from there. Once the ground work for a localization is in your code, you can move on to linking your codebase.
Resources
For help with choosing a localization scheme which is a good fit for your codebase, you can read our tips.To make sure your stack works with Quetzal ahead of time, you can check compatibility with Quetzal.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Quetzal","colors":{"primary":"#1dd839","light":"#3bf6a2","dark":"#1e8a2e"},"logo":{"light":"https://mintcdn.com/quetzal/_z_ngjGGtb32EFdl/logo/qt-small-logo.png?fit=max\u0026auto=format\u0026n=_z_ngjGGtb32EFdl\u0026q=85\u0026s=78d4ee434fe1a5fcfa1cfd4cb268549f","dark":"https://mintcdn.com/quetzal/_z_ngjGGtb32EFdl/logo/qt-small-logo.png?fit=max\u0026auto=format\u0026n=_z_ngjGGtb32EFdl\u0026q=85\u0026s=78d4ee434fe1a5fcfa1cfd4cb268549f"},"favicon":"https://mintcdn.com/quetzal/_z_ngjGGtb32EFdl/logo/qt-small-logo.png?fit=max\u0026auto=format\u0026n=_z_ngjGGtb32EFdl\u0026q=85\u0026s=78d4ee434fe1a5fcfa1cfd4cb268549f","navbar":{"links":[{"href":"mailto:brendan@getquetzal.com","label":"Support"}],"primary":{"type":"button","label":"Dashboard","href":"https://qtzl.ai/dashboard"}},"footer":{"socials":{"github":"https://github.com/quetzallabs","linkedin":"https://linkedin.com/company/quetzal"}},"icons":{"library":"lucide"},"styling":{"latex":false},"navigation":{"languages":[{"language":"en","banner":{"content":"🚀 Under Construction","dismissible":true},"href":"en-US/start/getting-started"},{"language":"es","banner":{"content":"🚀 En construcción...","dismissible":true},"href":"es-419/start/getting-started"},{"language":"it","banner":{"content":"🚀 In costruzione...","dismissible":true},"href":"it-IT/start/getting-started"}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"quetzal","hasAudioNarration":false,"actualSubdomain":"quetzal","customDomains":[],"gitSource":{"type":"github","owner":"quetzallabs","repo":"quetzal-docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"entitlements":{},"buildId":"6ae9216c5bfa35cf90444c9e:success","clientVersion":"0.0.4143","searchFilterCounts":[{"language":"en","tag":"Installation","count":4},{"language":"es","tag":"Installation","count":4},{"language":"it","tag":"Installation","count":4},{"language":"en","tag":"Get Started","count":3},{"language":"es","tag":"Get Started","count":3},{"language":"it","tag":"Get Started","count":3},{"language":"en","tag":"Dashboard","count":1},{"language":"es","tag":"Dashboard","count":1},{"language":"it","tag":"Dashboard","count":1}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"en-US/start/first-time-localization","slug":"/en-US/start/first-time-localization","pageMetadata":{"title":"First Time Localization","description":"Integrating with Quetzal without an existing localization system","href":"/en-US/start/first-time-localization"},"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: \"Integrating with Quetzal without an existing localization system\"\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={a:`a`,p:`p`,..._provideComponents(),...props.components},{Heading,Tip}=_components;if(!Heading)_missingMdxReference(`Heading`,true);if(!Tip)_missingMdxReference(`Tip`,true);return _jsxs(_Fragment,{children:[_jsx(Tip,{children:_jsx(_components.p,{children:`Heads up: For Swift applications, no existing localization is required to localize with Quetzal. Swift has standardized localization patterns that will be adhered to.`})}),`\n`,_jsx(Heading,{level:`2`,id:`setting-up-localization`,children:`Setting Up Localization`}),`\n`,_jsx(_components.p,{children:`Quetzal hooks into your existing localization patterns, but it does not provide, install, or set this up for you.`}),`\n`,_jsx(_components.p,{children:`Before linking your codebase with Quetzal, you should begin by setting up a localization system and translating a few strings to test.`}),`\n`,_jsxs(_components.p,{children:[`Quetzal will take it from there. Once the ground work for a localization is in your code, you can move on to `,_jsx(_components.a,{href:`/en-US/install/linking-a-repository`,children:`linking your codebase`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`resources`,children:`Resources`}),`\n`,_jsxs(_components.p,{children:[`For help with choosing a localization scheme which is a good fit for your codebase, you can read `,_jsx(_components.a,{href:`/en-US/install/choosing-a-framework`,children:`our tips`}),`.`]}),`\n`,_jsxs(_components.p,{children:[`To make sure your stack works with Quetzal ahead of time, you can `,_jsx(_components.a,{href:`/en-US/install/is-my-stack-supported`,children:`check compatibility with Quetzal`}),`.`]})]})}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":"First Time Localization","description":"Integrating with Quetzal without an existing localization system","href":"/en-US/start/first-time-localization"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Setting Up Localization","slug":"setting-up-localization","depth":2,"children":[]},{"title":"Resources","slug":"resources","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":["/_mintlify/custom/quetzal/d06934efd3259f91/lul/lul.js","/_mintlify/custom/quetzal/9407b533d090eeae/lul/post.js"],"subdomain":"quetzal","siteName":"Quetzal","title":"First Time Localization - Quetzal","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"en":{"href":"/en-US/start/first-time-localization","matchLevel":0},"es":{"href":"/es-419/start/getting-started","matchLevel":3},"it":{"href":"/it-IT/start/getting-started","matchLevel":3}}},"lastModified":"2026-07-19T04:00:17.834Z","originalFileLocation":"en-US/start/first-time-localization.mdx","locale":"en"},"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=\"Integrating with Quetzal without an existing localization system\">\u003cmeta data-mint-head name=\"application-name\" content=\"Quetzal\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/quetzal/YrpEfScSV1fz5R4N/_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/quetzal/YrpEfScSV1fz5R4N/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/quetzal/YrpEfScSV1fz5R4N/_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/quetzal/YrpEfScSV1fz5R4N/_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/quetzal/YrpEfScSV1fz5R4N/_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/quetzal/YrpEfScSV1fz5R4N/_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/quetzal/YrpEfScSV1fz5R4N/_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/quetzal/YrpEfScSV1fz5R4N/_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/quetzal/YrpEfScSV1fz5R4N/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"First Time Localization - Quetzal\">\u003cmeta data-mint-head property=\"og:description\" content=\"Integrating with Quetzal without an existing localization system\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Quetzal\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://quetzal.mintlify.app/en-US/start/first-time-localization\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://quetzal.mintlify.site/_mintlify/api/og/v2?division=Get+Started\u0026amp;title=First+Time+Localization\u0026amp;description=Integrating+with+Quetzal+without+an+existing+localization+system\u0026amp;theme=3f2d31e43142d53898dddfb7\u0026amp;signature=deeb326e7e7b96a942265ce4ca027c2544fc06e78b699c428be9d463fcf48602\">\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=\"First Time Localization - Quetzal\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Integrating with Quetzal without an existing localization system\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://quetzal.mintlify.site/_mintlify/api/og/v2?division=Get+Started\u0026amp;title=First+Time+Localization\u0026amp;description=Integrating+with+Quetzal+without+an+existing+localization+system\u0026amp;theme=3f2d31e43142d53898dddfb7\u0026amp;signature=deeb326e7e7b96a942265ce4ca027c2544fc06e78b699c428be9d463fcf48602\">\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/quetzal/YrpEfScSV1fz5R4N/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Quetzal\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#1dd839\">\u003clink data-mint-head rel=\"canonical\" href=\"https://quetzal.mintlify.app/en-US/start/first-time-localization\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/en-US/start/first-time-localization.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://quetzal.mintlify.app/#organization\",\"name\":\"Quetzal\",\"url\":\"https://quetzal.mintlify.app\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/quetzal/_z_ngjGGtb32EFdl/logo/qt-small-logo.png?fit=max\u0026auto=format\u0026n=_z_ngjGGtb32EFdl\u0026q=85\u0026s=78d4ee434fe1a5fcfa1cfd4cb268549f\"}},{\"@type\":\"WebSite\",\"@id\":\"https://quetzal.mintlify.app#website\",\"name\":\"Quetzal\",\"url\":\"https://quetzal.mintlify.app\",\"publisher\":{\"@id\":\"https://quetzal.mintlify.app/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://quetzal.mintlify.app/en-US/start/first-time-localization#webpage\",\"url\":\"https://quetzal.mintlify.app/en-US/start/first-time-localization\",\"name\":\"First Time Localization\",\"description\":\"Integrating with Quetzal without an existing localization system\",\"dateModified\":\"2026-07-19T04:00:17.834Z\",\"isPartOf\":{\"@id\":\"https://quetzal.mintlify.app#website\"},\"breadcrumb\":{\"@id\":\"https://quetzal.mintlify.app/en-US/start/first-time-localization#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://quetzal.mintlify.app/en-US/start/first-time-localization#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Get Started\",\"item\":\"https://quetzal.mintlify.app/en-US/start/getting-started\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"First Time Localization\",\"item\":\"https://quetzal.mintlify.app/en-US/start/first-time-localization\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://quetzal.mintlify.app/en-US/start/first-time-localization#article\",\"headline\":\"First Time Localization\",\"name\":\"First Time Localization\",\"description\":\"Integrating with Quetzal without an existing localization system\",\"url\":\"https://quetzal.mintlify.app/en-US/start/first-time-localization\",\"mainEntityOfPage\":{\"@id\":\"https://quetzal.mintlify.app/en-US/start/first-time-localization#webpage\"},\"dateModified\":\"2026-07-19T04:00:17.834Z\",\"publisher\":{\"@id\":\"https://quetzal.mintlify.app/#organization\"},\"isPartOf\":{\"@id\":\"https://quetzal.mintlify.app#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Quetzal\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Quetzal\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/en-US/start/first-time-localization.md","siteName":"Quetzal","nav":{"global":null,"languages":[{"language":"en","banner":{"content":"🚀 Under Construction","dismissible":true},"groups":[{"group":"Get Started","pages":[{"title":"Getting Started","description":"Integrate with Quetzal in minutes","href":"/en-US/start/getting-started"},{"title":"First Time Localization","href":"/en-US/start/first-time-localization"},{"title":"Setting Up Quetzal","description":"Integrating with Quetzal with an existing localization system","href":"/en-US/start/existing-localization"}]},{"group":"Installation","pages":[{"title":"Linking a Repository","href":"/en-US/install/linking-a-repository"},{"title":"Committing Changes","href":"/en-US/install/committing-changes"},{"title":"Is My Stack Supported?","href":"/en-US/install/is-my-stack-supported"},{"title":"Choosing a Framework","href":"/en-US/install/choosing-a-framework"}]},{"group":"Dashboard","pages":[{"title":"Integration Dashboard","href":"/en-US/dashboard/integration-dashboard"}]}]},{"language":"es","banner":{"content":"🚀 En construcción...","dismissible":true},"pages":[{"title":"es","href":"/es-419/start/getting-started"}]},{"language":"it","banner":{"content":"🚀 In costruzione...","dismissible":true},"pages":[{"title":"it","href":"/it-IT/start/getting-started"}]}]},"basePath":"","title":"First Time Localization - Quetzal","buildId":"dpl_Fyv1NbzwP68g2bEH2Roy98uY1zmE","deploymentId":"dpl_Fyv1NbzwP68g2bEH2Roy98uY1zmE","dynamics":[],"chunks":[]}