Kurs Next.js · Moduł 1: Konfiguracja Next.js

Instalacja i konfiguracja środowiska programistycznego

8 min czytania ·
W tej lekcji15

W Metropolii Quantum, zanim inżynier może rozpocząć pracę nad systemami miasta, musi przygotować swoje biometryczne stanowisko kwantowe. Podobnie, jako programista Next.js, musisz najpierw skonfigurować swoje środowisko deweloperskie. W tym module nauczysz się, jak zainstalować i skonfigurować wszystkie niezbędne narzędzia do tworzenia aplikacji w Next.js 16.

Wymagania systemowe

Zanim rozpoczniemy instalację, upewnij się, że Twój komputer spełnia minimalne wymagania. Podobnie jak kwantowe terminale w Metropolii Quantum wymagają określonych specyfikacji energetycznych, tak środowisko Next.js potrzebuje odpowiednich wersji oprogramowania:

  • Node.js - wersja 20.9 lub nowsza (Next.js 16 nie obsługuje już Node.js 18; najlepiej wybierz aktualną wersję LTS)
  • TypeScript (opcjonalnie) - wersja 5.1 lub nowsza
  • macOS, Windows (w tym WSL) lub Linux
  • Minimum 1GB RAM (zalecane 4GB lub więcej dla większych projektów)
  • Edytor kodu - zalecane Visual Studio Code z rozszerzeniami dla React/Next.js

Instalacja Node.js i npm

Node.js to jak generator energii kwantowej dla Twojego środowiska deweloperskiego - zasila wszystkie procesy i narzędzia.

Windows i macOS

  1. Odwiedź oficjalną stronę Node.js
  2. Pobierz i zainstaluj najnowszą wersję LTS (Long Term Support)
  3. Sprawdź instalację, otwierając terminal i wpisując:
node -v
npm -v

Powinieneś zobaczyć numery wersji Node.js i npm (Node Package Manager).

Linux (Ubuntu/Debian)

# Repozytoria Ubuntu 22.04/24.04 i Debiana 12 mają za stary Node.js (12 lub 18),
# a Next.js 16 wymaga wersji 20.9 lub nowszej. Zainstaluj aktualne LTS z NodeSource:
curl -fsSL https://deb.nodesource.com/setup_24.x | sudo -E bash -
sudo apt install nodejs

Zarządzanie wersjami Node.js

Dla bardziej zaawansowanych użytkowników, podobnie jak inżynierowie Metropolii Quantum używają systemów wirtualizacji do testowania różnych konfiguracji energetycznych, możesz użyć narzędzi do zarządzania wersjami Node.js:

  • nvm (Node Version Manager) dla macOS/Linux
  • nvm-windows dla Windows
# Instalacja nvm (macOS/Linux)
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.3/install.sh | bash

# Instalacja określonej wersji Node.js
nvm install 24
nvm use 24

Instalacja edytora kodu

W Metropolii Quantum holograficzne edytory kodu są zintegrowane z neuronowymi implantami inżynierów. Na szczęście w naszym świecie wystarczy zainstalować dobry edytor kodu na komputerze. Visual Studio Code to obecnie jeden z najpopularniejszych edytorów dla programistów Next.js.

  1. Pobierz i zainstaluj Visual Studio Code
  2. Zainstaluj przydatne rozszerzenia:
    • ES7+ React/Redux/React-Native snippets - szablony kodu
    • ESLint - analiza statyczna kodu
    • Prettier - formatowanie kodu
    • Tailwind CSS IntelliSense (jeśli planujesz używać Tailwind CSS)
    • GitHub Copilot (opcjonalnie) - asystent AI dla programistów

Tworzenie nowego projektu Next.js

Teraz, gdy masz już zainstalowane niezbędne narzędzia, możesz stworzyć swój pierwszy projekt Next.js 16. Vercel udostępnia wygodne narzędzie create-next-app, które automatycznie konfiguruje projekt z najlepszymi praktykami.

npx create-next-app@latest my-quantum-app

Podczas instalacji zostaniesz poproszony o odpowiedź na kilka pytań konfiguracyjnych:

Would you like to use the recommended Next.js defaults? No, customize settings
Would you like to use TypeScript? Yes
Which linter would you like to use? ESLint
Would you like to use React Compiler? No
Would you like to use Tailwind CSS? Yes
Would you like your code inside a `src/` directory? Yes
Would you like to use App Router? (recommended) Yes
Would you like to customize the import alias (`@/*` by default)? No
Would you like to include AGENTS.md to guide coding agents to write up-to-date Next.js code? Yes

W Next.js 16 kreator zaczyna od pytania o zalecane ustawienia domyślne: odpowiedź "Yes, use recommended defaults" od razu wybiera TypeScript, ESLint, Tailwind CSS, App Router i plik AGENTS.md. Wybieramy "No, customize settings", bo chcemy dodatkowo umieścić kod w katalogu src/. React Compiler, który automatycznie memoizuje komponenty, na razie zostawiamy wyłączony, a AGENTS.md to plik z instrukcjami dla asystentów AI, wskazujący im dokumentację zgodną z zainstalowaną wersją Next.js.

Zalecamy odpowiedź "Yes" na większość pytań, zwłaszcza dotyczących TypeScript i App Router, które są kluczowe dla nowoczesnych aplikacji Next.js 16.

Po zakończeniu instalacji przejdź do katalogu projektu i uruchom serwer deweloperski:

cd my-quantum-app
npm run dev

Twoja aplikacja powinna być teraz dostępna pod adresem http://localhost:3000.

Alternatywne metody instalacji

Yarn

Jeśli wolisz używać Yarn zamiast npm:

npm install -g yarn
yarn create next-app my-quantum-app

pnpm

pnpm to alternatywny menedżer pakietów, który może zaoszczędzić miejsce na dysku:

npm install -g pnpm
pnpm create next-app my-quantum-app

Konfiguracja TypeScript

TypeScript to jak system bezpieczeństwa w Metropolii Quantum - zapobiega błędom przed ich wystąpieniem. Next.js ma wbudowane wsparcie dla TypeScript, a najnowsze wersje create-next-app skonfigurują go automatycznie. Jeśli tworzysz projekt ręcznie, możesz dodać TypeScript później:

touch tsconfig.json
npm run dev

Next.js wykryje plik tsconfig.json, sam zainstaluje brakujące zależności (typescript, @types/react, @types/node) i uzupełni plik zalecaną konfiguracją.

Struktura projektu Next.js 16 z App Routerem

Po utworzeniu nowego projektu zobaczysz następującą strukturę katalogów:

my-quantum-app/
├── node_modules/      # Zainstalowane zależności
├── public/            # Statyczne pliki (obrazy, czcionki)
├── src/               # Kod źródłowy aplikacji
│   ├── app/           # Katalog App Router
│   │   ├── layout.tsx # Główny układ
│   │   ├── page.tsx   # Strona główna
│   │   └── globals.css # Style globalne (tu konfigurujesz też Tailwind CSS 4)
├── AGENTS.md          # Wskazówki dla asystentów AI
├── CLAUDE.md          # Odsyła do AGENTS.md
├── eslint.config.mjs  # Konfiguracja ESLint (format flat config)
├── next-env.d.ts      # Typy Next.js dla TypeScript
├── next.config.ts     # Konfiguracja Next.js
├── package.json       # Zależności i skrypty
├── postcss.config.mjs # Konfiguracja PostCSS (wtyczka Tailwind CSS)
└── tsconfig.json      # Konfiguracja TypeScript

W porównaniu ze starszymi wersjami zniknął plik tailwind.config.js: Tailwind CSS 4, który instaluje create-next-app, konfigurujesz bezpośrednio w globals.css. ESLint korzysta z nowego formatu eslint.config.mjs, a konfiguracja Next.js powstaje od razu w TypeScript jako next.config.ts.

Konfiguracja ESLint

ESLint to jak system monitorowania jakości powietrza w Metropolii Quantum - dba o czystość i jakość kodu. create-next-app tworzy podstawową konfigurację ESLint w pliku eslint.config.mjs (format flat config), a skrypt npm run lint uruchamia po prostu polecenie eslint. Next.js 16 usunął dawne polecenie next lint i nie sprawdza już kodu podczas next build, więc lintera uruchamiasz sam. Konfigurację możesz rozszerzyć, np. o Prettiera:

npm install --save-dev eslint-config-prettier eslint-plugin-prettier

Następnie zaktualizuj plik eslint.config.mjs:

// eslint.config.mjs
import { defineConfig, globalIgnores } from 'eslint/config';
import nextVitals from 'eslint-config-next/core-web-vitals';
import nextTs from 'eslint-config-next/typescript';
import prettierRecommended from 'eslint-plugin-prettier/recommended';

const eslintConfig = defineConfig([
  ...nextVitals,
  ...nextTs,
  {
    rules: {
      '@typescript-eslint/no-unused-vars': 'warn',
    },
  },
  prettierRecommended,
  globalIgnores(['.next/**', 'out/**', 'build/**', 'next-env.d.ts']),
]);

export default eslintConfig;

Konfiguracja eslint-plugin-prettier/recommended włącza regułę prettier/prettier i jednocześnie wyłącza reguły ESLinta, które kłóciłyby się z formatowaniem Prettiera, dlatego stoi pod koniec listy. Sprawdzenie całego projektu uruchomisz poleceniem npm run lint.

Konfiguracja Prettier

Prettier to jak automatyczny system organizacji przestrzeni w Metropolii Quantum - dba o spójny wygląd kodu. Utwórz plik .prettierrc w katalogu projektu:

{
  "semi": true,
  "trailingComma": "all",
  "singleQuote": true,
  "printWidth": 80,
  "tabWidth": 2
}

Konfiguracja VSCode dla projektu

Aby edytor VS Code był w pełni zintegrowany z Twoim projektem, utwórz katalog .vscode w katalogu głównym projektu, a następnie plik settings.json wewnątrz:

{
  "editor.formatOnSave": true,
  "editor.defaultFormatter": "esbenp.prettier-vscode",
  "editor.codeActionsOnSave": {
    "source.fixAll.eslint": true
  },
  "typescript.tsdk": "node_modules/typescript/lib",
  "typescript.enablePromptUseWorkspaceTsdk": true
}

Konfiguracja zmiennych środowiskowych

W Metropolii Quantum każdy system ma swoje specjalne parametry dostępu. W Next.js używamy zmiennych środowiskowych do przechowywania wrażliwych informacji i konfiguracji specyficznych dla środowiska. Utwórz plik .env.local w katalogu głównym projektu:

# Przykładowe zmienne środowiskowe
DATABASE_URL=your_database_url
API_KEY=your_api_key
NEXT_PUBLIC_API_URL=https://api.example.com

Zmienne z prefiksem NEXT_PUBLIC_ będą dostępne również w przeglądarce.

Testowanie instalacji

Aby upewnić się, że wszystko działa prawidłowo, zmodyfikuj trochę kod w pliku src/app/page.tsx i zobacz, czy zmiany są widoczne w przeglądarce. Jeśli tak, Twoje środowisko jest poprawnie skonfigurowane!

Najczęstsze problemy i rozwiązania

Problem z portami

Jeśli port 3000 jest już zajęty, możesz uruchomić Next.js na innym porcie:

npm run dev -- -p 3001

Problemy z Node.js

Jeśli napotkasz błędy związane z kompatybilnością wersji Node.js, upewnij się, że używasz wymaganej wersji:

node -v
# Jeśli wersja jest za stara, zaktualizuj Node.js lub użyj nvm

Problemy z TypeScript

Jeśli napotkasz błędy TypeScript, sprawdź, czy masz zainstalowane odpowiednie typy:

npm install --save-dev @types/react @types/node

Zaawansowana konfiguracja

Dla bardziej zaawansowanych projektów, podobnie jak zaawansowane systemy w Metropolii Quantum wymagają dodatkowej konfiguracji, możesz dostosować swoje środowisko Next.js:

Dodanie aliasów ścieżek

Zmodyfikuj tsconfig.json, aby dodać aliasy ścieżek:

{
  "compilerOptions": {
    "baseUrl": ".",
    "paths": {
      "@/components/*": ["src/components/*"],
      "@/lib/*": ["src/lib/*"],
      "@/styles/*": ["src/styles/*"],
      "@/utils/*": ["src/utils/*"]
    }
  }
}

Konfiguracja testów

Dodaj do projektu Jest i React Testing Library:

npm install --save-dev jest @testing-library/react @testing-library/jest-dom jest-environment-jsdom

Utwórz plik jest.config.js:

const nextJest = require('next/jest');

const createJestConfig = nextJest({
  dir: './',
});

const customJestConfig = {
  setupFilesAfterEnv: ['<rootDir>/jest.setup.js'],
  testEnvironment: 'jest-environment-jsdom',
};

module.exports = createJestConfig(customJestConfig);

Następnie utwórz plik jest.setup.js:

import '@testing-library/jest-dom';

Podsumowanie

Gratulacje! Tak jak inżynier w Metropolii Quantum, który ukończył konfigurację swojego stanowiska roboczego, Ty również masz teraz w pełni skonfigurowane środowisko deweloperskie dla Next.js 16. Twoje holograficzne terminale (czyli edytor kodu) są gotowe, reaktor kwantowy (Node.js) jest uruchomiony, a systemy bezpieczeństwa (TypeScript, ESLint) są aktywne.

W następnej lekcji dowiemy się więcej o inicjalizacji projektu i dostępnych starterach, które pozwolą Ci szybciej rozpocząć pracę nad konkretnymi typami aplikacji.

Kod do tej lekcji: index.html
<!DOCTYPE html>
<html lang="pl">
<head>
  <meta charset="UTF-8">
  <title>Virtual DOM - Metropolis Quantum</title>
  <style>
    body {
      font-family: 'Courier New', monospace;
      background: linear-gradient(135deg, #0f0f23 0%, #1a1a2e 100%);
      color: #64ffda;
      padding: 20px;
      margin: 0;
    }
    .container {
      max-width: 800px;
      margin: 0 auto;
      background: rgba(255, 255, 255, 0.1);
      padding: 20px;
      border-radius: 10px;
      border: 1px solid #64ffda;
    }
    h1 {
      color: #64ffda;
      text-align: center;
    }
    .comparison {
      display: grid;
      grid-template-columns: 1fr 1fr;
      gap: 20px;
      margin-top: 20px;
    }
    .method {
      background: rgba(0, 0, 0, 0.5);
      padding: 15px;
      border-radius: 8px;
      border: 2px solid #448aff;
    }
    .method h3 {
      color: #448aff;
      margin-top: 0;
    }
    .demo-box {
      background: rgba(100, 255, 218, 0.1);
      padding: 10px;
      border-radius: 5px;
      margin: 10px 0;
      border: 1px solid #64ffda;
    }
    button {
      background: linear-gradient(45deg, #7c4dff, #e91e63);
      color: white;
      border: none;
      padding: 10px 20px;
      border-radius: 5px;
      cursor: pointer;
      font-weight: bold;
      margin: 5px;
    }
    button:hover {
      transform: scale(1.05);
      box-shadow: 0 5px 15px rgba(124, 77, 255, 0.4);
    }
  </style>
</head>
<body>
  <div class="container">
    <h1>Virtual DOM a prawdziwy DOM</h1>

    <div class="comparison">
      <div class="method">
        <h3>Tradycyjna manipulacja DOM</h3>
        <div id="traditional-demo" class="demo-box">
          Licznik: <span id="trad-count">0</span>
        </div>
        <button onclick="traditionalUpdate()">Aktualizuj (wolno)</button>
        <p>Każda zmiana → Pełny re-render strony</p>
      </div>

      <div class="method">
        <h3>Virtual DOM (sposób Reacta)</h3>
        <div id="virtual-demo" class="demo-box">
          Licznik: <span id="virt-count">0</span>
        </div>
        <button onclick="virtualUpdate()">Aktualizuj (szybko)</button>
        <p>Zmiana → Diff → Tylko niezbędne aktualizacje</p>
      </div>
    </div>

    <div style="margin-top: 30px; background: rgba(124, 77, 255, 0.2); padding: 15px; border-radius: 8px;">
      <h3>Jak działa Virtual DOM?</h3>
      <ol style="line-height: 1.8;">
        <li>React tworzy wirtualną reprezentację DOM w pamięci</li>
        <li>Przy zmianie stanu - tworzy nowy Virtual DOM</li>
        <li>Porównuje (diffing) stary z nowym Virtual DOM</li>
        <li>Aktualizuje tylko zmienione części w prawdziwym DOM</li>
        <li>Wynik: Szybsze i bardziej wydajne aplikacje!</li>
      </ol>
    </div>
  </div>

  <script>
    let tradCount = 0;
    let virtCount = 0;

    // Tradycyjny DOM - wolniejsza metoda
    function traditionalUpdate() {
      tradCount++;
      console.log("Tradycyjna aktualizacja - cały element jest re-renderowany");
      document.getElementById('trad-count').textContent = tradCount;
      // Symulacja wolniejszego działania
      document.getElementById('traditional-demo').style.background = 'rgba(244, 67, 54, 0.3)';
      setTimeout(() => {
        document.getElementById('traditional-demo').style.background = 'rgba(100, 255, 218, 0.1)';
      }, 200);
    }

    // Symulacja Virtual DOM - szybsza metoda
    function virtualUpdate() {
      virtCount++;
      console.log("Aktualizacja przez Virtual DOM - tylko niezbędne zmiany");
      document.getElementById('virt-count').textContent = virtCount;
      // Symulacja szybszego działania
      document.getElementById('virtual-demo').style.background = 'rgba(76, 175, 80, 0.3)';
      setTimeout(() => {
        document.getElementById('virtual-demo').style.background = 'rgba(100, 255, 218, 0.1)';
      }, 100);
    }

    console.log("Demo Virtual DOM - Metropolis Quantum");
    console.log("Kliknij przyciski, aby zobaczyć różnicę w działaniu!");
  </script>
</body>
</html>

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. Next.js został wydany w roku:

  2. 2. JSX to:

  3. 3. Virtual DOM w React służy do:

Zadania praktyczne w grze

  • Układanie w pionie

    Ułóż składnię eksportu domyślnego komponentu strony w Next.js

  1. PytanieRok wydania Next.js
  2. PytanieDefinicja JSX
  3. PytanieRola Virtual DOM w React
  4. Ułóż w kolejnościEksport komponentu strony

Przydatne artykuły