JOYCO Lab

Public registry of JOYCO Studio experiments.

Each experiment lives in its own isolated repository and gets listed here via experiments.json — the single source of truth consumed by the Hub to render the experiments showcase.

How it works

1. Scaffold a new experiment using the JOYCO CLI:

   joyco create

   This lets you pick a template (3d or motion), creates a new repo, and sets everything up.

2. Build and deploy your experiment.

3. Publish it to the registry:

   joyco lab create

   This opens a PR adding your experiment to experiments.json.

Schema

Each entry in experiments.json follows this shape:

Field	Type	Required	Description
slug	string	yes	URL-friendly unique identifier
title	string	yes	Display name
description	string	yes	What the experiment explores
href	string	yes	Live deployment URL
repo	string	no	Source repository URL
template	string	no	Template used (3d | motion)
tags	string[]	no	Freeform tags for filtering
hasControls	boolean	no	Whether the experiment exposes controls
date	string	yes	Publication date (YYYY-MM-DD)

The full JSON Schema is in schema.json.

Templates

Template	Repository
3d	lab-template-3d
motion	lab-template-motion