spinny:~/writing $ less create-demo-claude-code-vibecoding.md
12**Vibecoding** - це нова парадигма розробки програмного забезпечення, де програміст керує AI-агентом за допомогою інструкцій природною мовою, дозволяючи штучному інтелекту писати фактичний код. Термін був створений Андрієм Карпаті (співзасновником OpenAI та колишнім Director of AI у Tesla) у відомому твіті лютого 2025 року: _"There's a new kind of coding I call vibecoding, where you fully give in to the vibes, embrace the exponentials, and forget that the code even exists."_34У цій статті ми розглянемо, як створити повну, робочу демо за допомогою **Claude Code** як AI-агента, **Supabase** як бекенду (база даних, автентифікація, API) та **Vercel** для розгортання - використовуючи виключно **безкоштовні тарифи** цих сервісів.56## 1. Що Таке Vibecoding і Чому Це Революційно78Vibecoding являє собою фундаментальну зміну парадигми в розробці програмного забезпечення. Замість написання коду рядок за рядком розробник:9101. **Описує** те, що хоче, природною мовою.112. **AI-агент** генерує повний код.123. **Розробник** переглядає, тестує та ітерує.1314### Чому Це Працює1516- **Швидкість**: проєкт, який зайняв би дні, можна побудувати за години.17- **Доступність**: навіть недосвідчені розробники можуть створювати робочі продукти.18- **Швидка ітерація**: можна тестувати ідеї та змінювати напрямок набагато швидше.19- **Фокус на продукті**: ви зосереджуєтесь на _що_, а не на _як_.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### Коли Використовувати Vibecoding3233Vibecoding ідеально підходить для:3435- **Демо та MVP**: швидке створення прототипу для валідації ідеї.36- **Хакатони**: створення робочого продукту всього за кілька годин.37- **Побічні проєкти**: вивчення нових технологій без інвестування тижнів.38- **Proof of Concept**: демонстрація технічної здійсненності для зацікавлених сторін або інвесторів.3940> **Попередження:** Vibecoding чудово підходить для демо та прототипів. Для виробничих додатків з високими вимогами до безпеки та масштабованості ретельний огляд згенерованого коду залишається необхідним.4142## 2. Технічний Стек: Claude Code + Supabase + Vercel4344### Claude Code4546Claude Code - це AI-агент кодування від Anthropic. Він працює безпосередньо у вашому терміналі та може:4748- Читати та розуміти всю кодову базу.49- Створювати, змінювати та видаляти файли.50- Виконувати команди терміналу.51- Взаємодіяти з API та зовнішніми сервісами.52- Керувати версіонуванням через Git.53- Автономно ітерувати над помилками та багами.5455```bash56# Install Claude Code57npm install -g @anthropic-ai/claude-code5859# Start in a project directory60cd my-project61claude62```6364### Supabase (Безкоштовний Тариф)6566Supabase - це альтернатива Firebase з відкритим кодом, яка пропонує:6768- **Базу даних PostgreSQL**: повну реляційну базу даних.69- **Автентифікацію**: вхід через email, Google, GitHub тощо.70- **REST та Realtime API**: автоматично згенеровані з вашої схеми.71- **Сховище**: для файлів та зображень.72- **Edge Functions**: безсерверні функції.7374Безкоштовний тариф включає:7576| Ресурс | Безкоштовний Ліміт |77|----------|-----------|78| База даних | 500 МБ |79| Сховище | 1 ГБ |80| Пропускна здатність | 5 ГБ |81| Виклики Edge Function | 500K/місяць |82| Автентифіковані користувачі | Необмежено |83| Проєкти | 2 активних проєкти |8485### Vercel (Безкоштовний Тариф)8687Vercel - ідеальна платформа для розгортання Next.js-додатків:8889- **Автоматичне розгортання** з GitHub.90- **Preview deployments** для кожної гілки та PR.91- **Глобальний CDN** для оптимальної продуктивності.92- **Serverless Functions** включені.93- **Базова аналітика** безкоштовно.9495Безкоштовний тариф включає:9697| Ресурс | Безкоштовний Ліміт |98|----------|-----------|99| Пропускна здатність | 100 ГБ/місяць |100| Виконання Serverless Function | 100 ГБ-годин/місяць |101| Збірки | 6 000 хвилин/місяць |102| Проєкти | Необмежено |103| Розгортання | Необмежено |104105## 3. Початкове Налаштування: Підготовка Середовища106107### Передумови108109Перед початком переконайтеся, що у вас є:110111- **Node.js 18+** встановлений.112- **Git** налаштований.113- Обліковий запис **GitHub**.114- Обліковий запис **Supabase** (безкоштовно на [supabase.com](https://supabase.com)).115- Обліковий запис **Vercel** (безкоштовно на [vercel.com](https://vercel.com)).116- **Claude Code** встановлений (`npm install -g @anthropic-ai/claude-code`).117118### Крок 1: Створіть Проєкт119120Відкрийте термінал та запустіть Claude Code:121122```bash123mkdir my-demo-app && cd my-demo-app124claude125```126127Тепер ви можете давати Claude Code інструкції природною мовою: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 автоматично виконає: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### Крок 2: Налаштуйте Supabase1431441. Перейдіть на [supabase.com](https://supabase.com) та створіть новий проєкт.1452. Запишіть **Project URL** та **anon key** з Settings > API.1463. Поверніться до терміналу з 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 створить повну конфігурацію: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. Створення Демо: Додаток для Управління Завданнями196197Давайте побудуємо конкретну демо: **додаток для управління завданнями** з автентифікацією, повним CRUD та сучасним інтерфейсом.198199### Визначте Схему Бази Даних200201Дайте Claude Code інструкції для створення схеми: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 згенерує повну міграцію: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```295296Цю міграцію можна виконати безпосередньо з панелі керування Supabase (SQL Editor) або через CLI.297298### Згенеруйте TypeScript Types299300```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### Побудуйте Інтерфейс Користувача309310Тепер настає найпотужніша частина vibecoding. Дайте Claude Code інструкції високого рівня: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 побудує весь інтерфейс, компонент за компонентом.326327### Додайте Автентифікацію328329```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 налаштує Next.js middleware та сторінки автентифікації: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. Просунуті Патерни Vibecoding387388### Ітеративний Промптинг389390Секрет ефективного vibecoding - це **ітерація**. Не намагайтеся описати все одним промптом. Працюйте поетапно:391392```393Крок 1: "Create the base layout with header and sidebar"394Крок 2: "Add the project list in the sidebar with a button to create new ones"395Крок 3: "Create the Kanban view in the main area"396Крок 4: "Add drag & drop between columns"397Крок 5: "Implement the modal to create new tasks"398Крок 6: "Add toast notifications for user feedback"399```400401> **Порада:** Чим конкретніший та контекстуалізованіший промпт, тим кращий результат. Claude Code має доступ до всієї кодової бази, тому може інтегрувати нові функції когерентно.402403### Обробка Помилок404405Коли щось не працює (а це буде), ви можете просто сказати: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 проаналізує код, визначить проблему та виправить її.413414### Рефакторинг з AI415416```417You: The Dashboard component has become too large. Split it into smaller,418reusable components while maintaining the same functionality.419```420421### Тестування422423```424You: Add tests with Vitest for utility functions and Playwright tests for425the authentication and task creation flow.426```427428## 6. Розгортання на Vercel: Від Коду до Світу429430### Крок 1: Пуш на 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### Крок 2: Підключіть Vercel4444451. Перейдіть на [vercel.com](https://vercel.com) та натисніть "Add New Project."4462. Імпортуйте щойно створений GitHub-репозиторій.4473. Додайте змінні середовища:448 - `NEXT_PUBLIC_SUPABASE_URL`449 - `NEXT_PUBLIC_SUPABASE_ANON_KEY`4504. Натисніть "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### Крок 3: Налаштуйте Власний Домен (Опціонально)461462Vercel надає безкоштовний URL типу `my-demo-app.vercel.app`. Для власного домену:463464```465You: Add the configuration for a custom domain in vercel.json466```467468### Preview Deployments469470Кожного разу, коли ви відкриваєте Pull Request на GitHub, Vercel автоматично створює **preview deployment** з унікальним URL. Ідеально для показу змін перед мержем.471472## 7. Оптимізації для Вашої Демо473474### Продуктивність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### Реальний Час з Supabase485486Функція, яка завжди вражає в демо - це **реальний час**: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### Темний Режим544545```546You: Add dark mode support with a toggle in the header.547Use Tailwind dark classes and save the preference in localStorage.548```549550## 8. Найкращі Практики Ефективного Vibecoding551552### 1. Будьте Конкретні у Своїх Промптах553554```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. Надавайте Контекст561562```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. Ітеруйте Малими Кроками570571Не намагайтеся побудувати все одним промптом. Рухайтесь поетапно:5725731. Базовий макет5742. Одна функція за раз5753. Стилізація та полірування5764. Обробка помилок5775. Тестування578579### 4. Переглядайте Згенерований Код580581Vibecoding не означає не читати код. Завжди перевіряйте:582583- **Безпеку**: RLS-політики, валідацію вводу, санітизацію даних.584- **Продуктивність**: N+1 запити, непотрібні клієнтські компоненти.585- **Найкращі практики**: структуру проєкту, конвенції іменування.586587### 5. Використовуйте Git Стратегічно588589```590You: Commit the changes with a descriptive message after each completed feature.591```592593Це дозволяє відкатити зміни, якщо щось піде не так.594595## 9. Вартість: Чи Справді Все Безкоштовно?596597Ось розбивка витрат по кожному сервісу:598599| Сервіс | Безкоштовний План | Коли Платити |600|---------|-----------|-------------|601| **Claude Code** | Потрібен план Anthropic (від $20/місяць) або API-ключ | Одразу, але цінність величезна |602| **Supabase** | Щедрий безкоштовний тариф (2 проєкти, 500МБ БД) | При перевищенні лімітів |603| **Vercel** | Безкоштовний тариф для особистих проєктів | Для команд або комерційного використання |604| **GitHub** | Безкоштовно для публічних і приватних репозиторіїв | Enterprise-функції |605606> **Примітка:** Claude Code вимагає підписку або API-кредити, але віддача у швидкості розробки є надзвичайною. Для демо або MVP загальна вартість складає близько $20.607608### Безкоштовні AI-альтернативи609610Якщо ви хочете тримати витрати на абсолютному нулі, можете використовувати:611612- **Cursor** (безкоштовний тариф з обмеженнями).613- **GitHub Copilot** (безкоштовно для студентів та відкритого коду).614- **Codeium/Windsurf** (щедрий безкоштовний тариф).615616## 10. Від Демо до Продукту: Наступні Кроки617618Коли ваша демо запущена, ось як рухатися далі: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. **Збирайте відгуки**: діліться демо з потенційними користувачами та збирайте думки.6322. **Ітеруйте швидко**: використовуйте vibecoding для впровадження запитаних змін.6333. **Відстежуйте метрики**: Vercel Analytics та Supabase Dashboard надають вам важливі дані.6344. **Масштабуйте за потреби**: переходьте на платні плани лише тоді, коли ви підтвердили попит.635636637## Висновок638639Vibecoding з Claude Code, Supabase та Vercel являє собою потужну комбінацію для створення демо та MVP у рекордний час. Те, що раніше займало тижні розробки, тепер можна досягти за лічені години з напрочуд високим рівнем якості.640641Ключ - підходити до vibecoding з правильним мисленням: це не про "невміння кодувати", а про **посилення ваших можливостей** за допомогою AI-інструментів. Чим більше ви знаєте про базові технології (React, SQL, автентифікація, розгортання), тим ефективніше ви зможете направляти AI-агента до бажаного результату.642643Майбутнє розробки програмного забезпечення вже тут, і вартість початку ніколи не була нижчою. Створіть свою демо, підтвердіть її реальними користувачами та побудуйте наступний чудовий продукт.644645> **Чек-лист для вашої першої демо:**646>647> - [x] Claude Code встановлено та налаштовано648> - [x] Проєкт Supabase створено зі схемою бази даних649> - [x] Проєкт Next.js ініціалізовано з shadcn/ui650> - [x] Автентифікацію налаштовано651> - [x] Повний CRUD реалізовано652> - [x] Сучасний та адаптивний UI653> - [x] Розгорнуто на Vercel654> - [x] URL для спільного доступу готовий для відгуків655
:Як Створити Демо з Claude Code: Vibecoding з Supabase та Vercellines 1-655 (END) — press q to close