Draft

RedFire PHP SDK & Laravel Package

Prepared for: RedFire Technology

Prepared on: 01/30/2026

Summary

This project delivers two Composer packages: a standalone PHP SDK wrapping the RedFire REST API, and a full-featured Laravel package that provides a working e-commerce storefront out of the box.

The SDK follows the Stripe PHP SDK conventions — a single client entry point, lazy-loaded service classes, typed resource objects, and structured exceptions. It ships via Packagist with a manual autoload fallback for non-Composer environments.

The Laravel package builds on the SDK to deliver a complete storefront experience: install the package, configure credentials, add one line to your routes file, and you have a working store with theming, caching, and cart/checkout functionality.

#1 PHP SDK (`redfire/redfire-php`)

Stripe-style PHP SDK wrapping the RedFire REST API. Approximately 20 files covering HTTP transport, service classes for all API endpoints, typed resource objects, and structured exception handling. Distributed via Composer/Packagist with a manual init.php fallback.

Deliverables:

RedFireClient entry point with lazy-loaded service access
ApiRequestor — raw cURL HTTP layer with auth and error handling
5 service classes (Location, Category, Inventory, Purchase, Transaction)
5 resource classes with ArrayAccess + magic property access
3 exception types (API, Authentication, Connection)
composer.json with PSR-4 autoload and dev tooling (PHPStan, PHP CS Fixer)
init.php for non-Composer usage
Packagist-ready repository structure

#2 Laravel Package (`redfire/laravel`)

Full-featured Laravel package that provides a working e-commerce storefront out of the box. Install, configure credentials, add one line to routes — done.

Deliverables:

Service provider with singleton SDK client binding
Facade with RedFire::routes() helper (14 routes)
4 controllers (Store, Cart, Checkout, Invoice)
Session initialization middleware (location + cart)
Theme system with config-driven switching
- Default theme (complete Blade view set)
- Tailwind theme (complete Blade view set)
Config-driven branding (logo, primary/secondary colors via CSS custom properties)
Stylesheet override support (no publish required)
Laravel cache integration with per-endpoint TTL configuration
Publishable config, views, and assets
Ported JS (cart operations, payment iframe)
Helper functions (rf_money(), rf_asset())

Investment

Package 1: PHP SDK	$2,500
Package 2: Laravel Package	$6,000
Implementation Support	$150/hr
Total Project Cost	$8,500

Notes

Price covers development and delivery of both packages. Does not include ongoing maintenance, hosting, or support beyond initial delivery.
SDK is delivered first as a dependency of the Laravel package.
Verification includes manual end-to-end testing against the live RedFire API (store browsing, cart operations, checkout flow).

Payment Terms

A 50% deposit is required to begin the project, with the remaining 50% due upon completion and delivery. Payments can be made via bank transfer, credit card, or other agreed methods.

Terms & Conditions

This proposal is bound by the terms and conditions found at https://borders.dev/terms, which are incorporated herein by reference. By accepting this proposal, you acknowledge that you have read and agree to these terms and conditions.

RedFire Technology:

Signature:

Name:

Title:

Date:

Borders Web Development, LLC