explaingit

ddyy/minshop

Analysis updated 2026-07-26

81TypeScriptAudience · developerComplexity · 3/5Setup · moderate

TLDR

A lightweight, open-source online store template that runs on Cloudflare's free tier, featuring an admin panel, Stripe payments, and the ability for AI agents to buy products using Bitcoin Lightning.

Mindmap

mindmap
  root((repo))
    What it does
      Server-rendered storefront
      Full admin panel
      AI agent purchases
    Payment options
      Stripe Checkout
      Bitcoin Lightning
      OpenNode
    Tech stack
      Cloudflare Pages
      Cloudflare D1
      Cloudflare R2
    Use cases
      Start small online store
      AI commerce experiments
    Setup
      Node 22.12 plus
      One-click deploy
      Setup wizard

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Launch a fast, low-cost online store on Cloudflare's free tier.

USE CASE 2

Let autonomous AI agents browse a catalog and buy items using Bitcoin Lightning.

USE CASE 3

Manage products, orders, and customers through a built-in admin dashboard.

USE CASE 4

Experiment with agent-to-store commerce using a programmatic management protocol.

What is it built with?

TypeScriptCloudflare PagesCloudflare D1Cloudflare R2StripeBitcoin Lightning

How does it compare?

ddyy/minshopdesktop-hermes/hermes-agent-desktopjusticekb/justicekb-simple-loop-claw
Stars818181
LanguageTypeScriptTypeScriptTypeScript
Setup difficultymoderatemoderate
Complexity3/52/5
Audiencedevelopervibe coderdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires Node version 22.12 or higher and a Cloudflare account for deployment and database provisioning.

The license details are not specified in the repository explanation.

In plain English

minshop is an open-source online store template built to run on Cloudflare's edge computing platform. It is designed to be lightweight and inexpensive to start, fitting within Cloudflare's free plan allowances. The core idea is a small, server-rendered store with a full admin panel, multiple payment options, and an optional server that lets AI agents interact with the store programmatically. A standout feature is that AI agents can read the product catalog and pay for items using Bitcoin Lightning invoices without human intervention. Human customers check out normally using Stripe. Merchants can also manage the store through an agent protocol. The storefront itself sends very little JavaScript to the browser, keeping things fast. It includes a cart that works even with JavaScript disabled, full-text search with typo correction, nested categories, and Markdown pages with a live preview editor. The admin panel handles products, categories, orders, customers, fulfillment, media, and runtime settings. On the payment side, it supports Stripe Checkout, self-hosted Bitcoin Lightning, hosted OpenNode, or a built-in demo rail. Merchants can configure shipping zones with flat rates, discount codes, and tax calculation through Stripe Tax. Order confirmation emails are supported through either Resend or Cloudflare Email, and uploaded images are stored privately on Cloudflare R2 and served through the app. Getting started requires Node version 22.12 or higher and Git. A setup command scaffolds a new store, installs dependencies, creates a local database with sample data, and starts a development server. The first visit to the admin panel launches a setup wizard where you set the store name and time zone. There are no hardcoded brand settings, so the project clones cleanly as a template. Deployment can be done through a one-click Cloudflare button or a command-line script that provisions the necessary databases and storage. The full README is longer than what was shown.

Copy-paste prompts

Prompt 1
Help me set up the minshop store template locally. I have Node 22.12 installed and need to run the setup command, configure the admin panel, and view the sample data.
Prompt 2
I want to enable AI agent purchases on my minshop store using Bitcoin Lightning. Walk me through configuring the self-hosted Lightning payment option and the agent protocol.
Prompt 3
Explain how to deploy minshop to Cloudflare using the one-click button, including how to provision the D1 database and R2 storage bucket for images.
Prompt 4
Help me configure Stripe Checkout and Stripe Tax in the minshop admin panel so I can start accepting human customer payments with automatic tax calculation.

Frequently asked questions

What is minshop?

A lightweight, open-source online store template that runs on Cloudflare's free tier, featuring an admin panel, Stripe payments, and the ability for AI agents to buy products using Bitcoin Lightning.

What language is minshop written in?

Mainly TypeScript. The stack also includes TypeScript, Cloudflare Pages, Cloudflare D1.

What license does minshop use?

The license details are not specified in the repository explanation.

How hard is minshop to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is minshop for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.