# Polar Handbook

## Docs

- [About Polar](https://polar-handbook-psincraian-elastic-greider-765c1a.mintlify.site/company/about-polar.md): Discover who we are
- [Design at Polar](https://polar-handbook-psincraian-elastic-greider-765c1a.mintlify.site/design/introduction.md): Our design vision, principles, and the standards that guide every decision
- [Design Principles](https://polar-handbook-psincraian-elastic-greider-765c1a.mintlify.site/design/principles.md): The three rules that govern every design decision at Polar
- [Product Design](https://polar-handbook-psincraian-elastic-greider-765c1a.mintlify.site/design/product-design.md): How the design principles apply to the Polar product
- [Visual Design](https://polar-handbook-psincraian-elastic-greider-765c1a.mintlify.site/design/visual-design.md): The visual world, typography, and motion at Polar
- [Voice & Tone](https://polar-handbook-psincraian-elastic-greider-765c1a.mintlify.site/design/voice-and-tone.md): How Polar sounds, in writing
- [Account & Payout Account](https://polar-handbook-psincraian-elastic-greider-765c1a.mintlify.site/engineering/backend-development/account-payout-account.md): How Polar's financial ledger entities work: Account (transaction ledger) and PayoutAccount (payout processor configuration).
- [Authorization](https://polar-handbook-psincraian-elastic-greider-765c1a.mintlify.site/engineering/backend-development/authorization.md): How authorization works in Polar: authentication vs authorization, PolicyGuard, policies, and org-scoped data access.
- [Metadata](https://polar-handbook-psincraian-elastic-greider-765c1a.mintlify.site/engineering/backend-development/metadata.md): A shared mechanism letting users attach arbitrary key-value data to Polar models.
- [Operational Errors](https://polar-handbook-psincraian-elastic-greider-765c1a.mintlify.site/engineering/backend-development/operational-errors.md): Understanding and handling operational errors in Polar backend development
- [REST API Guidelines](https://polar-handbook-psincraian-elastic-greider-765c1a.mintlify.site/engineering/backend-development/rest-api-guidelines.md): Best practices and conventions for designing and implementing RESTful APIs at Polar
- [Task Debouncer](https://polar-handbook-psincraian-elastic-greider-765c1a.mintlify.site/engineering/backend-development/task-debouncer.md): How to use task debouncing to avoid duplicate task execution in Polar's background worker system.
- [Tinybird](https://polar-handbook-psincraian-elastic-greider-765c1a.mintlify.site/engineering/backend-development/tinybird.md): How we use Tinybird for event ingestion, materialized views, and analytics in Polar.
- [API Versioning](https://polar-handbook-psincraian-elastic-greider-765c1a.mintlify.site/engineering/design-documents/api-versioning.md): Proposal for a date-based API versioning strategy with strict change policies and predictable release cadence
- [Business entity](https://polar-handbook-psincraian-elastic-greider-765c1a.mintlify.site/engineering/design-documents/business-entity.md)
- [Event storage](https://polar-handbook-psincraian-elastic-greider-765c1a.mintlify.site/engineering/design-documents/event-storage.md)
- [Design documents](https://polar-handbook-psincraian-elastic-greider-765c1a.mintlify.site/engineering/design-documents/index.md)
- [Merchant migrations](https://polar-handbook-psincraian-elastic-greider-765c1a.mintlify.site/engineering/design-documents/merchant-migrations.md)
- [Multi currency](https://polar-handbook-psincraian-elastic-greider-765c1a.mintlify.site/engineering/design-documents/multi-currency.md)
- [Payout reviews](https://polar-handbook-psincraian-elastic-greider-765c1a.mintlify.site/engineering/design-documents/payout-reviews.md)
- [Platform API](https://polar-handbook-psincraian-elastic-greider-765c1a.mintlify.site/engineering/design-documents/platform-api.md): Proposal for a Platform API to enable partners to create and manage Polar Organizations on behalf of their users.
- [Polar for polar](https://polar-handbook-psincraian-elastic-greider-765c1a.mintlify.site/engineering/design-documents/polar-for-polar.md)
- [Prorations](https://polar-handbook-psincraian-elastic-greider-765c1a.mintlify.site/engineering/design-documents/prorations.md)
- [Rbac](https://polar-handbook-psincraian-elastic-greider-765c1a.mintlify.site/engineering/design-documents/rbac.md)
- [Seat based pricing](https://polar-handbook-psincraian-elastic-greider-765c1a.mintlify.site/engineering/design-documents/seat-based-pricing.md)
- [Subscription retries](https://polar-handbook-psincraian-elastic-greider-765c1a.mintlify.site/engineering/design-documents/subscription-retries.md)
- [Wallets](https://polar-handbook-psincraian-elastic-greider-765c1a.mintlify.site/engineering/design-documents/wallets.md)
- [Guides](https://polar-handbook-psincraian-elastic-greider-765c1a.mintlify.site/engineering/guides.md): Step-by-step guides for common engineering tasks at Polar
- [Polar Cycle](https://polar-handbook-psincraian-elastic-greider-765c1a.mintlify.site/engineering/guides/cycle-admin.md): How to configure Polar Cycle, the Slack bot that announces PRs and rotates the primary reviewer
- [Releasing @polar-sh/checkout](https://polar-handbook-psincraian-elastic-greider-765c1a.mintlify.site/engineering/guides/release-checkout.md): Step-by-step guide for releasing a new version of the @polar-sh/checkout npm package
- [Engineering at Polar](https://polar-handbook-psincraian-elastic-greider-765c1a.mintlify.site/engineering/introduction.md): How we build software and work as an engineering team
- [Deploy Infrastructure Changes](https://polar-handbook-psincraian-elastic-greider-765c1a.mintlify.site/engineering/oncall/deploy-infra.md): Procedure for syncing and deploying infrastructure changes
- [Developer faq](https://polar-handbook-psincraian-elastic-greider-765c1a.mintlify.site/engineering/oncall/developer-faq.md)
- [On-Call Procedures](https://polar-handbook-psincraian-elastic-greider-765c1a.mintlify.site/engineering/oncall/introduction.md): Manual procedures and troubleshooting guide for on-call engineers
- [Merge Accounts](https://polar-handbook-psincraian-elastic-greider-765c1a.mintlify.site/engineering/oncall/merge-accounts.md): Procedure for merging multiple merchant accounts
- [Run One-Off Jobs](https://polar-handbook-psincraian-elastic-greider-765c1a.mintlify.site/engineering/oncall/run-one-off-jobs.md): Trigger backend scripts in production via Render One-Off Jobs
- [Trigger Webhooks](https://polar-handbook-psincraian-elastic-greider-765c1a.mintlify.site/engineering/oncall/trigger-webhooks.md): Procedure for manually triggering missed or failed webhooks
- [Tech Notes](https://polar-handbook-psincraian-elastic-greider-765c1a.mintlify.site/engineering/tech-notes.md): Technical insights, debugging stories, and engineering learnings from the Polar team
- [How we work](https://polar-handbook-psincraian-elastic-greider-765c1a.mintlify.site/working-at-polar/how-we-work.md): Discover what makes us spicy
- [Working at Polar](https://polar-handbook-psincraian-elastic-greider-765c1a.mintlify.site/working-at-polar/introduction.md): Welcome to Polar - our culture, values, and how we work together
- [Onboarding](https://polar-handbook-psincraian-elastic-greider-765c1a.mintlify.site/working-at-polar/onboarding.md): Your first 30 days at Polar
- [Project Management Workflow](https://polar-handbook-psincraian-elastic-greider-765c1a.mintlify.site/working-at-polar/project-management-workflow.md): How we manage issues and projects using GitHub
- [Recruitment Process](https://polar-handbook-psincraian-elastic-greider-765c1a.mintlify.site/working-at-polar/recruitment-process.md): Our engineering recruitment process and philosophy