CLI alat

kružić CLI je alat za objavljivanje igara, lokalno testiranje i upravljanje verzijama — sve iz terminala. Radi i za ručni deploy i za CI/CD.

Instalacija

npm install -g kruzic

Autentifikacija

Prijava

kruzic login

Otvara browser za prijavu sa kružić nalogom. Token se čuva lokalno nakon prijave.

CI/CD okruženje

U automatizovanim sistemima nema browsera, pa koristite pristupni token:

Na sajtu otvorite podešavanja naloga
Kreirajte pristupni token u sekciji “Pristupni tokeni”
Postavite ga kao environment varijablu:

export KRUZIC_TOKEN="vaš-token"

Ostalo

kruzic whoami   # Ko je ulogovan + timovi
kruzic logout   # Briše lokalni token

Povezivanje projekta

Svaki projekat mora biti povezan sa igrom na platformi pre deploy-a:

kruzic link

Birate tim i igru interaktivno. Komanda kreira kruzic.json:

{
  "gameId": "moja-igra",
  "sourceDir": ".",
  "entryPoint": "index.html"
}

Za uklanjanje veze: kruzic unlink

Lokalni razvoj

kruzic dev

Pokreće lokalni dev server sa dashboard-om za testiranje igre i SDK integracije. Nije potrebna prijava niti deploy — sve radi lokalno.

Server čita kruzic.json za source direktorijum, pa igra mora biti povezana (kruzic link) pre pokretanja.

Šta dobijate

Dashboard na http://localhost:4000 sa dva panela:

Levi panel — kontrole za simulaciju SDK-a:
- Korisnik: toggle za prijavu, podešavanje ID-ja, imena i avatara
- Podaci: pregled i editovanje korisničkih podataka igre
- Log: svi SDK pozivi u realnom vremenu
Desni panel — iframe sa igrom, play/stop/reload kontrole

Svi SDK pozivi (auth, storage, leaderboard) se simuliraju lokalno preko localStorage-a. Igra se automatski reload-uje kad izmenite fajlove u source direktorijumu.

Port

Podrazumevani port je 4000. Ako vam je zauzet:

kruzic dev --port 8080

Deploy

kruzic deploy

Pakuje source direktorijum u ZIP, otprema ga i kreira novu test verziju. Ako već postoji test verzija, zamenjuje je.

Flag	Opis
`--changelog "tekst"`	Opis izmena (vidljiv korisnicima)
`--yes`	Bez interaktivnih potvrda — za CI/CD

# Sa opisom izmena
kruzic deploy --changelog "Popravljen bug sa zvukom"

# CI/CD deploy
kruzic deploy --yes --changelog "Automatski deploy iz CI"

Promovisanje

kruzic promote

Šalje test verziju na pregled adminu. Kad odobri — igra je javna.

Flag	Opis
`--release <id>`	Promoviše konkretnu verziju umesto najnovije

SDK komande

kruzic sdk              # Pregled konfiguracije
kruzic sdk enable       # Uključi SDK
kruzic sdk disable      # Isključi SDK
kruzic sdk schema       # Prikaži polja podataka
kruzic sdk data         # Prikaži korisničke podatke

Konfiguracija

Fajl	Lokacija	Namena
`credentials.json`	`~/.kruzic/`	Token za prijavu
`kruzic.json`	Koren projekta	Veza direktorijum ↔ igra

KRUZIC_TOKEN env varijabla ima prioritet nad credentials.json.

Primer toka

# Setup (jednom)
npm install -g kruzic
kruzic login

# Novi projekat
cd moja-igra/
kruzic link

# Lokalno testiranje
kruzic dev
# ... igrate, testirate SDK, gledate logove ...

# Deploy kad ste zadovoljni
kruzic deploy --changelog "Prva verzija"
# ... testirate na sajtu ...
kruzic promote
# Admin odobrava → igra je javna

# Sledeće ažuriranje
kruzic deploy --changelog "Dodato 5 novih nivoa"
kruzic promote