Skip to Content
Introduction

Introduction

Hoikka is a full-stack e-commerce platform built with SvelteKit.

It bundles the storefront, admin panel, and business logic in a single codebase, stores everything in SQLite, and runs on either a Node.js server or Cloudflare Workers (D1 + R2). You pick with one env var, HOIKKA_TARGET.

There are no plugin systems, configuration DSLs, or hidden admin logic. Everything is plain TypeScript that you read, change, and extend directly, in the spirit of the Rails Doctrine . This also makes the codebase easy for AI tools to work with: a local MCP server (pnpm mcp) exposes schema, catalog, and order tools to AI assistants.

Quick Start

Scaffold a new store:

pnpx create-hoikka-app my-store

Then follow the installation instructions.

What’s Included

  • Storefront + admin in one SvelteKit app
  • SQLite everywhere — a local file on Node.js, D1 on Cloudflare, one Drizzle schema for both
  • Cookie-based cart — the cart lives entirely in a cookie while shopping, so there are zero database writes until checkout starts
  • Products & variants with facets, collections, categories, and full-text search
  • Orders & checkout with a state-machine order lifecycle
  • Payments — pluggable providers (Stripe and a mock provider)
  • Shipping — pluggable providers (flat-rate built in)
  • Tax — Finnish VAT with gross pricing and B2B tax exemption
  • Promotions — coupon codes and automatic discounts
  • B2B — customer groups with per-group variant pricing
  • Reviews, content pages, digital products, and asset management
  • Integrations — a dependency-free outbox for webhooks, ERP/PIM sync, and background jobs that works on both targets
Last updated on
Installation