# Bagisto

Laravel storefront plus admin, configured from .env, with an official GraphQL API package.

Full open-source store on Laravel and Vue: storefront, admin panel, multi-channel, multi-currency, and a theme and package system. The Builder ships bagisto/graphql-api (repo headless-ecommerce) so an agent can drive the store over GraphQL; paid cloud hosting and marketplace extensions sit alongside the MIT core.

Alternative to: Shopify, Adobe Commerce

- Capabilities: adaptable, operable
- Vertical: ecommerce
- Shape: business-app
- Form factor: web-app
- Execution model: deterministic
- Provenance: human-written (recorded, never ranked)
- Repo: https://github.com/bagisto/bagisto (MIT), 28086 stars, last commit 2026-09-02
- Last activity: 2026-09-02
- Page: apps/bagisto--bagisto.html
- JSON: apps/bagisto--bagisto.json

## Use it when

- I want a complete store with an admin panel that I can run myself and brand without writing PHP
- I need a GraphQL endpoint so a headless storefront or an agent can shop the catalog

## Gotchas

- GraphQL API is a separate composer package (bagisto/graphql-api:dev-main) on top of Bagisto ^2.3
- GraphQL calls need the x-app-secret-key header from APP_SECRET_KEY
- The older bagisto/rest-api package was last pushed 2025-08-04

## Editions

- Community: Free, open source
  - source: composer create-project bagisto/bagisto
  - container: docker compose up
- Bagisto Cloud hosting: Free, closed source
  - hosted: https://bagisto.com/en/

## Adaptable: make it yours

Effort: config-only (25 things to edit), surface kind admin-ui

.env.example is deployment configuration (APP_URL, DB_*, MAIL_*, CACHE_STORE, QUEUE_CONNECTION, FILESYSTEM_DISK, AWS_*/R2_*), with APP_LOCALE, APP_CURRENCY and APP_TIMEZONE as the only store-facing defaults. Business adaptation lives in the admin UI: Settings > Channels, Locales, Currencies, Taxes, Themes (theme customization), Configure > Sales for payment and shipping methods, plus Catalog, CMS pages and Marketing. Custom storefront code starts in packages/Webkul/Shop and Theme.

- Env vars: APP_NAME, APP_URL, APP_ADMIN_URL, APP_LOCALE, APP_CURRENCY, APP_TIMEZONE, DB_CONNECTION, DB_HOST, DB_DATABASE, DB_USERNAME, DB_PASSWORD, MAIL_MAILER, MAIL_HOST, MAIL_FROM_ADDRESS, CACHE_STORE, SESSION_DRIVER, QUEUE_CONNECTION, FILESYSTEM_DISK, AWS_BUCKET, ADMIN_MAIL_ADDRESS, RESPONSE_CACHE_ENABLED, APP_SECRET_KEY, GRAPHQL_ENDPOINT
- Config files: .env, config/app.php
- Prompt files: none
- Accounts you'll need: none

## Operable: what an agent can drive

Operability: official. Interface: api at https://devdocs.bagisto.com/2.3/api/graphql-api.html (published by the builder, local).

### Reach (partial coverage)

- Browse catalog and search: reachable. headless-ecommerce README: headless storefront GraphQL, playground at /graphiql
- Cart and checkout: reachable. package is built for headless storefronts (Ucraft collaboration); shop flows are its purpose
- Customer accounts: reachable. shop-side API per package README
- Create and update products: undetermined. docs page redirected on fetch; admin coverage not confirmed
- Manage orders (invoice, ship, refund): undetermined. admin coverage not confirmed
- Manage categories and attributes: undetermined. admin coverage not confirmed
- Marketing: promotions, CMS pages: undetermined. admin coverage not confirmed
- Store settings and channels: undetermined. admin coverage not confirmed

## Code stack

- Languages: PHP, JavaScript
- Frameworks: Laravel, Vue.js
- Package manager: composer
- Database: MySQL
- Hosting target: Docker, LAMP, Bagisto Cloud

## Evidence and confidence

- formFactor: Laravel monolith with storefront and admin (confidence 0.95)
- executionModel: no model at runtime (confidence 0.95)
- operability: bagisto/headless-ecommerce is under the bagisto org (confidence 0.9)
- effort: .env.example in repo; README and devdocs document installation; admin theme customizer (confidence 0.85)
- editions: MIT license; bagisto.com sells cloud hosting and extensions (confidence 0.6)
- active: pushedAt 2026-09-02
- reach:  (confidence 0.5)

## Open questions

- Does the GraphQL API include admin mutations (products, orders, settings) or only shop operations
- Bagisto Cloud prices

## Sources

- https://github.com/bagisto/bagisto (sourcing:ecommerce:github)
- https://github.com/bagisto/headless-ecommerce (sourcing:ecommerce:github)