pedropardoso/startup-kit-subscriptions

Startup Kit — Subscriptions module: recurring subscription management

v0.3.0 2026-07-06 13:55 UTC

Requires

• php: ^8.4
• illuminate/contracts: ^12.0
• illuminate/support: ^12.0
• pedropardoso/startup-kit-core: ^1.0

Requires (Dev)

• mockery/mockery: ^1.6
• orchestra/testbench: ^10.0
• phpunit/phpunit: ^11.0

MIT

Published on Packagist.org on 2026-07-06 15:43 UTC

README

Recurring subscription management domain module.

Part of Startup Kit, a modular backend for SaaS products built on PHP 8.4 / Laravel 12 with DDD, CQRS and ports & adapters.

Architecture

src/Subscriptions
├── Domain          # Subscription aggregate, SubscriptionId, SubscriptionStatus, SubscriptionCreated event
├── Application     # CreateSubscription command, GetSubscriptionById / ListSubscriptions queries + handlers
├── Contracts       # SubscriptionRepository port
├── Http            # Controller, FormRequest, API Resource
└── Infrastructure  # Persistence adapters: Eloquent, Postgres, MySQL, Mongo, InMemory

Highlights

• CQRS — commands and queries dispatched through the core buses (logging, tracing and transactions come for free)
• Domain events — SubscriptionCreated published via the core event bus with transactional outbox
• Swappable persistence — Postgres, MySQL, Mongo, Eloquent or in-memory, selected by config
• REST API — ready-made controller, request validation and resource under routes/api.php

Install

composer require pedropardoso/startup-kit-subscriptions

Not yet on Packagist — add the repo as a VCS repository in your composer.json first:

{ "repositories": [{ "type": "vcs", "url": "https://github.com/PedroPCardoso/startup-kit-subscriptions" }] }

Requires startup-kit-core. The service provider is auto-discovered by Laravel; configuration lives in config/startup-kit-subscriptions.php and migrations ship with the package.

Testing

composer install
vendor/bin/phpunit

Unit and integration tests run on Orchestra Testbench. Repository adapters share a contract test case, so every persistence backend is verified against the same behaviour.

Startup Kit modules

Module	Description
startup-kit-core	Primitives, contracts and cross-cutting infrastructure
startup-kit-users	User registration & management
startup-kit-payments	Payments with multi-gateway support (Stripe, Mercado Pago)
startup-kit-orders	Orders & order lines
startup-kit-subscriptions	Recurring subscriptions
startup-kit-notifications	Multi-channel notifications (SendGrid, Twilio, Telegram)

License

MIT