klaviyo-reference-architecture

Featured

Implement Klaviyo reference architecture with best-practice project layout. Use when designing new Klaviyo integrations, reviewing project structure, or establishing architecture standards for email/SMS marketing applications. Trigger with phrases like "klaviyo architecture", "klaviyo project structure", "klaviyo design", "how to organize klaviyo", "klaviyo layout".

AI & Automation 2,926 stars 433 forks Updated yesterday MIT

Install

View on GitHub

Quality Score: 99/100

Stars 20%
100
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
50
License 10%
100
Description 5%
100

Skill Content

# Klaviyo Reference Architecture ## Overview Production-ready architecture for Klaviyo integrations: layered project structure, service patterns, event-driven sync, and the `klaviyo-api` SDK wired into a real application. ## Prerequisites - TypeScript project with `klaviyo-api` installed - Understanding of layered architecture - Redis (for caching/queuing) and database (for audit/sync state) ## Project Structure ``` src/ ├── klaviyo/ # SDK layer (thin wrappers) │ ├── session.ts # ApiKeySession singleton │ ├── api.ts # Lazy API client getters │ ├── types.ts # Shared Klaviyo types │ └── errors.ts # Error parsing/classification ├── services/ # Business logic layer │ ├── profile-sync.ts # Bidirectional profile sync │ ├── event-tracker.ts # Server-side event tracking │ ├── campaign-manager.ts # Campaign create/send │ ├── list-manager.ts # List/subscription management │ └── segment-query.ts # Segment membership queries ├── webhooks/ # Inbound webhook handlers │ ├── router.ts # Topic-based event routing │ ├── verify.ts # HMAC-SHA256 signature verification │ └── handlers/ │ ├── profile-events.ts # profile.created, profile.updated │ ├── list-events.ts # list.member.added/removed │ └── campaign-events.ts # campaign.sent, delivered ├── jobs/ ...

Details

Author
jeremylongshore
Repository
jeremylongshore/claude-code-plugins-plus-skills
Created
1 years ago
Last Updated
yesterday
Language
Python
License
MIT

Integrates with

Bundled in these plugins

Similar Skills

Semantically similar based on skill content — not just same category