Kurs JavaScript i React · Moduł 1: Podstawy React
Tworzenie projektu React z Vite
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 reactTo polecenie:
- Używa
npm createdo uruchomienia generatora Vite vite@latestzapewnia użycie najnowszej wersjimoja-aplikacja-reactto nazwa Twojego projektu--template reactwybiera szablon React (dostępne też:react-tsdla TypeScript)
Po utworzeniu projektu przejdź do katalogu i zainstaluj zależności:
cd moja-aplikacja-react
npm installNastępnie uruchom serwer deweloperski:
npm run devTwoja 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:
- Importuje React i ReactDOM
- Tworzy "korzeń" React w elemencie o id
root - Renderuje główny komponent
AppwewnątrzStrictMode
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 Appvite.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 HMRnpm run build- buduje aplikację do wdrożenia produkcyjnegonpm run preview- podgląd zbudowanej wersji produkcyjnej lokalnienpm run lint- sprawdza kod linterem (w aktualnym szablonie: Oxlint)
Vite vs CRA - porównanie
| Cecha | CRA (wycofane) | Vite |
|---|---|---|
| Status | Wycofane, brak aktualizacji | Aktywnie rozwijane |
| Start serwera | 20-40 sekund | 1-2 sekundy |
| HMR | 1-3 sekundy | ~50ms |
| Bundler | Webpack | Rolldown (od Vite 8; wcześniej esbuild + Rollup) |
| Konfiguracja | Ukryta (eject) | Jawna (vite.config.js) |
| Moduły | CommonJS | Natywne ES Modules |
| TypeScript | Wymaga konfiguracji | Dział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. Do czego służy Vite w ekosystemie React?
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: