Kurs vibe coding z Claude Code · Moduł 4: Klon Instagrama

Zdjęcia ze skarbca: komponent Image z Next.js

9 min czytania ·
W tej lekcji11

Ahoj! Nowa lokacja to nowy klon: Treasure Gallery, galeria zdjęć z rejsu w stylu Instagrama. Zaczynasz od samych zdjęć, bo to one ważą w galerii najwięcej. Claude Code pokaże je komponentem, który dba o rozmiar, format i kolejność ładowania, a Ty sprawdzisz w Cursorze, czy zrobił to dobrze.

Czego się nauczysz

  • zlecić Claude Code stronę ze zdjęciami z folderu projektu i z obcego serwera;
  • czytać propsy width, height, fill, sizes i loading komponentu Image;
  • sprawdzić w next.config.ts, czy lista dozwolonych serwerów zdjęć jest wąska;
  • wyłapać trzy typowe błędy agenta: zwykły <img>, fill bez relative i alt, który nic nie mówi.

Kraken's Call zostaje w swoim porcie. To gra z komunikatorem, a Instagram to osobna aplikacja z innymi danymi, więc dostaje własny projekt. Zakładasz go tak jak w lekcji 1_2: otwórz w Cursorze folder projekty, uruchom claude i poproś o projekt tym samym poleceniem co w lekcji 1_2, zmieniając tylko nazwę na treasure-gallery. Zanim klikniesz Yes, porównaj komendę z tą:

npx create-next-app@latest treasure-gallery --ts --eslint --tailwind --app --no-src-dir --no-cache-components --agents-md --no-agent-feedback --use-npm

Flagi znasz z lekcji 1_2: TypeScript, ESLint, Tailwind CSS i App Router, bez folderu src/ i bez Cache Components. Dalej pętla z lokacji 2: przenieś sesję do folderu treasure-gallery, poproś o npm run build jako dowód, zrób krótki CLAUDE.md z importem @AGENTS.md jak w lekcji 1_7 i zapisz commit. Od tej chwili każde polecenie w tej lokacji dotyczy tego projektu.

Problem: zdjęcie z telefonu waży megabajty

Utwórz w projekcie folder public/images/ i wrzuć do niego trzy swoje zdjęcia, na przykład z telefonu, pod nazwami skarb-1.jpg, skarb-2.jpg i skarb-3.jpg. Czwarte, kapitan.jpg, posłuży za awatar. Zdjęcie z telefonu ma zwykle kilka tysięcy pikseli szerokości i waży megabajty, a miniatura w galerii zajmuje na ekranie około 300 pikseli. Zwykły znacznik <img> i tak wyśle przeglądarce cały plik. Strona ładuje się długo, na telefonie zjada transfer, a gdy zdjęcia dochodzą jedno po drugim, tekst pod nimi skacze w dół.

Image w jednym akapicie

Next.js ma na to komponent Image z paczki next/image, który rozszerza zwykły <img>. Przygotowuje kopię zdjęcia w rozmiarze potrzebnym na danym ekranie, w lżejszym formacie WebP. Zdjęcia niżej na stronie ładuje leniwie (lazy loading), czyli dopiero gdy zbliżają się do widocznej części ekranu. Rezerwuje też miejsce na obraz, zanim ten przyjdzie, więc nic nie skacze; to skakanie ma swoją nazwę: Cumulative Layout Shift, w skrócie CLS. W zamian Image chce wiedzieć, co jest na zdjęciu (alt) i jak duży ma być obraz (width i height albo fill). Zdjęcia z obcych serwerów przepuszcza tylko z listy w next.config.ts.

Polecenie dla Claude Code

Galeria ma dwa źródła zdjęć: Twój folder public/images/ i trzy zdjęcia z darmowego serwisu Unsplash. Polecenie ma cel, pliki, ograniczenia i sprawdzian, jak w lekcji 0_5:

Polecenie dla Claude Code:

Zbuduj stronę /gallery w Treasure Gallery, profil jak na Instagramie.
Dane zdjęć trzymaj w lib/photos.ts: id, src, alt, autor i podpis.
Trzy zdjęcia leżą w public/images/ (skarb-1.jpg, skarb-2.jpg,
skarb-3.jpg): obejrzyj je i napisz alt, który mówi, co na nich widać.
Trzy kolejne są z Unsplash:
https://images.unsplash.com/photo-1507525428034-b723cf961d3e
https://images.unsplash.com/photo-1505118380757-91f5f5632de0
https://images.unsplash.com/photo-1534447677768-be436bb09401
Na górze okrągły awatar z public/images/kapitan.jpg (96 px) i tytuł,
pod nim kwadratowe miniatury w trzech kolumnach. Wszędzie Image
z next/image, nigdzie <img>. W @next.config.ts pozwól tylko na serwer
images.unsplash.com i niczego innego w tym pliku nie zmieniaj.
Na koniec uruchom npm run build i npm run lint i pokaż wyniki.

Prośba "obejrzyj je" nie jest ozdobnikiem: Claude Code czyta pliki PNG, JPEG, GIF i WebP jako obrazy, więc sam zobaczy, co jest na Twoich zdjęciach. Zakaz innych zmian w next.config.ts chroni resztę pliku, w tym regułę, którą kreator wpisał tam dla Tailwinda.

Co napisał Claude: dane zdjęć

Otwórz w Cursorze lib/photos.ts. Na górze stoi typ zdjęcia, pod nim tablica sześciu wpisów. Tu dwa z nich, zdalny i lokalny:

export interface Photo {
  id: string;
  src: string;
  alt: string;
  author: string;
  caption: string;
}

export const photos: Photo[] = [
  {
    id: "zachod-na-plazy",
    src: "https://images.unsplash.com/photo-1507525428034-b723cf961d3e",
    alt: "Fale na piaszczystej plaży o zachodzie słońca",
    author: "Morgan",
    caption: "Tu zakopaliśmy skrzynię",
  },
  {
    id: "skarb-1",
    src: "/images/skarb-1.jpg",
    alt: "Palmy i słomkowy parasol na białej plaży",
    author: "Kapitan Redbeard",
    caption: "Wyspa z mapy",
  },
];

src zdjęcia z folderu public/ zaczyna się od ukośnika i nie zawiera słowa public: plik public/images/skarb-1.jpg jest dostępny pod adresem /images/skarb-1.jpg. Zdjęcie zdalne ma pełny adres z https://. Twoje opisy w alt będą inne, bo Claude pisał je, patrząc na Twoje zdjęcia.

Awatar: width i height

Otwórz app/gallery/page.tsx. Na górze stoi import komponentu: import Image from "next/image";. Strona to <main> z klasą max-w-4xl, więc ma najwyżej 896 pikseli szerokości. Zaczyna się od nagłówka profilu z awatarem:

<Image
  src="/images/kapitan.jpg"
  alt="Portret kapitana Redbearda"
  width={96}
  height={96}
  className="h-24 w-24 rounded-full object-cover"
/>

width i height to wymiary obrazu w pikselach. Next.js liczy z nich proporcje i rezerwuje miejsce, zanim plik przyjdzie, a według nich dobiera też rozmiar kopii. Rozmiar na ekranie ustawiają klasy: h-24 w-24 to 96 na 96 pikseli, rounded-full robi koło, a object-cover przycina zdjęcie, które nie jest kwadratowe. Oba propsy są obowiązkowe, chyba że obraz ma fill albo jest importowany z pliku instrukcją import.

Miniatury: fill, sizes i loading

Pod nagłówkiem stoi siatka. Każda miniatura to kwadratowe pudełko z obrazem w środku:

<div className="grid grid-cols-3 gap-1">
  {photos.map((photo, index) => (
    <div key={photo.id} className="relative aspect-square">
      <Image
        src={photo.src}
        alt={photo.alt}
        fill
        sizes="(max-width: 896px) 33vw, 300px"
        loading={index < 3 ? "eager" : "lazy"}
        className="object-cover"
      />
    </div>
  ))}
</div>

Wymiarów zdjęć z telefonu i z Unsplash nie znamy, więc Claude użył fill: obraz rozciąga się na całe pudełko rodzica. Rodzic musi mieć pozycję relative, absolute albo fixed, tu klasą relative, i wysokość, którą daje aspect-square, czyli kwadrat o proporcjach 1:1. object-cover wypełnia kwadrat i przycina to, co wystaje, a object-contain pokazałby całe zdjęcie z pustymi pasami.

sizes mówi przeglądarce, jak szeroki będzie obraz: w oknie do 896 pikseli jedna trzecia szerokości ekranu (33vw), w szerszym 300 pikseli. Bez sizes przeglądarka zakłada, że obraz z fill zajmuje cały ekran, i pobiera za duży plik. loading decyduje, kiedy ładować. Domyślnie obraz ładuje się leniwie, a pierwszy rząd, widoczny od razu po wejściu, Claude ustawił na "eager", czyli od razu.

Starszy prop priority jest od Next.js 16 przestarzały, a dokumentacja w większości przypadków zaleca zamiast niego loading="eager" albo fetchPriority="high" (stan na listopad 2026). Strona startowa z kreatora wciąż ma priority przy logo Next.js, więc nie bierz z niej wzoru.

next.config.ts: lista dozwolonych serwerów

Otwórz next.config.ts. Blok turbopack z regułą dla Tailwinda zostawił kreator, Claude dopisał pod nim tylko images:

import type { NextConfig } from "next";

const nextConfig: NextConfig = {
  /* config options here */
  turbopack: {
    rules: {
      "*.css": {
        loaders: ["@tailwindcss/turbopack"],
        as: "*.css",
      },
    },
  },
  images: {
    remotePatterns: [
      {
        protocol: "https",
        hostname: "images.unsplash.com",
        port: "",
        pathname: "/**",
        search: "",
      },
    ],
  },
};

export default nextConfig;

remotePatterns to lista wzorców adresów, z których Next.js może pobierać i przerabiać obrazy. Ten wpis przepuszcza tylko https, tylko serwer images.unsplash.com, bez innych portów (port: "") i bez parametrów po znaku zapytania (search: ""). /** w pathname znaczy dowolną ścieżkę na tym serwerze. Dokumentacja pokazuje też krótszy zapis jednym adresem: remotePatterns: [new URL("https://images.unsplash.com/**")]. Serwer npm run dev sam zauważa zmianę w tym pliku i wypisuje "Found a change in next.config.ts. Restarting the server", więc nie musisz go restartować. Zdjęcie z serwera spoza listy zatrzyma stronę takim błędem:

Error: Invalid src prop (https://example.com/a.jpg) on `next/image`, hostname "example.com" is not configured under images in your `next.config.js`

Komunikat mówi o next.config.js, ale w projekcie TypeScript chodzi o ten sam plik w wersji next.config.ts. Poprawka to nowy wpis na liście, zawsze z konkretnym serwerem.

Przegląd kapitana

Uruchom w drugim terminalu npm run dev, otwórz localhost:3000/gallery i sprawdź:

  1. Żadnego <img>. Wyszukaj w projekcie tekst <img: w app/ ma nie być trafień. Zwykły znacznik nie przerywa builda, a linter tylko ostrzega:
warning  Using `<img>` could result in slower LCP and higher bandwidth. Consider using `<Image />` from `next/image` ...  @next/next/no-img-element

Ostrzeżenie nie zmienia wyniku npm run lint na błąd, dlatego czytaj wyjście komendy, a nie tylko to, czy się skończyła.

  1. fill bez relative. To typowy błąd agenta: Claude dopisuje fill, ale pudełko nad obrazem nie ma pozycji. Zdjęcie rozlewa się wtedy na całą stronę, a konsola przeglądarki pokazuje:
Image with src "/images/skarb-1.jpg" has "fill" and parent element with invalid "position". Provided "static" should be one of absolute,fixed,relative.

Poprawka to klasa relative na rodzicu, a nie usunięcie fill.

  1. Wąska lista serwerów. W next.config.ts nie ma hostname: "**" ani wpisu bez protocol. Dokumentacja ostrzega, że pominięte pola działają jak gwiazdka i wpuszczają adresy, których nie planowałeś. Blok turbopack stoi nietknięty.

  2. alt opisuje zdjęcie. "Obraz", "zdjęcie 1" albo nazwa pliku nic nie mówią osobie, której czytnik ekranu czyta stronę na głos. Dobry alt zastępuje zdjęcie słowami. Dla obrazka czysto ozdobnego dokumentacja każe wpisać pusty alt="".

Na koniec dowód, że optymalizacja działa: kliknij miniaturę prawym przyciskiem myszy i otwórz obraz w nowej karcie. Adres zaczyna się od /_next/image?url= i ma parametr w, czyli szerokość kopii. W naszej próbie zdjęcie o wadze 1,5 MB przyszło w kopii o szerokości 384 pikseli jako plik WebP o wadze około 21 KB.

Następny krok

Gdy przegląd przejdzie, poproś o commit, na przykład "Galeria: zdjęcia przez next/image i lista serwerów". Przed następną lekcją zrób jeszcze jedno, z dala od komputera: narysuj na kartce, jak ma wyglądać galeria po kliknięciu zdjęcia. Siatka miniatur, a nad nią okno z dużym zdjęciem, autorem, podpisem i krzyżykiem do zamykania. Zrób zdjęcie kartki telefonem, bo w lekcji 3_2 Claude Code zbuduje okno właśnie z tego szkicu.

W edytorze poniżej masz kwadratowe kafelki z prawdziwymi zdjęciami. Edytor nie ma serwera Next.js, więc stoi w nim zwykły <img> z klasami, które w projekcie dostaje Image z fill. Przełącz object-cover na object-contain i zobacz, gdzie znika przycięcie, a potem rozwiąż zadania.

Zapamiętaj: skarb pokazujesz w rozmiarze, który mieści się w lunecie, a nie w całej skrzyni, i wpuszczasz tylko z portów, które sam wpisałeś na listę.

Kod do tej lekcji: App.jsx
// Kafelki galerii: object-cover kontra object-contain
// W projekcie Next.js stoi tu <Image fill className="object-cover" />.
// Edytor nie ma serwera Next.js, więc zwykły <img> dostaje klasy,
// które Image z fill ustawia sam: absolute, pełna szerokość i wysokość.
import { useState } from 'react';

const photos = [
  {
    id: 'zachod-na-plazy',
    src: 'https://images.unsplash.com/photo-1507525428034-b723cf961d3e?w=600',
    alt: 'Fale na piaszczystej plaży o zachodzie słońca',
  },
  {
    id: 'fale-z-gory',
    src: 'https://images.unsplash.com/photo-1505118380757-91f5f5632de0?w=600',
    alt: 'Turkusowe fale przy białej plaży widziane z lotu ptaka',
  },
  {
    id: 'zaglowka-noca',
    src: 'https://images.unsplash.com/photo-1534447677768-be436bb09401?w=600',
    alt: 'Mała żaglówka na spokojnym morzu pod rozgwieżdżonym niebem',
  },
];

const fits = ['object-cover', 'object-contain'];

export default function App() {
  const [fit, setFit] = useState('object-cover');

  return (
    <div className="min-h-screen bg-slate-100 p-6 text-slate-900">
      <h1 className="mb-1 text-2xl font-bold">Treasure Gallery</h1>
      <p className="mb-4 text-sm text-slate-600">
        Kafelek ma relative i aspect-square, zdjęcie wypełnia go w całości.
      </p>

      <div className="mb-4 flex gap-2">
        {fits.map((option) => (
          <button
            key={option}
            type="button"
            onClick={() => setFit(option)}
            aria-pressed={fit === option}
            className={fit === option
              ? 'rounded bg-slate-900 px-3 py-1 text-sm text-white'
              : 'rounded bg-white px-3 py-1 text-sm'}
          >
            {option}
          </button>
        ))}
      </div>

      <div className="grid grid-cols-3 gap-1">
        {photos.map((photo) => (
          <div key={photo.id} className="relative aspect-square bg-slate-800">
            <img
              src={photo.src}
              alt={photo.alt}
              className={`absolute inset-0 h-full w-full ${fit}`}
            />
          </div>
        ))}
      </div>

      <p className="mt-4 text-sm text-slate-600">
        {fit === 'object-cover'
          ? 'object-cover: kwadrat pełny, brzegi zdjęcia przycięte.'
          : 'object-contain: całe zdjęcie widoczne, puste pasy na brzegach.'}
      </p>
    </div>
  );
}

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. Co daje komponent Image z next/image w porównaniu ze zwykłym znacznikiem <img>?

  2. 2. W jakim formacie Next.js wysyła domyślnie zoptymalizowaną kopię zdjęcia przeglądarce, która ten format obsługuje?

To 2 z 7 pytań do tej lekcji. Pozostałe rozwiążesz w grze.

Zadania praktyczne w grze

  • Klikanie w kolejności

    Kliknij tokeny w kolejności, aby zaimportować komponent Image z Next.js:

  • Układanie w poziomie

    Ułóż fragmenty krótszego zapisu listy dozwolonych serwerów zdjęć z next.config.ts (jedna linia, od lewej):

  • Edytor kodu

    Image component

  • Klikanie w kolejności

    Kliknij fragmenty w kolejności, aby pierwsze trzy miniatury ładowały się od razu, a pozostałe leniwie:

  • Układanie w pionie

    Uporządkuj linie pliku next.config.ts z listą dozwolonych serwerów zdjęć (od góry do dołu):

  • Edytor kodu

    Responsive image

  • Układanie w poziomie

    Plik leży w public/images/skarby/skarb-1.jpg. Ułóż fragmenty wartości src, którą wpiszesz w Image:

  1. PytanieQuiz: Image zamiast img
  2. PytanieQuiz: Format zoptymalizowanego zdjęcia
  3. PytanieQuiz: Wymagane propsy obrazu
  4. Kliknij w kolejnościKlikanie: Import komponentu Image
  5. Ułóż w kolejnościSortowanie: Krótki zapis remotePatterns
  6. Zadanie z kodemPraktyka: Podstawowy Image
  7. PytanieQuiz: Prop fill
  8. PytanieQuiz: object-cover i object-contain
  9. Kliknij w kolejnościKlikanie: Kiedy ładować miniatury
  10. Ułóż w kolejnościSortowanie: Plik next.config.ts
  11. Zadanie z kodemPraktyka: Image z fill
  12. PytanieQuiz: Zdjęcia widoczne od razu
  13. PytanieQuiz: Zdjęcia z obcych serwerów
  14. Ułóż w kolejnościSortowanie: Ścieżka zdjęcia z public

Przydatne artykuły