Handbook
Studio 101 — First session
Your first successful visit to Forge Studio: confirm /studio/ loads, then complete one simple navigation path (for example open a project or workspace view).
What it is
Your first successful visit to Forge Studio: confirm /studio/ loads, then complete one simple navigation path (for example open a project or workspace view).
When to use it
Right after Install and run, before deeper Studio or Wizard work.
Time and checks
| Time | 5–10 minutes once the server is up. |
| Check | /studio/ returns 200 and the shell renders without a blank white screen. |
| Scenario | You just finished install and need proof Studio is viable before inviting a teammate. |
| Next | Studio 201 for daily review habits. |
Prerequisites
- Server running.
- Modern browser.
Glossary (labels you may see)
| Label | Meaning in practice |
|---|---|
| Workspace | The lens across your scanned repos |
| Projects | A single product/repo focus |
| Plans / Flow | Delivery-oriented views (names vary) |
Exact wording changes between builds; use this table only to orient, not as an API.
+-------------+ +------------------+ +----------------+
| Open /studio| --> | Confirm workspace | --> | Open a project |
+-------------+ +------------------+ +----------------+
Expected outcome
You leave this tutorial with /studio/ returning HTTP 200, visible chrome (navigation + content panels), and confidence that one workspace/project surface renders live data—matching the baseline captured in Install and run.
First session flow
| # | Action | Expected result |
|---|---|---|
| 1 | Confirm Classic loads at / |
Server healthy (Install and run) |
| 2 | Open /studio/ |
Chrome appears — not a blank document |
| 3 | Use sidebar once | One area shows real content |
Steps
-
Open
http://127.0.0.1:8080/studio/(adjust host/port if yours differs). -
If you see a blank page or missing assets, treat it as an environment issue: confirm the server started cleanly, then follow Troubleshooting.
-
Use the sidebar to open one primary area (for example Projects or Workspace) and confirm content appears.
Verify
/studio/shows chrome and at least one content area without errors.- You can repeat the navigation without reading source files.
Recover
If you still see a blank /studio/ page, restart the server, confirm asset URLs resolve, then walk through Troubleshooting starting with Fast triage.