spinny:~/writing $ vim create-demo-claude-code-vibecoding.md
1~2**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."_3~4W 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.5~6## 1. Czym Jest Vibecoding i Dlaczego Jest Rewolucyjny7~8Vibecoding reprezentuje fundamentalną zmianę paradygmatu w rozwoju oprogramowania. Zamiast pisać kod linia po linii, programista:9~101. **Opisuje** co chce w języku naturalnym.112. **Agent AI** generuje kompletny kod.123. **Programista** sprawdza, testuje i iteruje.13~14### Dlaczego To Działa15~16- **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_.20~21```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```30~31### Kiedy Używać Vibecoding32~33Vibecoding jest idealny do:34~35- **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.39~40> **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.41~42## 2. Stos Technologiczny: Claude Code + Supabase + Vercel43~44### Claude Code45~46Claude Code to agent kodowania AI od Anthropic. Działa bezpośrednio w terminalu i może:47~48- 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.54~55```bash56# Install Claude Code57npm install -g @anthropic-ai/claude-code58~59# Start in a project directory60cd my-project61claude62```63~64### Supabase (Darmowy Plan)65~66Supabase to open-source'owa alternatywa dla Firebase oferująca:67~68- **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.73~74Darmowy plan obejmuje:75~76| 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 |84~85### Vercel (Darmowy Plan)86~87Vercel to idealna platforma wdrożeniowa dla aplikacji Next.js:88~89- **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.94~95Darmowy plan obejmuje:96~97| 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 |104~105## 3. Początkowa Konfiguracja: Przygotowanie Środowiska106~107### Wymagania Wstępne108~109Przed rozpoczęciem upewnij się, że masz:110~111- **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`).117~118### Krok 1: Utwórz Projekt119~120Otwórz terminal i uruchom Claude Code:121~122```bash123mkdir my-demo-app && cd my-demo-app124claude125```126~127Teraz możesz zacząć dawać Claude Code instrukcje w języku naturalnym:128~129```130You: Create a Next.js 15 project with App Router, TypeScript, Tailwind CSS,131and shadcn/ui. Also initialize a Git repository.132```133~134Claude Code automatycznie wykona:135~136```bash137npx create-next-app@latest . --typescript --tailwind --eslint --app --src-dir138npx shadcn@latest init139git init && git add . && git commit -m "Initial commit"140```141~142### Krok 2: Skonfiguruj Supabase143~1441. 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:147~148```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```153~154Claude Code utworzy kompletną konfigurację:155~156```typescript157// src/lib/supabase/client.ts158import { createBrowserClient } from '@supabase/ssr';159~160export function createClient() {161 return createBrowserClient(162 process.env.NEXT_PUBLIC_SUPABASE_URL!,163 process.env.NEXT_PUBLIC_SUPABASE_ANON_KEY!164 );165}166```167~168```typescript169// src/lib/supabase/server.ts170import { createServerClient } from '@supabase/ssr';171import { cookies } from 'next/headers';172~173export async function createClient() {174 const cookieStore = await cookies();175~176 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```194~195## 4. Budowanie Demo: Aplikacja do Zarządzania Zadaniami196~197Zbudujmy konkretne demo: **aplikację do zarządzania zadaniami** z uwierzytelnianiem, pełnym CRUD i nowoczesnym interfejsem.198~199### Definicja Schematu Bazy Danych200~201Daj Claude Code instrukcje do stworzenia schematu:202~203```204You: Create a SQL migration for Supabase with the following tables:205~2061. 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_at214~215Enable Row Level Security on all tables and create appropriate policies.216```217~218Claude Code wygeneruje kompletną migrację:219~220```sql221-- Create enum types222CREATE TYPE task_status AS ENUM ('todo', 'in_progress', 'done');223CREATE TYPE task_priority AS ENUM ('low', 'medium', 'high');224~225-- 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);232~233-- 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);241~242-- 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);255~256-- Enable RLS257ALTER TABLE profiles ENABLE ROW LEVEL SECURITY;258ALTER TABLE projects ENABLE ROW LEVEL SECURITY;259ALTER TABLE tasks ENABLE ROW LEVEL SECURITY;260~261-- 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);266~267-- 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);276~277-- 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```295~296Migrację tę można uruchomić bezpośrednio z panelu Supabase (SQL Editor) lub przez CLI.297~298### Generowanie Typów TypeScript299~300```301You: Generate TypeScript types from the Supabase database and save them to src/types/database.ts302```303~304```bash305npx supabase gen types typescript --project-id YOUR_PROJECT_ID > src/types/database.ts306```307~308### Budowanie Interfejsu Użytkownika309~310Teraz nadchodzi najpotężniejsza część vibecoding. Daj Claude Code instrukcje wysokiego poziomu:311~312```313You: Create a dashboard page for the task management app with:314~3151. 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 Tailwind320~321Use data from Supabase with React Server Components where possible322and Client Components only where interactivity is needed.323```324~325Claude Code zbuduje cały interfejs, komponent po komponencie.326~327### Dodanie Uwierzytelniania328~329```330You: Add a complete authentication system with:331~3321. 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```338~339Claude Code skonfiguruje middleware Next.js i strony uwierzytelniania:340~341```typescript342// src/middleware.ts343import { createServerClient } from '@supabase/ssr';344import { NextResponse, type NextRequest } from 'next/server';345~346export async function middleware(request: NextRequest) {347 let supabaseResponse = NextResponse.next({ request });348~349 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 );369~370 const { data: { user } } = await supabase.auth.getUser();371~372 if (!user && !request.nextUrl.pathname.startsWith('/auth')) {373 const url = request.nextUrl.clone();374 url.pathname = '/auth/login';375 return NextResponse.redirect(url);376 }377~378 return supabaseResponse;379}380~381export const config = {382 matcher: ['/((?!_next/static|_next/image|favicon.ico|auth).*)'],383};384```385~386## 5. Zaawansowane Wzorce Vibecoding387~388### Iteracyjne Promptowanie389~390Sekret efektywnego vibecoding to **iteracja**. Nie próbuj opisywać wszystkiego w jednym prompcie. Postępuj etapowo:391~392```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```400~401> **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.402~403### Obsługa Błędów404~405Gdy coś nie działa (a będzie tak), możesz po prostu powiedzieć:406~407```408You: I'm getting this error in the console: "TypeError: Cannot read property409'map' of undefined" in the TaskList component. Fix it.410```411~412Claude Code przeanalizuje kod, zidentyfikuje problem i go naprawi.413~414### Refaktoring z AI415~416```417You: The Dashboard component has become too large. Split it into smaller,418reusable components while maintaining the same functionality.419```420~421### Testowanie422~423```424You: Add tests with Vitest for utility functions and Playwright tests for425the authentication and task creation flow.426```427~428## 6. Wdrożenie na Vercel: Od Kodu do Świata429~430### Krok 1: Push na GitHub431~432```433You: Create an appropriate .gitignore, commit everything, and push to a new434GitHub repository called "my-demo-app".435```436~437```bash438git add .439git commit -m "feat: complete task management demo"440gh repo create my-demo-app --public --push --source=.441```442~443### Krok 2: Podłącz Vercel444~4451. 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".451~452```mermaid453flowchart LR454 A[GitHub Push] --> B[Vercel Build]455 B --> C[Automatic Deploy]456 C --> D[Public URL]457 D --> E[Global CDN]458```459~460### Krok 3: Konfiguracja Własnej Domeny (Opcjonalnie)461~462Vercel zapewnia darmowy URL jak `my-demo-app.vercel.app`. Dla własnej domeny:463~464```465You: Add the configuration for a custom domain in vercel.json466```467~468### Wdrożenia Podglądowe469~470Za 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.471~472## 7. Optymalizacje dla Twojego Demo473~474### Wydajność475~476```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```483~484### Realtime z Supabase485~486Funkcja, która zawsze robi wrażenie w demo, to **realtime**:487~488```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```493~494```typescript495'use client';496~497import { useEffect, useState } from 'react';498import { createClient } from '@/lib/supabase/client';499import type { Task } from '@/types/database';500~501export function useRealtimeTasks(projectId: string) {502 const [tasks, setTasks] = useState<Task[]>([]);503 const supabase = createClient();504~505 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();533~534 return () => {535 supabase.removeChannel(channel);536 };537 }, [projectId, supabase]);538~539 return tasks;540}541```542~543### Tryb Ciemny544~545```546You: Add dark mode support with a toggle in the header.547Use Tailwind dark classes and save the preference in localStorage.548```549~550## 8. Najlepsze Praktyki Efektywnego Vibecoding551~552### 1. Bądź Konkretny w Promptach553~554```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```559~560### 2. Dostarcz Kontekst561~562```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```568~569### 3. Iteruj Małymi Krokami570~571Nie próbuj budować wszystkiego w jednym prompcie. Postępuj stopniowo:572~5731. Podstawowy układ5742. Jedna funkcja na raz5753. Stylizacja i dopracowanie5764. Obsługa błędów5775. Testowanie578~579### 4. Sprawdzaj Wygenerowany Kod580~581Vibecoding nie oznacza nieczytania kodu. Zawsze sprawdzaj:582~583- **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.586~587### 5. Używaj Git Strategicznie588~589```590You: Commit the changes with a descriptive message after each completed feature.591```592~593Pozwala to na cofnięcie zmian, jeśli coś pójdzie nie tak.594~595## 9. Koszty: Czy Naprawdę Wszystko Jest Za Darmo?596~597Analiza kosztów dla każdej usługi:598~599| 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 |605~606> **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.607~608### Darmowe Alternatywy AI609~610Jeśli chcesz utrzymać koszty na absolutnym zerze:611~612- **Cursor** (darmowy plan z ograniczeniami).613- **GitHub Copilot** (darmowy dla studentów i open source).614- **Codeium/Windsurf** (hojny darmowy plan).615~616## 10. Od Demo do Produktu: Następne Kroki617~618Gdy Twoje demo jest na żywo, oto jak postępować:619~620```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```630~6311. **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.635~636~637## Podsumowanie638~639Vibecoding 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ą.640~641Kluczem 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.642~643Przyszł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.644~645> **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~
NORMAL · create-demo-claude-code-vibecoding.md [readonly]655 lines · :q to close