2. Prvi koraci
Poglavlje 2

Prvi koraci

Od kloniranja šablona do aplikacije koja radi u potok grupi: tri komande i jedno otpremanje. Na kraju poglavlja je spisak fajlova šablona, sa onima koje menjaš i onima koje ne diraš.

2.1. Šablon

Aplikacija počinje kao kopija repoa potok-vite. Repo je javan, na github.com/aberged/potok-vite:

git clone https://github.com/aberged/potok-vite.git moja-aplikacija
cd moja-aplikacija

Treba ti Node sa npm-om. Šablon koristi Vite 8, TypeScript 6 i Tailwind 4 (@tailwindcss/vite); sve je u package.json, pa ništa ne instaliraš globalno.

2.2. Tri komande

npm install
npm run dev      # lokalno, uz dev mock potok API-ja
npm run build    # tsc + vite build → dist/potok-build.html
npm install
Instalira zavisnosti iz package.json. Jednom, i posle svake izmene zavisnosti.
npm run dev
Pokreće Vite dev server. Na vrhu src/main.ts blok if (import.meta.env.DEV) uvozi src/potok-dev.ts, koji pravi lažni potok: #group-panel-description i oba API-ja, sa podacima u localStorage (poglavlje 13).
npm run build
Pokreće tsc (provera tipova i nekorišćenih promenljivih), pa vite build. Na kraju build-a dodatak potokBuildPlugin spaja sve u jedan fajl, dist/potok-build.html (poglavlje 3).
Napomena

U package.json postoji i npm run preview, ali on služi build bez dev mock-a: blok import.meta.env.DEV se izbacuje iz build-a, pa u preview-u nema potok-a. Aplikaciju proveravaj u npm run dev, a zatim u potok-u.

Važno

Šablon nema testova ni lintera. npm run build je jedina automatska provera: tsc hvata greške u tipovima i nekorišćene promenljive. Ono što build ne hvata opisuje poglavlje 4.

2.3. Otpremanje u potok

Aplikacija ulazi u grupu kao fajl, ne lepljenjem koda u polje opisa:

  1. Pokreni npm run build.
  2. U potok-u otvori grupu, pa Uredi grupu, i na kartici Opis uključi Opis je aplikacija (API).
  3. Klikni Otpremi ZIP, izaberi dist/potok-build.html (ili ZIP u kome je samo on) i klikni Sačuvaj izmene.

Za alternativni opis: u Uredi grupu, pod Alternativni opisi, klikni Novi opis. Upiši ime, uključi Opis je aplikacija (API), otpremi dist/potok-build.html dugmetom Otpremi ZIP i klikni Sačuvaj opis.

Napomena

Starija uputstva kažu da se uključi „Koristi API“ i da se ceo potok-build.html nalepi u Opis. Danas se opcija zove Opis je aplikacija (API), a fajl se otprema dugmetom Otpremi ZIP.

2.4. Fajlovi šablona

FajlŠta jeMenjaš ga?
index.htmlHTML aplikacije; u build ulazi samo sadržaj <body>da
src/main.tskod aplikacije (u šablonu demo)da
src/style.cssulaz za Tailwind; dev mock ga ne čitada
src/potok.tstipovi potok API-ja (potok i window.potok)ne
src/potok-dev.tsdev mock API-ja; ne ulazi u buildne
vite.config.tsTailwind, potokBuildPlugin i licence u build-une
AGENTS.md, CLAUDE.mduputstvo za AI agente; CLAUDE.md samo uvozi AGENTS.mdodeljak „Aplikacija“

src/potok.ts, src/potok-dev.ts i vite.config.ts prate API potok-a i wrapper. Ne menjaj ih, osim ako baš to ne radiš namerno.

Napomena

Pošto su ta tri fajla isti u svakoj aplikaciji, nova verzija šablona (novi pozivi, ispravke dev mock-a) se prenosi kopiranjem baš njih iz novog potok-vite. Tvoj kod u src/main.ts i index.html ostaje isti.

2.5. Od demoa do svoje aplikacije

U šablonu je demo: svaki klik je jedna vrednost {x, y, picture}, a avatar svakog člana stoji tamo gde je poslednji put kliknuo. Demo je mali i pokazuje tri stvari koje gotovo svaka aplikacija radi: čita sve vrednosti, upisuje novu i uživo prati tuđe. Korak po korak ga prolazi poglavlje 5.

  1. Zameni sadržaj <body> u index.html.
  2. Zameni kod u src/main.ts, ali zadrži blok if (import.meta.env.DEV) na vrhu: on uključuje dev mock.
  3. U AGENTS.md, u odeljku „Aplikacija“, opiši šta aplikacija radi, oblik data i kako se stanje računa iz vrednosti.
Napomena

AGENTS.md je uputstvo za AI agente koji rade u repou: komande, šta se menja, pravila i konvencije (komentari u kodu na engleskom, tekst u UI-ju na srpskom). Kad agentu daš opis aplikacije u istom fajlu, on poštuje i pravila iz poglavlja 4.