Upute za predaju projekta

Povezivanje sa GitHub repozitorijem

###. Stvorite početni commit u lokalnom repozitoriju Svaki Next.js projekt automatski ima incijaliziran lokalni repozitorij. Prije nego ga povežemo sa udaljenim (remote) repozitorijem, potrebno je napraviti commit tj. označiti trenutno stanje aplikacije kao početnu verziju repozitorija.

Koristeći "Terminal" prozor u VS Code-u, provjerite jeste li pozicionirani na root lokaciji projekta i upišite ove naredbe:

git add .
git commit -m "Početni Next.js project"

U ovom primjeru, naredba git add . dodaje (prati) sve trenutačne datoteke, a git commit sprema njihovo stanje pod porukom "Početni Next.js project”.

Stvaranje praznog Github repozitorija

Idući korak nam je stvaranje praznog Github repozitorija kojeg ćemo povezati sa našim lokalnim repozitorijem.

1. Prijavite se na GitHub.
2. Kliknite ➕ New repository (gore desno).
3. U formi unesite:

• Repository name – npr. next-serije
• Visibility – Public
• Nemojte dodavati README, .gitignore ili licence – repo mora ostati prazan.

4. Kliknite "Create repository".
5. GitHub vas preusmjeri na stranicu novog repozitorija; pri vrhu se prikazuje URL s uputama za “Existing repository”. Zapamtite URL svog repozitorija koji će biti u obliku https://github.com/<user>/<ime-projekta>.git

Dodavanje udaljenog repozitorija

Prilikom stvaranja novog repozitorija, Github će vam ispisati upute kako povezati repozitorij sa lokalnom verzijom. Postupak je jednostavan, vratite se u VS Code Terminal:

1. Dodajte novi udaljeni repozitorij pod nekim imenom (uglavnom je to “origin”):

git remote add origin https://github.com/<korisnik>/<ime-projekta>.git

2. Pošaljite lokalne promjene na udaljeni repozitorij:

git push -u origin master

Napomena: Ovisno o postavkama i verzijama Git-a, početna grana repozitorija će vam se zvati master ili main, pa ovisno o tome prilagodite prethodnu naredbu. Ime grane možete provjeriti naredbom git status u Terminalu.

Opcija "-u" postavlja navedenu granu kao tracking granu pa je ubuduće dovoljno pozivati naredbu git push za slanje promjena.

Provjera na Github stranici

1. Osvježite stranicu repozitorija u pregledniku.

2. Datoteke iz vašeg Next.js projekta trebale bi biti vidljive, zajedno s povijesti commit-ova.

3. Aplikacija je sada sinkronizirana s GitHubom i spremna za uvoz u Vercel ili bilo koji drugi CI/CD alat.

Dodavanje novih commita

Sve promjene koje ste napravili unutar vaše aplikacije se neće automatski spremiti u samom repozitoriju. Ukoliko želite ažurirati stanje repozitorija, potrebno je napraviti novi commit. To možete napraviti pomoću dvije naredbe koje smo već koristili:

git add .
git commit -m "Poruka sa opisom promjena"

Na ovaj način, lokalni repozitorij će napraviti novi commit. Ako ga želite odmah poslati i na udaljeni (Github) repozitorij dovoljno je samo upisati još jednu naredbu:

git push

Ako ste povezali Github repozitorij sa Vercel projektom ili nekim drugim alatom za automatski build aplikacije, slanje nove verzije na udaljeni repozitorij će automatski pokrenuti deploy akciju.

Upute za izradu dokumentacije

Na početnu razinu (root) aplikacije dodajte datoteku "README.md". Sadržaj ove datoteke će se prikazivati i na glavnoj stranici Github repozitorija. Ova datoteka bi trebala sadržavati osnove informacije o projektu:

• Naziv i opis projekta: Rečenica ili dvije što aplikacija radi
• Pregled funkcionalnosti: Popis ključnih značajki: početna lista, dinamičke rute, dodavanje/brisanje favorita, stranica /favorites, 404, deploy.
• Upute za lokalno pokretanje 1) git clone, 2) npm install, 3) npm run dev + eventualne napomene (npr. NEXT_PUBLIC_SITE_URL varijabla).
• Build & deploy: Kako pokrenuti next build, kako lokalno testirati aplikaciju (next start), te link na Vercel URL.
• Poznate greške / TODO (Ako postoje) kratko navesti ograničenja ili planirane nadogradnje.

Upute za komentare u kôdu:

• Komentirajte “zašto” i “kako” – nije potrebno objašnjavati očito (“ovo je gumb”), nego opisati npr. zašto se koristi neka funkcija (npr. useTransition) ili zašto je Route Handler cache: "no-store".
• Na početku svake veće komponente ili server-datoteke stavite blok-komentar od 1-2 rečenice koji opisuje svrhu te komponente/stranice.
• Za kompleksnije funkcije (sortiranje, filtriranje) kratko navedite kako ste osmislili logiku/algoritam te funkcionalnosti ili izvor inspiracije (link na dokumentaciju, StackOverflow i sl.).

Video dokumentacija

Iskoristite neki od dostupnih alata (OBS, Loom, Screen-Cast-O-Matic – bilo koji alat koji snima ekran + glas) kako bi snimili kratku (5-10 min.) prezentaciju svog projekta. U samoj prezentaciji demonstrirajte koje funkcionalnosti ste implementirali u vašoj aplikaciji (putem sučelja, u ulozi korisnika aplikacije), te možete dati kratki osvrt kako ste neku od tih funkcionalnosti implementirali u samom kôdu.

Predaja projekta

Na portalu "edit.dalmacija.hr" je otvoren link za predaju dovršenih projekata. Prilikom predaje je potrebno upisati:

• Adresu Github repozitorija sa vašim projektom
• URL aplikacije na Vercel-u (ili nekom drugom servisu)
• Link na video prezentaciju

Gotovu prezentaciju (video) možete uploadati na EDIT portalu ili je postaviti na neki online video servis kao Youtube te poslati link (možete poslati link i na Google Drive/Dropbox/OneDrive koji sadrži video datoteku). Na portalu se mogu predati datoteke max. veličine do 100 MB.