docs

Kom i gang

CLI-en er én fil uten avhengigheter. Fem kommandoer skiller en tom mappe fra en app i drift i Norge.

Node ≥ 24én filpasskey-innlogging

1. Installer CLI-en

CLI-en er én selvstendig fil som kjører på Node 24 eller nyere — ingen pakkebehandler, ingen avhengigheter. Sjekksummen ligger ved siden av.

curl -fsSL https://nysky.no/cli -o nysky.mjs
curl -fsSL https://nysky.no/cli.sha256          # verifiser gjerne
node nysky.mjs --help

Legg den gjerne på PATH som nysky. Bygger du med en AI-assistent i stedet, trenger du ikke CLI-en selv: be assistenten lese agent.md, så gjør den resten.

2. Logg inn med nysky ID

nysky login

Kommandoen åpner nettleseren; du bekrefter med passkey og krysser av hvilke kontoer maskinen skal ha tilgang til. Ingen API-nøkler å kopiere. nysky login status viser innloggingen, nysky logout --overalt trekker den tilbake på alle maskiner.

3. Beskriv appen i nysky.toml

Minste gyldige manifest for en JS/TS-app:

schema_version = "0.1"
name = "minapp"
main = "src/index.ts"
compatibility_date = "2026-07-01"

Appen er en ES-modul som eksporterer en fetch-handler. Trenger du database, lagring eller eget domene, er det én blokk til per ting — se manifestreferansen. Nye apper uten nivaa starter som Personlig.

4. Kjør lokalt, se planen

nysky dev        # bygg + kjør lokalt
nysky plan       # hva ville deploy endret? (ingen sideeffekter)

plan viser diffen mot det som kjører — nye ruter, endrede bindings, nivåendringer — før du forplikter deg.

5. Deploy

nysky deploy --wait
nysky status

Bundelen bygges deterministisk, lastes opp og konvergeres. Appen svarer på <navn>.nysky.app med gyldig HTTPS med én gang. Hemmeligheter settes skriv-kun før eller etter deploy:

nysky secret put API_NOKKEL   # verdien leses fra stdin

Fem kommandoer fra tom mappe til app i drift.

Appen får adresse og HTTPS automatisk.

Foretrekker du git: nysky git deploy enable gir push-to-deploy.

Videre