Getting Started5 min read

Quickstart

Go from zero to a live, deployed application in under five minutes. This guide covers everything — from creating an account to sharing a public URL.

1

Sign up & log in

Head to spinini.com and click Sign up. You can register with your GitHub account for the fastest experience — your repositories will be available to import immediately.

If you prefer email + password, verify your email address and you'll be taken straight to your dashboard.

💡 Tip — Signing up with GitHub grants read access to your public repos and lets you import starter templates in one click.
2

Create a project

From your dashboard, click + New Project. You have three options:

  • Template — Start from a pre-configured stack (Next.js, Flask, Express, etc.).
  • Import from GitHub — Clone any public or private repository you own.
  • Blank project — An empty environment with your choice of language.

For this guide, select the Node.js template. Name your project and click Create. Your environment will boot in under 10 seconds.

📝 Note — Each project gets its own isolated Docker container with dedicated CPU and RAM. No neighbours, no shared state.
3

Write & run your code

You'll land in the Spinini IDE — Monaco editor on the left, live preview on the right, integrated terminal at the bottom. Open index.js and replace the contents with:

const http = require('http')

const server = http.createServer((req, res) => {
  res.writeHead(200, { 'Content-Type': 'text/plain' })
  res.end('Hello from Spinini!\n')
})

server.listen(3000, () => {
  console.log('Server running on port 3000')
})

Open the terminal (Ctrl `) and run:

node index.js

The live preview panel on the right will reload automatically and show Hello from Spinini!.

💡 Tip — Use the AI Agent panel (press Ctrl Shift A) to generate code, fix errors, or add features just by describing them in plain English.
4

Add environment variables

Secret keys and config values should never be hardcoded. Open Project Settings → Environment and add your variables. They are encrypted at rest and injected at runtime.

// Access your env vars as usual
const apiKey = process.env.MY_API_KEY
const dbUrl  = process.env.DATABASE_URL

Variables are available immediately — no restart required. You can also maintain separate sets for Development and Production.

⚠️ Warning — Never commit .env files to your repository. Use the Environment panel instead.
5

Deploy your app

Click the Deploy button in the top-right corner of the editor. Spinini will:

  1. 1.Build your project inside a fresh container.
  2. 2.Run any start script defined in your package.json.
  3. 3.Assign a public URL at <project>.spinini.app.
  4. 4.Provision a free TLS certificate automatically.

Deployments typically finish in 30–60 seconds. Share the live URL with anyone — no sign-in required for visitors.

💡 Tip — Want your own domain? See the Custom domains guide to point an existing domain at your project in minutes.

Next steps

Using the AI Agent →Let the agent write entire features for you.Connect a database →Add Postgres to your project in one click.Custom domains →Map your own domain to a deployed project.Invite collaborators →Code together in real time with your team.