PHPackages                             romansh/laravel-creem-demo - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Payment Processing](/categories/payments)
4. /
5. romansh/laravel-creem-demo

ActiveProject[Payment Processing](/categories/payments)

romansh/laravel-creem-demo
==========================

Demo application showcasing romansh/laravel-creem payment integration with Creem.io

v1.3.10(2mo ago)06MITBladePHP ^8.2

Since Feb 25Pushed 2mo agoCompare

[ Source](https://github.com/romansh/laravel-creem-demo)[ Packagist](https://packagist.org/packages/romansh/laravel-creem-demo)[ RSS](/packages/romansh-laravel-creem-demo/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependencies (12)Versions (14)Used By (0)

Laravel Creem Demo
==================

[](#laravel-creem-demo)

> Demo application showcasing [romansh/laravel-creem](https://github.com/romansh/laravel-creem) payment integration with Creem.io

[![License](https://camo.githubusercontent.com/7013272bd27ece47364536a221edb554cd69683b68a46fc0ee96881174c4214c/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d626c75652e737667)](LICENSE)

✨ Key Features
--------------

[](#-key-features)

- ✅ **Zero Setup Configuration** - Configure API keys via web interface (no .env editing!)
- ✅ **One-Command Installation** - `composer create-project` + `composer run setup`
- ✅ **Product Management** - One-time purchases & subscriptions
- ✅ **Checkout Flows** - Complete payment integration
- ✅ **Webhook Support** - Real-time event handling (Cloudflare Tunnels or ngrok)
- ✅ **Livewire 4** - Modern reactive UI
- ✅ **Modular Architecture** - Clean, maintainable code structure

Built with Laravel 12, Livewire 4, and Tailwind CSS 4.

🖼️ UI Walkthrough (Screenshots)
-------------------------------

[](#️-ui-walkthrough-screenshots)

The screenshots below show the main demo flow and key UI areas.

  **1) API Setup**
Configure API key & webhook secret (masked with eye toggle), webhook URL with copy button, multi-profile tabs, and code example for config/creem.php.
[![API Setup — credentials, webhook URL, profile tabs](docs/demo-screenshot-1.png)](docs/demo-screenshot-1.png) **2) Webhooks & Access**
Live access log showing GrantAccess / RevokeAccess events, event log with timestamps, event→action mapping table, and AppServiceProvider listener code.
[![Webhooks and Access — event log, access log, action mapping](docs/demo-screenshot-2.png)](docs/demo-screenshot-2.png)   **3) Transactions**
Browse payment transactions with IDs, amounts, dates, and customer emails. Includes a code example for listing transactions via the Creem facade.
[![Transactions — payment history list with code example](docs/demo-screenshot-3.png)](docs/demo-screenshot-3.png) **4) Discounts**
Create Discount Code dialog — set name, code, pick target products, choose discount type (percentage/fixed), amount, and duration. Validation shown inline.
[![Discounts — create discount code dialog with product selection](docs/demo-screenshot-4.png)](docs/demo-screenshot-4.png)   **5) Subscriptions**
Recurring plans list with billing periods (monthly, quarterly, bi-annual, annual), prices, and Subscribe buttons. Code example for creating plans and checkout sessions.
[![Subscriptions — recurring plans with billing periods and code example](docs/demo-screenshot-5.png)](docs/demo-screenshot-5.png) **6) One-Time Payments**
Product list with Preview Product modal showing name, description, price, currency, and tax mode. Create products via API with the code example on the right.
[![One-Time Payments — product preview modal and creation code](docs/demo-screenshot-6.png)](docs/demo-screenshot-6.png) Requirements
------------

[](#requirements)

- PHP 8.2+
- Composer 2.x
- Node.js 18+ & npm
- SQLite (default) or MySQL/PostgreSQL
- Docker & Docker Compose (optional, for containerized setup)

Quick Start
-----------

[](#quick-start)

### Option 1: Composer Create Project (Recommended)

[](#option-1-composer-create-project-recommended)

```
# Create new project
composer create-project romansh/laravel-creem-demo my-creem-app

# Navigate to directory
cd my-creem-app

# Run automated setup (installs dependencies, generates key, builds assets, runs migrations)
composer run setup

# Start development server
php artisan serve
```

Visit **** and configure your API keys via the web interface!

### Option 2: Using Docker (Includes Cloudflare Tunnel)

[](#option-2-using-docker-includes-cloudflare-tunnel)

```
# Create project
composer create-project romansh/laravel-creem-demo my-creem-app
cd my-creem-app

# Copy environment file
cp .env.example .env

# Optional: Configure Cloudflare Tunnel for webhooks (see section below)
# Edit .env and add your tunnel credentials

# Start all services
docker-compose up -d
```

Visit **** and configure API keys at `/creem-demo`

### Option 3: Manual Installation (Git Clone)

[](#option-3-manual-installation-git-clone)

```
# Clone repository
git clone https://github.com/romansh/laravel-creem-demo.git
cd laravel-creem-demo

# Run automated setup
composer run setup

# Start development server
php artisan serve
```

Visit ****

Development Workflow
--------------------

[](#development-workflow)

### Using Docker Compose (Recommended)

[](#using-docker-compose-recommended)

Starts all services including Cloudflare Tunnel:

```
# Start all services (Laravel Octane + Traefik + Cloudflare Tunnel)
docker-compose up -d

# View logs
docker-compose logs -f

# Run artisan commands
docker-compose exec laravel.test php artisan migrate
docker-compose exec laravel.test php artisan tinker

# Stop services
docker-compose down
```

**Services included:**

- Laravel Octane (Swoole) - High performance app server
- Traefik - Reverse proxy
- Cloudflare Tunnel - Secure public access (if configured)

Access:  (via Traefik) or your Cloudflare domain

### Using PHP Artisan Serve

[](#using-php-artisan-serve)

Traditional Laravel development server:

```
# Install dependencies
composer install
npm install

# Build assets
npm run build  # Production build
# OR
npm run dev    # Development with HMR

# Start server
php artisan serve

# ⚠️ Important: Use localhost, not IP addresses (e.g., --host=0.0.0.0)
# API requests may fail with IP-based URLs due to CORS/security restrictions

# Optional: Watch logs
php artisan pail
```

Access:

Configuration
-------------

[](#configuration)

### 🎯 Creem API Keys - Web Interface (No .env editing!)

[](#-creem-api-keys---web-interface-no-env-editing)

**The easiest way to get started:**

1. Start the application (any method above)
2. Visit `/`
3. **You'll see a configuration form at the top of the page**
4. Get your API credentials from [Creem.io Dashboard](https://www.creem.io/dashboard/developers):
    - **API Key** - Copy from Settings → Developers
    - **Webhook Secret** - Copy from Settings → Webhooks
5. **Enter credentials in the web form** and click "Save Configuration"
6. Start testing immediately! 🎉

**Important Notes:**

- ✅ API keys are stored in session (no database pollution)
- ✅ Demo uses test mode (`test_mode=true`)canvas - use **test API keys**, not production keys
- ✅ Optional: Configure additional profiles (Profile A, Profile B) for multi-account testing
- ✅ Changes take effect immediately - no server restart needed

### Alternative: Pre-fill via .env (Optional)

[](#alternative-pre-fill-via-env-optional)

You can pre-populate the web form by adding to `.env` (form values override these):

```
# Creem API Configuration (optional - web form is recommended)
CREEM_API_KEY=your_test_api_key
CREEM_WEBHOOK_SECRET=your_webhook_secret

# Optional: Additional test profiles
CREEM_PROFILE_A_KEY=another_test_key
CREEM_PROFILE_A_SECRET=another_secret
```

### 🔌 Webhook Configuration (Local Development)

[](#-webhook-configuration-local-development)

To receive real-time webhook events from Creem.io on your local machine, you need a public URL. Choose one:

#### Option 1: Cloudflare Tunnel (Recommended - Auto-configured with Docker)

[](#option-1-cloudflare-tunnel-recommended---auto-configured-with-docker)

**When using Docker Compose, Cloudflare Tunnel service is already included!**

##### Step 1: Get Cloudflare Tunnel Credentials

[](#step-1-get-cloudflare-tunnel-credentials)

1. Go to [Cloudflare Zero Trust Dashboard](https://one.dash.cloudflare.com/)
2. Navigate to **Networks → Tunnels** (or **Access → Tunnels**)
3. Click **Create a tunnel**
4. Choose tunnel type:
    - **Named tunnel** (recommended for production) - Persistent, custom domain
    - **Quick tunnel** (for testing) - Temporary \*.trycloudflare.com domain
5. Follow the setup wizard:
    - Give your tunnel a name (e.g., "creem-demo-local")
    - On the installation page, select **Docker** as connector
6. **Copy the tunnel token** from the docker run command: ```
    # Example command shown by Cloudflare:
    docker run cloudflare/cloudflared:latest tunnel --no-autoupdate run --token eyJhIjoiXXX...

    # Copy this part: eyJhIjoiXXX... (your token)
    ```
7. Configure tunnel route:
    - **Public hostname**: Choose subdomain (e.g., `creem-demo.yourdomain.com`) or use \*.trycloudflare.com
    - **Service type**: HTTP
    - **URL**: `laravel.test:80` (this matches Docker service name)
8. Save your **Tunnel Domain** (e.g., `creem-demo.yourdomain.com`)

##### Step 2: Add to `.env`

[](#step-2-add-to-env)

```
CLOUDFLARED_TUNNEL_TOKEN=eyJhIjoiXXXyourTokenHereXXX
CLOUDFLARED_TUNNEL_DOMAIN=creem-demo.yourdomain.com
```

##### Step 3: Restart Docker

[](#step-3-restart-docker)

```
docker-compose down
docker-compose up -d

# Check tunnel status
docker-compose logs cloudflared
```

You should see: `"Connection established"` or `"Registered tunnel connection"`

##### Step 4: Configure Webhook in Creem.io

[](#step-4-configure-webhook-in-creemio)

1. Go to [Creem.io Webhook Settings](https://www.creem.io/dashboard/webhooks)
2. Set webhook URL: ```
    https://creem-demo.yourdomain.com/creem/webhook

    ```
3. Save and test webhook delivery

#### Option 2: ngrok (For `php artisan serve`)

[](#option-2-ngrok-for-php-artisan-serve)

If not using Docker, use ngrok for quick public tunneling:

1. **Install ngrok:**

    ```
    # Download from https://ngrok.com/download
    # Or via package manager:
    brew install ngrok/ngrok/ngrok  # macOS
    snap install ngrok              # Linux
    choco install ngrok             # Windows
    ```
2. **Start your Laravel app:**

    ```
    php artisan serve
    ```
3. **In another terminal, start ngrok:**

    ```
    ngrok http 8000
    ```
4. **Copy the forwarding URL** from ngrok output:

    ```
    Forwarding  https://abc123.ngrok.io -> http://localhost:8000

    ```
5. **Configure webhook in Creem.io:**

    - Webhook URL: `https://abc123.ngrok.io/creem/webhook`

**Note:** Free ngrok URLs change on each restart. For persistent URLs, upgrade to ngrok paid plan.

### Database Configuration

[](#database-configuration)

Default: SQLite (`database/database.sqlite`) - created automatically by `composer run setup`

For MySQL/PostgreSQL, update `.env`:

```
DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=creem_demo
DB_USERNAME=root
DB_PASSWORD=
```

Then run migrations:

```
php artisan migrate
# Or with Docker:
docker-compose exec laravel.test php artisan migrate
```

Development Workflow
--------------------

[](#development-workflow-1)

### Method 1: Using Docker Compose (Production-like Environment)

[](#method-1-using-docker-compose-production-like-environment)

Docker Compose provides a complete environment with Octane, Traefik, and optional Cloudflare Tunnel:

```
# Start all services
docker-compose up -d

# View logs
docker-compose logs -f

# Run artisan commands
docker-compose exec laravel.test php artisan migrate
docker-compose exec laravel.test php artisan tinker

# Stop services
docker-compose down
```

**Services included:**

- ✅ **Laravel Octane (Swoole)** - High-performance PHP server
- ✅ **Traefik** - Reverse proxy and load balancer
- ✅ **Cloudflare Tunnel** - Secure public access (if configured in .env)

**Access:**

- Local:  (via Traefik)
- Public:  (if Cloudflare Tunnel configured)

**When to use Docker:**

- ✅ Production-like environment testing
- ✅ Need webhook support without ngrok
- ✅ Testing with Octane performance
- ✅ Deploying to server

### Method 2: Using PHP Artisan Serve (Traditional Development)

[](#method-2-using-php-artisan-serve-traditional-development)

Standard Laravel development server - simple and fast for local development:

```
# Start development server
php artisan serve

# In another terminal: Watch and build assets with HMR
npm run dev

# Optional: Run queue worker (if testing background jobs)
php artisan queue:work

# Optional: Watch logs in real-time
php artisan pail
```

**Or use the combined dev command (runs all services in parallel):**

```
composer run dev
```

This starts:

- Laravel development server (port 8000)
- Queue worker
- Log viewer (Laravel Pail)
- Vite dev server with Hot Module Replacement

**Access:**

- Local:

**When to use artisan serve:**

- ✅ Quick local development
- ✅ Simple debugging
- ✅ Frontend development with HMR
- ✅ Don't need webhooks (or okay with ngrok)

### Webhook Support Summary

[](#webhook-support-summary)

MethodWebhook SolutionPublic URLSetup Complexity**Docker**Cloudflare Tunnel (built-in)✅ Persistent custom domainMedium (one-time setup)**artisan serve**ngrok⚠️ Temporary URL (changes each restart)Easy (install + run)**Recommendation:** Use Docker if you need reliable webhook testing. Use artisan serve for quick UI/feature development.

Architecture
------------

[](#architecture)

### Module Structure

[](#module-structure)

This demo uses [nwidart/laravel-modules](https://github.com/nwidart/laravel-modules) for clean, modular architecture:

```
Modules/
└── CreemDemo/
    ├── app/
    │   ├── Http/Controllers/     # Route controllers
    │   ├── Livewire/             # Livewire v4 components
    │   └── Models/               # Domain models
    ├── config/
    │   └── config.php            # Module configuration
    ├── database/
    │   ├── migrations/           # Database migrations
    │   └── seeders/              # Test data seeders
    ├── resources/
    │   ├── views/                # Blade templates
    │   └── assets/               # CSS/JS assets
    ├── routes/
    │   ├── web.php               # Web routes
    │   └── api.php               # API routes (if needed)
    ├── tests/                    # Module tests
    └── composer.json             # Module dependencies

```

### Routes

[](#routes)

Auto-registered after installation:

MethodURIDescriptionGET`/creem-demo`Main dashboard with config formGET`/creem-demo/success`Payment success pagePOST`/creem/webhook`Webhook endpoint for Creem.io### Features Demonstrated

[](#features-demonstrated)

- ✅ **Zero-config Setup** - Configure via web UI, no .env editing
- ✅ **Product Management** - Create/manage products & subscriptions
- ✅ **Checkout Flows** - Complete payment integration with randomized test data
- ✅ **Subscription Management** - Cancel, pause, resume subscriptions
- ✅ **Webhook Monitoring** - Real-time event tracking and visualization
- ✅ **Dashboard & Statistics** - Visual overview of payments and activity
- ✅ **Multi-profile Support** - Test with multiple API key sets simultaneously
- ✅ **Session-based Storage** - Clean testing without database pollution
- ✅ **Modular Code** - Easy to extract and reuse in your own projects

Testing
-------

[](#testing)

Run the included test suite:

```
# Run all tests
composer run test

# Or directly with PHPUnit
vendor/bin/phpunit

# With coverage (if xdebug enabled)
vendor/bin/phpunit --coverage-html coverage
```

Troubleshooting
---------------

[](#troubleshooting)

### Composer create-project fails

[](#composer-create-project-fails)

**Issue:** Package not found on Packagist

**Solution:** If not yet published to Packagist, clone manually:

```
git clone https://github.com/romansh/laravel-creem-demo.git
cd laravel-creem-demo
composer run setup
```

### Module Not Found

[](#module-not-found)

**Issue:** `Module [CreemDemo] not found`

**Solution:**

```
composer dump-autoload
php artisan module:list
php artisan module:discover
```

### Livewire Components Not Working

[](#livewire-components-not-working)

**Issue:** Livewire components not rendering or updating

**Solution:**

```
php artisan livewire:discover
php artisan view:clear
php artisan config:clear
php artisan optimize:clear
```

### Cloudflare Tunnel Not Connecting (Docker)

[](#cloudflare-tunnel-not-connecting-docker)

**Issue:** Tunnel shows as disconnected in dashboard

**Solutions:**

1. **Verify token is correct:**

    ```
    # Check .env file
    cat .env | grep CLOUDFLARED_TUNNEL_TOKEN
    ```
2. **Check tunnel status:**

    ```
    docker-compose logs cloudflared
    ```

    Look for: `"Connection established"` or `"Registered tunnel connection"`
3. **Verify tunnel configuration in Cloudflare dashboard:**

    - Service type: HTTP
    - URL: `laravel.test:80` (or `http://laravel.test:80`)
    - Domain matches `CLOUDFLARED_TUNNEL_DOMAIN` in .env
4. **Restart tunnel service:**

    ```
    docker-compose restart cloudflared
    docker-compose logs -f cloudflared
    ```

### Webhooks Not Received

[](#webhooks-not-received)

**Issue:** Creem.io webhooks not triggering events in the app

**Checklist:**

1. **Verify webhook URL in Creem.io:**

    - Docker: `https://your-tunnel-domain.com/creem/webhook`
    - Artisan serve + ngrok: `https://abc123.ngrok.io/creem/webhook`
2. **Test tunnel/ngrok is working:**

    ```
    # Docker: Check cloudflared logs
    docker-compose logs cloudflared

    # ngrok: Check status
    curl http://localhost:4040/api/tunnels
    # Or visit: http://localhost:4040
    ```
3. **Test webhook endpoint manually:**

    ```
    # Docker
    curl -X POST https://your-tunnel-domain.com/creem/webhook \
      -H "Content-Type: application/json" \
      -d '{"event": "test", "data": {}}'

    # Local
    curl -X POST http://localhost:8000/creem/webhook \
      -H "Content-Type: application/json" \
      -d '{"event": "test", "data": {}}'
    ```
4. **Check Laravel logs:**

    ```
    # Docker
    docker-compose logs -f laravel.test

    # Local
    tail -f storage/logs/laravel.log
    # Or
    php artisan pail
    ```

### API Errors / Invalid Keys

[](#api-errors--invalid-keys)

**Issue:** API calls return 401/403 errors

**Solutions:**

1. **Verify using test mode keys:**

    - Demo app uses `test_mode=true`
    - Production API keys will NOT work
    - Get test keys from [Creem.io Dashboard](https://www.creem.io/dashboard/developers)
2. **Check API key is saved:**

    - Clear browser cache and reload `/creem-demo`
    - Re-enter API credentials in web form
    - Check browser dev tools → Application → Session Storage
3. **Test API connection:**

    ```
    # Via artisan tinker
    php artisan tinker
    >>> use Romansh\LaravelCreem\Facades\Creem;
    >>> Creem::products()->all();
    ```

### API/CORS Errors with Custom Host

[](#apicors-errors-with-custom-host)

**Issue:** API requests fail when using `php artisan serve --host=0.0.0.0` or IP addresses

**Solution:**Always use `localhost` for local development:

```
# ✅ Correct
php artisan serve
# Access: http://localhost:8000

# ❌ Avoid
php artisan serve --host=0.0.0.0
php artisan serve --host=192.168.1.100
```

**Reason:** API providers may reject requests from IP-based URLs due to CORS policies and security restrictions. Use `localhost` to ensure proper API communication.

### Docker Build Issues

[](#docker-build-issues)

**Issue:** Docker images fail to build

**Solution:**

```
# Clean rebuild
docker-compose down -v
docker-compose build --no-cache
docker-compose up -d
```

### Permission Errors (Linux/macOS)

[](#permission-errors-linuxmacos)

**Issue:** Permission denied errors on storage/ or bootstrap/cache/

**Solution:**

```
# Fix permissions
chmod -R 775 storage bootstrap/cache
chown -R $USER:www-data storage bootstrap/cache

# Or with Docker
docker-compose exec laravel.test chmod -R 775 storage bootstrap/cache
```

What's Next?
------------

[](#whats-next)

After getting the demo running:

1. **Explore the code** - Check `Modules/CreemDemo/` for implementation examples
2. **Test workflows** - Try creating products, checkouts, and subscriptions
3. **Monitor webhooks** - Watch real-time events in the dashboard
4. **Integrate into your app** - Extract and adapt code for your project
5. **Read the docs** - Learn more about the main package

Documentation & Links
-------------------------

[](#documentation--links)

- 📦 [Laravel Creem Package](https://github.com/romansh/laravel-creem) - Main package repository
- 📚 [Creem.io API Docs](https://docs.creem.io) - Official API documentation
- 🧩 [Laravel Modules](https://nwidart.com/laravel-modules) - Modular architecture docs
- 🔥 [Livewire](https://livewire.laravel.com) - Reactive components
- 🌐 [Cloudflare Tunnels](https://developers.cloudflare.com/cloudflare-one/connections/connect-apps/) - Tunnel documentation

Support & Contributing
--------------------------

[](#support--contributing)

- 🐛 **Report issues:** [GitHub Issues](https://github.com/romansh/laravel-creem-demo/issues)
- 💬 **Questions:**
- 🤝 **Contributions welcome** via Pull Requests
- ⭐ **Star the repo** if you find it helpful!

License
-------

[](#license)

MIT License. See [LICENSE](LICENSE) for details.

Credits
-------

[](#credits)

Created by [Roman Shalabanov](https://github.com/romansh)

**Powered by:**

- [Laravel 12](https://laravel.com) - PHP framework
- [Livewire 4](https://livewire.laravel.com) - Reactive components
- [Tailwind CSS 4](https://tailwindcss.com) - Utility-first CSS
- [Laravel Octane](https://laravel.com/docs/octane) - High-performance server
- [Creem.io](https://creem.io) - Payment provider

###  Health Score

40

—

FairBetter than 88% of packages

Maintenance85

Actively maintained with recent releases

Popularity4

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity54

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~0 days

Total

13

Last Release

76d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/b453f266005966bf6243a4834c93882f8c2de3e66194f8d086dc7484db29e7cb?d=identicon)[romansh](/maintainers/romansh)

---

Top Contributors

[![romansh](https://avatars.githubusercontent.com/u/10420314?v=4)](https://github.com/romansh "romansh (25 commits)")

---

Tags

laravelpaymentsubscriptiondemosaascreem

###  Code Quality

TestsPHPUnit

Code StyleLaravel Pint

### Embed Badge

![Health badge](/badges/romansh-laravel-creem-demo/health.svg)

```
[![Health](https://phpackages.com/badges/romansh-laravel-creem-demo/health.svg)](https://phpackages.com/packages/romansh-laravel-creem-demo)
```

###  Alternatives

[helori/laravel-saas

Software as a Service scaffholding for Laravel based on Vue 3, Tailwindcss and Stripe. Inspired by Laravel Jetstream and Spark.

121.3k](/packages/helori-laravel-saas)[tsaiyihua/laravel-linepay

linepay library for laravel

102.9k](/packages/tsaiyihua-laravel-linepay)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)