Miranda Bender Vite

Tento balíček slouží jako základ pro rychlý vývoj a build šablon s Vite.

Rychlý start

1. Inicializace projektu

   Vytvoř si nový adresář a nainstaluj balíček:

   npm install miranda-bender-vite

   Poté spusť inicializaci, která vytvoří složku src a základní config.json a přidá potřebné skripty do tvého package.json:

   npx miranda-bender init

2. Struktura projektu

   Po inicializaci budeš mít:

   • složku src/js a src/scss s ukázkovými soubory
   • soubor config.json v rootu
   • v package.json přidané skripty:
     • dev – spustí vývojový server
     • dev:blank – spustí vývojový server v blank režimu
     • build – build projektu

3. Použití

   Spusť vývojový server:

   npm run dev

   nebo build:

   npm run build

4. Konfigurace

   V souboru config.json nastav:

   • sourceUrl – zdrojová URL pro proxy
   • blankMode – true/false pro blank režim

5. Poznámky

   • Složky src a dist jsou vždy ve tvém projektu, ne v balíčku.
   • Příkaz preview není součástí skriptů.
   • Pro další úpravy si přizpůsob vlastní src a config.json.

Poznámka k optimalizaci obrázků

Při každém spuštění buildu (npm run build) probíhá optimalizace všech obrázků ve složce src/assets znovu, protože složka dist/ se vždy maže. To je vlastnost Vite a pluginu vite-plugin-imagemin – neuchovává optimalizované assety mezi buildy. Pokud potřebuješ rychlejší buildy, doporučuje se optimalizovat obrázky jednorázově mimo Vite a do projektu vkládat už optimalizované soubory.

Aktualizace po update balíčku

Pokud aktualizuješ balíček miranda-bender-vite (např. pomocí npm update), zkontroluj případné změny v vite.config.js:

• Tento soubor se při inicializaci kopíruje do rootu projektu a dále se automaticky nepřepisuje.
• Po updatu balíčku porovnej svůj vite.config.js s novou verzí v node_modules/miranda-bender-vite/vite.config.js.
• Proveď případné změny ručně (například pomocí diff nástroje nebo porovnání ve VS Code).
• Pokud chceš přepsat celý soubor, můžeš jej zkopírovat z balíčku, ale pozor na vlastní úpravy.

Pro více informací si projdi komentáře v vite.config.js nebo kontaktuj autora.