Every bar in the tool, drawn, with what each button does.
Verified
Roswaal's chrome is mostly icons. Hovering one gives its name, which works once you know roughly where to look — so this page is the map: each bar drawn as it appears, with every control named underneath it.
Info
The three hardest to find:
Docs — the document icon, third from the right on the editor's top bar.
Node Design — the palette icon, second from the right.
Settings — the gear icon, last on the bar.
On a computer all three open in their own window rather than over the canvas, so nothing appears to happen on the page you were on: look for a new tab. On a phone or a tablet they take turns in the one tab, and the back button returns.
Info
There are two editors: the one roswaal serve runs, and the browser preview on the project site — the same build, on a project kept in the browser instead of your repository.
Every preview window is marked: a blue mark beside the version (yellow on the canary), or a preview chip in Node Design. If you see either, your work is in this browser, not on disk.
Otherwise the bars are the same. Where one differs, both are drawn below under a switch.
The editor's top bar
Where are you working?
0.97.4Compile
Across the top of the editor. Everything on it acts on the project.
Hover a control or its row to light the other.
The Roswaal markfar leftOpens the project menu: the project you have open, the ones you opened before, and a folder dialog for anything else. The version beside it is the build you are on, which is the first thing any bug report needs; on a narrow screen it is in the mark's tooltip instead.
RefreshRe-reads the project from disk, node packs included.
New graphA new .nodescript: one Script, LocalScript or ModuleScript.
New node mapA new map of where things live in the DataModel. See Node maps.
Compile: Manual | DynamicHow generated Luau reaches disk. Manual writes when you ask; Dynamic writes on every edit. Also in Settings.
Compile projectCompiles every graph and node map in the project.
Docsthird icon from the rightThis documentation, in its own window — guides, and a page for every node including your project's own packs.
Node Designsecond icon from the rightOpens Node Design in its own window: a form over a node definition, for making nodes of your own.
Settingsthe last icon on the barThe project's settings, this browser's preferences, and themes. See Settings.
0.97.4Compile
The same bar in the browser preview. Same buttons, in the same order — three of them reach something different.
The Roswaal markfar left, in blueOpens the project menu. Blue means the browser preview: your project is kept in this browser, not on your disk — it survives a reload and it is gone if you clear the site's data. The menu offers a folder on your own machine instead, where the browser allows it.
RefreshRe-reads the project you have open, node packs included.
New graphA new .nodescript: one Script, LocalScript or ModuleScript.
New node mapA new map of where things live in the DataModel. See Node maps.
Compile: Manual | DynamicHow generated Luau reaches the project. Manual writes when you ask; Dynamic writes on every edit. Also in Settings.
Compile projectCompiles every graph and node map. The generated .luau appears in the tree beside each graph, to read or copy out.
Docsthird icon from the rightThe published documentation — these pages, which cover the built-in library. They are a separate site with no editor behind them, so they cannot document a project's own packs. For those, read the reference from the editor the daemon serves.
Node Designsecond icon from the rightOpens Node Design in its own tab, on the packs of the project you have open here. It works the same way it does under the daemon.
Settingsthe last icon on the barThe project's settings, this browser's preferences, and themes. See Settings.
The web app's bar. Held upright its words fold away so it keeps one row; held sideways it is as on a computer.
The Roswaal markfar left, in blueOpens the project menu. Blue means the browser preview: your project is kept in this browser, not on your disk — it survives a reload and it is gone if you clear the site's data. The menu offers a folder on your own machine instead, where the browser allows it. Held upright, where the bar is short of room, the version beside it steps aside; it is in the mark's tooltip.
RefreshRe-reads the project you have open, node packs included.
New graphA new .nodescript: one Script, LocalScript or ModuleScript.
New node mapA new map of where things live in the DataModel. See Node maps.
Compile: Manual | DynamicHow generated Luau reaches the project. Manual writes when you ask; Dynamic writes on every edit. Also in Settings. Held upright, where the bar is short of room, the Compile caption goes.
Compile projectCompiles every graph and node map. The generated .luau appears in the tree beside each graph, to read or copy out. Held upright, where the bar is short of room, it is its icon.
Docsthird icon from the rightThe published documentation — these pages, which cover the built-in library. They are a separate site with no editor behind them, so they cannot document a project's own packs. For those, read the reference from the editor the daemon serves. On a tablet or a phone it opens in this tab, and the back button returns.
Node Designsecond icon from the rightOpens Node Design in this tab, on the packs of the project you have open here; the back button returns.
Settingsthe last icon on the barThe project's settings, this browser's preferences, and themes. See Settings.
The tablet's bar held upright, in two rows: Docs, Node Design and Settings go under the rest.
The Roswaal markfar left, in blueOpens the project menu. Blue means the browser preview: your project is kept in this browser, not on your disk — it survives a reload and it is gone if you clear the site's data. The menu offers a folder on your own machine instead, where the browser allows it. The version is in its tooltip.
RefreshRe-reads the project you have open, node packs included.
New graphA new .nodescript: one Script, LocalScript or ModuleScript.
New node mapA new map of where things live in the DataModel. See Node maps.
Compile: Manual | DynamicHow generated Luau reaches the project. Manual writes when you ask; Dynamic writes on every edit. Also in Settings.
Compile projectCompiles every graph and node map. The generated .luau appears in the tree beside each graph, to read or copy out. As its icon.
Docssecond row, firstThe published documentation — these pages, which cover the built-in library. They are a separate site with no editor behind them, so they cannot document a project's own packs. For those, read the reference from the editor the daemon serves. On a tablet or a phone it opens in this tab, and the back button returns.
Node Designsecond row, secondOpens Node Design in this tab, on the packs of the project you have open here; the back button returns.
Settingssecond row, lastThe project's settings, this browser's preferences, and themes. See Settings.
It is always there, and everything on it acts on the project rather than on the document you have open. The bar below it, and the tools over the canvas, are the ones that change with what you are looking at.
Warning
In the browser preview, Docs opens the published pages, which cover the built-in library only. Your own packs are documented in the editor roswaal serve runs.
The graph toolbars
Where are you working?
Tank.nodescriptModuleScriptStrict Mode
Roblox
Three floating groups over the canvas: the graph's settings, the tools, and compiling.
Script classWhat this graph compiles to: a Script, a LocalScript or a ModuleScript. Absent on a Lune graph, where every file is .luau.
Typechecking modeWhich Luau typechecking mode the generated file declares. Default writes no mode line; the other two also annotate the types of generated locals. See Types.
Add nodeOpens the node menu at the centre of the view. Right-clicking the canvas does the same, where you clicked.
RealignTidies the graph into columns — Ctrl + Shift + L. With several nodes selected, only those move.
StraightenA setting on Realign rather than an action: lit, each node lines up on the execution wire arriving at it instead of on a plain column.
PreviewThe Luau this graph produced, picked out of the generated file — P does the same. With nodes selected it shows just what they compiled to.
TargetWhat this graph compiles for. Beside the button that compiles it, because a Roblox-only node being an error in a Lune graph is what it explains.
Compile scriptCompiles this document alone — Ctrl + S.
ModuleScriptStrict Mode
Roblox
Held upright, Straighten and Compile script are their icons, so the three groups keep one row. Held sideways they are as on a computer.
Script classWhat this graph compiles to: a Script, a LocalScript or a ModuleScript. Absent on a Lune graph, where every file is .luau.
Typechecking modeWhich Luau typechecking mode the generated file declares. Default writes no mode line; the other two also annotate the types of generated locals. See Types.
Add nodeOpens the node menu at the centre of the view. Right-clicking the canvas does the same, where you clicked. On a touch screen, pressing and holding the graph does the same, where you held.
RealignTidies the graph into columns — Ctrl + Shift + L. With several nodes selected, only those move.
StraightenA setting on Realign rather than an action: lit, each node lines up on the execution wire arriving at it instead of on a plain column. Held upright, where the bar is short of room, it is its icon, lit while it is on.
PreviewThe Luau this graph produced, picked out of the generated file — P does the same. With nodes selected it shows just what they compiled to.
TargetWhat this graph compiles for. Beside the button that compiles it, because a Roblox-only node being an error in a Lune graph is what it explains. Lune shows a warning triangle after its name.
Compile scriptCompiles this document alone — Ctrl + S. Held upright, where the bar is short of room, it is its icon.
Script
Roblox
The tablet's tools held upright, with the document's settings behind a button each.
Script and modeWhat this graph compiles to — a Script, a LocalScript or a ModuleScript — and which Luau typechecking mode the file declares, behind one button that names the type in a word — Script, Local or Module — and lists them in full. Tap anywhere else to put them away. See Types.
Add nodeOpens the node menu at the centre of the view. Right-clicking the canvas does the same, where you clicked. On a touch screen, pressing and holding the graph does the same, where you held.
RealignTidies the graph into columns — Ctrl + Shift + L. With several nodes selected, only those move.
StraightenA setting on Realign rather than an action: lit, each node lines up on the execution wire arriving at it instead of on a plain column. As its icon, lit while it is on.
PreviewThe Luau this graph produced, picked out of the generated file — P does the same. With nodes selected it shows just what they compiled to.
TargetWhat this graph compiles for. Beside the button that compiles it, because a Roblox-only node being an error in a Lune graph is what it explains. Behind a button that names it, with a warning triangle after Lune.
Compile scriptCompiles this document alone — Ctrl + S. As its icon.
Info
These are three separate floating panels, not one strip. The gaps between them are canvas you can click and drag.
The graph's name only appears here if you ask for it: Show document name in Settings. Without it, unsaved edits are a dot in the same place. The keys these buttons duplicate are on Controls.
A node map's bar
Tank.nodemapnode map
What the same row holds when the open document is a node map rather than a graph.
Write project fileWrites the map into the Rojo project file — Ctrl + S. See Building and Rojo.
A node map is a tree rather than a graph, so it takes a row above the view instead of floating tools, and it has none of the graph tools — there is no canvas for them to act on. That is the shape, not something missing.
Node Design's top bar
Where are you working?
Node Design0.97.4
Across the top of the Node Design window.
Node Designfar leftSays which window you are in, and which build it is.
How custom nodes workthe question markOpens Creating custom nodes — the page about what you are looking at, rather than the documentation's front door.
DocsThis documentation, in its own window. Ctrl + K searches it from here.
Open EditorThe editor, in a new tab. Node Design is a window of its own, not a panel.
Settingsthe gear at the endThis browser's preferences — node corners, wire style and themes — which is what a window that draws nodes all day wants to hand. No project settings: roswaal.json is the repository's and is changed from the editor.
Node Design0.97.4
The same window in the browser preview, marked as one.
Node Designfar left, in blueEvery window of the browser preview says it is one. The packs are the project's own, read out of the browser the same way they are read off disk — Node Design itself works the same in both builds.
DocsThe published documentation — the built-in library. Ctrl + K searches it from here.
Open EditorThe editor, in a new tab.
Settingsthe gear at the endThis browser's preferences — node corners, wire style and themes — which is what a window that draws nodes all day wants to hand. No project settings: roswaal.json is the repository's and is changed from the editor.
Node Design
The web app's bar. Over a node, a second bar switches between its preview and its logic: see Only on a touch screen below.
Node Designfar left, in blueEvery window of the browser preview says it is one. The packs are the project's own, read out of the browser the same way they are read off disk — Node Design itself works the same in both builds.
DocsThe published documentation — the built-in library. Ctrl + K searches it from here. On a tablet or a phone it opens in this tab, and the back button returns.
Open EditorThe editor. On a tablet or a phone it opens in this tab, and the back button returns. Leaving a node with unsaved edits asks first.
Settingsthe gear at the endThis browser's preferences — node corners, wire style and themes — which is what a window that draws nodes all day wants to hand. No project settings: roswaal.json is the repository's and is changed from the editor.
Node Design
The web app's bar, with Docs as its icon so the row holds Settings.
Node Designfar left, in blueEvery window of the browser preview says it is one. The packs are the project's own, read out of the browser the same way they are read off disk — Node Design itself works the same in both builds. The version steps aside on a phone.
DocsThe published documentation — the built-in library. Ctrl + K searches it from here. As its icon. On a tablet or a phone it opens in this tab, and the back button returns.
Open EditorThe editor. On a tablet or a phone it opens in this tab, and the back button returns. Leaving a node with unsaved edits asks first.
Settingsthe gear at the endThis browser's preferences — node corners, wire style and themes — which is what a window that draws nodes all day wants to hand. No project settings: roswaal.json is the repository's and is changed from the editor.
Node Design is reached from the palette icon on the editor's top bar, or at /designer while the daemon is running. What to do once you are in it is on Creating custom nodes.
The documentation's top bar
Which copy are you reading, and on what?
Docs0.97.4
Across the top of this window.
Docsfar leftSays which window you are in, and which build it is. A warning sits beside it when the daemon is not reachable — the built-in library is still documented, your project's own packs are not.
SettingsThis browser's preferences and themes, including the ones that change the pictures on these pages. No project settings here: those are the repository's, and they are changed from the editor.
Open EditorThe editor, in a new tab.
Docs0.97.4
Across the top of these pages on the project site, where there is no daemon behind them.
The mark, and Docsfar leftOpens the editor on your projects. Beside it, the build these pages were generated from.
Try it in your browserThe editor, running in a tab, on a project kept in this browser. No install and no daemon — and no access to a folder on your machine unless you hand one over.
SourceThe repository. Roswaal is 0BSD: read it, fork it, take what you want from it.
Settingsthe gear at the endYour theme and reading face, kept in this browser. The same preference the editor writes, so a scheme picked there is the one these pages are in — and the icon alone, because a published page gives its width to what you came to read.
Docs0.97.4
The web app's header, with the contents behind a button rather than holding a column, and a button for search.
The mark, and Docsfar leftOpens the editor on your projects. Beside it, the build these pages were generated from.
ContentsSlides the contents out over the page. Tap beside them to put them away.
SearchThe search Ctrl + K opens, for a screen with no keyboard.
Try it in your browserThe editor, running in a tab, on a project kept in this browser. No install and no daemon — and no access to a folder on your machine unless you hand one over. On a tablet or a phone it opens in this tab, and the back button returns.
SourceThe repository. Roswaal is 0BSD: read it, fork it, take what you want from it.
Settingsthe gear at the endYour theme and reading face, kept in this browser. The same preference the editor writes, so a scheme picked there is the one these pages are in — and the icon alone, because a published page gives its width to what you came to read.
Docs
The tablet's header in two rows: the mark, Contents and search, then the rest.
The mark, and Docsfar leftOpens the editor on your projects. Beside it, the build these pages were generated from. The version steps aside on a phone.
ContentsSlides the contents out over the page. Tap beside them to put them away.
SearchThe search Ctrl + K opens, for a screen with no keyboard.
Try it in your browsersecond rowThe editor, running in a tab, on a project kept in this browser. No install and no daemon — and no access to a folder on your machine unless you hand one over. On a tablet or a phone it opens in this tab, and the back button returns.
Sourcesecond rowThe repository. Roswaal is 0BSD: read it, fork it, take what you want from it.
Settingssecond row, at the endYour theme and reading face, kept in this browser. The same preference the editor writes, so a scheme picked there is the one these pages are in — and the icon alone, because a published page gives its width to what you came to read.
These are two different headers rather than one header pointing at two places. The window the daemon serves has an editor and a project behind it, so it offers Settings and a way back. The published copy has neither, so it offers the browser preview and the source instead.
The documentation window is reached from the document icon on the editor's top bar, or at /docs. Ctrl + K searches it from the editor and from Node Design without opening it first.
Getting between the three windows
Roswaal is three windows out of one build, and each one can reach the others. On a computer none of them replaces the window you are on; on a phone or a tablet they take turns in one tab, and the back button returns.
To get to
From the editor
From Node Design
From Docs
The editor
—
Open Editor
Open Editor
Docs
The document icon
Docs, or Ctrl + K
—
Node Design
The palette icon
—
Not from here
Settings
The gear
The gear
Settings
Warning
Settings in Node Design and the docs has no Project tab. Project settings are changed from the editor, which has the project open.
Only on a touch screen
Two bars a tablet and a phone have and a computer does not, the same on both. Where they sit is on The Interface.
The action row
Under the graph on a phone or a tablet, and under Node Design's logic graph. Icons or words with Settings → Editor → Action buttons; separate buttons or one bar with Action row.
UndoAs Ctrl + Z. Greyed when there is nothing to undo.
RedoAs Ctrl + Y.
AlignTwo or more selectedLines the selection up on the node picked first, as A does.
CopySomething selectedAs Ctrl + C.
CutSomething selectedAs Ctrl + X.
DuplicateSomething selectedAs Ctrl + D.
DeleteSomething selectedAs Delete.
PasteSomething copiedAs Ctrl + V, where the graph was last touched.
Node Design's bar, on a phone or a tablet
Apply Knockback
Above the node on a phone or a tablet: the pack, the node, and which view of it is showing.
The packSlides the pack's node list out over the editor. Pick a node and it goes away again.
Preview and LogicThe node as a graph draws it, or what it does when it runs.
Luau and NodesWith Logic showingWrite the logic as Luau, or build it from nodes.