spinny:~/writing $ less create-demo-claude-code-vibecoding.md
12**Vibecoding** to nowy paradygmat rozwoju oprogramowania, w którym programista kieruje agentem AI za pomocą instrukcji w języku naturalnym, pozwalając sztucznej inteligencji pisać właściwy kod. Termin został ukuty przez Andreja Karpathy'ego (współzałożyciela OpenAI i byłego dyrektora AI w Tesli) w słynnym tweecie z lutego 2025: _"Jest nowy rodzaj kodowania, który nazywam vibecoding, gdzie całkowicie oddajesz się vibom, akceptujesz wykładniczy wzrost i zapominasz, że kod w ogóle istnieje."_34W tym artykule zobaczymy, jak zbudować kompletne, działające demo używając **Claude Code** jako agenta AI, **Supabase** jako backendu (baza danych, uwierzytelnianie, API) i **Vercel** do wdrożenia - wszystko wykorzystując wyłącznie **darmowe plany** tych usług.56## 1. Czym Jest Vibecoding i Dlaczego Jest Rewolucyjny78Vibecoding reprezentuje fundamentalną zmianę paradygmatu w rozwoju oprogramowania. Zamiast pisać kod linia po linii, programista:9101. **Opisuje** co chce w języku naturalnym.112. **Agent AI** generuje kompletny kod.123. **Programista** sprawdza, testuje i iteruje.1314### Dlaczego To Działa1516- **Szybkość**: projekt, który zajmowałby dni, można zbudować w godzinach.17- **Dostępność**: nawet niedoświadczeni programiści mogą budować działające produkty.18- **Szybka iteracja**: możesz testować pomysły i zmieniać kierunek znacznie szybciej.19- **Skupienie na produkcie**: koncentrujesz się na _co_ zamiast _jak_.2021```mermaid22flowchart LR23 A[Idea] --> B[Natural language prompt]24 B --> C[Claude Code generates code]25 C --> D[Review and test]26 D --> E[Iteration]27 E --> B28 D --> F[Deploy to Vercel]29```3031### Kiedy Używać Vibecoding3233Vibecoding jest idealny do:3435- **Demo i MVP**: szybkie budowanie prototypu w celu walidacji pomysłu.36- **Hackathonów**: tworzenie działającego produktu w zaledwie kilka godzin.37- **Projektów pobocznych**: eksplorowanie nowych technologii bez inwestowania tygodni.38- **Proof of Concept**: demonstrowanie wykonalności technicznej interesariuszom lub inwestorom.3940> **Ostrzeżenie:** Vibecoding jest doskonały do demo i prototypów. W przypadku aplikacji produkcyjnych o wysokich wymaganiach bezpieczeństwa i skalowalności, dokładny przegląd wygenerowanego kodu jest nadal niezbędny.4142## 2. Stos Technologiczny: Claude Code + Supabase + Vercel4344### Claude Code4546Claude Code to agent kodowania AI od Anthropic. Działa bezpośrednio w terminalu i może:4748- Czytać i rozumieć całą bazę kodu.49- Tworzyć, modyfikować i usuwać pliki.50- Wykonywać polecenia terminala.51- Współdziałać z API i zewnętrznymi usługami.52- Zarządzać wersjonowaniem z Git.53- Autonomicznie iterować nad błędami i bugami.5455```bash56# Install Claude Code57npm install -g @anthropic-ai/claude-code5859# Start in a project directory60cd my-project61claude62```6364### Supabase (Darmowy Plan)6566Supabase to open-source'owa alternatywa dla Firebase oferująca:6768- **Bazę danych PostgreSQL**: kompletną relacyjną bazę danych.69- **Uwierzytelnianie**: logowanie przez email, Google, GitHub itp.70- **API REST i Realtime**: automatycznie generowane ze schematu.71- **Storage**: dla plików i obrazów.72- **Edge Functions**: funkcje serverless.7374Darmowy plan obejmuje:7576| Zasób | Darmowy limit |77|----------|-----------|78| Baza danych | 500 MB |79| Storage | 1 GB |80| Przepustowość | 5 GB |81| Wywołania Edge Function | 500K/miesiąc |82| Uwierzytelnieni użytkownicy | Bez limitu |83| Projekty | 2 aktywne projekty |8485### Vercel (Darmowy Plan)8687Vercel to idealna platforma wdrożeniowa dla aplikacji Next.js:8889- **Automatyczne wdrożenie** z GitHub.90- **Wdrożenia podglądowe** dla każdej gałęzi i PR.91- **Globalna sieć CDN** dla optymalnej wydajności.92- **Serverless Functions** w zestawie.93- **Podstawowa analityka** za darmo.9495Darmowy plan obejmuje:9697| Zasób | Darmowy limit |98|----------|-----------|99| Przepustowość | 100 GB/miesiąc |100| Wykonanie Serverless Function | 100 GB-godzin/miesiąc |101| Kompilacje | 6000 minut/miesiąc |102| Projekty | Bez limitu |103| Wdrożenia | Bez limitu |104105## 3. Początkowa Konfiguracja: Przygotowanie Środowiska106107### Wymagania Wstępne108109Przed rozpoczęciem upewnij się, że masz:110111- **Node.js 18+** zainstalowany.112- **Git** skonfigurowany.113- Konto **GitHub**.114- Konto **Supabase** (darmowe na [supabase.com](https://supabase.com)).115- Konto **Vercel** (darmowe na [vercel.com](https://vercel.com)).116- **Claude Code** zainstalowany (`npm install -g @anthropic-ai/claude-code`).117118### Krok 1: Utwórz Projekt119120Otwórz terminal i uruchom Claude Code:121122```bash123mkdir my-demo-app && cd my-demo-app124claude125```126127Teraz możesz zacząć dawać Claude Code instrukcje w języku naturalnym:128129```130You: Create a Next.js 15 project with App Router, TypeScript, Tailwind CSS,131and shadcn/ui. Also initialize a Git repository.132```133134Claude Code automatycznie wykona:135136```bash137npx create-next-app@latest . --typescript --tailwind --eslint --app --src-dir138npx shadcn@latest init139git init && git add . && git commit -m "Initial commit"140```141142### Krok 2: Skonfiguruj Supabase1431441. Przejdź na [supabase.com](https://supabase.com) i utwórz nowy projekt.1452. Zanotuj **Project URL** i **anon key** z Settings > API.1463. Wróć do terminala z Claude Code:147148```149You: Add Supabase to the project. Create a .env.local file with the variables150NEXT_PUBLIC_SUPABASE_URL and NEXT_PUBLIC_SUPABASE_ANON_KEY. Configure the151Supabase client with SSR support for Next.js App Router.152```153154Claude Code utworzy kompletną konfigurację:155156```typescript157// src/lib/supabase/client.ts158import { createBrowserClient } from '@supabase/ssr';159160export function createClient() {161 return createBrowserClient(162 process.env.NEXT_PUBLIC_SUPABASE_URL!,163 process.env.NEXT_PUBLIC_SUPABASE_ANON_KEY!164 );165}166```167168```typescript169// src/lib/supabase/server.ts170import { createServerClient } from '@supabase/ssr';171import { cookies } from 'next/headers';172173export async function createClient() {174 const cookieStore = await cookies();175176 return createServerClient(177 process.env.NEXT_PUBLIC_SUPABASE_URL!,178 process.env.NEXT_PUBLIC_SUPABASE_ANON_KEY!,179 {180 cookies: {181 getAll() {182 return cookieStore.getAll();183 },184 setAll(cookiesToSet) {185 cookiesToSet.forEach(({ name, value, options }) =>186 cookieStore.set(name, value, options)187 );188 },189 },190 }191 );192}193```194195## 4. Budowanie Demo: Aplikacja do Zarządzania Zadaniami196197Zbudujmy konkretne demo: **aplikację do zarządzania zadaniami** z uwierzytelnianiem, pełnym CRUD i nowoczesnym interfejsem.198199### Definicja Schematu Bazy Danych200201Daj Claude Code instrukcje do stworzenia schematu:202203```204You: Create a SQL migration for Supabase with the following tables:2052061. profiles: id (uuid, FK to auth.users), username (text), avatar_url (text),207 created_at2082. projects: id (uuid), name (text), description (text), owner_id (uuid, FK209 to profiles), created_at2103. tasks: id (uuid), title (text), description (text), status (enum:211 todo/in_progress/done), priority (enum: low/medium/high), project_id (uuid,212 FK to projects), assigned_to (uuid, FK to profiles), due_date (timestamp),213 created_at, updated_at214215Enable Row Level Security on all tables and create appropriate policies.216```217218Claude Code wygeneruje kompletną migrację:219220```sql221-- Create enum types222CREATE TYPE task_status AS ENUM ('todo', 'in_progress', 'done');223CREATE TYPE task_priority AS ENUM ('low', 'medium', 'high');224225-- Profiles table226CREATE TABLE profiles (227 id UUID REFERENCES auth.users ON DELETE CASCADE PRIMARY KEY,228 username TEXT UNIQUE,229 avatar_url TEXT,230 created_at TIMESTAMPTZ DEFAULT NOW()231);232233-- Projects table234CREATE TABLE projects (235 id UUID DEFAULT gen_random_uuid() PRIMARY KEY,236 name TEXT NOT NULL,237 description TEXT,238 owner_id UUID REFERENCES profiles(id) ON DELETE CASCADE NOT NULL,239 created_at TIMESTAMPTZ DEFAULT NOW()240);241242-- Tasks table243CREATE TABLE tasks (244 id UUID DEFAULT gen_random_uuid() PRIMARY KEY,245 title TEXT NOT NULL,246 description TEXT,247 status task_status DEFAULT 'todo',248 priority task_priority DEFAULT 'medium',249 project_id UUID REFERENCES projects(id) ON DELETE CASCADE NOT NULL,250 assigned_to UUID REFERENCES profiles(id),251 due_date TIMESTAMPTZ,252 created_at TIMESTAMPTZ DEFAULT NOW(),253 updated_at TIMESTAMPTZ DEFAULT NOW()254);255256-- Enable RLS257ALTER TABLE profiles ENABLE ROW LEVEL SECURITY;258ALTER TABLE projects ENABLE ROW LEVEL SECURITY;259ALTER TABLE tasks ENABLE ROW LEVEL SECURITY;260261-- Profiles policies262CREATE POLICY "Users can view own profile"263 ON profiles FOR SELECT USING (auth.uid() = id);264CREATE POLICY "Users can update own profile"265 ON profiles FOR UPDATE USING (auth.uid() = id);266267-- Projects policies268CREATE POLICY "Users can view own projects"269 ON projects FOR SELECT USING (auth.uid() = owner_id);270CREATE POLICY "Users can create projects"271 ON projects FOR INSERT WITH CHECK (auth.uid() = owner_id);272CREATE POLICY "Users can update own projects"273 ON projects FOR UPDATE USING (auth.uid() = owner_id);274CREATE POLICY "Users can delete own projects"275 ON projects FOR DELETE USING (auth.uid() = owner_id);276277-- Tasks policies278CREATE POLICY "Users can view tasks in their projects"279 ON tasks FOR SELECT USING (280 project_id IN (SELECT id FROM projects WHERE owner_id = auth.uid())281 );282CREATE POLICY "Users can create tasks in their projects"283 ON tasks FOR INSERT WITH CHECK (284 project_id IN (SELECT id FROM projects WHERE owner_id = auth.uid())285 );286CREATE POLICY "Users can update tasks in their projects"287 ON tasks FOR UPDATE USING (288 project_id IN (SELECT id FROM projects WHERE owner_id = auth.uid())289 );290CREATE POLICY "Users can delete tasks in their projects"291 ON tasks FOR DELETE USING (292 project_id IN (SELECT id FROM projects WHERE owner_id = auth.uid())293 );294```295296Migrację tę można uruchomić bezpośrednio z panelu Supabase (SQL Editor) lub przez CLI.297298### Generowanie Typów TypeScript299300```301You: Generate TypeScript types from the Supabase database and save them to src/types/database.ts302```303304```bash305npx supabase gen types typescript --project-id YOUR_PROJECT_ID > src/types/database.ts306```307308### Budowanie Interfejsu Użytkownika309310Teraz nadchodzi najpotężniejsza część vibecoding. Daj Claude Code instrukcje wysokiego poziomu:311312```313You: Create a dashboard page for the task management app with:3143151. Sidebar with navigation between projects3162. Kanban view with 3 columns (Todo, In Progress, Done) with drag & drop3173. Modal to create/edit tasks3184. Header with user avatar and logout3195. Modern design with shadcn/ui and Tailwind320321Use data from Supabase with React Server Components where possible322and Client Components only where interactivity is needed.323```324325Claude Code zbuduje cały interfejs, komponent po komponencie.326327### Dodanie Uwierzytelniania328329```330You: Add a complete authentication system with:3313321. Login page with email/password and GitHub login3332. Registration page3343. Middleware to protect authenticated routes3354. Automatic redirect for unauthenticated users3365. Automatic profile creation after registration337```338339Claude Code skonfiguruje middleware Next.js i strony uwierzytelniania:340341```typescript342// src/middleware.ts343import { createServerClient } from '@supabase/ssr';344import { NextResponse, type NextRequest } from 'next/server';345346export async function middleware(request: NextRequest) {347 let supabaseResponse = NextResponse.next({ request });348349 const supabase = createServerClient(350 process.env.NEXT_PUBLIC_SUPABASE_URL!,351 process.env.NEXT_PUBLIC_SUPABASE_ANON_KEY!,352 {353 cookies: {354 getAll() {355 return request.cookies.getAll();356 },357 setAll(cookiesToSet) {358 cookiesToSet.forEach(({ name, value }) =>359 request.cookies.set(name, value)360 );361 supabaseResponse = NextResponse.next({ request });362 cookiesToSet.forEach(({ name, value, options }) =>363 supabaseResponse.cookies.set(name, value, options)364 );365 },366 },367 }368 );369370 const { data: { user } } = await supabase.auth.getUser();371372 if (!user && !request.nextUrl.pathname.startsWith('/auth')) {373 const url = request.nextUrl.clone();374 url.pathname = '/auth/login';375 return NextResponse.redirect(url);376 }377378 return supabaseResponse;379}380381export const config = {382 matcher: ['/((?!_next/static|_next/image|favicon.ico|auth).*)'],383};384```385386## 5. Zaawansowane Wzorce Vibecoding387388### Iteracyjne Promptowanie389390Sekret efektywnego vibecoding to **iteracja**. Nie próbuj opisywać wszystkiego w jednym prompcie. Postępuj etapowo:391392```393Step 1: "Create the base layout with header and sidebar"394Step 2: "Add the project list in the sidebar with a button to create new ones"395Step 3: "Create the Kanban view in the main area"396Step 4: "Add drag & drop between columns"397Step 5: "Implement the modal to create new tasks"398Step 6: "Add toast notifications for user feedback"399```400401> **Wskazówka:** Im bardziej szczegółowy i kontekstowy prompt, tym lepszy wynik. Claude Code ma dostęp do całej bazy kodu, więc może spójnie integrować nowe funkcje.402403### Obsługa Błędów404405Gdy coś nie działa (a będzie tak), możesz po prostu powiedzieć:406407```408You: I'm getting this error in the console: "TypeError: Cannot read property409'map' of undefined" in the TaskList component. Fix it.410```411412Claude Code przeanalizuje kod, zidentyfikuje problem i go naprawi.413414### Refaktoring z AI415416```417You: The Dashboard component has become too large. Split it into smaller,418reusable components while maintaining the same functionality.419```420421### Testowanie422423```424You: Add tests with Vitest for utility functions and Playwright tests for425the authentication and task creation flow.426```427428## 6. Wdrożenie na Vercel: Od Kodu do Świata429430### Krok 1: Push na GitHub431432```433You: Create an appropriate .gitignore, commit everything, and push to a new434GitHub repository called "my-demo-app".435```436437```bash438git add .439git commit -m "feat: complete task management demo"440gh repo create my-demo-app --public --push --source=.441```442443### Krok 2: Podłącz Vercel4444451. Przejdź na [vercel.com](https://vercel.com) i kliknij „Add New Project".4462. Zaimportuj właśnie utworzone repozytorium GitHub.4473. Dodaj zmienne środowiskowe:448 - `NEXT_PUBLIC_SUPABASE_URL`449 - `NEXT_PUBLIC_SUPABASE_ANON_KEY`4504. Kliknij „Deploy".451452```mermaid453flowchart LR454 A[GitHub Push] --> B[Vercel Build]455 B --> C[Automatic Deploy]456 C --> D[Public URL]457 D --> E[Global CDN]458```459460### Krok 3: Konfiguracja Własnej Domeny (Opcjonalnie)461462Vercel zapewnia darmowy URL jak `my-demo-app.vercel.app`. Dla własnej domeny:463464```465You: Add the configuration for a custom domain in vercel.json466```467468### Wdrożenia Podglądowe469470Za każdym razem, gdy otwierasz Pull Request na GitHub, Vercel automatycznie utworzy **wdrożenie podglądowe** z unikalnym URL. Idealne do pokazywania zmian przed scaleniem.471472## 7. Optymalizacje dla Twojego Demo473474### Wydajność475476```477You: Optimize the app's performance:4781. Add loading states with Suspense and skeletons4792. Implement caching with Next.js unstable_cache4803. Optimize images with next/image4814. Add SEO metadata for each page482```483484### Realtime z Supabase485486Funkcja, która zawsze robi wrażenie w demo, to **realtime**:487488```489You: Add realtime synchronization for tasks using Supabase Realtime.490When a user updates a task, all other users should see the change491in real time without refreshing.492```493494```typescript495'use client';496497import { useEffect, useState } from 'react';498import { createClient } from '@/lib/supabase/client';499import type { Task } from '@/types/database';500501export function useRealtimeTasks(projectId: string) {502 const [tasks, setTasks] = useState<Task[]>([]);503 const supabase = createClient();504505 useEffect(() => {506 const channel = supabase507 .channel('tasks-changes')508 .on(509 'postgres_changes',510 {511 event: '*',512 schema: 'public',513 table: 'tasks',514 filter: `project_id=eq.${projectId}`,515 },516 (payload) => {517 if (payload.eventType === 'INSERT') {518 setTasks((prev) => [...prev, payload.new as Task]);519 } else if (payload.eventType === 'UPDATE') {520 setTasks((prev) =>521 prev.map((t) =>522 t.id === payload.new.id ? (payload.new as Task) : t523 )524 );525 } else if (payload.eventType === 'DELETE') {526 setTasks((prev) =>527 prev.filter((t) => t.id !== payload.old.id)528 );529 }530 }531 )532 .subscribe();533534 return () => {535 supabase.removeChannel(channel);536 };537 }, [projectId, supabase]);538539 return tasks;540}541```542543### Tryb Ciemny544545```546You: Add dark mode support with a toggle in the header.547Use Tailwind dark classes and save the preference in localStorage.548```549550## 8. Najlepsze Praktyki Efektywnego Vibecoding551552### 1. Bądź Konkretny w Promptach553554```555❌ "Make a nice page"556✅ "Create a landing page with a hero section with a purple-blue gradient,557 a features section with 3 cards with icons, and an orange CTA button"558```559560### 2. Dostarcz Kontekst561562```563❌ "Add authentication"564✅ "Add authentication with Supabase Auth. The project uses Next.js 15 App565 Router with TypeScript. I want email/password login and OAuth with GitHub.566 Use the SSR pattern with @supabase/ssr"567```568569### 3. Iteruj Małymi Krokami570571Nie próbuj budować wszystkiego w jednym prompcie. Postępuj stopniowo:5725731. Podstawowy układ5742. Jedna funkcja na raz5753. Stylizacja i dopracowanie5764. Obsługa błędów5775. Testowanie578579### 4. Sprawdzaj Wygenerowany Kod580581Vibecoding nie oznacza nieczytania kodu. Zawsze sprawdzaj:582583- **Bezpieczeństwo**: polityki RLS, walidacja danych wejściowych, sanityzacja danych.584- **Wydajność**: zapytania N+1, niepotrzebne komponenty po stronie klienta.585- **Najlepsze praktyki**: struktura projektu, konwencje nazewnictwa.586587### 5. Używaj Git Strategicznie588589```590You: Commit the changes with a descriptive message after each completed feature.591```592593Pozwala to na cofnięcie zmian, jeśli coś pójdzie nie tak.594595## 9. Koszty: Czy Naprawdę Wszystko Jest Za Darmo?596597Analiza kosztów dla każdej usługi:598599| Usługa | Darmowy plan | Kiedy płacisz |600|---------|-----------|-------------|601| **Claude Code** | Wymaga planu Anthropic (od $20/miesiąc) lub klucza API | Natychmiast, ale wartość jest ogromna |602| **Supabase** | Hojny darmowy plan (2 projekty, 500MB DB) | Po przekroczeniu limitów |603| **Vercel** | Darmowy plan dla projektów osobistych | Dla zespołów lub użytku komercyjnego |604| **GitHub** | Darmowy dla publicznych i prywatnych repozytoriów | Funkcje korporacyjne |605606> **Uwaga:** Claude Code wymaga subskrypcji lub kredytów API, ale zwrot z inwestycji pod względem szybkości rozwoju jest nadzwyczajny. Dla demo lub MVP całkowity koszt wynosi około $20.607608### Darmowe Alternatywy AI609610Jeśli chcesz utrzymać koszty na absolutnym zerze:611612- **Cursor** (darmowy plan z ograniczeniami).613- **GitHub Copilot** (darmowy dla studentów i open source).614- **Codeium/Windsurf** (hojny darmowy plan).615616## 10. Od Demo do Produktu: Następne Kroki617618Gdy Twoje demo jest na żywo, oto jak postępować:619620```mermaid621flowchart TD622 A[Live Demo] --> B{User Feedback}623 B --> C[Product Iteration]624 C --> D[Product-Market Fit]625 D --> E[Scaling]626 E --> F[Supabase Pro Plan]627 E --> G[Vercel Pro Plan]628 E --> H[Custom Domain]629```6306311. **Zbieraj opinie**: udostępnij demo potencjalnym użytkownikom i zbieraj opinie.6322. **Szybko iteruj**: użyj vibecoding do wdrażania żądanych zmian.6333. **Monitoruj metryki**: Vercel Analytics i Supabase Dashboard dostarczają niezbędne dane.6344. **Skaluj gdy potrzeba**: przechodź na płatne plany dopiero po potwierdzeniu popytu.635636637## Podsumowanie638639Vibecoding z Claude Code, Supabase i Vercel to potężna kombinacja do budowania demo i MVP w rekordowym czasie. To, co kiedyś zajmowało tygodnie rozwoju, teraz można osiągnąć w zaledwie kilka godzin, z zaskakująco wysoką jakością.640641Kluczem jest podejście do vibecoding z odpowiednim nastawieniem: nie chodzi o „nieumiejętność kodowania", ale o **wzmacnianie swoich możliwości** za pomocą narzędzi AI. Im więcej wiesz o bazowych technologiach (React, SQL, uwierzytelnianie, wdrażanie), tym skuteczniej prowadzisz agenta AI do pożądanego rezultatu.642643Przyszłość rozwoju oprogramowania jest tutaj, a koszt rozpoczęcia nigdy nie był niższy. Stwórz swoje demo, zweryfikuj z prawdziwymi użytkownikami i zbuduj kolejny wielki produkt.644645> **Lista kontrolna dla Twojego pierwszego demo:**646>647> - [x] Claude Code zainstalowany i skonfigurowany648> - [x] Projekt Supabase utworzony ze schematem bazy danych649> - [x] Projekt Next.js zainicjalizowany z shadcn/ui650> - [x] Uwierzytelnianie skonfigurowane651> - [x] Pełny CRUD zaimplementowany652> - [x] Nowoczesny i responsywny UI653> - [x] Wdrożony na Vercel654> - [x] URL do udostępnienia gotowy na opinie655
:Jak Zbudować Demo z Claude Code: Vibecoding z Supabase i Vercellines 1-655 (END) — press q to close