Kurs JavaScript i React · Moduł 1: Podstawy React

Tworzenie projektu React z Vite

5 min czytania ·
W tej lekcji6

W kosmicznej podróży przez świat React potrzebujesz odpowiedniego statku, aby wyruszyć w drogę. Dawniej standardowym wyborem był Create React App (CRA), ale to narzędzie zostało oficjalnie wycofane (deprecated) i nie jest już rozwijane. Współczesnym standardem do tworzenia projektów React jest Vite - ultraszybki bundler nowej generacji.

Ra, nasz kosmiczny przewodnik, mówi: "Porzuć stary wahadłowiec CRA - Vite to nowy napęd warp, który przeniesie Cię w galaktykę React szybciej niż kiedykolwiek!"

Dlaczego Vite?

Vite (wymawiane "vit", z francuskiego "szybki") to nowoczesne narzędzie do budowania aplikacji frontendowych, stworzone przez Evana You (twórcę Vue.js). Dokumentacja React wymienia je (obok Parcel i Rsbuild) wśród zalecanych narzędzi, gdy budujesz aplikację bez frameworka.

Dlaczego Vite zastąpił CRA:

  • Błyskawiczny start serwera - Vite wykorzystuje natywne moduły ES (ESM) przeglądarki, więc serwer deweloperski startuje w 1-2 sekundy (CRA potrzebował 20-40 sekund)
  • Natychmiastowy Hot Module Replacement (HMR) - zmiany w kodzie pojawiają się w przeglądarce w ~50ms, niezależnie od rozmiaru aplikacji
  • Nowoczesna architektura - oparty na ESM zamiast starszego Webpacka
  • Szybkie buildy produkcyjne - od Vite 8 wykorzystuje Rolldown (wcześniej Rollup) do łączenia plików w paczki
  • Wsparcie od razu po instalacji - TypeScript, JSX, CSS Modules, PostCSS działają bez dodatkowej konfiguracji

Tworzenie nowego projektu z Vite

Aby utworzyć nowy projekt React z Vite, otwórz terminal i wpisz:

npm create vite@latest moja-aplikacja-react -- --template react

To polecenie:

  1. Używa npm create do uruchomienia generatora Vite
  2. vite@latest zapewnia użycie najnowszej wersji
  3. moja-aplikacja-react to nazwa Twojego projektu
  4. --template react wybiera szablon React (dostępne też: react-ts dla TypeScript)

Po utworzeniu projektu przejdź do katalogu i zainstaluj zależności:

cd moja-aplikacja-react
npm install

Następnie uruchom serwer deweloperski:

npm run dev

Twoja aplikacja będzie dostępna pod adresem http://localhost:5173 w przeglądarce. Zwróć uwagę - Vite domyślnie używa portu 5173, nie 3000.

Struktura projektu Vite + React

Po utworzeniu projektu zobaczysz następującą strukturę:

moja-aplikacja-react/
├── node_modules/         # Zainstalowane zależności
├── public/               # Pliki statyczne (kopiowane bez zmian)
│   ├── favicon.svg       # Ikona strony
│   └── icons.svg         # Ikony
├── src/                  # Kod źródłowy
│   ├── assets/           # Zasoby (obrazy, fonty)
│   │   └── react.svg     # Logo React
│   ├── App.css           # Style komponentu App
│   ├── App.jsx           # Główny komponent App
│   ├── index.css         # Globalne style
│   └── main.jsx          # Punkt wejściowy aplikacji
├── index.html            # Główny plik HTML (w katalogu głównym!)
├── vite.config.js        # Konfiguracja Vite
├── package.json          # Informacje o projekcie i zależności
├── .gitignore            # Pliki ignorowane przez Git
└── .oxlintrc.json        # Konfiguracja lintera (Oxlint)

Kluczowe różnice w stosunku do CRA

Zauważ kilka istotnych różnic:

  • index.html jest w katalogu głównym, nie w public/ - Vite traktuje go jako punkt wejściowy
  • Pliki używają rozszerzenia .jsx zamiast .js - to jasny sygnał, że plik zawiera JSX
  • Punkt wejściowy to main.jsx, nie index.js
  • vite.config.js zamiast ukrytej konfiguracji Webpacka - masz pełną kontrolę

index.html

W Vite plik index.html jest w katalogu głównym projektu i wygląda tak:

<!DOCTYPE html>
<html lang="en">
  <head>
    <meta charset="UTF-8" />
    <link rel="icon" type="image/svg+xml" href="/vite.svg" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
    <title>Vite + React</title>
  </head>
  <body>
    <div id="root"></div>
    <script type="module" src="/src/main.jsx"></script>
  </body>
</html>

Kluczowa linia to <script type="module" src="/src/main.jsx"></script> - Vite ładuje aplikację jako natywny moduł ES, co zapewnia błyskawiczny start.

src/main.jsx

To punkt wejściowy aplikacji React:

import React from 'react'
import ReactDOM from 'react-dom/client'
import App from './App.jsx'
import './index.css'

ReactDOM.createRoot(document.getElementById('root')).render(
  <React.StrictMode>
    <App />
  </React.StrictMode>,
)

Ten kod:

  1. Importuje React i ReactDOM
  2. Tworzy "korzeń" React w elemencie o id root
  3. Renderuje główny komponent App wewnątrz StrictMode

src/App.jsx

Główny komponent Twojej aplikacji:

import { useState } from 'react'
import reactLogo from './assets/react.svg'
import viteLogo from '/vite.svg'
import './App.css'

function App() {
  const [count, setCount] = useState(0)

  return (
    <>
      <div>
        <a href="https://vite.dev" target="_blank">
          <img src={viteLogo} className="logo" alt="Vite logo" />
        </a>
        <a href="https://react.dev" target="_blank">
          <img src={reactLogo} className="logo react" alt="React logo" />
        </a>
      </div>
      <h1>Vite + React</h1>
      <div className="card">
        <button onClick={() => setCount(c => c + 1)}>
          count is {count}
        </button>
      </div>
    </>
  )
}

export default App

vite.config.js

Plik konfiguracyjny Vite - prosty i czytelny:

import { defineConfig } from 'vite'
import react from '@vitejs/plugin-react'

export default defineConfig({
  plugins: [react()],
})

To wszystko, czego potrzeba! Plugin @vitejs/plugin-react zapewnia wsparcie JSX, Fast Refresh (HMR) i inne funkcje React.

Dostępne skrypty

W package.json projektu Vite znajdziesz:

  • npm run dev - uruchamia serwer deweloperski z HMR
  • npm run build - buduje aplikację do wdrożenia produkcyjnego
  • npm run preview - podgląd zbudowanej wersji produkcyjnej lokalnie
  • npm run lint - sprawdza kod linterem (w aktualnym szablonie: Oxlint)

Vite vs CRA - porównanie

CechaCRA (wycofane)Vite
StatusWycofane, brak aktualizacjiAktywnie rozwijane
Start serwera20-40 sekund1-2 sekundy
HMR1-3 sekundy~50ms
BundlerWebpackRolldown (od Vite 8; wcześniej esbuild + Rollup)
KonfiguracjaUkryta (eject)Jawna (vite.config.js)
ModułyCommonJSNatywne ES Modules
TypeScriptWymaga konfiguracjiDziała od razu

Inne narzędzia w ekosystemie React

Oprócz Vite, warto znać inne popularne narzędzia:

  • Next.js - framework React z SSR (Server-Side Rendering), SSG i routingiem opartym na plikach. Idealny do aplikacji wymagających SEO
  • React Router (dawniej Remix) - framework React skupiony na podstawach sieci i stopniowym ulepszaniu (progressive enhancement)
  • Gatsby - generator statycznych stron z GraphQL

Dla nauki React i budowania aplikacji SPA (Single Page Application), Vite jest najlepszym wyborem - szybki, prosty i wymieniany w dokumentacji React.

Ra podsumowuje: "Vite to silnik nowej generacji Twojego kosmicznego statku React. Szybki start, natychmiastowe reakcje na zmiany kursu i pełna kontrola nad konfiguracją - wszystko, czego potrzebujesz, aby podbić galaktykę!"

Kod do tej lekcji: App.jsx
import React, { useState } from 'react';

// Demonstracja struktury projektu Vite + React
function ViteProjectDemo() {
  const [activeFile, setActiveFile] = useState('App.jsx');

  const fileStructure = [
    { name: 'node_modules/', type: 'folder', description: 'Zainstalowane pakiety' },
    { name: 'public/', type: 'folder', description: 'Pliki statyczne' },
    { name: '  vite.svg', type: 'file', description: 'Logo Vite' },
    { name: 'src/', type: 'folder', description: 'Kod źródłowy' },
    { name: '  assets/', type: 'folder', description: 'Zasoby (obrazy, fonty)' },
    { name: '  App.jsx', type: 'file', description: 'Główny komponent', active: true },
    { name: '  App.css', type: 'file', description: 'Style komponentu' },
    { name: '  main.jsx', type: 'file', description: 'Punkt wejściowy' },
    { name: '  index.css', type: 'file', description: 'Style globalne' },
    { name: 'index.html', type: 'file', description: 'Główny HTML (w katalogu głównym!)' },
    { name: 'vite.config.js', type: 'file', description: 'Konfiguracja Vite' },
    { name: 'package.json', type: 'file', description: 'Konfiguracja projektu' },
  ];

  const fileContents = {
    'App.jsx': `import { useState } from 'react'
import './App.css'

function App() {
  const [count, setCount] = useState(0)

  return (
    <>
      <h1>Vite + React</h1>
      <div className="card">
        <button onClick={() => setCount(c => c + 1)}>
          count is {count}
        </button>
      </div>
    </>
  )
}

export default App`,
    'main.jsx': `import React from 'react'
import ReactDOM from 'react-dom/client'
import App from './App.jsx'
import './index.css'

ReactDOM.createRoot(
  document.getElementById('root')
).render(
  <React.StrictMode>
    <App />
  </React.StrictMode>,
)`,
    'vite.config.js': `import { defineConfig } from 'vite'
import react from '@vitejs/plugin-react'

export default defineConfig({
  plugins: [react()],
})`,
    'package.json': `{
  "name": "moja-aplikacja",
  "version": "0.0.0",
  "type": "module",
  "scripts": {
    "dev": "vite",
    "build": "vite build",
    "preview": "vite preview"
  },
  "dependencies": {
    "react": "^18.2.0",
    "react-dom": "^18.2.0"
  },
  "devDependencies": {
    "@vitejs/plugin-react": "^4.2.0",
    "vite": "^5.0.0"
  }
}`
  };

  return (
    <div style={{
      fontFamily: 'Arial, sans-serif',
      maxWidth: '1000px',
      margin: '0 auto',
      padding: '20px'
    }}>
      <header style={{
        background: 'linear-gradient(135deg, #61dafb 0%, #21a1f1 100%)',
        padding: '30px',
        borderRadius: '12px',
        color: 'white',
        textAlign: 'center',
        marginBottom: '30px'
      }}>
        <h1 style={{ margin: 0, fontSize: '2rem' }}>Vite + React</h1>
        <p style={{ margin: '10px 0 0 0', opacity: 0.9 }}>
          Struktura projektu i podstawowe pliki
        </p>
      </header>

      <div style={{
        backgroundColor: '#1e1e1e',
        borderRadius: '8px',
        padding: '20px',
        marginBottom: '30px',
        fontFamily: 'monospace'
      }}>
        <div style={{ color: '#888', marginBottom: '10px' }}>Terminal:</div>
        <div style={{ color: '#00ff00' }}>$ npm create vite@latest moja-aplikacja -- --template react</div>
        <div style={{ color: '#888', marginTop: '5px' }}>Scaffolding project in /moja-aplikacja...</div>
        <div style={{ color: '#00ff00', marginTop: '5px' }}>Done. Now run: cd moja-aplikacja && npm install && npm run dev</div>
      </div>

      <div style={{ display: 'grid', gridTemplateColumns: '300px 1fr', gap: '20px' }}>
        <div style={{
          backgroundColor: '#252526',
          borderRadius: '8px',
          padding: '15px'
        }}>
          <h3 style={{ color: '#cccccc', margin: '0 0 15px 0', fontSize: '14px' }}>
            EXPLORER
          </h3>
          {fileStructure.map((item, index) => (
            <div
              key={index}
              onClick={() => item.type === 'file' && setActiveFile(item.name.trim())}
              style={{
                padding: '8px 10px',
                color: item.type === 'folder' ? '#dcb67a' : '#9cdcfe',
                cursor: item.type === 'file' ? 'pointer' : 'default',
                backgroundColor: activeFile === item.name.trim() ? '#094771' : 'transparent',
                borderRadius: '4px',
                fontSize: '14px',
                fontFamily: 'monospace'
              }}
            >
              {item.type === 'folder' ? '▸' : '•'} {item.name}
            </div>
          ))}
        </div>

        <div style={{
          backgroundColor: '#1e1e1e',
          borderRadius: '8px',
          padding: '20px'
        }}>
          <div style={{
            color: '#888',
            fontSize: '12px',
            marginBottom: '10px',
            borderBottom: '1px solid #333',
            paddingBottom: '10px'
          }}>
            {activeFile}
          </div>
          <pre style={{
            color: '#d4d4d4',
            margin: 0,
            fontSize: '14px',
            lineHeight: '1.5',
            overflow: 'auto'
          }}>
            {fileContents[activeFile] || '// Wybierz plik z listy'}
          </pre>
        </div>
      </div>

      <div style={{
        marginTop: '30px',
        padding: '20px',
        backgroundColor: '#fff3e0',
        borderRadius: '8px'
      }}>
        <h3 style={{ color: '#e65100', marginTop: 0 }}>Komendy startowe</h3>
        <div style={{ display: 'grid', gridTemplateColumns: 'repeat(2, 1fr)', gap: '15px' }}>
          <div style={{ backgroundColor: 'white', padding: '15px', borderRadius: '8px' }}>
            <code style={{ color: '#e65100' }}>npm run dev</code>
            <p style={{ margin: '5px 0 0 0', fontSize: '14px', color: '#666' }}>
              Uruchamia serwer deweloperski
            </p>
          </div>
          <div style={{ backgroundColor: 'white', padding: '15px', borderRadius: '8px' }}>
            <code style={{ color: '#e65100' }}>npm run build</code>
            <p style={{ margin: '5px 0 0 0', fontSize: '14px', color: '#666' }}>
              Buduje wersję produkcyjną
            </p>
          </div>
        </div>
      </div>
    </div>
  );
}

export default function App() {
  return <ViteProjectDemo />;
}

Hasła z dokumentacji w tej lekcji

Widzisz błąd w tej lekcji?

Sprawdź się

Odpowiedz na pytania z tej lekcji. Wybierz odpowiedź, a od razu zobaczysz, czy jest poprawna.

  1. 1. Do czego służy Vite w ekosystemie React?

  2. 2. Co to jest hot reloading w React?

Zadania praktyczne w grze

  • Klikanie w kolejności

    Ułóż kroki tworzenia pierwszej aplikacji React:

  • Układanie w pionie

    Ułóż etapy transpilacji kodu przez Babel od góry do dołu:

  • Edytor kodu

    Stwórz prosty komponent React App, który wyświetla nagłówek i paragraf powitalny.

  • Klikanie w kolejności

    Zbuduj polecenie tworzące nowy projekt React z Vite:

  1. PytanieNarzędzie Vite
  2. Kliknij w kolejnościSortowanie: Podstawy React
  3. PytanieHot Module Replacement
  4. Ułóż w kolejnościProces transpilacji Babel
  5. Zadanie z kodemPraktyka: Pierwszy komponent App
  6. Kliknij w kolejnościPolecenie tworzenia projektu Vite

Przydatne artykuły