Launch your online store in minutes. Built on Cloudflare's edge network for lightning-fast performance, zero infrastructure costs, and unlimited scalability.
OpenShop is the fastest, most cost-effective way to launch an e-commerce store. Built entirely on Cloudflare's edge network, you get:
- Lightning Fast - Sub-100ms response times worldwide
- Completely Free - Stays within Cloudflare's generous free tier (100k requests/day)
- One-Command Deploy - Your store is live in under 5 minutes
- Enterprise Security - Built-in DDoS protection, SSL, and secure authentication
- Mobile-First - Beautiful, responsive design that works everywhere
- Unlimited Stores - Deploy as many stores as you want from one codebase
Perfect for entrepreneurs, developers, and businesses who want a professional online store without the complexity or cost of traditional e-commerce platforms.
- Complete E-commerce - Products, collections, shopping cart, and Stripe checkout
- Product Management - Multiple images, variants, and rich descriptions
- Collections - Organize products with beautiful hero banners
- Stripe Integration - Automatic product sync and secure payment processing
- Analytics Dashboard - Real-time revenue and order insights
- Smart Shopping Cart - Persistent cart with quantity management
- Mobile Optimized - Fully responsive with mobile-specific cart experience
- Intuitive Navigation - Collection links with product preview dropdowns
- Beautiful UI - Modern design with Tailwind CSS and ShadCN/UI
- Rich Media Support - Multiple product images with carousel navigation
- Store Customization - Dynamic logo management (text or image)
- Secure Admin System - Token-based authentication with session management
- AI Image Generation (Optional) - Generate product images via OpenRouter
- Google Drive Integration (Optional) - Store and serve images from Google Drive
- Node.js 18+ - Download here
- Cloudflare Account - Sign up free
- Stripe Account - Create account
-
Clone and Install
git clone https://github.com/AJFrio/OpenShop openshop cd openshop npm install -
Automated Deployment
npm run setup
The setup wizard will prompt you for:
- Project Name - Unique name for your store
- Cloudflare API Token - Get token here
- Cloudflare Account ID - Found in your Cloudflare dashboard
- (Optional) Stripe Keys - Press Enter to skip; you can add them later
- (Optional) OpenRouter API Key - For AI image generation
- (Optional) Admin Password - Press Enter for the default
- (Optional) Google OAuth - For Google Drive integration
Only the first three are required. Everything else can be set later from the admin panel under Developer Settings, without redeploying.
See Configuration Guide for detailed setup instructions.
-
Your Store is Live!
Access your store at:
https://your-project-name.username.workers.dev -
Sign in and secure it
Go to
/adminand sign in. If you skipped the password prompt, the default isadmin123— the panel will warn you and require a change before you do anything else.Without Stripe keys the store runs in catalogue-only mode: you can add products and design the storefront, but checkout stays disabled until you add keys under Developer Settings.
Access admin at:
https://your-project-name.username.workers.dev/admin
Access your admin dashboard at /admin on your store URL.
Security Features:
- Password-protected login
- 24-hour session tokens
- Separate authenticated API endpoints
- No visible admin link on storefront (access via direct URL)
Admin Capabilities:
- Create, edit, and delete products with multiple images
- Manage collections with hero banners
- Customize store branding and appearance
- View real-time analytics and revenue insights
- Generate AI images (optional)
- Upload images to Google Drive (optional)
For detailed admin documentation, see Architecture Guide.
Deploy unlimited stores from a single codebase, each with its own:
- Worker deployment and subdomain
- Isolated KV namespace (separate data)
- Admin credentials and settings
- Stripe configuration
# Create your first store
npm run setup
# Project Name: "electronics-hub"
# Create another store
npm run setup
# Project Name: "fashion-boutique"
# List all your stores
npm run sites
# Deploy a specific store
npm run deploy electronics-hubSee Deployment Guide for complete multi-site documentation.
# Full-stack development (Worker + Frontend)
npm run dev
# Frontend-only development
npm run dev:frontend
# Build for production
npm run build
# Deploy to production
npm run deploy
# Preview production build locally
npm run previewFor detailed development instructions, see Development Guide.
Complete documentation is available in the docs/ directory:
- Architecture Guide - Technical architecture, security, and data models
- API Reference - Complete API documentation
- Configuration Guide - Environment variables and setup
- Stripe Integration - Payment processing and webhook setup
- AI & Media - OpenRouter AI and Google Drive integration
- Deployment Guide - Deployment instructions and multi-site setup
- Performance Guide - Performance metrics and optimization
- Customization Guide - Frontend and backend customization
- Troubleshooting - Common issues and solutions
- Testing Guide - Testing guidelines and examples
- Engineering Harness - Agent-first docs, validation, and CI
- AGENTS.md - Short map for coding agents (start here for AI-assisted work)
We welcome contributions! Please follow these steps:
- Fork the repository
- Create a feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
- Follow existing code style and patterns
- Read AGENTS.md for repository navigation and layer rules
- Run
npm run harness:validateandnpm test -- --runbefore submitting - Add tests for new functionality
- Update documentation for any changes
- Ensure lint and harness CI pass before submitting
This project is licensed under the GNU Affero General Public License v3.0 (AGPL-3.0) - see the LICENSE file for details.
- Documentation - Complete guides in the
docs/directory - Bug Reports - GitHub Issues
- Feature Requests - GitHub Discussions
- Community Chat - Discord Server
- Cloudflare Workers Documentation
- Stripe API Documentation
- Tailwind CSS Documentation
- ShadCN/UI Documentation
Special thanks to:
- Cloudflare - For the incredible Workers platform and generous free tier
- Stripe - For reliable payment processing and excellent developer experience
- Vercel - For the ShadCN/UI component library
- The Open Source Community - For the amazing tools and libraries
Built something awesome with OpenShop? We'd love to feature your store! Open an issue with your store URL and a brief description.
Made for the open-source community