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

Pierwsza aplikacja "Hello World" - krok po kroku - prosta strona dla firmy kosmicznej

15 min czytania ·
W tej lekcji16

W Metropolii Quantum każdy inżynier pamięta swój pierwszy projekt - moment, gdy po raz pierwszy uruchomił własny system kwantowy. W świecie deweloperów Next.js tym pierwszym krokiem jest stworzenie aplikacji "Hello World". W tej lekcji przeprowadzimy Cię krok po kroku przez proces tworzenia prostej strony internetowej dla fikcyjnej firmy kosmicznej "Quantum Voyages", wykorzystując najnowsze funkcje Next.js 16 i App Router.

Przygotowanie projektu

Najpierw musimy stworzyć nowy projekt Next.js. Otwórz terminal i wykonaj następujące polecenie:

npx create-next-app@latest quantum-voyages

W trakcie procesu inicjalizacji odpowiedz na pytania konfiguracyjne:

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 (domyślny alias @/* wystarczy)
Would you like to include AGENTS.md to guide coding agents to write up-to-date Next.js code? Yes

Gdy proces instalacji zakończy się, przejdź do katalogu projektu:

cd quantum-voyages

Struktura projektu

Po utworzeniu projektu zobaczysz strukturę katalogów podobną do tej:

quantum-voyages/
├── node_modules/
├── public/
├── src/
│   ├── app/
│   │   ├── favicon.ico
│   │   ├── globals.css
│   │   ├── layout.tsx
│   │   └── page.tsx
├── AGENTS.md
├── CLAUDE.md
├── eslint.config.mjs
├── next-env.d.ts
├── next.config.ts
├── package.json
├── postcss.config.mjs
└── tsconfig.json

Tworzenie strony głównej

Zacznijmy od modyfikacji strony głównej. Otwórz plik src/app/page.tsx i zastąp jego zawartość poniższym kodem:

// src/app/page.tsx
import Link from 'next/link';

export default function HomePage() {
  return (
    <main className="flex min-h-screen flex-col items-center justify-center p-24">
      <h1 className="text-6xl font-bold text-center bg-gradient-to-r from-blue-600 to-purple-600 bg-clip-text text-transparent mb-8">
        Quantum Voyages
      </h1>
      <p className="text-xl text-center max-w-2xl mb-8">
        Odkrywamy wszechświat używając najnowszych technologii kwantowych.
        Dołącz do naszej międzygwiezdnej podróży i razem przekraczajmy granice możliwości.
      </p>
      <div className="flex gap-4">
        <Link
          href="/oferta"
          className="px-6 py-3 rounded-full bg-blue-600 text-white hover:bg-blue-700 transition-colors"
        >
          Nasza oferta
        </Link>
        <Link
          href="/kontakt"
          className="px-6 py-3 rounded-full bg-purple-600 text-white hover:bg-purple-700 transition-colors"
        >
          Kontakt
        </Link>
      </div>
    </main>
  );
}

Globalne style i layout

Następnie zmodyfikujmy globalny layout naszej aplikacji. Otwórz plik src/app/layout.tsx i zaktualizuj go:

// src/app/layout.tsx
import './globals.css';
import type { Metadata } from 'next';
import { Inter } from 'next/font/google';

const inter = Inter({ subsets: ['latin'] });

export const metadata: Metadata = {
  title: 'Quantum Voyages - Podróże międzygwiezdne',
  description: 'Firma kosmiczna specjalizująca się w międzygwiezdnych podróżach kwantowych',
};

export default function RootLayout({
  children,
}: {
  children: React.ReactNode;
}) {
  return (
    <html lang="pl">
      <body className={inter.className}>
        {children}
      </body>
    </html>
  );
}

Tworzenie komponentu nagłówka (header)

Teraz stwórzmy wspólny nagłówek, który będzie wyświetlany na wszystkich stronach. Najpierw utworzymy katalog dla współdzielonych komponentów:

mkdir -p src/components/ui

Następnie utwórz plik src/components/ui/Header.tsx:

// src/components/ui/Header.tsx
"use client";

import Link from 'next/link';
import { useState } from 'react';

export default function Header() {
  const [isMenuOpen, setIsMenuOpen] = useState(false);

  return (
    <header className="fixed w-full bg-black/80 backdrop-blur-md text-white z-10">
      <div className="container mx-auto px-4 py-4 flex justify-between items-center">
        <Link href="/" className="text-2xl font-bold">
          Quantum Voyages
        </Link>

        {/* Mobile Menu Button */}
        <button
          className="md:hidden"
          onClick={() => setIsMenuOpen(!isMenuOpen)}
        >
          <svg xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 24 24" stroke="currentColor" className="w-6 h-6">
            {isMenuOpen
              ? <path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M6 18L18 6M6 6l12 12" />
              : <path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M4 6h16M4 12h16m-7 6h7" />
            }
          </svg>
        </button>

        {/* Desktop Navigation */}
        <nav className="hidden md:flex gap-6">
          <Link href="/" className="hover:text-blue-400 transition-colors">
            Strona główna
          </Link>
          <Link href="/oferta" className="hover:text-blue-400 transition-colors">
            Nasza oferta
          </Link>
          <Link href="/o-nas" className="hover:text-blue-400 transition-colors">
            O nas
          </Link>
          <Link href="/kontakt" className="hover:text-blue-400 transition-colors">
            Kontakt
          </Link>
        </nav>
      </div>

      {/* Mobile Navigation */}
      {isMenuOpen && (
        <nav className="flex flex-col md:hidden bg-black/90 py-4">
          <Link
            href="/"
            className="px-4 py-2 hover:bg-blue-900/30"
            onClick={() => setIsMenuOpen(false)}
          >
            Strona główna
          </Link>
          <Link
            href="/oferta"
            className="px-4 py-2 hover:bg-blue-900/30"
            onClick={() => setIsMenuOpen(false)}
          >
            Nasza oferta
          </Link>
          <Link
            href="/o-nas"
            className="px-4 py-2 hover:bg-blue-900/30"
            onClick={() => setIsMenuOpen(false)}
          >
            O nas
          </Link>
          <Link
            href="/kontakt"
            className="px-4 py-2 hover:bg-blue-900/30"
            onClick={() => setIsMenuOpen(false)}
          >
            Kontakt
          </Link>
        </nav>
      )}
    </header>
  );
}

Zauważ, że użyliśmy dyrektywy "use client" na górze pliku, ponieważ ten komponent używa hooków React i obsługuje zdarzenia użytkownika.

Teraz stwórzmy stopkę, która również będzie obecna na wszystkich stronach. Utwórz plik src/components/ui/Footer.tsx:

// src/components/ui/Footer.tsx
import Link from 'next/link';

export default function Footer() {
  const currentYear = new Date().getFullYear();

  return (
    <footer className="bg-black/80 backdrop-blur-md text-white py-8">
      <div className="container mx-auto px-4">
        <div className="grid grid-cols-1 md:grid-cols-3 gap-8">
          <div>
            <h3 className="text-xl font-bold mb-4">Quantum Voyages</h3>
            <p className="text-gray-300">
              Odkrywamy wszechświat używając najnowszych technologii kwantowych.
            </p>
          </div>

          <div>
            <h3 className="text-xl font-bold mb-4">Nawigacja</h3>
            <ul className="space-y-2">
              <li><Link href="/" className="text-gray-300 hover:text-white transition-colors">Strona główna</Link></li>
              <li><Link href="/oferta" className="text-gray-300 hover:text-white transition-colors">Nasza oferta</Link></li>
              <li><Link href="/o-nas" className="text-gray-300 hover:text-white transition-colors">O nas</Link></li>
              <li><Link href="/kontakt" className="text-gray-300 hover:text-white transition-colors">Kontakt</Link></li>
            </ul>
          </div>

          <div>
            <h3 className="text-xl font-bold mb-4">Kontakt</h3>
            <address className="not-italic text-gray-300">
              <p>Stacja Orbitalna Alfa</p>
              <p>Orbita geostacjonarna, Ziemia</p>
              <p>kontakt@quantum-voyages.space</p>
            </address>
          </div>
        </div>

        <div className="border-t border-gray-800 mt-8 pt-8 text-center">
          <p className="text-gray-400">© {currentYear} Quantum Voyages. Wszelkie prawa zastrzeżone.</p>
        </div>
      </div>
    </footer>
  );
}

Aktualizacja głównego layoutu

Teraz zaktualizujmy główny layout aplikacji, aby zawierał utworzone przez nas nagłówek i stopkę:

// src/app/layout.tsx
import './globals.css';
import type { Metadata } from 'next';
import { Inter } from 'next/font/google';
import Header from '@/components/ui/Header';
import Footer from '@/components/ui/Footer';

const inter = Inter({ subsets: ['latin'] });

export const metadata: Metadata = {
  title: 'Quantum Voyages - Podróże międzygwiezdne',
  description: 'Firma kosmiczna specjalizująca się w międzygwiezdnych podróżach kwantowych',
};

export default function RootLayout({
  children,
}: {
  children: React.ReactNode;
}) {
  return (
    <html lang="pl">
      <body className={inter.className + " bg-gradient-to-b from-gray-900 to-black text-white min-h-screen"}>
        <Header />
        <div className="pt-20">
          {children}
        </div>
        <Footer />
      </body>
    </html>
  );
}

Aktualizacja strony głównej

Teraz dostosujmy stronę główną, aby lepiej pasowała do naszego nowego layoutu:

// src/app/page.tsx
import Link from 'next/link';
import Image from 'next/image';

export default function HomePage() {
  return (
    <>
      {/* Hero Section */}
      <section className="h-[90vh] flex flex-col items-center justify-center text-center p-4 relative overflow-hidden">
        <div className="absolute inset-0 z-0">
          <div className="absolute inset-0 bg-black/60 z-10"></div>
          <Image
            src="/space.jpg"
            alt="Przestrzeń kosmiczna"
            fill
            className="object-cover"
            preload
          />
        </div>

        <div className="relative z-20 max-w-4xl mx-auto">
          <h1 className="text-6xl font-bold mb-6 bg-gradient-to-r from-blue-400 to-purple-500 bg-clip-text text-transparent">
            Quantum Voyages
          </h1>
          <p className="text-xl mb-8 text-gray-200">
            Przełamujemy granice przestrzeni i czasu dzięki technologii kwantowej.
            Jesteśmy pionierami w dziedzinie międzygwiezdnej eksploracji.
          </p>
          <div className="flex flex-wrap gap-4 justify-center">
            <Link
              href="/oferta"
              className="px-8 py-3 rounded-full bg-blue-600 text-white hover:bg-blue-700 transition-colors"
            >
              Odkryj nasze misje
            </Link>
            <Link
              href="/kontakt"
              className="px-8 py-3 rounded-full bg-purple-600 text-white hover:bg-purple-700 transition-colors"
            >
              Dołącz do załogi
            </Link>
          </div>
        </div>
      </section>

      {/* Features Section */}
      <section className="py-20 px-4">
        <div className="container mx-auto">
          <h2 className="text-4xl font-bold text-center mb-16">Nasze przewagi kwantowe</h2>

          <div className="grid grid-cols-1 md:grid-cols-3 gap-10">
            <div className="p-6 bg-gradient-to-br from-blue-900/30 to-blue-800/10 rounded-xl backdrop-blur-sm">
              <div className="w-16 h-16 bg-blue-600 rounded-lg flex items-center justify-center mb-4">
                <svg xmlns="http://www.w3.org/2000/svg" className="h-8 w-8 text-white" fill="none" viewBox="0 0 24 24" stroke="currentColor">
                  <path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M13 10V3L4 14h7v7l9-11h-7z" />
                </svg>
              </div>
              <h3 className="text-xl font-semibold mb-2">Napęd kwantowy</h3>
              <p className="text-gray-300">
                Nasze statki kosmiczne wykorzystują najnowszą technologię napędu kwantowego,
                umożliwiającą podróże z prędkością przekraczającą prędkość światła.
              </p>
            </div>

            <div className="p-6 bg-gradient-to-br from-purple-900/30 to-purple-800/10 rounded-xl backdrop-blur-sm">
              <div className="w-16 h-16 bg-purple-600 rounded-lg flex items-center justify-center mb-4">
                <svg xmlns="http://www.w3.org/2000/svg" className="h-8 w-8 text-white" fill="none" viewBox="0 0 24 24" stroke="currentColor">
                  <path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M9 12l2 2 4-4m5.618-4.016A11.955 11.955 0 0112 2.944a11.955 11.955 0 01-8.618 3.04A12.02 12.02 0 003 9c0 5.591 3.824 10.29 9 11.622 5.176-1.332 9-6.03 9-11.622 0-1.042-.133-2.052-.382-3.016z" />
                </svg>
              </div>
              <h3 className="text-xl font-semibold mb-2">Osłony kwantowe</h3>
              <p className="text-gray-300">
                Zaawansowane osłony oparte na mechanice kwantowej zapewniają
                najwyższy poziom bezpieczeństwa podczas międzygwiezdnych podróży.
              </p>
            </div>

            <div className="p-6 bg-gradient-to-br from-teal-900/30 to-teal-800/10 rounded-xl backdrop-blur-sm">
              <div className="w-16 h-16 bg-teal-600 rounded-lg flex items-center justify-center mb-4">
                <svg xmlns="http://www.w3.org/2000/svg" className="h-8 w-8 text-white" fill="none" viewBox="0 0 24 24" stroke="currentColor">
                  <path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M19.428 15.428a2 2 0 00-1.022-.547l-2.387-.477a6 6 0 00-3.86.517l-.318.158a6 6 0 01-3.86.517L6.05 15.21a2 2 0 00-1.806.547M8 4h8l-1 1v5.172a2 2 0 00.586 1.414l5 5c1.26 1.26.367 3.414-1.415 3.414H4.828c-1.782 0-2.674-2.154-1.414-3.414l5-5A2 2 0 009 10.172V5L8 4z" />
                </svg>
              </div>
              <h3 className="text-xl font-semibold mb-2">Laboratoria kwantowe</h3>
              <p className="text-gray-300">
                Nasze statki wyposażone są w najnowocześniejsze laboratoria kwantowe,
                umożliwiające badania naukowe w przestrzeni kosmicznej.
              </p>
            </div>
          </div>
        </div>
      </section>

      {/* Call to Action */}
      <section className="py-16 px-4 bg-gradient-to-r from-blue-900/40 to-purple-900/40">
        <div className="container mx-auto text-center">
          <h2 className="text-3xl font-bold mb-4">Gotowy na międzygwiezdną przygodę?</h2>
          <p className="text-xl text-gray-300 mb-8 max-w-2xl mx-auto">
            Dołącz do społeczności odkrywców kwantowych i bądź częścią
            następnego wielkiego kroku ludzkości w eksploracji kosmosu.
          </p>
          <Link
            href="/kontakt"
            className="px-8 py-3 rounded-full bg-gradient-to-r from-blue-600 to-purple-600 text-white hover:from-blue-700 hover:to-purple-700 transition-colors"
          >
            Dowiedz się więcej
          </Link>
        </div>
      </section>
    </>
  );
}

Przygotowanie zasobów

Aby nasza strona wyglądała atrakcyjnie, potrzebujemy obrazu tła dla sekcji hero. Pobierz zdjęcie przestrzeni kosmicznej (lub użyj własnego) i umieść je w katalogu public/ jako space.jpg.

Tworzenie podstrony "Oferta"

Teraz stwórzmy podstronę z ofertą firmy. Utwórz katalog src/app/oferta i plik page.tsx wewnątrz:

// src/app/oferta/page.tsx
import Image from 'next/image';

interface MissionProps {
  title: string;
  description: string;
  image: string;
  destination: string;
  duration: string;
  price: string;
}

function Mission({ title, description, image, destination, duration, price }: MissionProps) {
  return (
    <div className="bg-gradient-to-br from-gray-800/50 to-gray-900/50 rounded-xl overflow-hidden backdrop-blur-sm">
      <div className="relative h-64">
        <Image
          src={image}
          alt={title}
          fill
          className="object-cover"
        />
      </div>
      <div className="p-6">
        <h3 className="text-2xl font-bold mb-2">{title}</h3>
        <p className="text-gray-300 mb-4">{description}</p>
        <div className="grid grid-cols-2 gap-4 text-sm">
          <div>
            <p className="text-gray-400">Cel podróży</p>
            <p className="font-medium">{destination}</p>
          </div>
          <div>
            <p className="text-gray-400">Czas trwania</p>
            <p className="font-medium">{duration}</p>
          </div>
          <div className="col-span-2">
            <p className="text-gray-400">Koszt</p>
            <p className="font-bold text-xl text-blue-400">{price}</p>
          </div>
        </div>
      </div>
    </div>
  );
}

export default function OfertaPage() {
  const missions = [
    {
      title: "Wycieczka Orbitalna",
      description: "Idealna dla początkujących odkrywców kosmosu. Doświadcz nieważkości i podziwiaj Ziemię z orbity.",
      image: "/mission-orbit.jpg",
      destination: "Niska orbita Ziemi",
      duration: "3 dni",
      price: "250,000 ¤"
    },
    {
      title: "Weekend na Księżycu",
      description: "Spędź niezapomniany weekend w luksusowym kompleksie na powierzchni Księżyca.",
      image: "/mission-moon.jpg",
      destination: "Księżyc",
      duration: "5 dni",
      price: "750,000 ¤"
    },
    {
      title: "Ekspedycja na Marsa",
      description: "Odkryj czerwoną planetę i bądź jednym z pierwszych ludzi, którzy postawili na niej stopę.",
      image: "/mission-mars.jpg",
      destination: "Mars",
      duration: "3 miesiące",
      price: "5,000,000 ¤"
    },
    {
      title: "Podróż do Proximy Centauri",
      description: "Międzygwiezdna ekspedycja do najbliższej gwiazdy poza naszym Układem Słonecznym.",
      image: "/mission-proxima.jpg",
      destination: "Proxima Centauri",
      duration: "5 lat (czas na pokładzie: 6 miesięcy)",
      price: "25,000,000 ¤"
    }
  ];

  return (
    <div className="container mx-auto px-4 py-16">
      <div className="text-center mb-16">
        <h1 className="text-5xl font-bold mb-4">Nasze misje kosmiczne</h1>
        <p className="text-xl text-gray-300 max-w-3xl mx-auto">
          Wybierz swoją podróż kosmiczną spośród naszych ofert. Od krótkiej wycieczki orbitalnej
          po międzygwiezdne ekspedycje - każda z nich zmieni na zawsze Twoje postrzeganie wszechświata.
        </p>
      </div>

      <div className="grid grid-cols-1 md:grid-cols-2 gap-8">
        {missions.map((mission, index) => (
          <Mission key={index} {...mission} />
        ))}
      </div>

      <div className="mt-16 p-8 bg-gradient-to-r from-blue-900/30 to-purple-900/30 rounded-xl backdrop-blur-sm">
        <h2 className="text-3xl font-bold mb-4">Misje niestandardowe</h2>
        <p className="text-gray-300 mb-6">
          Poszukujesz czegoś wyjątkowego? Oferujemy ekskluzywne, niestandardowe misje
          dostosowane do Twoich konkretnych oczekiwań i potrzeb badawczych.
        </p>
        <button className="px-6 py-3 bg-gradient-to-r from-blue-600 to-purple-600 rounded-full hover:from-blue-700 hover:to-purple-700 transition-colors">
          Skontaktuj się z nami
        </button>
      </div>
    </div>
  );
}

Dla tej podstrony potrzebne będą także obrazy. Możesz dodać własne pliki do katalogu public/ lub użyć istniejących obrazów.

Tworzenie podstrony "Kontakt"

Teraz stwórzmy podstronę kontaktową z formularzem. Utwórz katalog src/app/kontakt i plik page.tsx wewnątrz:

// src/app/kontakt/page.tsx
import ContactForm from './ContactForm';

export default function KontaktPage() {
  return (
    <div className="container mx-auto px-4 py-16">
      <div className="text-center mb-16">
        <h1 className="text-5xl font-bold mb-4">Skontaktuj się z nami</h1>
        <p className="text-xl text-gray-300 max-w-3xl mx-auto">
          Masz pytania dotyczące naszych misji kosmicznych lub chcesz dołączyć do załogi?
          Skorzystaj z poniższego formularza lub odwiedź nasze biuro.
        </p>
      </div>

      <div className="grid grid-cols-1 lg:grid-cols-2 gap-16">
        <div>
          <h2 className="text-3xl font-semibold mb-6">Wyślij wiadomość</h2>
          <ContactForm />
        </div>

        <div>
          <h2 className="text-3xl font-semibold mb-6">Dane kontaktowe</h2>

          <div className="space-y-6">
            <div className="flex items-start">
              <div className="bg-blue-600 p-3 rounded-lg mr-4">
                <svg xmlns="http://www.w3.org/2000/svg" className="h-6 w-6 text-white" fill="none" viewBox="0 0 24 24" stroke="currentColor">
                  <path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M17.657 16.657L13.414 20.9a1.998 1.998 0 01-2.827 0l-4.244-4.243a8 8 0 1111.314 0z" />
                  <path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M15 11a3 3 0 11-6 0 3 3 0 016 0z" />
                </svg>
              </div>
              <div>
                <h3 className="text-xl font-medium mb-1">Adres</h3>
                <address className="not-italic text-gray-300">
                  <p>Stacja Orbitalna Alfa</p>
                  <p>Orbita geostacjonarna, Ziemia</p>
                </address>
              </div>
            </div>

            <div className="flex items-start">
              <div className="bg-blue-600 p-3 rounded-lg mr-4">
                <svg xmlns="http://www.w3.org/2000/svg" className="h-6 w-6 text-white" fill="none" viewBox="0 0 24 24" stroke="currentColor">
                  <path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M3 8l7.89 5.26a2 2 0 002.22 0L21 8M5 19h14a2 2 0 002-2V7a2 2 0 00-2-2H5a2 2 0 00-2 2v10a2 2 0 002 2z" />
                </svg>
              </div>
              <div>
                <h3 className="text-xl font-medium mb-1">Email</h3>
                <p className="text-gray-300">kontakt@quantum-voyages.space</p>
              </div>
            </div>

            <div className="flex items-start">
              <div className="bg-blue-600 p-3 rounded-lg mr-4">
                <svg xmlns="http://www.w3.org/2000/svg" className="h-6 w-6 text-white" fill="none" viewBox="0 0 24 24" stroke="currentColor">
                  <path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M12 18h.01M8 21h8a2 2 0 002-2V5a2 2 0 00-2-2H8a2 2 0 00-2 2v14a2 2 0 002 2z" />
                </svg>
              </div>
              <div>
                <h3 className="text-xl font-medium mb-1">Telefon</h3>
                <p className="text-gray-300">+0 (123) 456-7890</p>
              </div>
            </div>
          </div>

          <div className="mt-10">
            <h2 className="text-3xl font-semibold mb-6">Godziny pracy</h2>
            <div className="bg-gradient-to-br from-gray-800/50 to-gray-900/50 rounded-xl p-6 backdrop-blur-sm">
              <div className="flex justify-between py-2 border-b border-gray-700">
                <span>Poniedziałek - Piątek:</span>
                <span>09:00 - 18:00</span>
              </div>
              <div className="flex justify-between py-2 border-b border-gray-700">
                <span>Sobota:</span>
                <span>10:00 - 15:00</span>
              </div>
              <div className="flex justify-between py-2">
                <span>Niedziela:</span>
                <span>Zamknięte</span>
              </div>
            </div>
          </div>
        </div>
      </div>
    </div>
  );
}

Teraz utwórzmy komponent formularza kontaktowego w pliku src/app/kontakt/ContactForm.tsx:

// src/app/kontakt/ContactForm.tsx
"use client";

import { useState } from 'react';

export default function ContactForm() {
  const [formData, setFormData] = useState({
    name: '',
    email: '',
    subject: '',
    message: ''
  });

  const [formStatus, setFormStatus] = useState<'idle' | 'loading' | 'success' | 'error'>('idle');

  const handleChange = (e: React.ChangeEvent<HTMLInputElement | HTMLTextAreaElement | HTMLSelectElement>) => {
    const { name, value } = e.target;
    setFormData(prevData => ({
      ...prevData,
      [name]: value
    }));
  };

  const handleSubmit = async (e: React.FormEvent<HTMLFormElement>) => {
    e.preventDefault();
    setFormStatus('loading');

    // W rzeczywistej aplikacji tutaj byłaby obsługa formularza, np. wysłanie danych do API
    try {
      // Symulacja opóźnienia odpowiedzi serwera
      await new Promise(resolve => setTimeout(resolve, 1500));

      // Symulacja sukcesu
      setFormStatus('success');
      setFormData({
        name: '',
        email: '',
        subject: '',
        message: ''
      });
    } catch (error) {
      setFormStatus('error');
    }
  };

  return (
    <form onSubmit={handleSubmit} className="space-y-6">
      <div>
        <label htmlFor="name" className="block text-sm font-medium mb-1">
          Imię i nazwisko <span className="text-red-500">*</span>
        </label>
        <input
          type="text"
          id="name"
          name="name"
          value={formData.name}
          onChange={handleChange}
          required
          className="w-full px-4 py-2 bg-gray-800/60 border border-gray-700 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500"
        />
      </div>

      <div>
        <label htmlFor="email" className="block text-sm font-medium mb-1">
          Email <span className="text-red-500">*</span>
        </label>
        <input
          type="email"
          id="email"
          name="email"
          value={formData.email}
          onChange={handleChange}
          required
          className="w-full px-4 py-2 bg-gray-800/60 border border-gray-700 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500"
        />
      </div>

      <div>
        <label htmlFor="subject" className="block text-sm font-medium mb-1">
          Temat <span className="text-red-500">*</span>
        </label>
        <select
          id="subject"
          name="subject"
          value={formData.subject}
          onChange={handleChange}
          required
          className="w-full px-4 py-2 bg-gray-800/60 border border-gray-700 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500"
        >
          <option value="">Wybierz temat</option>
          <option value="rezerwacja">Rezerwacja misji</option>
          <option value="informacje">Informacje o misjach</option>
          <option value="praca">Dołączenie do załogi</option>
          <option value="inne">Inne</option>
        </select>
      </div>

      <div>
        <label htmlFor="message" className="block text-sm font-medium mb-1">
          Wiadomość <span className="text-red-500">*</span>
        </label>
        <textarea
          id="message"
          name="message"
          value={formData.message}
          onChange={handleChange}
          required
          rows={5}
          className="w-full px-4 py-2 bg-gray-800/60 border border-gray-700 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500"
        ></textarea>
      </div>

      <button
        type="submit"
        disabled={formStatus === 'loading'}
        className="w-full px-6 py-3 bg-gradient-to-r from-blue-600 to-purple-600 text-white rounded-lg hover:from-blue-700 hover:to-purple-700 transition-colors disabled:opacity-70"
      >
        {formStatus === 'loading' ? 'Wysyłanie...' : 'Wyślij wiadomość'}
      </button>

      {formStatus === 'success' && (
        <div className="p-4 bg-green-900/40 border border-green-500 rounded-lg text-green-200">
          Dziękujemy za wiadomość! Odpowiemy tak szybko, jak to możliwe.
        </div>
      )}

      {formStatus === 'error' && (
        <div className="p-4 bg-red-900/40 border border-red-500 rounded-lg text-red-200">
          Wystąpił błąd podczas wysyłania wiadomości. Proszę spróbować ponownie później.
        </div>
      )}
    </form>
  );
}

Tworzenie strony 404 (Not Found)

Dodajmy stronę 404, która będzie wyświetlana, gdy użytkownik wejdzie na nieistniejącą ścieżkę. Utwórz plik src/app/not-found.tsx:

// src/app/not-found.tsx
import Link from 'next/link';

export default function NotFound() {
  return (
    <div className="min-h-[80vh] flex flex-col items-center justify-center p-4 text-center">
      <h1 className="text-9xl font-bold bg-gradient-to-r from-blue-400 to-purple-500 bg-clip-text text-transparent">
        404
      </h1>
      <h2 className="text-4xl font-bold mt-4 mb-6">Zagubiony w kosmosie</h2>
      <p className="text-xl text-gray-300 mb-8 max-w-xl">
        Wygląda na to, że zabłądziłeś w głębokim kosmosie. Niestety, strona której
        szukasz znajduje się poza naszym zasięgiem kwantowym.
      </p>
      <Link
        href="/"
        className="px-8 py-3 rounded-full bg-gradient-to-r from-blue-600 to-purple-600 text-white hover:from-blue-700 hover:to-purple-700 transition-colors"
      >
        Wróć na Ziemię
      </Link>
    </div>
  );
}

Uruchomienie aplikacji

Teraz możemy uruchomić naszą aplikację lokalnie za pomocą polecenia:

npm run dev

Po uruchomieniu serwera deweloperskiego otwórz w przeglądarce adres http://localhost:3000, aby zobaczyć swoją stronę "Hello World" dla firmy kosmicznej.

Budowanie i wdrażanie

Gdy jesteś zadowolony z działania aplikacji lokalnie, możesz ją zbudować i przygotować do wdrożenia:

npm run build

Polecenie to wygeneruje zoptymalizowaną wersję produkcyjną aplikacji w katalogu .next/. Możesz także przetestować tę wersję lokalnie, uruchamiając:

npm run start

Wdrażanie na Vercel

Next.js jest tworzony i utrzymywany przez Vercel, więc wdrożenie na tej platformie jest niezwykle proste:

  1. Utwórz konto na Vercel (jeśli jeszcze go nie masz)
  2. Połącz swoje repozytorium z Vercelem (GitHub, GitLab lub Bitbucket)
  3. Wybierz swój projekt i kliknij "Import"
  4. Vercel automatycznie wykryje, że jest to aplikacja Next.js i skonfiguruje wdrożenie
  5. Kliknij "Deploy" i poczekaj na zakończenie procesu

Po zakończeniu wdrożenia Vercel dostarczy Ci URL, pod którym Twoja aplikacja jest dostępna publicznie.

Co dalej?

Stworzyliśmy prostą, ale elegancką i funkcjonalną stronę dla firmy kosmicznej z wykorzystaniem Next.js 16 i App Routera. Oto kilka sugestii do dalszego rozwijania aplikacji:

  1. Dodaj podstronę "O nas" z historią i misją firmy
  2. Zaimplementuj animacje za pomocą bibliotek takich jak Framer Motion
  3. Dodaj prawdziwą obsługę formularza z wykorzystaniem Server Actions
  4. Zintegruj CMS (np. Contentful, Sanity) do zarządzania treścią
  5. Dodaj internacjonalizację (i18n) do obsługi wielu języków
  6. Zaimplementuj system uwierzytelniania dla klientów i członków załogi

W miarę rozbudowy aplikacji pamiętaj o zasadach i najlepszych praktykach poznanych w poprzednich lekcjach, szczególnie o właściwym podziale na Server i Client Components.

Gratulacje! Właśnie stworzyłeś swoją pierwszą aplikację Next.js 16 z wykorzystaniem App Routera.

Kod do tej lekcji: App.tsx
// Zarządzanie stanem - Metropolis Quantum
import React, { useState, createContext, useContext } from 'react';

console.log("Zarządzanie stanem w React");
console.log("Context API i podnoszenie stanu\n");

// ==========================================
// 1. Podnoszenie stanu (lifting state up)
// ==========================================

function TemperatureInput({ scale, temperature, onTemperatureChange }: any) {
  return (
    <div style={{ marginBottom: '15px' }}>
      <label style={{ display: 'block', marginBottom: '5px', color: '#64ffda' }}>
        Temperatura w skali {scale === 'celsius' ? 'Celsjusza' : 'Fahrenheita'}:
      </label>
      <input
        type="number"
        value={temperature}
        onChange={(e) => onTemperatureChange(e.target.value)}
        style={{
          width: '100%',
          padding: '10px',
          borderRadius: '6px',
          border: '1px solid #64ffda',
          background: 'rgba(255, 255, 255, 0.1)',
          color: 'white',
          fontSize: '1rem'
        }}
      />
    </div>
  );
}

function TemperatureCalculator() {
  const [temperature, setTemperature] = useState('');
  const [scale, setScale] = useState('celsius');

  const handleCelsiusChange = (temp: string) => {
    setTemperature(temp);
    setScale('celsius');
  };

  const handleFahrenheitChange = (temp: string) => {
    setTemperature(temp);
    setScale('fahrenheit');
  };

  const toCelsius = (fahrenheit: number) => (fahrenheit - 32) * 5 / 9;
  const toFahrenheit = (celsius: number) => (celsius * 9 / 5) + 32;

  const celsius = scale === 'fahrenheit' ? toCelsius(parseFloat(temperature)) : parseFloat(temperature);
  const fahrenheit = scale === 'celsius' ? toFahrenheit(parseFloat(temperature)) : parseFloat(temperature);

  return (
    <div style={{
      background: 'rgba(255, 255, 255, 0.1)',
      padding: '20px',
      borderRadius: '12px',
      border: '2px solid #7c4dff'
    }}>
      <h3 style={{ color: '#7c4dff' }}>Przelicznik temperatury (podnoszenie stanu)</h3>

      <TemperatureInput
        scale="celsius"
        temperature={scale === 'celsius' ? temperature : isNaN(celsius) ? '' : celsius.toFixed(1)}
        onTemperatureChange={handleCelsiusChange}
      />

      <TemperatureInput
        scale="fahrenheit"
        temperature={scale === 'fahrenheit' ? temperature : isNaN(fahrenheit) ? '' : fahrenheit.toFixed(1)}
        onTemperatureChange={handleFahrenheitChange}
      />

      <div style={{
        marginTop: '15px',
        padding: '15px',
        background: celsius >= 100 ? 'rgba(244, 67, 54, 0.3)' : 'rgba(33, 150, 243, 0.3)',
        borderRadius: '8px',
        textAlign: 'center'
      }}>
        {celsius >= 100 ? 'Woda gotuje się!' : 'Woda nie gotuje się'}
      </div>
    </div>
  );
}

// ==========================================
// 2. Context API
// ==========================================

interface ThemeContextType {
  theme: 'dark' | 'light';
  toggleTheme: () => void;
}

const ThemeContext = createContext<ThemeContextType>({
  theme: 'dark',
  toggleTheme: () => {}
});

function ThemeButton() {
  const { theme, toggleTheme } = useContext(ThemeContext);

  return (
    <button
      onClick={toggleTheme}
      style={{
        background: theme === 'dark'
          ? 'linear-gradient(45deg, #7c4dff, #e91e63)'
          : 'linear-gradient(45deg, #ff9800, #ffeb3b)',
        color: 'white',
        border: 'none',
        padding: '12px 24px',
        borderRadius: '8px',
        cursor: 'pointer',
        fontWeight: 'bold',
        fontSize: '1rem'
      }}
    >
      {theme === 'dark' ? 'Tryb ciemny' : 'Tryb jasny'}
    </button>
  );
}

function ThemedPanel() {
  const { theme } = useContext(ThemeContext);

  return (
    <div style={{
      background: theme === 'dark'
        ? 'rgba(255, 255, 255, 0.1)'
        : 'rgba(255, 152, 0, 0.2)',
      padding: '20px',
      borderRadius: '12px',
      border: `2px solid ${theme === 'dark' ? '#64ffda' : '#ff9800'}`,
      marginTop: '20px'
    }}>
      <h3 style={{ color: theme === 'dark' ? '#64ffda' : '#ff9800' }}>
        Panel z motywem
      </h3>
      <p style={{ color: theme === 'dark' ? '#b0bec5' : '#5d4037' }}>
        Ten panel automatycznie dostosowuje się do aktualnego motywu dzięki Context API!
      </p>
      <p style={{ color: theme === 'dark' ? '#b0bec5' : '#5d4037' }}>
        Aktualny motyw: <strong>{theme === 'dark' ? 'Ciemny' : 'Jasny'}</strong>
      </p>
    </div>
  );
}

// ==========================================
// 3. Przykład kontekstu użytkownika
// ==========================================

interface User {
  name: string;
  role: string;
  level: number;
}

interface UserContextType {
  user: User | null;
  login: (user: User) => void;
  logout: () => void;
}

const UserContext = createContext<UserContextType>({
  user: null,
  login: () => {},
  logout: () => {}
});

function UserProfile() {
  const { user, logout } = useContext(UserContext);

  if (!user) return null;

  return (
    <div style={{
      background: 'rgba(76, 175, 80, 0.2)',
      padding: '15px',
      borderRadius: '10px',
      border: '2px solid #4caf50',
      display: 'flex',
      justifyContent: 'space-between',
      alignItems: 'center'
    }}>
      <div>
        <h4 style={{ color: '#4caf50', margin: '0 0 5px 0' }}>{user.name}</h4>
        <p style={{ margin: '5px 0', color: '#b0bec5' }}>Rola: {user.role}</p>
        <p style={{ margin: '5px 0', color: '#ff9800' }}>Poziom: {user.level}</p>
      </div>
      <button
        onClick={logout}
        style={{
          background: 'linear-gradient(45deg, #f44336, #e91e63)',
          color: 'white',
          border: 'none',
          padding: '8px 16px',
          borderRadius: '6px',
          cursor: 'pointer',
          fontWeight: 'bold'
        }}
      >
        Wyloguj
      </button>
    </div>
  );
}

function LoginForm() {
  const { login } = useContext(UserContext);
  const [name, setName] = useState('');

  const handleLogin = () => {
    if (name.trim()) {
      login({
        name: name,
        role: 'Inżynier kwantowy',
        level: Math.floor(Math.random() * 50) + 1
      });
    }
  };

  return (
    <div style={{
      background: 'rgba(33, 150, 243, 0.2)',
      padding: '20px',
      borderRadius: '12px',
      border: '2px solid #2196f3'
    }}>
      <h3 style={{ color: '#2196f3' }}>Logowanie do systemu kwantowego</h3>
      <input
        type="text"
        placeholder="Wpisz swoje imię..."
        value={name}
        onChange={(e) => setName(e.target.value)}
        style={{
          width: '100%',
          padding: '12px',
          marginTop: '15px',
          borderRadius: '6px',
          border: '1px solid #2196f3',
          background: 'rgba(255, 255, 255, 0.1)',
          color: 'white',
          fontSize: '1rem'
        }}
      />
      <button
        onClick={handleLogin}
        style={{
          marginTop: '15px',
          width: '100%',
          background: 'linear-gradient(45deg, #2196f3, #21cbf3)',
          color: 'white',
          border: 'none',
          padding: '12px',
          borderRadius: '6px',
          cursor: 'pointer',
          fontWeight: 'bold',
          fontSize: '1rem'
        }}
      >
        Zaloguj
      </button>
    </div>
  );
}

// ==========================================
// Główna aplikacja z providerami
// ==========================================
function App() {
  const [theme, setTheme] = useState<'dark' | 'light'>('dark');
  const [user, setUser] = useState<User | null>(null);

  const toggleTheme = () => {
    setTheme(prev => prev === 'dark' ? 'light' : 'dark');
    console.log(`Zmieniono motyw na: ${theme === 'dark' ? 'jasny' : 'ciemny'}`);
  };

  const login = (newUser: User) => {
    setUser(newUser);
    console.log(`Zalogowano użytkownika: ${newUser.name}`);
  };

  const logout = () => {
    setUser(null);
    console.log("Wylogowano użytkownika");
  };

  return (
    <ThemeContext.Provider value={{ theme, toggleTheme }}>
      <UserContext.Provider value={{ user, login, logout }}>
        <div style={{
          padding: '20px',
          background: theme === 'dark'
            ? 'linear-gradient(135deg, #0f0f23 0%, #1a1a2e 100%)'
            : 'linear-gradient(135deg, #fafafa 0%, #e0e0e0 100%)',
          minHeight: '100vh',
          color: theme === 'dark' ? 'white' : '#333',
          transition: 'all 0.3s ease'
        }}>
          <h1 style={{
            textAlign: 'center',
            color: theme === 'dark' ? '#64ffda' : '#ff9800'
          }}>
            Demo zarządzania stanem
          </h1>

          <div style={{ display: 'flex', justifyContent: 'center', marginTop: '20px' }}>
            <ThemeButton />
          </div>

          <div style={{ marginTop: '30px' }}>
            <TemperatureCalculator />
          </div>

          <ThemedPanel />

          <div style={{ marginTop: '30px' }}>
            {user ? <UserProfile /> : <LoginForm />}
          </div>

          <div style={{
            marginTop: '30px',
            background: theme === 'dark'
              ? 'rgba(100, 255, 218, 0.1)'
              : 'rgba(255, 152, 0, 0.2)',
            padding: '20px',
            borderRadius: '10px',
            borderLeft: `4px solid ${theme === 'dark' ? '#64ffda' : '#ff9800'}`
          }}>
            <h3>Wzorce zarządzania stanem:</h3>
            <ul style={{ lineHeight: '1.8' }}>
              <li><strong>Podnoszenie stanu</strong>: Przenoś stan do wspólnego rodzica</li>
              <li><strong>Context API</strong>: Globalny stan bez prop drillingu</li>
              <li><strong>Własne hooki</strong>: Logika stanu wielokrotnego użytku</li>
              <li><strong>Redux/Zustand</strong>: Dla większych aplikacji</li>
            </ul>
          </div>
        </div>
      </UserContext.Provider>
    </ThemeContext.Provider>
  );
}

export default App;

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. Które z poniższych jest poprawną metodą renderowania listy w React?

  2. 2. Atrybut 'key' w React jest potrzebny przy:

  3. 3. Co robi polecenie npm run build (next build) w projekcie Next.js?

Zadania praktyczne w grze

  • Edytor kodu

    Utwórz komponent LoginStatus, który przyjmuje prop isLoggedIn (true albo false) i wyświetla „Zalogowany”, gdy isLoggedIn jest true, albo „Niezalogowany”, gdy jest false. Użyj renderowania warunkowego (operator ? : albo if).

  • Edytor kodu

    W komponencie App utwórz przycisk <button>, który po kliknięciu (onClick) wyświetla alert z komunikatem 'Przycisk został kliknięty!'.

  • Klikanie w kolejności

    Ułóż składnię deklaracji Client Component w Next.js

  • Edytor kodu

    Stwórz komponent DroneControlPanel (export default) z nagłówkiem <h1> „Panel drona” i elementem <nav> z trzema linkami <Link> z next/link: „Mapa” (/map), „Status” (/status) i „Ustawienia” (/settings).

  • Układanie w pionie

    Ułóż ścieżkę do pliku Route Handler w Next.js, a na końcu funkcję, którą ten plik eksportuje

  1. PytanieZaawansowane: Renderowanie list w React
  2. PytanieZaawansowane: Atrybut key w React
  3. Zadanie z kodemZaawansowane: Praktyka: Renderowanie warunkowe
  4. PytaniePolecenie npm run build
  5. Zadanie z kodemZaawansowane: Praktyka: Obsługa zdarzeń onClick
  6. Kliknij w kolejnościSkładnia dyrektywy 'use client'
  7. Zadanie z kodemPraktyka: Panel kontrolny drona
  8. Ułóż w kolejnościŚcieżka do Route Handler

Przydatne artykuły