https://github.com/thefreelight/jiffoo

Open-source commerce core with storefront, admin, themes, plugins, and marketplace-ready architecture.
https://github.com/thefreelight/jiffoo

ecommerce fastify headless-commerce marketplace multi-tenant nextjs plugins prisma saas themes

Last synced: about 2 months ago
JSON representation

Open-source commerce core with storefront, admin, themes, plugins, and marketplace-ready architecture.

• Host: GitHub
• URL: https://github.com/thefreelight/jiffoo
• Owner: thefreelight
• License: other
• Created: 2025-05-28T03:01:05.000Z (about 1 year ago)
• Default Branch: main
• Last Pushed: 2026-04-19T16:01:06.000Z (2 months ago)
• Last Synced: 2026-04-19T18:29:40.077Z (2 months ago)
• Topics: ecommerce, fastify, headless-commerce, marketplace, multi-tenant, nextjs, plugins, prisma, saas, themes
• Language: TypeScript
• Size: 668 MB
• Stars: 8
• Watchers: 0
• Forks: 1
• Open Issues: 3
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# Jiffoo - Open Source E-Commerce Platform

[![License: GPL v2+](https://img.shields.io/badge/License-GPL%20v2+-blue.svg)](https://www.gnu.org/licenses/gpl-2.0)

[![TypeScript](https://img.shields.io/badge/TypeScript-5.3-blue.svg)](https://www.typescriptlang.org/)

[![Next.js](https://img.shields.io/badge/Next.js-black.svg)](https://nextjs.org/)

[![Fastify](https://img.shields.io/badge/Fastify-5-green.svg)](https://www.fastify.io/)

Jiffoo is a TypeScript commerce core for self-hosted storefronts, admin tooling, and extension-driven customization.

## Features

- Complete commerce flows for catalog, cart, checkout, orders, and payments

- Theme packs and plugin-based extensibility

- Fastify API with Prisma-backed data access

- Next.js shop and admin applications

- Shared SDKs for frontend, theme, and plugin integrations

## Quick Start

### Prerequisites

- Node.js 20+

- PostgreSQL 14+

- Redis 6+ for caching and async jobs

- pnpm 9+

### Installation

```bash

git clone https://github.com/thefreelight/Jiffoo.git

cd Jiffoo

pnpm install

cp apps/api/.env.example .env

pnpm --filter api db:migrate

pnpm dev

```

### Local URLs

- Shop: `http://localhost:3003`

- Admin: `http://localhost:3002`

- API: `http://localhost:3001`

## Repository Layout

```text

Jiffoo/

├── apps/

│   ├── api/

│   ├── admin/

│   └── shop/

├── packages/

│   ├── core-api-sdk/

│   ├── plugin-sdk/

│   ├── shared/

│   ├── shop-themes/

│   ├── theme-api-sdk/

│   └── ui/

└── scripts/

```

## Documentation

- [Create App CLI](packages/create-jiffoo-app/README.md)

- [Core API SDK](packages/core-api-sdk/README.md)

- [Plugin SDK](packages/plugin-sdk/README.md)

- [Theme API SDK](packages/theme-api-sdk/README.md)

- [Default Theme Pack](packages/shop-themes/default/README.md)

## License

Jiffoo is licensed under the [GNU General Public License v2.0 or later](LICENSE).