PHPackages                             cartxis/cartxis - 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. [Framework](/categories/framework)
4. /
5. cartxis/cartxis

ActiveProject[Framework](/categories/framework)

cartxis/cartxis
===============

Open source eCommerce for Laravel, Inertia.js and Vue 3.

1.0.8(1mo ago)214↓50%1MITVuePHP ^8.2CI passing

Since Dec 19Pushed 1mo ago1 watchersCompare

[ Source](https://github.com/wontonee/cartxis)[ Packagist](https://packagist.org/packages/cartxis/cartxis)[ Docs](https://github.com/cartxis/cartxis)[ RSS](/packages/cartxis-cartxis/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (10)Dependencies (46)Versions (11)Used By (0)

Cartxis — Open Source Laravel eCommerce Platform
================================================

[](#cartxis--open-source-laravel-ecommerce-platform)

A modern, extensible eCommerce platform built with **Laravel 12**, **Inertia.js**, **Vue 3.5**, and **TypeScript**. Cartxis provides a complete solution for building online stores with a powerful admin panel, flexible theme system, and modular architecture.

[![License](https://camo.githubusercontent.com/7013272bd27ece47364536a221edb554cd69683b68a46fc0ee96881174c4214c/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d626c75652e737667)](https://camo.githubusercontent.com/7013272bd27ece47364536a221edb554cd69683b68a46fc0ee96881174c4214c/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d626c75652e737667)[![PHP](https://camo.githubusercontent.com/3f99b197569aa2dcfbefff17ecc68d74098e7f929d8b52dc40f3a898f740eae1/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048502d382e322532422d3737374242343f6c6f676f3d706870)](https://camo.githubusercontent.com/3f99b197569aa2dcfbefff17ecc68d74098e7f929d8b52dc40f3a898f740eae1/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048502d382e322532422d3737374242343f6c6f676f3d706870)[![Laravel](https://camo.githubusercontent.com/24831afda9c8e8876d7702e2ce827d05183c1de75f3d04d96819101bf09fe4b5/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c61726176656c2d31322d4646324432303f6c6f676f3d6c61726176656c)](https://camo.githubusercontent.com/24831afda9c8e8876d7702e2ce827d05183c1de75f3d04d96819101bf09fe4b5/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c61726176656c2d31322d4646324432303f6c6f676f3d6c61726176656c)[![Vue.js](https://camo.githubusercontent.com/db96db2ad0179185a5316b9f4bf37f3e68d5976f210c005845d71a3990ea2a74/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5675652e6a732d332e352d3446433038443f6c6f676f3d7675652e6a73)](https://camo.githubusercontent.com/db96db2ad0179185a5316b9f4bf37f3e68d5976f210c005845d71a3990ea2a74/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5675652e6a732d332e352d3446433038443f6c6f676f3d7675652e6a73)[![TypeScript](https://camo.githubusercontent.com/8217f4b5d07c0d95c53dbc4b9a61df4acfe8b8b1a7cd67aee72e2e7cac83b51c/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f547970655363726970742d352e322532422d3331373843363f6c6f676f3d74797065736372697074)](https://camo.githubusercontent.com/8217f4b5d07c0d95c53dbc4b9a61df4acfe8b8b1a7cd67aee72e2e7cac83b51c/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f547970655363726970742d352e322532422d3331373843363f6c6f676f3d74797065736372697074)[![Tailwind CSS](https://camo.githubusercontent.com/c9620e4b945de89ce886b2af6dc6390123cb237cadbcf8b29aa2ffe02519996a/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5461696c77696e642d342e312d3338423241433f6c6f676f3d7461696c77696e642d637373)](https://camo.githubusercontent.com/c9620e4b945de89ce886b2af6dc6390123cb237cadbcf8b29aa2ffe02519996a/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5461696c77696e642d342e312d3338423241433f6c6f676f3d7461696c77696e642d637373)

---

✨ Features
----------

[](#-features)

### 🛍️ Shop Features

[](#️-shop-features)

- **Product Management** — Complete product catalog with variants, attributes, and inventory tracking
- **Shopping Cart** — Real-time cart with session persistence and guest checkout support
- **Multi-Payment Gateway** — Stripe, Razorpay, PayPal, PhonePe, and PayUMoney support
- **Order Management** — Comprehensive order tracking and lifecycle management
- **Customer Accounts** — Registration, authentication, profile, and order history
- **Theme System** — Flexible theme architecture with easy customization

### 🎛️ Admin Features

[](#️-admin-features)

- **Dashboard** — Analytics and key insights at a glance
- **Product Management** — Products, categories, brands, attributes, and variants
- **Order Processing** — Complete order lifecycle with status management
- **Customer Management** — Profiles, addresses, and notes
- **Settings** — Store configuration, payment methods, shipping rates, and tax rules
- **AI Agents** — Create and manage custom AI agents for commerce workflows
- **Email Templates** — Customizable transactional email templates
- **CMS & UI Editor** — Visual drag-and-drop page builder with 32+ block types, global regions, reusable saved blocks, and responsive live preview
- **Reports** — Sales, customer, and inventory reporting
- **Maintenance Mode** — Built-in maintenance banner and system controls

### 💳 Payment Gateways

[](#-payment-gateways)

GatewayStatusStripe✅ SupportedRazorpay✅ SupportedPayPal✅ SupportedPhonePe✅ SupportedPayUMoney✅ Supported### 📱 Mobile App

[](#-mobile-app)

The **Cartxis Mobile App** is live and open source! Download it or explore the source:

PlatformLinkAndroid (Google Play)[Download on Google Play](https://play.google.com/store/apps/details?id=com.cartxis.app)Source Code[github.com/wontonee/cartxis-mobile](https://github.com/wontonee/cartxis-mobile)The app is powered by a full **REST API** and supports:

- Authentication and customer accounts
- Product catalog, search, and categories
- Cart, checkout, and order management
- Wishlist and reviews
- Store sync and banners

#### 🗑️ Google Play / App Store — Account Deletion URL

[](#️-google-play--app-store--account-deletion-url)

Google Play Store (and Apple App Store) require apps that support account creation to provide a **publicly accessible account deletion page** as part of their Data Safety policy.

Cartxis includes this page out of the box. When submitting your app, use the following URL pattern:

```
https://yourdomain.com/account-deletion

```

**Example:** `https://shop.example.com/account-deletion`

This page:

- Is publicly accessible (no login required)
- Explains step-by-step how users can delete their account from within the app
- Lists what data is permanently deleted (profile, addresses, wishlist, cart, tokens)
- Discloses what is retained (anonymized order records for accounting, 7-year minimum)
- Provides an email contact (`dev@wontonee.com`) for users who cannot log in

In the **Google Play Console → App content → Data safety**, paste this URL in the **"Delete account URL"** field.

### 🔧 Technical Features

[](#-technical-features)

- **Modular Architecture** — Package-based structure for easy extension
- **MySQL 8.0+** — Optimised relational database layer
- **Modern Frontend** — Vue 3 with TypeScript and Tailwind CSS
- **Inertia.js** — SPA-like experience without API complexity
- **Two-Factor Authentication** — Enhanced security with 2FA
- **Email Verification** — Built-in email verification workflow
- **Fortify Integration** — Laravel Fortify for authentication

---

📋 Requirements
--------------

[](#-requirements)

RequirementVersionPHP8.2 or higherComposer2.xNode.js18.x or higherNPM9.x or higherMySQL8.0 or higher**Required PHP extensions:** OpenSSL, PDO, Mbstring, Tokenizer, XML, Ctype, JSON, BCMath

---

🚀 Quick Install via Composer
----------------------------

[](#-quick-install-via-composer)

The fastest way to get Cartxis running:

```
composer create-project cartxis/cartxis my-store
cd my-store
php artisan cartxis:install
```

The interactive installer will guide you through:

- Database configuration (with live connection test)
- Admin account creation (name, email, and password)
- Migrations and seeders
- Building frontend assets automatically

Once complete, the installer displays your admin panel URL, email, and password.

> **If you see blank pages or asset errors after the setup wizard**, the frontend build may not have completed yet. Fix it by running:
>
> ```
> npm run build
> # or if you use Yarn:
> yarn build
> ```

---

🛠️ Installation (Development / Git Clone)
-----------------------------------------

[](#️-installation-development--git-clone)

Use this method if you are contributing to or developing on Cartxis.

### 1. Clone the Repository

[](#1-clone-the-repository)

```
git clone https://github.com/cartxis/cartxis.git
cd cartxis
```

### 2. Install Dependencies

[](#2-install-dependencies)

```
composer install
npm install
```

### 3. Environment Setup

[](#3-environment-setup)

```
cp .env.example .env
php artisan key:generate
```

### 4. Database Setup

[](#4-database-setup)

Create a MySQL database:

```
CREATE DATABASE cartxis CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
```

Update your `.env` file:

```
DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=cartxis
DB_USERNAME=your_username
DB_PASSWORD=your_password
```

### 5. Run the Installer

[](#5-run-the-installer)

```
php artisan cartxis:install
```

Or manually run migrations and seed:

```
php artisan migrate --seed
```

> **Note:** When seeding manually, provide admin credentials via environment variables:
>
> ```
> CARTXIS_ADMIN_NAME="Admin" \
> CARTXIS_ADMIN_EMAIL="you@example.com" \
> CARTXIS_ADMIN_PASSWORD="yourpassword" \
> php artisan db:seed
> ```

### 6. Build Frontend Assets

[](#6-build-frontend-assets)

Development (watch mode):

```
npm run dev
```

Production build:

```
npm run build
```

### 7. Start the Server

[](#7-start-the-server)

```
php artisan serve
```

Visit `http://localhost:8000` for the storefront and `http://localhost:8000/admin/login` for the admin panel.

---

⚙️ Configuration
----------------

[](#️-configuration)

### Email Configuration

[](#email-configuration)

Email (SMTP) settings are configured directly in the **Admin Panel** — no `.env` changes required.

1. Log in to **Admin → Settings → Email Settings**
2. Enter your SMTP host, port, username, password, and encryption type
3. Set your "From" name and address
4. Send a test email to verify the configuration

### Payment Gateway Setup

[](#payment-gateway-setup)

All payment gateway credentials are configured directly in the **Admin Panel** — no `.env` changes required.

1. Log in to **Admin → Settings → Payment Methods**
2. Select the gateway you want to enable (Stripe, Razorpay, PayPal, PhonePe, or PayUMoney)
3. Enter your API keys and credentials in the provided fields
4. Toggle the gateway to **Active**

Your credentials are stored securely in the database and managed entirely through the admin interface.

### Store Settings

[](#store-settings)

Configure your store through the admin panel:

1. **Settings → Store Configuration** — name, currency, timezone
2. **Settings → Payment Methods** — enable/disable gateways
3. **Settings → Shipping** — shipping rates and zones
4. **Settings → Tax Rules** — tax configuration

---

📦 Package Structure
-------------------

[](#-package-structure)

```
packages/Cartxis/
├── Admin/          # Admin panel — controllers, views, assets
├── Cart/           # Shopping cart management
├── CMS/            # Content pages and blocks
├── Core/           # Core utilities, installer command, service providers
├── UIEditor/       # Visual drag-and-drop page builder
├── Customer/       # Customer profiles and authentication
├── Marketing/      # Promotions, coupons, and tools
├── PayPal/         # PayPal payment integration
├── PayUMoney/      # PayUMoney payment integration
├── PhonePe/        # PhonePe payment integration (SDK bundled)
├── Product/        # Product catalog, variants, attributes
├── Razorpay/       # Razorpay payment integration
├── Reports/        # Sales, inventory, and customer reports
├── Sales/          # Orders and sales management
├── Settings/       # System and store settings
├── Setup/          # First-run setup wizard
├── Shop/           # Frontend storefront
├── Stripe/         # Stripe payment integration
└── System/         # System health and utilities

```

---

🖌️ Visual Page Builder (UI Editor)
----------------------------------

[](#️-visual-page-builder-ui-editor)

Cartxis ships with a powerful visual drag-and-drop page builder that lets you design storefront pages and reusable regions without writing code.

### Pages

[](#pages)

Manage CMS pages and your store's homepage through a full visual editing workflow:

- **Create** — Start from a blank canvas or insert saved block templates
- **Edit** — Drag and drop sections, columns, and blocks to build layouts
- **Draft / Publish** — Changes stay in draft until explicitly published; auto-saves every 3 seconds
- **Unpublish** — Revert any page to draft, removing it from the live storefront instantly
- **Live Preview** — Preview pages at Desktop (full width), Tablet (768 px), and Mobile (390 px) breakpoints inside a real theme iframe

### Layout Hierarchy

[](#layout-hierarchy)

Layouts are a three-level tree stored as JSON:

```
Page → Sections → Columns → Blocks

```

- **Sections** — Full-width rows with configurable background colour, padding, and full-width toggle
- **Columns** — Responsive 12-column grid; presets: 1, 2, 3, 4 columns · 2/3+1/3 · 1/3+2/3
- **Blocks** — Content units dropped into columns; each block type has its own settings panel

### 32 Built-in Block Types

[](#32-built-in-block-types)

CategoryBlock TypesLayout`spacer`, `divider`Text & Content`heading`, `text`, `image`, `button`, `video`, `form`, `table`, `card`, `html`, `code`, `accordion`, `tabs`, `icon_box`, `counter`, `social_links`, `author_card`, `share_buttons`Commerce`hero`, `slider`, `products_grid`, `categories_grid`, `newsletter`, `pricing`, `testimonials`Blog`post_featured`, `post_list`, `post_carousel`, `blog_posts_grid`Regions`global_region`### Global Regions

[](#global-regions)

Create reusable layout areas (header, footer, sidebar, banner, section) that are embedded into any page via the `global_region` block. Updating a global region propagates instantly to every page that references it.

**Default seeded regions:** Main Header and Main Footer.

### Saved (Reusable) Blocks

[](#saved-reusable-blocks)

Save any section or individual block as a reusable template. Saved blocks appear in the block palette under the **Saved** tab and can be inserted into any page — ideal for promotional banners, CTA strips, or complex product grids you want to maintain consistently.

### Theme Integration

[](#theme-integration)

The `UIBlockRenderer` Vue component is shared across all themes. When a published layout exists for a page, it is rendered visually via the block renderer; if no published layout exists the platform falls back gracefully to raw HTML, preserving backward compatibility.

---

🎨 Theme Development
-------------------

[](#-theme-development)

The default theme is located in `themes/cartxis-default/`.

### Creating a Custom Theme

[](#creating-a-custom-theme)

```
cp -r themes/cartxis-default themes/your-theme-name
```

Update `config/theme.php`:

```
'active' => 'your-theme-name',
```

Customise:

- **Pages**: `themes/your-theme-name/resources/views/pages/`
- **Components**: `themes/your-theme-name/resources/views/components/`
- **Layouts**: `themes/your-theme-name/resources/views/layouts/`

---

🧪 Running Tests
---------------

[](#-running-tests)

```
# Run all tests
./vendor/bin/pest

# Feature tests only
./vendor/bin/pest tests/Feature

# With coverage
./vendor/bin/pest --coverage
```

---

🚢 Deployment
------------

[](#-deployment)

### Production Checklist

[](#production-checklist)

1. Set `APP_ENV=production` and `APP_DEBUG=false` in `.env`
2. `composer install --optimize-autoloader --no-dev`
3. `npm run build`
4. `php artisan config:cache`
5. `php artisan route:cache`
6. `php artisan view:cache`
7. Set file permissions: ```
    chmod -R 755 storage bootstrap/cache
    chown -R www-data:www-data storage bootstrap/cache
    ```
8. Configure your web server (Nginx/Apache) with document root pointing to `public/`
9. Set up an SSL certificate
10. Configure queue workers and the task scheduler

### Queue Workers

[](#queue-workers)

```
php artisan queue:work
```

Use **Supervisor** in production to keep queue workers running.

### Scheduler

[](#scheduler)

Add to crontab:

```
* * * * * cd /path-to-cartxis && php artisan schedule:run >> /dev/null 2>&1
```

---

🛠️ Developer Notes
------------------

[](#️-developer-notes)

### Code Style

[](#code-style)

- **PHP**: PSR-12 standard — `./vendor/bin/phpcs`
- **TypeScript/JavaScript**: ESLint — `npm run lint`

### Clearing Caches

[](#clearing-caches)

```
php artisan optimize:clear
```

### Creating an Extension

[](#creating-an-extension)

See [EXTENSION-DEVELOPMENT-GUIDE.md](specificationandtask/EXTENSION-DEVELOPMENT-GUIDE.md) for the full guide on building Cartxis extension packages.

---

🤝 Contributing
--------------

[](#-contributing)

Contributions are welcome!

1. Fork the repository
2. Create a feature branch: `git checkout -b feature/amazing-feature`
3. Commit your changes: `git commit -m 'Add amazing feature'`
4. Push: `git push origin feature/amazing-feature`
5. Open a Pull Request

Please follow PSR-12 for PHP, write tests for new features, and update documentation as needed.

---

📞 Support
---------

[](#-support)

ChannelLinkWebsiteEmailIssues[GitHub Issues](https://github.com/cartxis/cartxis/issues)Discussions[GitHub Discussions](https://github.com/cartxis/cartxis/discussions)For billing, licensing, or partnership enquiries, contact us at ****.

---

🗺️ Roadmap
----------

[](#️-roadmap)

### ✅ Completed

[](#-completed)

- Product management (variants, attributes, inventory)
- Shopping cart with guest checkout
- Order management — invoices, shipments, credit memos, transactions
- Customer accounts and profiles
- Wishlist
- Reviews
- Newsletter
- Multi-payment gateway (Stripe, Razorpay, PayPal, PhonePe, PayUMoney)
- CMS — pages, content blocks, and visual page builder (UI Editor with 32+ block types, global regions, saved blocks, live preview)
- Media management
- Email templates (customizable transactional emails)
- Reports — sales, customer, and inventory
- Flexible theme system
- Maintenance mode
- Extensions system
- Backup and cache management
- Tax management (classes, rates, rules, zones)
- Shipping methods and delivery settings
- Shiprocket integration
- AI settings and product AI
- Demo data (Electronics, Fashion, Kirana, Retail)
- Data migration (WooCommerce, Bagisto)
- REST API for mobile app
- Mobile app — Android ([Google Play](https://play.google.com/store/apps/details?id=com.cartxis.app)) · [Open source](https://github.com/wontonee/cartxis-mobile)
- Interactive CLI installer (`php artisan cartxis:install`)
- Composer create-project support

### 🔜 Upcoming

[](#-upcoming)

- iOS mobile app
- Two-factor authentication (2FA)
- Multi-vendor marketplace
- Subscription products
- Advanced SEO tools
- Multi-language support (i18n)
- Advanced analytics dashboard
- Integration marketplace

---

📝 License
---------

[](#-license)

Cartxis is open-source software licensed under the [MIT License](LICENSE).

---

Made with ❤️ by the [Wontonee Team](https://www.cartxis.com)

###  Health Score

43

—

FairBetter than 91% of packages

Maintenance90

Actively maintained with recent releases

Popularity11

Limited adoption so far

Community10

Small or concentrated contributor base

Maturity53

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 98.5% 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 ~11 days

Total

9

Last Release

52d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/990964f490e33904da3bcc7f878293090d96ce9f244b4251f3b0b84cf8fc2860?d=identicon)[wontone18](/maintainers/wontone18)

---

Top Contributors

[![wontone18](https://avatars.githubusercontent.com/u/10259774?v=4)](https://github.com/wontone18 "wontone18 (134 commits)")[![Copilot](https://avatars.githubusercontent.com/in/1143301?v=4)](https://github.com/Copilot "Copilot (2 commits)")

---

Tags

ai-commerceecommerceecommerce-platformecommerce-shopping-solutionecommerce-websiteheadless-commercelaravellaravel-frameworksaaslaravelinertiaecommercevuecartxis

###  Code Quality

TestsPest

Code StyleLaravel Pint

### Embed Badge

![Health badge](/badges/cartxis-cartxis/health.svg)

```
[![Health](https://phpackages.com/badges/cartxis-cartxis/health.svg)](https://phpackages.com/packages/cartxis-cartxis)
```

###  Alternatives

[bagisto/bagisto

Bagisto Laravel E-Commerce

26.2k161.6k7](/packages/bagisto-bagisto)[krayin/laravel-crm

Krayin CRM

22.0k32.8k1](/packages/krayin-laravel-crm)[unopim/unopim

UnoPim Laravel PIM

9.4k1.8k](/packages/unopim-unopim)

PHPackages © 2026

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