Kurs JavaScript i React · Moduł 1: Podstawy React
Instalacja Node.js i npm
W tej lekcji6
Zanim zaczniemy korzystać z React, musimy zainstalować podstawowe narzędzia - Node.js i npm (Node Package Manager). To jak przygotowanie zapasów tlenu i paliwa przed wyruszeniem w kosmos.
Czym jest Node.js?
Node.js to platforma, która pozwala uruchamiać JavaScript poza przeglądarką. Tradycyjnie JavaScript był językiem działającym tylko w przeglądarkach, ale Node.js zmienił to, umożliwiając uruchamianie JavaScript również na serwerach i w narzędziach deweloperskich.
Dla dewelopera React, Node.js jest niezbędny do:
- Uruchamiania lokalnego serwera deweloperskiego
- Korzystania z menedżera pakietów (npm lub yarn)
- Budowania i kompilowania aplikacji
- Uruchamiania narzędzi takich jak lintery, formatery czy testy
Czym jest npm?
npm (Node Package Manager) to największy na świecie rejestr pakietów oprogramowania. To magazyn zawierający miliony pakietów i bibliotek, które możesz dodać do swojego projektu. Wyobraź sobie gigantyczny katalog części zamiennych do statków kosmicznych - cokolwiek potrzebujesz, prawdopodobnie znajdziesz to w npm.
Proces instalacji Node.js i npm
Dla Windows:
- Odwiedź oficjalną stronę Node.js
- Pobierz wersję LTS (Long-Term Support) - ta wersja jest najbardziej stabilna i zalecana dla większości użytkowników
- Uruchom pobrany instalator i postępuj zgodnie z instrukcjami
- Instalator automatycznie zainstaluje zarówno Node.js, jak i npm
Dla macOS:
Opcja 1: Instalator
- Odwiedź Node.js i pobierz instalator dla macOS
- Uruchom instalator i postępuj zgodnie z instrukcjami
Opcja 2: Homebrew (zalecane, jeśli masz już Homebrew)
- Otwórz terminal
- Wpisz:
brew install node
Dla Linux:
Pakiet nodejs z repozytoriów dystrybucji bywa za stary dla Vite (Ubuntu 22.04 instaluje Node 12, Ubuntu 24.04 i Debian 12 - Node 18, a aktualne Vite wymaga Node 20.19 lub nowszego). Najpewniej zainstalujesz aktualną wersję LTS przez nvm (menedżer wersji Node): polecenie instalacji nvm skopiujesz ze strony pobierania nodejs.org (wybierz Linux i nvm), a potem wpiszesz:
nvm install --ltsWeryfikacja instalacji
Po zakończeniu instalacji, otwórz terminal (lub wiersz poleceń) i zweryfikuj instalację, wpisując:
node -v
npm -vPowinieneś zobaczyć numery wersji, na przykład v22.12.0 dla Node.js i 10.9.0 dla npm (u Ciebie mogą być nowsze). Node.js musi mieć co najmniej wersję 20.19, bo tego wymaga Vite. Jeśli widzisz te informacje, gratulacje! Twój statek kosmiczny jest gotowy do podróży.
Alternatywne menedżery pakietów
Oprócz npm, istnieją również alternatywne menedżery pakietów, które możesz rozważyć:
Yarn
Yarn to menedżer pakietów stworzony przez Facebook, który oferuje szybsze pobieranie pakietów i lepsze zarządzanie zależnościami.
Instalacja:
npm install -g yarnpnpm
pnpm to wydajny menedżer pakietów, który oszczędza miejsce na dysku, współdzieląc wspólne zależności między projektami.
Instalacja:
npm install -g pnpmW tym kursie będziemy używać głównie npm, ale wszystkie polecenia mają swoje odpowiedniki w Yarn i pnpm.
Następne kroki
Teraz, gdy masz już zainstalowane Node.js i npm, jesteś gotowy do tworzenia aplikacji React! W następnej lekcji nauczymy się, jak utworzyć nowy projekt React przy użyciu Vite.
Kod do tej lekcji: App.jsx
import React, { useState } from 'react';
// Demonstracja koncepcji npm i zarządzania pakietami w React
function PackageManager() {
const [packages, setPackages] = useState([
{ name: 'react', version: '19.2.0', description: 'Biblioteka do budowania UI' },
{ name: 'react-dom', version: '19.2.0', description: 'Renderowanie React w przeglądarce' },
{ name: 'axios', version: '1.4.0', description: 'Klient HTTP dla API' },
]);
const [newPackage, setNewPackage] = useState('');
const installPackage = () => {
if (newPackage.trim()) {
setPackages([...packages, {
name: newPackage,
version: '1.0.0',
description: 'Nowo zainstalowany pakiet'
}]);
setNewPackage('');
}
};
const removePackage = (name) => {
setPackages(packages.filter(pkg => pkg.name !== name));
};
return (
<div style={{
fontFamily: 'Arial, sans-serif',
maxWidth: '800px',
margin: '0 auto',
padding: '20px'
}}>
<header style={{
background: 'linear-gradient(135deg, #667eea 0%, #764ba2 100%)',
padding: '30px',
borderRadius: '12px',
color: 'white',
textAlign: 'center',
marginBottom: '30px'
}}>
<h1 style={{ margin: 0 }}>NPM Package Manager</h1>
<p style={{ margin: '10px 0 0 0', opacity: 0.9 }}>
Symulacja zarządzania pakietami w projekcie React
</p>
</header>
<div style={{
display: 'flex',
gap: '10px',
marginBottom: '20px'
}}>
<input
type="text"
value={newPackage}
onChange={(e) => setNewPackage(e.target.value)}
placeholder="Nazwa pakietu do instalacji..."
style={{
flex: 1,
padding: '12px 15px',
border: '2px solid #e0e0e0',
borderRadius: '8px',
fontSize: '16px'
}}
/>
<button
onClick={installPackage}
style={{
padding: '12px 24px',
backgroundColor: '#4caf50',
color: 'white',
border: 'none',
borderRadius: '8px',
cursor: 'pointer',
fontWeight: 'bold'
}}
>
npm install
</button>
</div>
<div style={{
backgroundColor: '#1e1e1e',
borderRadius: '8px',
padding: '15px',
marginBottom: '20px',
fontFamily: 'monospace',
color: '#00ff00'
}}>
<div style={{ color: '#888', marginBottom: '5px' }}>$ npm install {newPackage || '<package-name>'}</div>
<div>added 1 package in 0.5s</div>
</div>
<h2 style={{ color: '#333', marginBottom: '15px' }}>
Zainstalowane pakiety ({packages.length})
</h2>
<div style={{ display: 'flex', flexDirection: 'column', gap: '10px' }}>
{packages.map((pkg, index) => (
<div key={index} style={{
display: 'flex',
alignItems: 'center',
padding: '15px',
backgroundColor: '#f8f9fa',
borderRadius: '8px',
border: '1px solid #e0e0e0'
}}>
<div style={{ flex: 1 }}>
<div style={{
fontWeight: 'bold',
color: '#333',
marginBottom: '5px'
}}>
{pkg.name} <span style={{ color: '#666', fontWeight: 'normal' }}>v{pkg.version}</span>
</div>
<div style={{ color: '#666', fontSize: '14px' }}>
{pkg.description}
</div>
</div>
<button
onClick={() => removePackage(pkg.name)}
style={{
padding: '8px 16px',
backgroundColor: '#f44336',
color: 'white',
border: 'none',
borderRadius: '4px',
cursor: 'pointer'
}}
>
Odinstaluj
</button>
</div>
))}
</div>
<div style={{
marginTop: '30px',
padding: '20px',
backgroundColor: '#e3f2fd',
borderRadius: '8px'
}}>
<h3 style={{ color: '#1976d2', marginTop: 0 }}>Podstawowe komendy npm</h3>
<ul style={{ color: '#333', lineHeight: '1.8' }}>
<li><code>npm init</code> - Inicjalizacja nowego projektu</li>
<li><code>npm install</code> - Instalacja wszystkich zależności</li>
<li><code>npm install nazwa-pakietu</code> - Instalacja konkretnego pakietu</li>
<li><code>npm uninstall nazwa-pakietu</code> - Odinstalowanie pakietu</li>
<li><code>npm run dev</code> - Uruchomienie serwera deweloperskiego (projekt Vite)</li>
</ul>
</div>
</div>
);
}
export default function App() {
return <PackageManager />;
}Widzisz błąd w tej lekcji?
Zadania praktyczne w grze
- Układanie w poziomie
Ułóż polecenie instalacji pakietu React za pomocą npm:
- Klikanie w kolejności
Zbuduj polecenie: przejdź do folderu projektu Vite i uruchom serwer deweloperski:
- Układanie w pionie
Ułóż proces instalacji React od zera: