All employees are remote, which means we don’t have a physical office. Instead, we use video conferencing and messaging tools to communicate and collaborate with each other.
We believe in open source, it’s in our DNA. We contributed to open source projects, use open source tools, and we build on public. Check out our GitHub
We’re transparent, which means we share information and ideas freely. We believe in open communication and collaboration, which allows us to learn from each other and improve our work. That’s why almost all our documentation and processes are public.
We’re autonomous, which means we have the freedom to make decisions and take ownership of our work. We believe in self-organization and self-management, which allows us to work efficiently and effectively.
We don’t have a fixed schedule and meetings. We believe in asynchronous communication and collaboration, which allows us to work at our own pace and in our own time.
⌘I
{"docsConfig":{"theme":"maple","$schema":"https://mintlify.com/docs.json","name":"Polar Handbook","colors":{"primary":"#000","light":"#fff","dark":"#000"},"logo":{"light":"https://mintcdn.com/polar-handbook/lJCpMX18DJeucCdV/images/light.png?fit=max\u0026auto=format\u0026n=lJCpMX18DJeucCdV\u0026q=85\u0026s=d57d5ae90ddaff62cce287ad100a8532","dark":"https://mintcdn.com/polar-handbook/lJCpMX18DJeucCdV/images/dark.png?fit=max\u0026auto=format\u0026n=lJCpMX18DJeucCdV\u0026q=85\u0026s=38f67240972a3848c6179a162c8f3e2c"},"favicon":"https://mintcdn.com/polar-handbook/lJCpMX18DJeucCdV/images/favicon.png?fit=max\u0026auto=format\u0026n=lJCpMX18DJeucCdV\u0026q=85\u0026s=3f3b1886ae03a807ac478dc0f59c171b","appearance":{"default":"system"},"background":{"color":{"dark":"#131316"}},"contextual":{"options":["copy","chatgpt","claude"],"display":"header"},"styling":{"latex":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"polar-handbook","hasAudioNarration":false,"actualSubdomain":"polar-handbook","customDomains":["handbook.polar.sh"],"gitSource":{"type":"github","owner":"polarsource","repo":"polar","deployBranch":"main","contentDirectory":"handbook","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ae07125dc8e261a8bb5c23a","collectionId":"c67bc25c-de73-4688-8d87-63c6e23c13f1","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ae07125dc8e261a8bb5c23a"},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6ae07125dc8e261a8bb5c23a","clientVersion":"0.0.3990","searchFilterCounts":[{"language":"default","tag":"Engineering","count":64},{"language":"default","tag":"Design Documents","count":20},{"language":"default","tag":"Architecture Decisions","count":16},{"language":"default","tag":"On-Call Procedures","count":13},{"language":"default","tag":"Backend Development","count":8},{"language":"default","tag":"Design","count":5},{"language":"default","tag":"Working at Polar","count":5},{"language":"default","tag":"Guides","count":3},{"language":"default","tag":"Company","count":1}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","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":"editor-v7-file-tree","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":"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":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"pause-universal-search-reconcile","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":"per-site-search-delta","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":"editor-private-page-search","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":"editor-nav-generations","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":"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":"byok-sep-25","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":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-agent-model-picker","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","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":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"isAtlas":false,"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"working-at-polar/how-we-work","slug":"/working-at-polar/how-we-work","pageMetadata":{"title":"How we work","description":"Discover what makes us spicy","href":"/working-at-polar/how-we-work"},"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: \"Discover what makes us spicy\"\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}=_components;if(!Heading)_missingMdxReference(`Heading`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`So, what’s like working at Polar?`}),`\n`,_jsx(Heading,{level:`2`,id:`we’re-remote`,children:`We’re remote`}),`\n`,_jsx(_components.p,{children:`All employees are remote, which means we don’t have a physical office. Instead, we use video conferencing and messaging tools to communicate and collaborate with each other.`}),`\n`,_jsx(Heading,{level:`2`,id:`we-love-open-source`,children:`We love open source`}),`\n`,_jsxs(_components.p,{children:[`We believe in open source, it’s in our DNA. We contributed to open source projects, use open source tools, and we build on public. Check out our `,_jsx(_components.a,{href:`https://github.com/polarsource/polar`,children:`GitHub`})]}),`\n`,_jsx(Heading,{level:`2`,id:`we’re-transparent`,children:`We’re transparent`}),`\n`,_jsx(_components.p,{children:`We’re transparent, which means we share information and ideas freely. We believe in open communication and collaboration, which allows us to learn from each other and improve our work. That’s why almost all our documentation and processes are public.`}),`\n`,_jsx(Heading,{level:`2`,id:`we’re-autonomous`,children:`We’re autonomous`}),`\n`,_jsx(_components.p,{children:`We’re autonomous, which means we have the freedom to make decisions and take ownership of our work. We believe in self-organization and self-management, which allows us to work efficiently and effectively.`}),`\n`,_jsx(Heading,{level:`2`,id:`we’re-async`,children:`We’re async`}),`\n`,_jsx(_components.p,{children:`We don’t have a fixed schedule and meetings. We believe in asynchronous communication and collaboration, which allows us to work at our own pace and in our own time.`})]})}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":"How we work","description":"Discover what makes us spicy","href":"/working-at-polar/how-we-work"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"We’re remote","slug":"we’re-remote","depth":2,"children":[]},{"title":"We love open source","slug":"we-love-open-source","depth":2,"children":[]},{"title":"We’re transparent","slug":"we’re-transparent","depth":2,"children":[]},{"title":"We’re autonomous","slug":"we’re-autonomous","depth":2,"children":[]},{"title":"We’re async","slug":"we’re-async","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"polar-handbook","siteName":"Polar Handbook","title":"How we work - Polar Handbook","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2025-09-23T15:37:26.097Z","originalFileLocation":"working-at-polar/how-we-work.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=\"Discover what makes us spicy\">\u003cmeta data-mint-head name=\"application-name\" content=\"Polar Handbook\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/polar-handbook/gUYbsHdeOTU04sqy/_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/polar-handbook/gUYbsHdeOTU04sqy/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/polar-handbook/gUYbsHdeOTU04sqy/_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/polar-handbook/gUYbsHdeOTU04sqy/_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/polar-handbook/gUYbsHdeOTU04sqy/_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/polar-handbook/gUYbsHdeOTU04sqy/_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/polar-handbook/gUYbsHdeOTU04sqy/_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/polar-handbook/gUYbsHdeOTU04sqy/_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/polar-handbook/gUYbsHdeOTU04sqy/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"How we work - Polar Handbook\">\u003cmeta data-mint-head property=\"og:description\" content=\"Discover what makes us spicy\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Polar Handbook\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://handbook.polar.sh/working-at-polar/how-we-work\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://polar-handbook.mintlify.app/_mintlify/api/og/v2?division=Working+at+Polar\u0026amp;title=How+we+work\u0026amp;description=Discover+what+makes+us+spicy\u0026amp;theme=6fad0777c87be054b9ac2477\u0026amp;signature=a5bd673c8060e0cfebfcde0eb6ea7e31110502cfe909999a7af713e72bc1b346\">\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=\"How we work - Polar Handbook\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Discover what makes us spicy\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://polar-handbook.mintlify.app/_mintlify/api/og/v2?division=Working+at+Polar\u0026amp;title=How+we+work\u0026amp;description=Discover+what+makes+us+spicy\u0026amp;theme=6fad0777c87be054b9ac2477\u0026amp;signature=a5bd673c8060e0cfebfcde0eb6ea7e31110502cfe909999a7af713e72bc1b346\">\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/polar-handbook/gUYbsHdeOTU04sqy/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Polar Handbook\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#000\">\u003clink data-mint-head rel=\"canonical\" href=\"https://handbook.polar.sh/working-at-polar/how-we-work\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/working-at-polar/how-we-work.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://handbook.polar.sh/#organization\",\"name\":\"Polar Handbook\",\"url\":\"https://handbook.polar.sh\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/polar-handbook/lJCpMX18DJeucCdV/images/light.png?fit=max\u0026auto=format\u0026n=lJCpMX18DJeucCdV\u0026q=85\u0026s=d57d5ae90ddaff62cce287ad100a8532\"}},{\"@type\":\"WebSite\",\"@id\":\"https://handbook.polar.sh#website\",\"name\":\"Polar Handbook\",\"url\":\"https://handbook.polar.sh\",\"publisher\":{\"@id\":\"https://handbook.polar.sh/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://handbook.polar.sh/working-at-polar/how-we-work#webpage\",\"url\":\"https://handbook.polar.sh/working-at-polar/how-we-work\",\"name\":\"How we work\",\"description\":\"Discover what makes us spicy\",\"dateModified\":\"2025-09-23T15:37:26.097Z\",\"isPartOf\":{\"@id\":\"https://handbook.polar.sh#website\"},\"breadcrumb\":{\"@id\":\"https://handbook.polar.sh/working-at-polar/how-we-work#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://handbook.polar.sh/working-at-polar/how-we-work#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Working at Polar\",\"item\":\"https://handbook.polar.sh/working-at-polar/introduction\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"How we work\",\"item\":\"https://handbook.polar.sh/working-at-polar/how-we-work\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://handbook.polar.sh/working-at-polar/how-we-work#article\",\"headline\":\"How we work\",\"name\":\"How we work\",\"description\":\"Discover what makes us spicy\",\"url\":\"https://handbook.polar.sh/working-at-polar/how-we-work\",\"mainEntityOfPage\":{\"@id\":\"https://handbook.polar.sh/working-at-polar/how-we-work#webpage\"},\"dateModified\":\"2025-09-23T15:37:26.097Z\",\"publisher\":{\"@id\":\"https://handbook.polar.sh/#organization\"},\"isPartOf\":{\"@id\":\"https://handbook.polar.sh#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Polar Handbook\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Polar Handbook","nav":{"global":null,"groups":[{"group":"Company","pages":[{"title":"About Polar","href":"/company/about-polar"}]},{"group":"Working at Polar","pages":[{"title":"Working at Polar","href":"/working-at-polar/introduction"},{"title":"Onboarding","description":"Your first 30 days at Polar","href":"/working-at-polar/onboarding"},{"title":"How we work","href":"/working-at-polar/how-we-work"},{"title":"Project Management Workflow","description":"How we manage issues and projects using GitHub","href":"/working-at-polar/project-management-workflow"},{"title":"Recruitment Process","href":"/working-at-polar/recruitment-process"}]},{"group":"Design","pages":[{"title":"Design at Polar","href":"/design/introduction"},{"title":"Design Principles","href":"/design/principles"},{"title":"Product Design","href":"/design/product-design"},{"title":"Visual Design","href":"/design/visual-design"},{"title":"Voice \u0026 Tone","href":"/design/voice-and-tone"}]},{"group":"Engineering","pages":[{"title":"Engineering at Polar","href":"/engineering/introduction"},{"title":"API Tokens and System Credentials","href":"/engineering/api-tokens-and-system-credentials"},{"group":"Guides","pages":[{"title":"Guides","href":"/engineering/guides"},{"title":"Releasing @polar-sh/checkout","href":"/engineering/guides/release-checkout"},{"title":"Polar Cycle","href":"/engineering/guides/cycle-admin"}]},{"group":"Backend Development","pages":[{"title":"Authorization","href":"/engineering/backend-development/authorization"},{"title":"REST API Guidelines","href":"/engineering/backend-development/rest-api-guidelines"},{"title":"API Versioning","href":"/engineering/backend-development/api-versioning"},{"title":"Task Debouncer","href":"/engineering/backend-development/task-debouncer"},{"title":"Operational Errors","href":"/engineering/backend-development/operational-errors"},{"title":"Metadata","href":"/engineering/backend-development/metadata"},{"title":"Tinybird","href":"/engineering/backend-development/tinybird"},{"title":"Account \u0026 Payout Account","href":"/engineering/backend-development/account-payout-account"}]},{"group":"Design Documents","pages":[{"title":"Design documents","href":"/engineering/design-documents/index"},{"title":"\u003cshort feature title>","href":"/engineering/design-documents/template"},{"title":null,"href":"/engineering/design-documents/seat-based-pricing"},{"title":null,"href":"/engineering/design-documents/prorations"},{"title":null,"href":"/engineering/design-documents/subscription-retries"},{"title":null,"href":"/engineering/design-documents/wallets"},{"title":null,"href":"/engineering/design-documents/multi-currency"},{"title":null,"href":"/engineering/design-documents/business-entity"},{"title":null,"href":"/engineering/design-documents/event-storage"},{"title":"Platform API","href":"/engineering/design-documents/platform-api"},{"title":null,"href":"/engineering/design-documents/rbac"},{"title":null,"href":"/engineering/design-documents/polar-for-polar"},{"title":"API Versioning","href":"/engineering/design-documents/api-versioning"},{"title":null,"href":"/engineering/design-documents/payout-reviews"},{"title":null,"href":"/engineering/design-documents/secrets-encryption"},{"title":null,"href":"/engineering/design-documents/merchant-migrations"},{"title":"Tasks on Lambda","href":"/engineering/design-documents/tasks-on-lambda"},{"title":"Switching to Resend Forge","href":"/engineering/design-documents/resend-forge"},{"title":"Versioning","href":"/engineering/design-documents/versioning"},{"title":"Outpost","href":"/engineering/design-documents/outpost"}]},{"group":"Architecture Decisions","pages":[{"title":"Architecture Decision Records","href":"/engineering/decisions/index"},{"title":"ADR-NNNN: \u003cshort decision title>","href":"/engineering/decisions/template"},{"title":"ADR-0001: Record architecture decisions","href":"/engineering/decisions/0001-record-architecture-decisions"},{"title":"ADR-0002: Business errors are status-coded PolarError subclasses","href":"/engineering/decisions/0002-status-coded-polar-errors"},{"title":"ADR-0003: One request or task is one transaction","href":"/engineering/decisions/0003-request-scoped-unit-of-work"},{"title":"ADR-0004: Frontend UI is authored with Orbit Box and design tokens","href":"/engineering/decisions/0004-orbit-box-design-system"},{"title":"ADR-0005: Authorization is AuthSubject plus scopes, with per-module authenticators","href":"/engineering/decisions/0005-auth-subject-and-scopes"},{"title":"ADR-0006: Migrations and backfills are deploy-safe by construction","href":"/engineering/decisions/0006-migration-and-backfill-safety"},{"title":"ADR-0007: No default in output schemas","href":"/engineering/decisions/0007-no-default-in-output-schemas"},{"title":"ADR-0008: Encrypt secrets at rest","href":"/engineering/decisions/0008-encrypt-secrets-at-rest"},{"title":"ADR-0009: Use bare boolean expressions in SQLAlchemy predicates","href":"/engineering/decisions/0009-use-bare-boolean-expressions-in-sqlalchemy-predicates"},{"title":"ADR-0010: JWKS signing keys live in KMS and rotate by kid","href":"/engineering/decisions/0010-jwks-signing-keys-in-kms"},{"title":"ADR-0011: Specialized webhook events also emit the catch-all updated","href":"/engineering/decisions/0011-specialized-webhooks-also-emit-updated"},{"title":"ADR-0012: Minimize data in AI API calls","href":"/engineering/decisions/0012-minimize-data-in-ai-api-calls"},{"title":"ADR-0013: Minimize personal data in telemetry","href":"/engineering/decisions/0013-minimize-personal-data-in-telemetry"},{"title":"ADR-0014: AI agents are their own auth subject until a human claims them","href":"/engineering/decisions/0014-agent-auth-subject"}]},{"title":"Data Flows","href":"/engineering/data-flows"},{"title":"Tech Notes","href":"/engineering/tech-notes"},{"group":"On-Call Procedures","pages":[{"title":"On-Call Procedures","href":"/engineering/oncall/introduction"},{"title":null,"href":"/engineering/oncall/developer-faq"},{"title":"Merge Accounts","href":"/engineering/oncall/merge-accounts"},{"title":"Deploy Infrastructure Changes","href":"/engineering/oncall/deploy-infra"},{"title":"Trigger Webhooks","href":"/engineering/oncall/trigger-webhooks"},{"title":"Run One-Off Jobs","href":"/engineering/oncall/run-one-off-jobs"},{"title":"Connecting to the Database","href":"/engineering/oncall/connecting-to-prod-db"},{"title":"Kill Blocking DB Queries","href":"/engineering/oncall/kill-blocking-queries"},{"title":"Rotate Database Credentials","href":"/engineering/oncall/rotate-db-credentials"},{"title":"Rotate the JWKS Signing Key","href":"/engineering/oncall/rotate-jwks"},{"title":"Rotate the Token Hashing Secret","href":"/engineering/oncall/rotate-secret"},{"title":"Respond to a KMS Key Compromise","href":"/engineering/oncall/respond-to-a-kms-compromise"},{"title":"Vendor Security Monitoring","href":"/engineering/oncall/vendor-security-monitoring"}]}]}]},"title":"How we work - Polar Handbook","buildId":"dpl_2oYXwqkEXirXBPk8wV1FtM5USFWi","deploymentId":"dpl_2oYXwqkEXirXBPk8wV1FtM5USFWi","dynamics":[],"chunks":[]}