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.tsblokif (import.meta.env.DEV)uvozisrc/potok-dev.ts, koji pravi lažni potok:#group-panel-descriptioni oba API-ja, sa podacima ulocalStorage(poglavlje 13). npm run build- Pokreće
tsc(provera tipova i nekorišćenih promenljivih), pavite build. Na kraju build-a dodatakpotokBuildPluginspaja sve u jedan fajl,dist/potok-build.html(poglavlje 3).
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.
Š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:
- Pokreni
npm run build. - U potok-u otvori grupu, pa Uredi grupu, i na kartici Opis uključi Opis je aplikacija (API).
- 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.
- Fajl ostaje u pregledaču: potok ga raspakuje i u opis upisuje samo HTML.
- Preuzmi ZIP vraća ono što je trenutno u opisu, kao
index.htmlu ZIP-u. - Forma za izmenu ne pokreće aplikaciju, pa se ona vidi tek na stranici grupe.
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 je | Menjaš ga? |
|---|---|---|
index.html | HTML aplikacije; u build ulazi samo sadržaj <body> | da |
src/main.ts | kod aplikacije (u šablonu demo) | da |
src/style.css | ulaz za Tailwind; dev mock ga ne čita | da |
src/potok.ts | tipovi potok API-ja (potok i window.potok) | ne |
src/potok-dev.ts | dev mock API-ja; ne ulazi u build | ne |
vite.config.ts | Tailwind, potokBuildPlugin i licence u build-u | ne |
AGENTS.md, CLAUDE.md | uputstvo za AI agente; CLAUDE.md samo uvozi AGENTS.md | odeljak „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.
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.
- Zameni sadržaj
<body>uindex.html. - Zameni kod u
src/main.ts, ali zadrži blokif (import.meta.env.DEV)na vrhu: on uključuje dev mock. - U
AGENTS.md, u odeljku „Aplikacija“, opiši šta aplikacija radi, oblikdatai kako se stanje računa iz vrednosti.
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.