04store models
04complete themes
11builder blocks
01free core download
ShopKeeprr gives you the whole shop: a storefront that can be shaped without a separate page builder, an admin that handles the work behind it, and an extension layer for the parts that are specific to your business. It is built on Laravel and runs on your own server, with your database and your customer data under your control.
How to read this page. Everything below is in the free ShopKeeprr 1.1.2 core unless it is explicitly labelled as an optional ShopKeeprr Store extension. Paid plugins, themes and business kits are additions, not requirements. The core is a complete store on its own.
Sell the way your business works
Four store models, one platform
Choose the model that matches how you sell today. You can change it later in Admin → Settings without rebuilding the catalog, rewriting orders or running a migration.
Retail
A standard catalog and checkout for everyday commerce, curated ranges, seasonal drops and direct-to-consumer stores.
B2B wholesale
Trade applications, tier pricing, hidden guest prices, minimum order quantities and a wholesale experience kept separate from retail.
Subscription box
Recurring plans on products, customer subscription management and renewal state, handled in the same back office as one-off orders.
Multi-vendor marketplace
Approved sellers, a seller portal, per-seller commission and automatic split payouts through Stripe Connect or PayPal Payouts.
- Switch store models without a database migration
- One catalog and customer history across models
- Mode-aware checkout and admin behaviour
- B2B, subscription and marketplace features in the free core
The customer-facing shop
Storefront & catalog
A complete, responsive storefront with theme-aware home, shop, product, cart, checkout, account and authentication pages. The front-end build is included, so a store owner does not need Node or a separate build step to run the shop.
- Theme-driven homepage, shop, product, cart, checkout, account and auth pages
- Product catalog with product detail pages and image galleries
- Product variants and variant-level pricing
- Tier prices for wholesale customers
- Inventory tracking with stock movements and last-unit protection
- Categories and category browsing
- Coupons and promotional pricing
- Editable store pages
- Responsive navigation, account menus and mobile layouts
- Theme-aware product cards and featured-product sections
- Cart and checkout with server-side validation
- Customer accounts and order history
- B2B guest-price rules and wholesale approval gates
- Shared pages inherit the active theme's colours and typography
Catalog management
The admin catalog covers products, variants, tier prices, stock, categories, coupons and pages. Inventory movements are recorded as the catalog changes, and checkout re-checks stock so the last unit cannot be sold twice.
No separate page builder required
Visual storefront builder
Admin → Storefront builder replaces the theme homepage with a page assembled from sections. Drag a block from the library onto the live preview, or click it to append it. Reorder sections by dragging on the page or in the Layers panel, click editable text in the preview to change it in place, and use the right panel for images, links, layout, spacing, background and dividers.
Eleven built-in sections
- Hero banner
- Image carousel
- Featured products
- Category tiles
- Promo banner
- Testimonials
- Newsletter
- Text section
- Image section
- Countdown banner
- Reassurance bar
- Drag-and-drop section library
- Layers panel and drag reordering
- Inline editing directly in the preview
- Image, link, layout, spacing, background and divider controls
- Product sections read the live catalog
- Category tiles count visible products
- Every block inherits the active theme tokens and product cards
- Automatic drafts; shoppers see the last published layout
- Desktop, tablet and mobile previews
- One-click publish
- Return to the theme homepage without losing the published layout
- Starter sections for a sensible default page
- Server-side normalisation of every save
- Unknown block types dropped; unsafe links and images rejected
- Text escaped and pages capped at 80 sections / 512 KB
- Modules can register their own blocks
Four complete directions
Themes & templates
ShopKeeprr includes four complete storefront themes. Switch them in Admin → Theme; the curated palette and typography apply instantly, while products, orders, customers and saved template overrides stay untouched.
| Theme | Best for | Palette |
| Editorial | Boutique, typography-led catalogs | Cream, deep teal, amber |
| Marketplace | Dense, search-first high-SKU stores | Navy, amber, yellow CTAs, blue links |
| Auction House | Listings, deals and discovery | White, marketplace blue, yellow/green accents |
| Global Bazaar | Promotion-led discount retail | White, signal red, warm orange |
- Each theme has its own header, footer, homepage and product card
- Responsive navigation and account menus in every theme
- Shared pages inherit the active theme's semantic colour tokens
- Theme metadata, palettes, fonts, copy and preview swatches in config
- Admin activation and validation
- Per-template overrides: custom, then preset, then shared default
- Template editor under Admin → Theme → Templates
- Blade compiled before saving, so syntax errors are rejected
- Template backups written to storage/app/theme-backups
- Reset to default removes an override
- Add another theme by copying a preset and adding a config entry
- Semantic tokens for brand, links, surfaces, lines, prices and sale states
The whole shop, in one place
Admin dashboard & back office
The admin brings orders, customers, catalog, payments, reports and settings together. It is the operating surface for the store, not a thin settings screen.
- Dashboard with revenue, orders, customers and recent activity
- Order, refund and fulfilment management
- Order status history
- Catalog, variants, tier prices and inventory movements
- Categories, coupons and pages
- Customer management
- Wholesale approval management
- Subscription plans and customer subscriptions
- Shipping zones and methods
- Tax rates
- Reports with CSV export
- Store, checkout, payment, mail and theme settings
- Drag-and-drop storefront builder
- Module manager
- Signed one-click updates
- Audit log of admin actions and update runs
- Seller workspace for multi-vendor stores
From payment to fulfilment
Orders, fulfilment & refunds
One queue for paid, pending and fulfilled orders, with the history needed to support the customer after checkout.
- Paid, pending and fulfilled order views
- Order status changes with history
- Fulfilment management
- Refunds started from the admin order screen
- Gateway refund and order totals updated together
- Idempotency token prevents duplicate refunds from a double-click
- Refunds issued in Stripe or PayPal are reconciled back onto the order
- Configurable cancellation window for unpaid orders
- Configurable retention of abandoned unpaid orders on the order screen
- Paid orders are always listed
- A payment that completes after cancellation reopens the order and re-reserves stock
- Order email settings and a test order email
Payments that reconcile
Payments, webhooks & refunds
ShopKeeprr ships with the payment layer most stores need, plus the verification and reconciliation work that keeps the order record trustworthy.
Stripe
Card checkout, webhook signature checks with a five-minute tolerance, and refunds reconciled onto the order.
PayPal
PayPal checkout with webhook verification through PayPal's verification endpoint and refund reconciliation.
Manual invoice
A payment path for stores that invoice customers directly or collect payment outside a card gateway.
Test mode
Sandbox/test toggle for integrating a gateway before live keys are used.
- Stripe and PayPal credentials encrypted at rest
- Webhook endpoints printed in Settings → Payments
- Stripe signature checked against the signing secret
- PayPal webhook verified through PayPal
- Webhook deliveries are idempotent; replays cannot double-charge or double-refund
- Amount and currency matched against the order before it is marked paid
- Refund flow from the admin order screen
- Gateway dashboard refunds reconciled back onto the order
- Payment after abandonment reopens the order and restores stock
- Subscription activation through checkout
- Payment credentials masked in the UI
Wholesale without the spreadsheets
B2B wholesale
Run trade and retail from one store without exposing wholesale prices or rules to retail shoppers.
- Trade applications and approval management
- Tier pricing for approved trade customers
- Hidden guest prices
- Minimum order quantities
- A wholesale experience kept separate from retail
- Wholesale customer accounts
- B2B checkout and guest rules
- Customer history that makes account support easier
- Same admin, catalog and order tools as retail
Repeat business, built in
Subscriptions
Sell recurring products and manage the customer relationship in the same back office as one-off orders.
- Recurring plans on products
- Customer subscription management
- Renewal state
- Subscription activation through checkout
- Admin management of plans and customer subscriptions
- Subscription orders appear alongside other commerce
- Works with the standard order and customer records
A marketplace you operate
Multi-vendor marketplace
Create sellers in Admin → Vendors, link each one to a customer account and connect their payout account. Sellers sign in at /vendor to manage their own catalog, see their orders and request a payout.
- Seller accounts linked to customer accounts
- Seller approval and suspension
- Seller portal at /vendor
- Sellers manage their own catalog
- Sellers see their own orders
- Sellers can request a payout
- Commission as a percentage, a fixed fee per seller order, or both
- Each seller inherits the platform rule or overrides it
- Commission taken from the discounted item subtotal
- Shipping and tax stay with the platform
- Seller products disappear when the account is suspended or unapproved
- Stripe Connect hosted onboarding
- Separate charges and transfers for multi-seller carts
- Automatic transfer reversal when an order is refunded
- PayPal orders collected by the store, then paid through PayPal Payouts after the hold period
- PayPal Payouts approval handled by the store's PayPal app
- Manual payouts available
- All payout methods recorded in the seller ledger
- Seller portal access isolation
Stripe Connect is the recommended path for automatic splits. PayPal cannot split a standard checkout, so PayPal marketplace orders are collected by the store and settled through Payouts; the store's PayPal app must have Payouts approved.
Optional extensions, one connection
Marketplace & ShopKeeprr Store
ShopKeeprr 1.1.2 adds an optional Store-connected marketplace under Admin → Marketplace. Connect a ShopKeeprr Store account to browse free and owned plugins, install them with one click, and keep the ZIP uploader as an offline fallback.
- Store account linking from Admin → Marketplace
- Store account linking from Settings → Store account
- One-time device-code request; approval happens while signed in to the Store
- No Store password or client secret stored in the self-hosted platform
- Store catalog in admin
- Owned-product library
- One-click installs
- Packages downloaded server-side
- SHA-256 checksum verified against the Store release record
- Module archive validation before installation
- Installed disabled until an administrator enables it
- Manual ZIP upload remains as the offline fallback
- Store tokens revocable
- Store tokens encrypted at rest
- Store tokens masked in the UI
- Store tokens scoped to the Store account
- Marketplace scanner 1.1
- Critical execution findings remain blocking
- Lower-risk developer patterns such as console and command shell calls can warn
- 2 MB per-file scan size and 32 MB read limit
- Free and paid extensions from independent makers
Optional by design. The Store is where themes, plugins, components and specialist business kits are distributed. The free core does not require a Store account or a paid extension; the manual module uploader remains available for offline installation.
An extension layer, not a closed checkout
Modules & extensibility
Modules are self-contained packages under modules/{slug} with a module.json manifest. Upload a ZIP in Admin → Plugins, confirm that you trust the author, then enable it.
- Module ZIP upload and installation
- Manifest with namespace, provider and module type
- Explicit trust confirmation before installation
- Enable and disable installed modules
- Module manager in admin
- Modules declare ShopKeeprr and module-API compatibility
- Blocking compatibility warnings before a core update
- Warnings when a module has no compatibility declaration
- Module migrations in database/migrations run automatically
- Modules can register storefront blocks
- Modules can add payment processors and other extensions
- Modules can run their own schedules when enabled
- Themes can change the storefront
- Components plug into the builder
- Business models can be packaged as extensions
- The legacy nexus compatibility key is still accepted
Bundled free modules
| Module | Type | What it adds |
| Product Reviews & Ratings | Plugin · bundled free | Verified reviews, star ratings, photos, helpful votes and moderation |
| Customer Wishlist | Plugin · bundled free | Per-account saved products and a private wishlist page |
| Announcement & Promotion Bars | Plugin · bundled free | Builder blocks for announcement bars and countdown promotions |
Security: a module is trusted, executable code. It is not sandboxed, runs with the same privileges as ShopKeeprr and can read or change your database and files. Only install modules from authors you trust, and take a database backup first.
Change without losing the store
Signed updates & rollback
The core includes signed update tooling, available from Admin → Updates or the command line. Updates can create the backups, verify the package and put the store back if a step fails.
- Compares the installed version with the vendor's signed release manifest
- RSA-SHA256 signature verification
- SHA-256 hash verification
- Byte-size verification
- Release notes in the update flow
- Module compatibility warnings
- Maintenance mode during the update
- Database dump before changes
- Every file that will be replaced is zipped first
- Pending migrations run in a clean PHP process where possible
- Version, required tables and migration state verified after applying
- Caches cleared and the store brought back online
- Automatic rollback of both backups if any step fails
- Manual rollback of the last update
- Update history and status
- Audit log of update runs
- Command-line check, update, status and rollback
- Backup locations and rollback procedure documented in UPDATING.md
The updater is designed for hosts that publish a manifest; the official release host is updates.shopkeeprr.com. The release notes, module compatibility warnings, backup locations and manual rollback procedure are documented in the download.
From ZIP to working shop
Installer & first-run setup
Install with the browser installer or the command line. The browser path is a four-step flow: server check, database, store and owner account, then install.
- Browser installer at /install.php
- Server and PHP extension checks
- MySQL 8+ or SQLite 3 database setup
- Writes .env and generates APP_KEY
- Runs migrations
- Creates the administrator account
- Optional demo catalog seeding
- Installer lock via storage/app/installed.lock
- Command-line installer for hosts without the browser flow
- Documented fallback when proc_open or exec is disabled
- Demo products, customers, orders, subscriptions, coupons and tax
- Random demo customer passwords generated at install time
- Demo credentials printed once and saved outside the web root
- SHOPKEEPRR_DEMO_PASSWORD override for the demo password
- --mode=retail, b2b, subscription or multivendor
- --live, --store-email and --force installer options
- Full installation and FAQ PDF included in the download
Requirements
- PHP 8.3 or newer
- pdo, openssl, mbstring, fileinfo, zip, tokenizer, json, dom and libxml
- MySQL 8+ or SQLite 3
- Apache or Nginx with the document root at public/
- Composer 2 for command-line installation
- Node 20+ only when rebuilding front-end assets
- Outbound HTTPS for signed updates
- Writable storage/app for update backups
- Writable storage/, bootstrap/cache/, database/ (SQLite) and public/uploads/
- HTTPS recommended for accounts and checkout
Operate with your eyes open
Security & data protection
Security is part of the operating model: encrypted credentials, verified payment events, authenticated admin and seller areas, and an explicit trust boundary around extensions.
- Stripe and PayPal credentials encrypted at rest
- Store tokens encrypted at rest, masked and revocable
- Webhook signatures verified before payment state changes
- Idempotent webhook and refund handling
- Amount and currency checked against the order
- Authenticated admin area
- Seller portal access isolation
- CSRF-protected forms and server-side request validation
- Module trust confirmation before executable code is installed
- Module compatibility checks before updates
- Admin action and update audit log
- Configurable secure session cookies in production
- Guidance to protect .env, storage/, database/ and vendor/
- Web root points at public/, not the project root
- Database user limited to the store database
- No .env, local database, logs, tests or credentials in the release archive
- Security reports handled by email without publishing an unpatched issue
Installation tracking & privacy
- Installation tracking is on by default in 1.1.2
- The installer explains what is sent and includes a checked opt-out
- A completed installation registers with the ShopKeeprr Store
- A daily heartbeat keeps the installation record current
- The record includes a pseudonymous install ID and the store URL
- The administrator email entered during setup is included
- Version, store model, theme, PHP version, database driver and enabled module count are included
- No customers, orders, payment data or product data are sent
- The install ID is not an anonymity guarantee because the admin email is included
- Store admin sees the install list, active counts and installs-per-sale comparison
- Install and heartbeat routes are rate-limited and the administrator email is stored encrypted
- Opt out during setup or set SHOPKEEPRR_TRACKING_ENABLED=false and clear config
- Existing records can be deleted on request to the vendor
Self-hosted means self-operated. You control the server, database, files, backups and access. Keep PHP and dependencies current, test updates on a staging copy and maintain independent backups. The free core does not include managed hosting or incident response for your server.
The numbers and the routine
Reports & store operations
ShopKeeprr keeps the routine work in the same admin as the storefront data, with reports you can export and settings that cover the store's operating rules.
- Revenue reporting
- Tax reporting
- Shipping reporting
- Product performance reporting
- CSV export from reports
- Dashboard activity overview
- Order status and refund history
- Store settings
- Checkout settings, including unpaid-order cancellation
- Payment settings with sandbox/test mode
- Mail settings and test order email
- Theme settings
- Shipping zones and methods
- Tax rates
- Abandoned unpaid order cancellation task
- Module schedules through the Laravel scheduler
- Update audit history
- Admin action audit log
Add a cron entry for php artisan schedule:run so abandoned unpaid orders are cancelled hourly and enabled modules can run their own schedules. Keep independent database and uploads backups as part of your hosting routine.
Built to be extended
Developer & extensibility features
ShopKeeprr is a Laravel application, not a closed SaaS product. The same extension points used by the core are available to module and theme developers.
- Laravel 13 application
- PHP 8.3+ runtime
- Vite 8 front-end build
- Tailwind CSS 4
- Alpine.js 3
- Module API 1.0
- Module manifests with namespace, provider and type
- Service-provider extension points
- Storefront block registry for third-party components
- Theme presets and Blade overrides
- Config-driven theme metadata and palettes
- Module migrations
- Module routes and schedules
- Signed module compatibility constraints
- Store release packaging with checksums
- Test suite in the source repository
- Installation, update, security and FAQ documentation
- Source and developer documentation on GitHub
The test suite is included in the source repository for developers and reviewers, not in the download archive. It covers the storefront, all four themes, checkout and payment flows, webhooks, B2B guest rules, module trust, installation tracking, inventory integrity, version constraints, signed manifests, compatibility warnings, maintenance routing, multi-vendor commissions and payouts, and the upgrade/rollback harness.
Add only what you need
Optional Store extensions
The Store carries plugins, themes, components and specialist business kits from independent makers. They are optional additions; the free core is a complete store without them. Extension licensing and support stay with the developer who sold them.
| Extension | Distribution | What it adds |
| Abandoned Cart Recovery | ShopKeeprr Store | Timed unpaid-checkout emails, signed return links and recovery metrics |
| Product Bundles & Upsells | ShopKeeprr Store | Frequently-bought-together sets with proportional bundle discounts and stock checks |
| Loyalty & Rewards | ShopKeeprr Store | Points on paid orders, a customer ledger and single-use reward coupons |
| Email Marketing Hub | ShopKeeprr Store | Consent-aware Mailchimp, Klaviyo, Brevo, MailerLite and Constant Contact sync |
- Free and paid plugins
- Complete themes
- Storefront components
- Specialist business models
- One-click install for owned items
- Manual ZIP upload when the Store is not reachable
- Extension licensing handled by each developer
- Optional installation and customization services
- Buy Me a Coffee tips do not buy a license, priority support or any feature
The practical details
Download, install & support
The free core is delivered as a ZIP from download.shopkeeprr.com, with a published SHA-256 checksum. No account or activation step is required.
- Free core download
- No platform subscription or activation
- Self-hosted on your own PHP server
- MySQL 8+ or SQLite 3 database
- Apache or Nginx, document root at public/
- Browser installer at /install.php
- Command-line installer alternative
- Installation and FAQ PDF in the download
- Full README and UPDATING.md
- Signed update support
- Best-effort support by email
- No managed hosting, SSL, server administration or backups included
- Paid installation, customization and launch help available separately
- ShopKeeprr Free Self-Hosted License; Laravel remains MIT licensed
Ready to see it running?
Download the free 1.1.2 core, install it on your own hosting, and shape the storefront around your business. The Store is there when you want an optional extension.
Back to top ↑