Start a Project
A Project is one game: its code and its assets. A person with access to a Project is a Member of it. Everything on this page happens on the Dashboard, at https://app.shell-engine.com.
Sign in
Section titled “Sign in”- Open
https://app.shell-engine.com. - Click Sign in with Google, and choose the Google account of the address you were invited by.
Projects are by invitation, and there is no sign-up. An address that was not invited is told so and is let no further. To get in, ask a Member of a Project to invite you.
The menu
Section titled “The menu”Signed in, the Dashboard has a menu down its left side. On a phone it is a bar at the bottom, with what has no room there behind More.
| In the menu | What it shows |
|---|---|
| Your Projects | The Projects you made |
| Shared with you | The Projects you were invited to |
| New Project | Where a Project is made |
| Agent | On or Off: the Agent in the editor, an agent on your computer instead, and Usage. See Agent |
| People | Everyone you share a Project with. See Working together |
| Appearance | How the Dashboard looks. See Appearance |
| Docs | These pages |
| Your name | Account: who is signed in, and Sign out |
Make a Project
Section titled “Make a Project”Click New Project in the menu, give the Project a name under Its name, and click Make it. The browser goes on to the new Project’s editor. Nothing is in it yet, and no Agent starts: it waits until you ask it in the Agent panel. Your first scene goes on from there.
Your Projects
Section titled “Your Projects”The Dashboard opens on Your Projects: each Project you made is a card. The ones you were invited to are cards under Shared with you, each with the name of its Owner.
| On the card | What it tells |
|---|---|
| A picture | The Project’s Cover. It is drawn from the Project’s address, and says nothing of the game yet |
| The Project’s name | A link to the Project’s page |
| Running or Stopped | Whether the Project’s machine runs now. Suspended where an Admin suspended it: it cannot be opened until that is lifted |
| Changed 3 hours ago | When the Project last changed |
| 3 Members | How many are in it |
| Open | To the editor |
| Play | To the game alone, with no editor around it |
A Project that is stopped
Section titled “A Project that is stopped”A Project stops by itself about 15 minutes after the last Member closed its editor, when the Agent is not working. Nothing is lost by that.
Open starts it again. You see Starting and the Project’s name for some seconds, with a clock that counts up and a tip that changes every few seconds; the page asks again by itself, and then the editor is there with the Project as it was left.
A Host runs a few Projects’ editors at once. When all of them are busy, you see You’re #2 in line. The page keeps your place and opens the editor by itself when it is your turn. If the Project did not start the last time, the page says why, and tries again.
A Project’s page
Section titled “A Project’s page”Click a Project’s name on its card. Its page has the Project’s own address, such as crate-game.shll.games, and tabs:
- Game: the table below.
- Analytics: how the published game is played. For the Owner of a game that can be published. See Analytics.
- Store page: the game’s page in the collection at shell-engine.com/games, marked Draft, Listed or Unlisted. See The Store page.
| On the Game tab | What it is for |
|---|---|
| Published game | For the Owner alone: Publish, Publish again and Unpublish, the week’s plays with a link to Analytics, and the Store page’s standing with Edit store page. See Working together |
| Members | Who is in the Project, and who was invited. See Working together |
| Your computer | Where a computer has your token for the Project: Connected from a computer since a date, and Take it back. See Work on your computer |
| Your allowance | What you have spent on the model this month, here and in your other Projects together, of the allowance an Admin gave you. With none, You have no allowance, with a link to Agent. See Usage |
| Name, Delete | For the Owner alone. See below |
Analytics
Section titled “Analytics”The Analytics tab shows the published game’s page loads, play sessions and play time over the Last 7, 30 or 90 days: by day, by published build, how long sessions last, and on which devices, with the errors each build met. It counts nothing that tells who played: no cookie, no address, no browser details. Each day’s numbers are kept 90 days, and go with the Project when it is deleted.
The Store page
Section titled “The Store page”The Store page tab is the game’s page in the collection at shell-engine.com/games. Any Member of the Project can fill it in and click Save:
- About the game: a Title, a One-line pitch (80 characters), a Genre, up to 5 Tags, and a Description. Use the Gamedoc description fills it in from the Gamedoc.
- Pictures and clip: a cover (16:9, at least 1280 × 720; PNG, JPEG or WebP, 1 MB at most), up to 5 screenshots, and a clip of up to 15 seconds (MP4 or WebM, 8 MB at most) that plays muted on a loop.
- How it plays: its Controls (Keyboard, Mouse, Touch, Gamepad), and whether it plays on a Phone or a Computer.
- Credits: the Members named under “Made by”. A Member switched off here is not named.
- Preview: the page as the collection shows it.
Only the Owner switches on Show on shell-engine.com/games. It needs a published build, a title and a pitch, a cover and a genre, and the page lists what is still missing. An Admin of the Host can take a game off the collection: the tab then says Unlisted, and who did it.
A screenshot or the cover can come from the game itself:
- Play the game in the editor’s Game panel.
- Run Screenshot for the Store Page or Cover for the Store Page from the command palette. Or switch on View → Screenshot Buttons to have Screenshot and Cover over the game.
Each takes the frame the Game panel shows and says where it went, such as Added to the Store page, 2 of 5 screenshots.
Rename or delete a Project
Section titled “Rename or delete a Project”The Member who made a Project is its Owner. Only the Owner sees these two, on the Project’s page.
- Name: type another name and click Rename. The Project’s address stays the one it was.
- Delete this Project: type the Project’s name and click Delete. That takes the Project away from everyone in it: its editor, its game, and its files. Its repository on GitHub stays.
Agent in the menu says On or Off beside its name. The Agent builds in your Projects when you ask it. It is off until an Admin of this host gives you a monthly allowance, and you can run an agent on your computer instead, at any time.
- The Agent in the editor: with it on, the Agent panel shows in the editor, in your browser and in the Shell app, in every Project you open. Off, the page says You have no allowance: to use the Agent in the editor, ask an Admin of this host to give you one. Until then nothing new is asked of the model or counted.
- An agent on your computer instead: your own agent, such as Claude Code, in a folder kept in step with the Project, with the steps with the Shell app and without it. It needs no allowance, is paid by you where you run it, and is not counted under Usage. See Work on your computer.
An Admin can change your allowance or take it back. With none, the Agent panel is no longer shown; your Projects and the Runs already made stay.
The lower part of the Agent page has what your Runs in the editor cost this month, in every Project together, of the allowance an Admin gave you, and the day it is counted again from. Allowances are per Member, not per Project. Usage is no longer an entry of its own in the menu.
Close to it, the meter says Near your allowance. At At your allowance, a Run fails and says so, until the month is counted again: Your allowance for October is spent: $25.00 of $25.00. You can ask again from 1 November. See The Agent.
Appearance
Section titled “Appearance”Appearance in the menu is where the Dashboard’s Theme and Shape are chosen: its colours, and how round it is drawn. The Themes are the editor’s.
- With Follow the system on, you choose one Theme for the day and one for the night.
- The choice is kept in this browser, and is the Dashboard’s alone. Each Project’s editor has a choice of its own, under View, Appearance.
Sign out
Section titled “Sign out”Click your name at the foot of the menu. Sign out is on the Account page that opens.