Skip to content

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.

  1. Open https://app.shell-engine.com.
  2. 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.

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 menuWhat it shows
Your ProjectsThe Projects you made
Shared with youThe Projects you were invited to
New ProjectWhere a Project is made
AgentOn or Off: the Agent in the editor, an agent on your computer instead, and Usage. See Agent
PeopleEveryone you share a Project with. See Working together
AppearanceHow the Dashboard looks. See Appearance
DocsThese pages
Your nameAccount: who is signed in, and Sign out

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.

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 cardWhat it tells
A pictureThe Project’s Cover. It is drawn from the Project’s address, and says nothing of the game yet
The Project’s nameA link to the Project’s page
Running or StoppedWhether the Project’s machine runs now. Suspended where an Admin suspended it: it cannot be opened until that is lifted
Changed 3 hours agoWhen the Project last changed
3 MembersHow many are in it
OpenTo the editor
PlayTo the game alone, with no editor around it

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.

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 tabWhat it is for
Published gameFor 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
MembersWho is in the Project, and who was invited. See Working together
Your computerWhere 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 allowanceWhat 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, DeleteFor the Owner alone. See below

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 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:

  1. Play the game in the editor’s Game panel.
  2. 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.

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 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.

Click your name at the foot of the menu. Sign out is on the Account page that opens.