ArtisanBase 🎨

Empowering artisans with professional e-commerce solutions

Build and launch your online store without technical complexity

---

🌟 Overview

ArtisanBase is a full-stack multi-tenant SaaS platform that enables independent artisans and craftspeople to launch professional online storefronts. Built with enterprise-grade architecture, it provides secure, isolated environments for each creator while maintaining simplicity and ease of use.

Why ArtisanBase?

For Artisans Focus on your craft, not technology. Get a professional online presence with zero technical knowledge required.

For Developers Experience modern full-stack architecture with multi-tenancy, advanced security patterns, and scalable design.

---

🚀 Live Demos

🛍️ Customer Storefront	⚙️ Admin Dashboard
Browse products, shopping cart, mobile responsive	Analytics, inventory management, customization
artisan-base-storefront.vercel.app	artisan-base-dashboard.vercel.app

📖 Documentation • 🐛 Report Issues • 💬 Discussions

---

✨ Key Features

🏪 Multi-Tenant Architecture Isolated database schemas per store Enterprise-level data security Handle thousands of stores seamlessly 🔐 Enterprise Security JWT authentication with httpOnly cookies Role-based access control End-to-end data encryption

🌐 Professional Storefronts SEO-optimized with server-side rendering Mobile-first responsive design Custom branding for each store ⚡ Developer Experience Full TypeScript type safety Modern tooling and frameworks Organized monorepo architecture

---

🛠️ Technology Stack

Frontend

Next.js 14+      App Router, SSR, modern React patterns
TypeScript       Type safety across the stack
Tailwind CSS     Utility-first styling
shadcn/ui        Beautiful, accessible components
React Hook Form  Performant form validation
TanStack Query   Server state management
Zod              Runtime type validation

Backend

NestJS           Scalable Node.js framework
Prisma ORM       Type-safe database access
Passport.js      Authentication middleware
PostgreSQL       Robust relational database

DevOps & Infrastructure

pnpm Workspaces  Monorepo package management
Turborepo        Build optimization and caching
Supabase         Managed PostgreSQL hosting
Vercel           Edge deployment platform

---

🏗️ Architecture Highlights

Schema-Per-Tenant Multi-Tenancy

Revolutionary data isolation where each store gets its own PostgreSQL schema (tenant_[storeId]):

tenant_001.products
tenant_001.orders
tenant_002.products
tenant_002.orders

Benefits:

• ✅ Maximum security through complete data isolation
• ✅ Independent scaling per tenant
• ✅ Simplified compliance with data regulations

Dynamic Tenant Resolution

Request-scoped database connections with automatic tenant detection:

const tenantPrisma = await this.tenantPrismaService.getTenantClient(storeId);
const products = await tenantPrisma.product.findMany();

Seamless Development

• Next.js proxies API requests (no CORS issues)
• Hot reloading across the entire stack
• Shared types and schemas between frontend and backend

---

🚀 Quick Start

Prerequisites

• Node.js 18+
• pnpm package manager
• PostgreSQL database (Supabase recommended)

Installation

# Clone repository
git clone https://github.com/Arnoldsteve/artisan-base.git
cd artisan-base

# Install dependencies
pnpm install

# Setup environment
cd packages/api
cp .env.example .env
# Edit .env with your configuration

# Setup database
pnpm exec prisma migrate dev
pnpm exec prisma generate

# Start development servers
cd ../..
pnpm dev

🎉 You're ready!

• Storefront: http://localhost:3000
• Dashboard: http://localhost:3001
• API: http://localhost:4000

---

📚 Project Structure

artisan-base/
│
├── packages/
│   │
│   ├── api/                    # NestJS Backend Server
│   │   ├── src/
│   │   │   ├── auth/           # Authentication & authorization
│   │   │   ├── store/          # Store management
│   │   │   ├── product/        # Product CRUD operations
│   │   │   └── tenant/         # Multi-tenancy logic
│   │   └── prisma/             # Database schemas & migrations
│   │
│   ├── dashboard/              # Admin Dashboard (Next.js)
│   │   ├── app/                # App Router pages
│   │   ├── components/         # Admin UI components
│   │   └── lib/                # Utilities & configurations
│   │
│   ├── storefront/             # Customer Storefront (Next.js)
│   │   ├── app/                # App Router pages
│   │   ├── components/         # Storefront UI components
│   │   └── lib/                # Utilities & configurations
│   │
│   └── common/                 # Shared Resources
│       ├── types/              # TypeScript type definitions
│       ├── schemas/            # Zod validation schemas
│       └── utils/              # Helper functions
│
├── turbo.json                  # Turborepo configuration
└── package.json                # Workspace configuration

---

🗺️ Roadmap

Dynamic Subdomains – Custom store.artisanbase.com URLs Payment Integration – Stripe & PayPal checkout Order Management – Complete order lifecycle Analytics Dashboard – Sales insights & reporting Theme Customization – Visual store builder

Mobile App – React Native companion Email Notifications – Transactional emails Inventory Alerts – Low stock warnings Multi-Currency – International sales support Shipping Integration – Real-time rates & tracking

---

🤝 Contributing

We welcome contributions from the community!

Getting Started:

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 to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

See CONTRIBUTING.md for detailed guidelines.

---

📄 License

This project is licensed under the MIT License – see LICENSE for details.

Free for personal and commercial use.

---

🙏 Acknowledgments

Built with ❤️ for the artisan community.

Special thanks to all the open-source projects and contributors who make this possible.

---

Made with 🎨 by Arnold Steve

⭐ Star this repo if you find it helpful! ⭐