From 54324b486c8141ba0f8889b822ebb9a8a9c5a550 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Berke=20Ba=C5=9Fbay?=
<132104179+berkebasbay@users.noreply.github.com>
Date: Thu, 29 Oct 2026 20:26:51 +0300
Subject: [PATCH] Add a visual product tour and a documentation hub
---
README.md | 73 ++++++++++++++++++-----
docs/QUICKSTART.md | 19 +++++-
docs/README.md | 60 +++++++++++++++++++
docs/media/README.md | 4 ++
docs/media/loopset-service-compare.png | Bin 0 -> 312050 bytes
docs/media/loopset-service-edit.png | Bin 0 -> 265320 bytes
docs/media/loopset-service-workspace.png | Bin 0 -> 480424 bytes
7 files changed, 140 insertions(+), 16 deletions(-)
create mode 100644 docs/README.md
create mode 100644 docs/media/loopset-service-compare.png
create mode 100644 docs/media/loopset-service-edit.png
create mode 100644 docs/media/loopset-service-workspace.png
diff --git a/README.md b/README.md
index dc4712c..5cdcff3 100644
--- a/README.md
+++ b/README.md
@@ -10,17 +10,21 @@
Try Loopset → ·
- Quickstart ·
+ Documentation ·
Contribute
-Loopset lets you build a small factory, service team or event, then see how a different plan affects queues, waiting and cost. It runs in your browser, with no installation or account.
+**A simulation playground for process ideas.** Build a factory, a service team or an event. Change how work arrives, how long it takes or who is available, then see what happens to queues, waiting and cost.
+
+Loopset is free and runs in your browser. Your projects stay on your device, with no account or installation required.
## See it in action
+From a working template to a real comparison: explore the world, change the shared team and run the next plan.
+
https://github.com/user-attachments/assets/42cf61e9-e756-4939-8fbe-9a2239fef163
-30-second tour · Captions & downloads · Video credits
+30-second tour · Captions & downloads · Media credits
Watch the full walkthrough · 55 seconds
@@ -29,23 +33,64 @@ https://github.com/user-attachments/assets/03fb5577-61f1-4ac8-a22f-95c133f78d10
-## Build. Run. Compare.
+## A tour of the workspace
+
+### 01 · Start with a world you can change
+
+Choose from **12 editable templates**, each with a starting plan and two prepared alternatives, or start with an empty site. Arrange your facility with **1,141 ready-to-use 3D models**, then define the process that makes it work.
+
+
+
+
+
+Service Studio: reception, specialists and resolution in one editable workspace. Build your own facility →
+
+### 02 · Turn a question into an experiment
+
+Select a step and adjust processing time, parallel stations or the team it needs. Stations, people and shifts are separate decisions. In this example, the shared specialist team changes from **2 available units to 3**, while the station count and break plan stay the same.
+
+
+
+
+
+The real editor, enlarged in the walkthrough. Try this experiment →
+
+### 03 · See the result and the trade-off
+
+Run the changed plan and compare it with the original. Here, completed requests rise from **66 to 86** and average waiting falls from **9.5 to 5.2 minutes**. The extra capacity also raises modeled resource cost from **$85 to $115**.
+
+
+
+
+
+One synthetic example: 106 arrivals, one hour, seed 4207. Results depend on the model's assumptions; resource cost is not total business cost. How to read a result →
-- **Build your world.** Choose one of 12 templates or start with an empty site. Drag in equipment, shelves and work areas from 1,141 ready-to-use 3D models.
-- **Try a different plan.** Change arrivals, processing time or staffing. Run it and compare completed work, waiting and resource cost.
-- **Make it yours.** Save your project, keep alternatives, or turn your setup into a reusable template.
+Save the plan, keep it as a reusable template, or download an editable project file. Repeated experiments and matched-input comparisons are available when you want to investigate uncertainty beyond a single run.
-### Pick a place to start
+## Find your starting point
| Service Studio | Festival Gate | Little Factory |
| :---: | :---: | :---: |
-|
|
|
|
+|
|
|
|
| Teams & waiting | Arrivals & queues | Production & capacity |
-[Explore all templates →](docs/TEMPLATES.md)
+The collection also includes workshops, machining, rework, 3D printing, packing, fulfillment, returns, parcel handling and repairs. [Explore the templates and their experiments →](docs/TEMPLATES.md)
+
+## Documentation
+
+**[Browse all guides →](docs/README.md)**
+
+| I want to… | Start here |
+| --- | --- |
+| Run my first experiment | [Quickstart](docs/QUICKSTART.md) · [Starter templates](docs/TEMPLATES.md) |
+| Build a facility and edit its process | [Facility guide](docs/FACILITY_GUIDE.md) · [Workspace guide](docs/UX_GUIDE.md) |
+| Understand assumptions and results | [Model guide](docs/MODEL_GUIDE.md) · [Export and sharing](docs/SHARING.md) |
+| Use the engine in my own project | [Headless API](docs/API.md) · [Architecture](docs/ARCHITECTURE.md) |
+| Develop, test or host Loopset | [Contributing](CONTRIBUTING.md) · [Testing](docs/QUALITY.md) · [Static hosting](docs/DEPLOYMENT.md) |
+| Find artwork sources and licenses | [Asset catalogue](docs/CATALOGUE.md) · [Asset attribution](docs/NVIDIA_ASSETS.md) · [Media credits](docs/media/README.md) |
-Run locally & develop
+Run locally
Use Node.js 24 and npm:
@@ -54,15 +99,13 @@ npm ci
npm run dev
```
-Open the local address printed by Vite. No API keys or backend setup.
-
-The engine also runs without the interface. See the [Engine API](docs/API.md), [model guide](docs/MODEL_GUIDE.md), and [contribution guide](CONTRIBUTING.md).
+Open the local address printed by Vite. No API keys or backend setup are required. The [contribution guide](CONTRIBUTING.md) covers checks and development conventions.
## Help build Loopset
-New templates, clearer guides, accessible interactions and focused bug fixes are welcome. [Open an issue](https://github.com/berkebasbay/loopset/issues/new/choose) or [send a pull request](CONTRIBUTING.md).
+New templates, clearer guides, accessible interactions and focused bug fixes are welcome. [Open an issue](https://github.com/berkebasbay/loopset/issues/new/choose) or [send a pull request](CONTRIBUTING.md). For a larger change, discuss the problem and scope first.
---
diff --git a/docs/QUICKSTART.md b/docs/QUICKSTART.md
index bccf949..98b76cd 100644
--- a/docs/QUICKSTART.md
+++ b/docs/QUICKSTART.md
@@ -11,7 +11,7 @@ npm ci
npm run dev
```
-Open the address printed by Vite. Choose **Little Factory**, **Festival Gate** or **Service Studio**; examples calculate on opening. **New model** starts a valid arrival → waiting → processing → completion flow.
+Open the address printed by Vite. Use **Templates** to choose **Service Studio**, **Festival Gate**, **Little Factory** or another starter; examples calculate on opening. **Blank** starts an empty site, and **Start a process** adds a valid arrival → waiting → processing → completion flow when you are ready.
The working surface has a world, a searchable **Steps** list, contextual **Properties**, and **Run simulation**. **Tools → Model editor** keeps the complete professional model available when you need it.
@@ -27,6 +27,23 @@ For a custom facility, choose **Build facility → Empty site**. This starts wit
Use Undo/Redo or **Action history** to reverse model edits. Restoring a saved scenario changes the draft; calculate it to get a new result.
+## Reproduce the Service Studio demo
+
+1. Open **Templates → Service Studio** and let the original plan finish calculating.
+2. In **Define process**, select **Specialists** in the world or Steps list, then open **Properties**.
+3. Under **Team or equipment → Shared specialists**, change **Base available units** from **2** to **3** and apply the field with Enter. Leave **Parallel stations**, the installed limit and the shift/break plan unchanged.
+4. Choose **Run & compare**. The original remains the baseline for the comparison.
+
+With the starter's one-hour duration and seed 4207, the same 106 realized arrivals produce these rounded results:
+
+| Outcome | Original · 2 shared units | Changed · 3 shared units |
+| --- | ---: | ---: |
+| Completed requests | 66 | 86 |
+| Average waiting time | 9.5 min | 5.2 min |
+| Modeled resource cost | $85 | $115 |
+
+This is one synthetic example. The arrival estimate in Scenario settings is an expectation; the actual count comes from the recorded run. Cost is a modeled resource charge, not total business cost. The [model guide](MODEL_GUIDE.md#measurement-and-interpretation) explains which work contributes to each metric and how repeated experiments help examine uncertainty.
+
## Change duration or demand
**Scenario settings**, beside Run, offers 30-minute, 1-hour, 8-hour and custom durations. Choose seconds, minutes, hours or days for display. Changing the unit alone leaves the model unchanged.
diff --git a/docs/README.md b/docs/README.md
new file mode 100644
index 0000000..eb17744
--- /dev/null
+++ b/docs/README.md
@@ -0,0 +1,60 @@
+# Loopset documentation
+
+Build a process, test a plan and understand the result. These guides cover the browser workspace, modeling rules, experiments and the standalone engine.
+
+**[Open Loopset →](https://berkebasbay.github.io/loopset/)** · [Watch the demos](https://berkebasbay.github.io/loopset/watch/) · [Project overview](../README.md)
+
+## Choose a starting point
+
+| Your goal | Follow this path |
+| --- | --- |
+| Try Loopset for the first time | [Quickstart](QUICKSTART.md) → [Service Studio video experiment](QUICKSTART.md#reproduce-the-service-studio-demo) |
+| Build a layout from scratch | [Facility guide](FACILITY_GUIDE.md) → [Workspace controls](UX_GUIDE.md) |
+| Explore a ready-made process | [Starter templates](TEMPLATES.md) → [Read a result carefully](TEMPLATES.md#read-a-result-carefully) |
+| Understand results and uncertainty | [Read results in the workspace](UX_GUIDE.md#read-results-and-keep-alternatives) → [Measurement and interpretation](MODEL_GUIDE.md#measurement-and-interpretation) |
+| Integrate or extend the engine | [Headless API](API.md) → [Architecture](ARCHITECTURE.md) → [Contributing](../CONTRIBUTING.md) |
+
+## Use the application
+
+| Guide | What you will find |
+| --- | --- |
+| [Quickstart](QUICKSTART.md) | Open a template, try a capacity decision, reproduce the demo, calculate, save and reopen a project. |
+| [Workspace guide](UX_GUIDE.md) | Properties, demand and duration, teams and shifts, process editing, comparisons, replay, keyboard controls and smaller screens. |
+| [Build a facility](FACILITY_GUIDE.md) | Start empty, place and arrange objects, connect process cells, save templates and transfer the complete facility. |
+| [Starter templates](TEMPLATES.md) | All twelve starters, their process questions, two alternatives each, assumptions and personal templates. |
+| [Export and share](SHARING.md) | Choose project JSON, run JSON, CSV, PNG, HTML or print/PDF and keep the calculation context with the result. |
+
+## Understand the simulation
+
+The visual world and the numerical model have different roles. Artwork and walking make a process easier to follow; arrivals, durations, routing, queues and capacity determine its results.
+
+- [Model guide](MODEL_GUIDE.md): process steps, distributions, priorities, patience, resources, calendars, event ordering, measurement, reproducibility and CSV inputs.
+- [Measurement and interpretation](MODEL_GUIDE.md#measurement-and-interpretation): completed versus unfinished work, waiting samples, percentiles, warm-up, replay limits and uncertainty.
+- [Replications and paired comparisons](API.md#replications-and-paired-comparisons): run repeated experiments and compare compatible plans through the headless API.
+- [Bounded capacity search](API.md#bounded-capacity-search): search a finite set of shared-resource capacities and retain separate verification runs.
+- [Portable examples](../examples/README.md): synthetic reference projects and reproducible command-line runs.
+
+The supplied examples are learning models. Real decisions need appropriate inputs, validation and an understanding of uncertainty. A single run is not a general improvement guarantee.
+
+## Develop and deploy
+
+| Guide | What you will find |
+| --- | --- |
+| [Headless API](API.md) | Build/import commands, public exports, project validation, one run, replay statistics, experiments and the CLI contract. |
+| [Architecture](ARCHITECTURE.md) | Model, calculation, rendering and storage boundaries; immutable results; templates and empty layouts. |
+| [Contributing](../CONTRIBUTING.md) | Where to make a change, what evidence to include, template/demo exports and publication checks. |
+| [Testing](QUALITY.md) | Automated coverage and browser smoke-check commands. |
+| [Static hosting](DEPLOYMENT.md) | Build a static deployment, configure a subpath, serve media and verify the deployed source revision. |
+| [Security](../SECURITY.md) | Supported reporting and handling of vulnerabilities. |
+
+## Assets, media and licenses
+
+- [Prepared asset catalogue](CATALOGUE.md): the browser-ready inventory, source preparation and verification.
+- [World assets and attribution](NVIDIA_ASSETS.md): model, people, surroundings and lighting sources, plus browser adaptations.
+- [Demo media](media/README.md): videos, screenshots, repository artwork, recording scope and credits.
+- [Third-party notices](../THIRD_PARTY_NOTICES.md): the separate licenses for dependencies, artwork, fonts, music and effects.
+- [Code license](../LICENSE): MIT terms for original Loopset code.
+
+## Get help
+
+[Open an issue](https://github.com/berkebasbay/loopset/issues/new/choose) with a small synthetic example, the actions you took and the result you expected. Keep personal or customer data out of public examples.
diff --git a/docs/media/README.md b/docs/media/README.md
index bc7bcff..1bf87da 100644
--- a/docs/media/README.md
+++ b/docs/media/README.md
@@ -20,6 +20,10 @@ Stock music and effects are incorporated into the films; their standalone source
## Interface screenshots
+`loopset-service-workspace.png` shows the actual Service Studio workspace before the recorded team change. It is taken from the same high-resolution native capture used in the current films. The full-run metrics and the replay's momentary scene counters describe different scopes.
+
+`loopset-service-edit.png` and `loopset-service-compare.png` are stills from the published English walkthrough, at 34.4 and 39.5 seconds. They retain the real editor/table and the film's larger editorial annotations. The field has been applied before the edit still; the comparison shows the same synthetic case described above. No interface control or numerical value was reconstructed for these images.
+
The PNG screenshots in this directory document the RC14 workspace, template gallery and recorded-result surfaces. `loopset-facility.png` uses the enhanced Little Factory layout; its source is [`examples/facility.json`](../../examples/facility.json). `loopset-compare.png` shows that Factory's separate station/team experiment, 40 → 77 completed orders; it is not the Service Studio comparison in the current films.
`public/previews/templates/` contains the twelve starter scene previews. All models and examples shown are synthetic. Original browser captures omit local-origin footers. NVIDIA CC BY 4.0 models, Quaternius/Poly Haven CC0 material and fonts retain the creator/source/license records linked above.
diff --git a/docs/media/loopset-service-compare.png b/docs/media/loopset-service-compare.png
new file mode 100644
index 0000000000000000000000000000000000000000..148ab4a0efd9783830563192a3b1eb7eb3f07e86
GIT binary patch
literal 312050
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