Getting started
Serin is a development server you open from the iPad app, the Mac app, or any browser at serin.work. Your files stay on the server, so every device sees the same folder.
1. Get a server
There are two kinds, and the apps show both side by side.
- Hosted. Sign in to the app and choose Create a Server. Serin runs it for you. It sleeps when nobody is using it and wakes when you open it.
- Your own. Run the Serin server on a Mac or Linux computer. It prints a one-time pairing code, valid for 30 minutes. In the app, choose Pair a Server and enter it.
npm run service -- install # starts at login, restarts if it stops2. Open it
The iPad and Mac apps do the same things: editor, terminal, live preview, Git and agents. serin.work shows every server in a browser, with its files, your Drive and the day’s activity. The apps have serin.work built in: use the toggle next to the sidebar button, or ⇧⌘D.
3. Start a workspace
Choose New Workspace. Starter builds one from the list below, Open Folder uses a folder already on the server, and Clone from Git takes a Git URL. Give it a name, optionally ask an agent to do something first, then choose Create and Run. It installs, starts, and opens in the preview.
| Starter | What it is |
|---|---|
| Next.js | A React app with the App Router and TypeScript. |
| Vite + React | A single-page React app that reloads in place. |
| Website | Plain HTML, CSS and JavaScript. Nothing to install. |
| Astro blog | A blog with posts written in Markdown. |
| Express API | A JSON API in Node.js, with tests. |
| FastAPI | A Python API with docs you can try. |
| Empty | A README and a Git repository. |
4. Run it
The Run button starts the workspace’s default target and opens its preview. Serin finds targets in:
package.jsonscripts nameddev,start,serveordevelop, in the root and in a monorepo’s packages- Django (
manage.py), FastAPI, Flask, Rails and Go - A
Procfile, andMakefiletargets nameddev,run,serveorstart
Every target gets PORT and HOST and listens on 127.0.0.1. When detection gets it wrong, list your own in .serin/run.json.
Keys worth knowing
| Keys | Where | What |
|---|---|---|
| ⌘K | serin.work | Go to any file, server, workspace or page, or run a command |
| ⌘/ | serin.work | Every keyboard shortcut |
| ⌘P | iPad and Mac | Open a file by name |
| ⇧⌘D | iPad and Mac | serin.work inside the app |