Vibenly Starter Kit: Postav a spusť

Proč to potřebuješ

text

Základní příkazy, spouštění projektu, Git workflow a troubleshooting pro úplného začátečníka. Cíl není naučit tě být vývojář. Cíl je dostat tě přes první build bez paniky.

Kompletní postup

list

→Co je terminál a proč ho vůbec potřebuješ
→Jak otevřít projekt ve složce
→cd, ls, pwd a práce s cestami
→npm install, npm run dev a npm run build
→git status, git add, git commit a git push
→Jak číst chyby bez slepého googlení
→Co dělat, když projekt nejde spustit
→Jak si udržet kontrolu nad změnami

Co je terminál

text

Terminál je textová vrstva nad operačním systémem. Místo klikání píšeš příkazy. Pro první build je důležitý proto, že spouštíš projekt, instaluješ dependencies, kontroluješ Git a čteš chyby z buildů.

Jak otevřít projekt

list

→Otevři terminál v rootu projektu.
→Zkontroluj, kde se nacházíš pomocí `pwd`.
→Přesuň se do správné složky přes `cd`.
→Ověř obsah složky přes `ls`.

Nejdůležitější příkazy

code

bash

pwd
ls
cd moji-slozka
npm install
npm run dev
npm run build
git status
git add .
git commit -m "update"
git push

Co ty příkazy dělají

list

→`pwd` ukáže, kde právě jsi.
→`ls` vypíše soubory a složky.
→`cd` přesuneš do jiné složky.
→`npm install` stáhne dependencies.
→`npm run dev` spustí lokální vývojový server.
→`npm run build` ověří production build.
→`git status` ukáže změny v repu.
→`git add` připraví změny na commit.
→`git commit` uloží snapshot změn.
→`git push` pošle změny na GitHub.

Jednoduchý Git workflow

code

text

1. Udělám změnu
2. Spustím git status
3. Přidám změny přes git add
4. Udělám commit
5. Pošlu změny na GitHub
6. Zkontroluju, že build pořád funguje

Jak číst chyby

warning

Nechoď hned opravovat random soubor. Nejdřív si všimni, kde chyba vznikla, jaký soubor ji vyvolal a jestli jde o chybějící balíček, špatný import, neplatnou proměnnou nebo rozbitý build.

Když projekt nejde spustit

list

→Zkontroluj, jestli jsi ve správné složce.
→Zkontroluj, jestli běží `npm install` bez chyby.
→Zkontroluj, jestli máš správnou verzi Node.
→Podívej se na první error v terminálu, ne jen na poslední řádek.
→Zkus restartovat dev server.
→Ověř, že nejsou rozbité environment variables.

První lokální build

code

bash

npm install
npm run dev
npm run build

Prompt pro první kontrolu projektu

code

text

Zkontroluj můj projekt z pohledu úplného začátečníka.

Řekni mi:
1. jestli jsem ve správné složce,
2. jaké tři příkazy mám zkusit jako první,
3. jak mám číst chybu v terminálu,
4. co je safe krok a co už je zbytečný zásah.

Bezpečné návyky

list

→Nevkládám secrets do terminálu bez rozmyslu.
→Nehádám názvy souborů, když je můžu vypsat.
→Po každé změně kontroluji výstup.
→Po větší úpravě spouštím build.
→Když si nejsem jistý, dělám menší krok.

Checklist kapitoly

9 kroků

✓Vím, co je terminál
✓Umím otevřít projekt ve správné složce
✓Umím ověřit, kde se právě nacházím
✓Umím nainstalovat dependencies
✓Umím spustit lokální server
✓Umím zkontrolovat stav Git
✓Umím udělat commit
✓Umím přečíst základní error
✓Umím ověřit production build

Resources

Materiály ke kapitole

reference

Placené

Základy terminálu — pracovní poznámky

Strukturovaný podklad k této kapitole.

download

Zdarma

Terminal cheat sheet

Krátký přehled příkazů, které potřebuješ v prvním projektu.

reference

Zdarma

Git flow pro začátečníka

Jednoduchý postup: změna → status → add → commit → push.

checklist

Zdarma

Troubleshooting list

Co zkontrolovat, když `npm run dev` nebo `npm run build` padá.

Základy terminálu

Základy terminálu

Proč to potřebuješ

Kompletní postup

Co je terminál

Jak otevřít projekt

Nejdůležitější příkazy

Co ty příkazy dělají

Jednoduchý Git workflow

Jak číst chyby

Když projekt nejde spustit

První lokální build

Prompt pro první kontrolu projektu

Bezpečné návyky

Checklist kapitoly

Resources

Základy terminálu — pracovní poznámky

Terminal cheat sheet

Git flow pro začátečníka

Troubleshooting list

Další kapitoly ve stejném layoutu