מדריך

האפיון המלא לבניית אינסטגרם עם קלוד

האפיון של ״פריים״ מהסרטון, וחמישה צעדים להריץ אותו אצלכם עם Claude Code

זה האפיון הסגור שנתתי לקלוד בסרטון. אפליקציה בשם "פריים": פיד, העלאת תמונות, לייקים ותגובות בזמן אמת, עוקבים, סטוריז והתראות. האפיון מגדיר כל מסך, כל טקסט וכל צבע, כדי שקלוד יבנה בדיוק את מה שכתוב ולא יותר.

  • Next.js 15
  • Supabase
  • עברית ו-RTL
  • הרצה מקומית
  • 17 סעיפים

איך מריצים את זה

חמישה צעדים. את רובם עושים פעם אחת לפני שמתחילים, ואז קלוד עובד לבד עד הסוף.

1. תיקייה ריקה עם קובץ האפיון

יוצרים תיקייה חדשה, ושומרים בתוכה קובץ בשם SPEC.md עם האפיון המלא שבהמשך העמוד. לבלוק של האפיון יש כפתור העתקה שמעתיק את כולו.

2. פרויקט חדש ב-Supabase

  • פותחים פרויקט חדש וריק באזור Frankfurt, ושומרים בצד את סיסמת הדאטהבייס.
  • ב-Authentication, בהגדרות של Email, מכבים את Confirm email.

3. קובץ .env.local באותה תיקייה

קלוד לא יכול להוציא את המפתחות האלה בשבילכם, אז ממלאים אותם לפני שמתחילים:

NEXT_PUBLIC_SUPABASE_URL=
NEXT_PUBLIC_SUPABASE_PUBLISHABLE_KEY=
SUPABASE_SECRET_KEY=
SUPABASE_PROJECT_REF=
SUPABASE_ACCESS_TOKEN=
SUPABASE_DB_PASSWORD=
SEED_PASSWORD=
  • URL, PUBLISHABLE_KEY ו-SECRET_KEY: ב-Supabase, בהגדרות הפרויקט, תחת API Keys.
  • PROJECT_REF: המזהה שמופיע בכתובת של הפרויקט, אחרי /project/.
  • ACCESS_TOKEN: מריצים בטרמינל npx supabase login ומעתיקים את הטוקן, או יוצרים אחד בהגדרות החשבון תחת Access Tokens.
  • DB_PASSWORD: הסיסמה שבחרתם כשפתחתם את הפרויקט.
  • SEED_PASSWORD: סיסמה לבחירתכם, למשתמשי הדמו.

4. פותחים את Claude Code בתיקייה ושולחים

תקרא את SPEC.md ותתחיל

האפיון אומר לו לא לשאול שאלות ולא לחכות לאישור, אז הוא עובד שלב אחרי שלב עד הסוף. הוא עוצר רק אם משהו באמת חוסם, למשל מפתח חסר, ואז אומר בדיוק מה לעשות.

5. פותחים מהטלפון

בסוף קלוד נותן את הפקודה להרצה ואת כתובת ה-IP של המחשב. הטלפון צריך להיות באותה רשת Wi-Fi, ונכנסים לכתובת בפורמט http://<IP>:3000.

npm run dev -- -H 0.0.0.0

האפיון המלא

את כל הבלוק הזה שומרים כקובץ SPEC.md.

# אפיון: "פריים", אפליקציית ווב לשיתוף תמונות

האפיון הזה סגור. כל מה שלא כתוב כאן לא נבנה.

## 0. כללי עבודה (חובה)
1. בונים רק מה שמופיע באפיון. אסור להוסיף מסך, כפתור, פיצ'ר, אנימציה, טקסט או הגדרה שלא כתובים כאן.
2. כל טקסט בממשק נלקח מילה במילה מהאפיון. אסור לנסח מחדש, לתרגם או להוסיף טקסטים.
3. משתמשים רק בחבילות שמופיעות בסעיף 2. אסור להתקין שום חבילה אחרת.
4. כשמשהו לא מוגדר, בוחרים את הפתרון הפשוט ביותר, ממשיכים, ורושמים את ההחלטה ב-`DECISIONS.md` (שורה אחת לכל החלטה).
5. לא שואלים שאלות ולא מחכים לאישור. עוצרים רק כשמשהו חוסם באמת (מפתח חסר, פקודה שנכשלת בגלל הרשאה), ואז כותבים בדיוק מה הבעלים צריך לעשות.
6. לפני שכותבים קוד: כותבים תוכנית קצרה ב-`PLAN.md` וממשיכים מיד, בלי לחכות.
7. בונים לפי סדר השלבים בסעיף 13. בסוף כל שלב מריצים `npm run build` ו-`npm run lint` ומתקנים עד שהם עוברים בלי שגיאות. אחר כך כותבים שורה אחת בפורמט: `שלב N הושלם: <מה עובד עכשיו>`, וממשיכים לשלב הבא בלי לחכות.
8. לא מתקינים כלי בדיקות דפדפן (Playwright, Cypress וכדומה) ולא כותבים בדיקות אוטומטיות, חוץ מהסקריפט בסעיף 12.
9. לא משתמשים בשום כלי חיצוני אחר מעבר ל-npm ו-Supabase CLI. לא עושים דיפלוי לשום מקום.

## 1. מה הבעלים כבר הכין (לפני שמתחילים)
- התיקייה הנוכחית ריקה חוץ מ-`SPEC.md` ו-`.env.local`.
- פרויקט Supabase חדש וריק (אזור Frankfurt). ב-Authentication, האפשרות Confirm email כבויה.
- ב-`.env.local` יש ערכים לכל המשתנים האלה:
  ```
  NEXT_PUBLIC_SUPABASE_URL=
  NEXT_PUBLIC_SUPABASE_PUBLISHABLE_KEY=
  SUPABASE_SECRET_KEY=
  SUPABASE_PROJECT_REF=
  SUPABASE_ACCESS_TOKEN=
  SUPABASE_DB_PASSWORD=
  SEED_PASSWORD=
  ```
- Node 20 ומעלה.

## 2. טכנולוגיות וחבילות (רשימה סגורה)
- הקמה: `npx create-next-app@15` בתיקייה הנוכחית, עם TypeScript, ESLint, Tailwind, App Router, בלי תיקיית src, בלי Turbopack, ו-import alias `@/*`.
- dependencies מותרות: `next@15`, `react@19`, `react-dom@19`, `@supabase/supabase-js`, `@supabase/ssr`, `lucide-react`, `react-easy-crop`, `browser-image-compression`.
- devDependencies מותרות: מה ש-create-next-app מתקין, ובנוסף `supabase` (CLI) ו-`tsx`.
- מיגרציות: בתיקייה `supabase/migrations`. מחילים עם `npx supabase link --project-ref $SUPABASE_PROJECT_REF` ואז `npx supabase db push`.
- הרצה: מקומית בלבד, עם `npm run dev -- -H 0.0.0.0` (כדי שאפשר יהיה לפתוח מטלפון באותה רשת Wi-Fi). בלי דיפלוי.

## 3. ארכיטקטורה
- כל שליפת הנתונים נעשית בצד הלקוח, בקומפוננטות `"use client"` עם `@supabase/supabase-js`. בלי Server Actions ובלי API routes.
- `@supabase/ssr` משמש רק ב-`middleware.ts`, לרענון הסשן ולהפניות:
  - משתמש לא מחובר שנכנס לכל דף חוץ מ-`/login` ו-`/signup` מופנה ל-`/login`.
  - משתמש מחובר בלי שורה ב-`profiles` מופנה ל-`/onboarding`.
  - משתמש מחובר שנכנס ל-`/login` או ל-`/signup` מופנה ל-`/`.
- בלי ספריית state ובלי ספריית data fetching. רק `useState`, `useEffect` ו-Context אחד למשתמש המחובר ולפרופיל שלו.
- תמונות מוצגות ב-`<img>` רגיל עם `loading="lazy"` ו-`decoding="async"`, לא ב-`next/image`. את חוק ה-ESLint `@next/next/no-img-element` מכבים.
- קבצים: דפים ב-`app/`, קומפוננטות ב-`components/`, לקוח Supabase ופונקציות עזר ב-`lib/`, סקריפטים ב-`scripts/`.
- בלי Service Worker ובלי מצב אופליין.

## 4. עיצוב (מדויק)

### צבעים (CSS variables ב-`globals.css`, לפי `prefers-color-scheme`, בלי כפתור החלפה)
| שם | בהיר | כהה |
|---|---|---|
| `--bg` | `#FFFFFF` | `#000000` |
| `--surface` | `#F4F4F5` | `#18181B` |
| `--text` | `#0A0A0A` | `#FAFAFA` |
| `--text-secondary` | `#71717A` | `#A1A1AA` |
| `--border` | `#E4E4E7` | `#27272A` |
| `--accent` | `#E11D74` | `#F43F8E` |
| `--on-accent` | `#FFFFFF` | `#FFFFFF` |
| `--danger` | `#DC2626` | `#F87171` |
| `--ring-seen` | `#D4D4D8` | `#3F3F46` |

הטבעת של סטורי שלא נצפה: `linear-gradient(45deg, #F97316, #E11D74)` בשני המצבים.

### טיפוגרפיה
- פונט: Heebo דרך `next/font/google`, משקלים 400, 500, 700, 800, עם subsets `hebrew` ו-`latin`.
- גדלים: 12px (מטא וזמן), 14px (טקסט רגיל), 16px (שדות קלט וכותרות מסך), 20px (שם בפרופיל), 24px (לוגו).
- הלוגו: הטקסט "פריים", Heebo 800, 24px, בצבע `--text`. בלי תמונה ובלי אייקון.

### פריסה כללית
- `<html lang="he" dir="rtl">`, וכותרת המסמך היא תמיד "פריים".
- עמודה אחת ממורכזת, `max-width: 470px`, ברקע `--bg`. ממסך ברוחב 471px ומעלה יש לעמודה קו של 1px בצבע `--border` מימין ומשמאל.
- כותרת עליונה: גובה 52px, קו תחתון 1px `--border`, צמודה למעלה (sticky). כותרת מסך: 16px במשקל 700, ממורכזת. במסכים שאינם טאב ראשי יש כפתור חזרה בצד ימין: אייקון `ChevronRight` 24px.
- סרגל ניווט תחתון: גובה 56px ועוד `env(safe-area-inset-bottom)`, קו עליון 1px `--border`, צמוד למטה. חמישה פריטים ברוחב שווה, מימין לשמאל: `Home`, `Search`, `PlusSquare`, `Heart`, ותמונת הפרופיל שלי בעיגול 26px. האייקונים 26px עם strokeWidth 2. פעיל: `--text`. לא פעיל: `--text-secondary`.
- הסרגל התחתון מופיע בכל המסכים חוץ מ-`/login`, `/signup`, `/onboarding`, `/new`, `/new/story` וצופה הסטוריז.
- מרווח בסיסי 4px. ריפוד צדדי במסכים 16px.
- שדה קלט: גובה 44px, רדיוס 8px, רקע `--surface`, מסגרת 1px `--border`, טקסט 16px, ריפוד 12px. בפוקוס המסגרת בצבע `--text`.
- כפתור ראשי: גובה 44px, רדיוס 8px, רקע `--accent`, טקסט `--on-accent` 14px במשקל 700, ברוחב מלא. כשהוא מושבת: שקיפות 0.5.
- כפתור משני: כמו הראשי, עם רקע `--surface` וטקסט `--text`.
- כפתור בפרופיל: כמו כפתור רגיל, אבל בגובה 36px.
- תמונת פרופיל: עיגול עם `object-fit: cover`. אם אין תמונה: עיגול ברקע `--surface` עם האות הראשונה של שם התצוגה, בצבע `--text-secondary`, במשקל 700, בגודל 40% מקוטר העיגול.
- Bottom sheet: רקע `--bg`, רדיוס עליון 16px, ריפוד 8px ועוד safe-area למטה, רקע אחורי `rgba(0,0,0,0.4)`. נכנס מלמטה ב-200ms. לחיצה על הרקע סוגרת. כל שורה: גובה 52px, טקסט 16px, ריפוד 16px.
- Skeleton: בלוקים ברקע `--surface` עם `animate-pulse`.
- שגיאה: טקסט 14px בצבע `--danger` מתחת לכפתור הרלוונטי. בלי toast.
- אנימציות: רק אלה שמוגדרות באפיון.

### אייקונים (lucide-react בלבד)
`Home`, `Search`, `PlusSquare`, `Heart`, `MessageCircle`, `MoreHorizontal`, `ChevronRight`, `X`, `Plus`, `ImagePlus`, `CircleDashed`, `Eye`, `Trash2`. לכל כפתור עם אייקון בלבד יש `aria-label` בעברית, לפי השם שמופיע בסעיף 5.

### פורמט זמן (פונקציה אחת שמשמשת בכל מקום)
- פחות מ-60 שניות: "עכשיו"
- פחות מ-60 דקות: "לפני {n} דק׳"
- פחות מ-24 שעות: "לפני {n} שע׳"
- יום אחד: "אתמול"
- 2 עד 6 ימים: "לפני {n} ימים"
- 7 ימים ומעלה: `Intl.DateTimeFormat('he-IL', { day: 'numeric', month: 'short' })`

### מספרים
כל המספרים בממשק מעוצבים עם `toLocaleString('he-IL')`.

## 5. מסכים

### `/signup` הרשמה
- הלוגו ממורכז, 48px מעל הטופס.
- שדות: "אימייל" (type email), "סיסמה" (type password, מינימום 8 תווים). הטקסט של כל שדה הוא ה-placeholder שלו, בלי label נפרד שנראה על המסך, עם `aria-label` זהה.
- כפתור ראשי: "הרשמה". בזמן שליחה: "רגע..." והכפתור מושבת.
- מתחת: "כבר יש לך חשבון? התחברות". המילה "התחברות" היא קישור ל-`/login`, בצבע `--accent`.
- שגיאות: משתמש קיים: "כבר יש חשבון עם האימייל הזה". סיסמה קצרה: "הסיסמה צריכה להכיל לפחות 8 תווים". כל שגיאה אחרת: "משהו השתבש, נסו שוב".
- אחרי הרשמה מוצלחת: מעבר ל-`/onboarding`.

### `/login` התחברות
- כמו ההרשמה. הכפתור: "התחברות". מתחת: "אין לך חשבון? הרשמה" עם קישור ל-`/signup`.
- שגיאות: פרטים שגויים: "האימייל או הסיסמה שגויים". כל שגיאה אחרת: "משהו השתבש, נסו שוב".
- אחרי התחברות: מעבר ל-`/`.

### `/onboarding` יצירת פרופיל
- כותרת 20px במשקל 700, ממורכזת: "בואו נכיר".
- תמונת פרופיל 86px ממורכזת, ומתחתיה קישור בצבע `--accent`: "הוספת תמונת פרופיל" (לא חובה).
- שדות: "שם משתמש" ו-"שם".
- כפתור ראשי: "המשך".
- ולידציה של שם משתמש: `^[a-z0-9_]{3,20}$`. אם לא עובר: "3 עד 20 תווים: אותיות באנגלית קטנות, מספרים וקו תחתון". אם תפוס: "שם המשתמש הזה תפוס".
- שם: 1 עד 40 תווים. אם ריק: "צריך למלא שם".
- אחרי שמירה: מעבר ל-`/`.

### `/` פיד
- כותרת עליונה: הלוגו בצד ימין, ריפוד 16px. בלי שום דבר נוסף.
- שורת סטוריז (סעיף 6), ומתחתיה קו 1px `--border`.
- פוסטים: של מי שאני עוקב אחריו ושלי, לפי `created_at` מהחדש לישן (ואז לפי `id`). 10 בכל טעינה. הטעינה הבאה מתחילה כשהפוסט האחרון נכנס למסך, עם `IntersectionObserver` (בלי ספרייה).
- בזמן טעינה ראשונה: שני skeletons של פוסט.
- מצב ריק: כותרת 16px במשקל 700 "עוד אין פוסטים בפיד", מתחתיה טקסט 14px `--text-secondary` "עקבו אחרי אנשים כדי לראות את הפוסטים שלהם", ואז כפתור ראשי "חיפוש אנשים" שמוביל ל-`/search`. הכול ממורכז, 64px מתחת לשורת הסטוריז.
- לחיצה על `Home` כשכבר נמצאים ב-`/`: גלילה למעלה וטעינה מחדש של הפיד ושל שורת הסטוריז.
- בלי pull to refresh.

### כרטיס פוסט
- רווח של 16px בין פוסטים, בלי קווים ביניהם.
- שורה עליונה בגובה 56px, ריפוד 12px: תמונת פרופיל 32px, ואחריה שם המשתמש (14px, 700) ואחריו הזמן (12px, `--text-secondary`), עם רווח של 8px. לחיצה על התמונה או על השם מובילה ל-`/u/[username]`. בפוסט שלי בלבד, בצד שמאל: כפתור `MoreHorizontal` 24px עם `aria-label` "אפשרויות".
- התמונה: ברוחב מלא, ביחס של הפוסט (`1:1` או `4:5`), `object-fit: cover`, רקע `--surface` עד שהתמונה נטענת. טקסט חלופי: הכיתוב, ואם אין כיתוב: "פוסט של {username}".
- דאבל טאפ על התמונה (שתי לחיצות בתוך 300ms): לייק בלבד, אף פעם לא ביטול לייק. במרכז התמונה מופיע `Heart` לבן ממולא בגודל 96px: גדל מ-0 ל-1.2 ואז ל-1 ב-300ms, נשאר, ונעלם עד 800ms.
- שורת פעולות בגובה 44px, ריפוד 12px, רווח 16px: `Heart` (aria-label "לייק") ו-`MessageCircle` (aria-label "תגובות"), 26px. אחרי לייק: מילוי וקו בצבע `--accent`, ואנימציה של scale מ-1 ל-1.2 ל-1 ב-150ms. `MessageCircle` מוביל ל-`/p/[id]`.
- לייקים (14px, 700, ריפוד 12px): 0: לא מוצג. 1: "לייק אחד". יותר: "{n} לייקים".
- כיתוב (14px): שם המשתמש ב-700, רווח, ואז הטקסט. עד 2 שורות. אם ארוך יותר, בסוף מופיע "עוד" ב-`--text-secondary`, ולחיצה עליו מציגה את כל הכיתוב. אם הכיתוב ריק, השורה לא מוצגת.
- קישור לתגובות (14px, `--text-secondary`), מוביל ל-`/p/[id]`: 0: לא מוצג. 1: "הצגת תגובה אחת". יותר: "הצגת כל {n} התגובות".
- לייק וביטול לייק מתעדכנים מיד במסך (אופטימי). אם השמירה נכשלת, המצב חוזר אחורה.
- `MoreHorizontal` פותח bottom sheet עם שתי שורות: "מחיקת הפוסט" (`--danger`) ו-"ביטול". מחיקה מוחקת מיד, בלי אישור נוסף, ומסירה את הפוסט מהמסך. אם המחיקה נעשתה מ-`/p/[id]`, חוזרים ל-`/`.

### `/p/[id]` פוסט ותגובות
- כותרת: "פוסט" עם כפתור חזרה.
- כרטיס הפוסט המלא, ובלי הקישור לתגובות.
- מתחת: רשימת תגובות מהישנה לחדשה. כל תגובה: ריפוד 12px, תמונת פרופיל 32px, שם המשתמש ב-700 ואחריו הטקסט (14px), ומתחת הזמן (12px, `--text-secondary`). בתגובה שלי בלבד, בצד שמאל: `Trash2` 16px בצבע `--text-secondary` עם aria-label "מחיקת תגובה". לחיצה מוחקת מיד.
- אין תגובות: "עוד אין תגובות" (14px, `--text-secondary`, ממורכז, ריפוד 24px).
- שורת הוספת תגובה צמודה מעל הסרגל התחתון: גובה 52px, קו עליון 1px `--border`, רקע `--bg`, תמונת הפרופיל שלי 32px, שדה בלי מסגרת ובלי רקע עם placeholder "הוספת תגובה..." (עד 500 תווים), וכפתור טקסט "פרסום" ב-`--accent` 14px במשקל 700. כשהשדה ריק, הכפתור מושבת בשקיפות 0.4.
- תגובות חדשות מכל משתמש מופיעות בזמן אמת (סעיף 8).

### `/search` חיפוש
- בכותרת העליונה: שדה קלט עם placeholder "חיפוש", ריפוד צדדי 16px.
- בזמן הקלדה (debounce של 300ms): חיפוש `ilike` לפי `username` או `display_name`, עד 20 תוצאות. כל שורה בגובה 60px: תמונת פרופיל 44px, שם משתמש (14px, 700), ומתחתיו שם התצוגה (14px, `--text-secondary`). לחיצה מובילה ל-`/u/[username]`.
- אין תוצאות: "לא נמצאו משתמשים".
- כשהשדה ריק: רשת של 30 הפוסטים האחרונים מכל המשתמשים, 3 עמודות, רווח 2px, ריבועים עם `object-fit: cover`. לחיצה מובילה ל-`/p/[id]`.

### Bottom sheet העלאה (לחיצה על `PlusSquare`)
- שורות: `ImagePlus` + "פוסט חדש" (מוביל ל-`/new`), `CircleDashed` + "סטורי חדש" (מוביל ל-`/new/story`), "ביטול".

### `/new` פוסט חדש
- כותרת: "פוסט חדש", ובצד ימין כפתור `X` עם aria-label "סגירה", שחוזר ל-`/`.
- שלב 1: כפתור ראשי "בחירת תמונה", ממורכז, שפותח `<input type="file" accept="image/jpeg,image/png,image/webp">` בלי `capture`. מעל 10MB: "התמונה גדולה מדי (עד 10MB)".
- שלב 2: אזור חיתוך עם `react-easy-crop`, ברוחב מלא וריבועי. מתחת, שני כפתורים בגובה 32px ברדיוס 16px: "1:1" ו-"4:5". הנבחר: רקע `--text` וטקסט `--bg`. ברירת מחדל: "4:5". כפתור ראשי: "הבא".
- שלב 3: תצוגה מקדימה של התמונה החתוכה ברוחב 96px, ולידה textarea בלי מסגרת עם placeholder "כתיבת כיתוב...". מתחת: מונה "{n}/2200" (12px, `--text-secondary`). כפתור ראשי: "שיתוף".
- בזמן העלאה: פס של 3px בצבע `--accent` בראש המסך שמתמלא לפי ההתקדמות, והכפתור "משתף..." ומושבת.
- עיבוד: חיתוך, ואז `browser-image-compression` עם `maxWidthOrHeight: 1080`, `fileType: 'image/webp'`, `initialQuality: 0.82`. הנתיב: `{user_id}/{uuid}.webp` בבאקט `posts`.
- בסוף: מעבר ל-`/`, והפוסט החדש ראשון בפיד.

### `/new/story` סטורי חדש
- כמו `/new`, עם הכותרת "סטורי חדש". החיתוך קבוע ב-9:16, בגובה `70vh`, בלי כפתורי יחס. בלי שלב כיתוב: בשלב 2 הכפתור הראשי הוא "שיתוף לסטורי".
- עיבוד: `maxWidthOrHeight: 1920`, webp, איכות 0.82, לבאקט `stories`.
- בסוף: מעבר ל-`/`.

### `/notifications` התראות
- כותרת: "התראות".
- 30 ההתראות האחרונות שלי, מהחדשה לישנה, בלי טעינה נוספת.
- שורה בגובה 60px, ריפוד 12px: תמונת פרופיל של מי שביצע את הפעולה 44px, טקסט 14px, זמן 12px `--text-secondary`. בלייק ובתגובה: בצד שמאל תמונה ממוזערת 44px, מרובעת, של הפוסט.
- טקסטים (שם המשתמש ב-700):
  - לייק: "{username} סימן/ה לייק לפוסט שלך"
  - תגובה: "{username} הגיב/ה: {40 התווים הראשונים של התגובה}"
  - עוקב: "{username} התחיל/ה לעקוב אחריך"
- לחיצה: לייק ותגובה מובילים ל-`/p/[post_id]`. עוקב מוביל ל-`/u/[username]`.
- כשנכנסים למסך: כל ההתראות מסומנות כנקראו (`read_at = now()`). השורות שלא היו נקראות ברגע הכניסה מקבלות רקע `--surface` עד שיוצאים מהמסך.
- אין התראות: "אין התראות עדיין".
- נקודה: עיגול 8px בצבע `--accent` בפינה העליונה השמאלית של אייקון `Heart` בסרגל התחתון, כשיש לפחות התראה אחת לא נקראה. מתעדכן בזמן אמת.

### `/u/[username]` פרופיל
- כותרת: שם המשתמש. בפרופיל של מישהו אחר יש גם כפתור חזרה.
- שורה עליונה, ריפוד 16px: תמונת פרופיל 86px בצד ימין, ולידה שלוש עמודות ממורכזות: מספר (16px, 700) ומתחתיו תווית (14px): "פוסטים", "עוקבים", "במעקב". לחיצה על "עוקבים" מובילה ל-`/u/[username]/followers`, ולחיצה על "במעקב" ל-`/u/[username]/following`.
- מתחת: שם התצוגה (14px, 700), ואז הביו (14px, אם יש).
- כפתור ברוחב מלא, ריפוד 16px:
  - הפרופיל שלי: כפתור משני "עריכת פרופיל", שמוביל ל-`/settings/profile`.
  - מישהו שאני לא עוקב אחריו: כפתור ראשי "מעקב".
  - מישהו שאני עוקב אחריו: כפתור משני "במעקב". לחיצה מבטלת את המעקב מיד.
  - מעקב וביטול מעקב מתעדכנים מיד במסך, כולל מספר העוקבים.
- רשת פוסטים: 3 עמודות, רווח 2px, ריבועים, מהחדש לישן. לחיצה מובילה ל-`/p/[id]`. אין פוסטים: "עוד אין פוסטים" (ממורכז, ריפוד 48px).
- בזמן טעינה: skeleton של השורה העליונה ושל 9 ריבועים.
- שם משתמש שלא קיים: "המשתמש לא נמצא".

### `/u/[username]/followers` ו-`/u/[username]/following`
- כותרת: "עוקבים" או "במעקב", עם כפתור חזרה.
- שורות כמו בתוצאות החיפוש, בלי כפתורי מעקב. רשימה ריקה: "אין עדיין אף אחד כאן".

### `/settings/profile` עריכת פרופיל
- כותרת: "עריכת פרופיל", עם כפתור חזרה.
- תמונת פרופיל 86px ממורכזת, ומתחתיה קישור `--accent` "שינוי תמונה". אחרי בחירה: דחיסה ל-`maxWidthOrHeight: 400`, webp, לבאקט `avatars`.
- שדות: "שם משתמש" (מושבת, לא ניתן לשינוי), "שם" (1 עד 40), "ביו" (textarea, עד 150, ומתחתיו מונה "{n}/150").
- כפתור ראשי: "שמירה". אחרי שמירה: חזרה ל-`/u/[username]`.
- בתחתית, 32px מתחת: כפתור טקסט "התנתקות" בצבע `--danger`. מתנתק ומעביר ל-`/login`.

## 6. סטוריז

### שורת הסטוריז (בראש הפיד)
- גובה 104px, גלילה אופקית בלי פס גלילה, ריפוד 12px, רווח 12px.
- כל פריט ברוחב 72px: עיגול 72px שבתוכו טבעת של 2px, רווח של 2px בצבע `--bg`, ואז תמונת פרופיל 64px. מתחת: שם המשתמש, 12px, בשורה אחת עם `...` אם ארוך.
- טבעת: יש סטורי פעיל שלא ראיתי, גרדיאנט. כל הסטוריז הפעילים של המשתמש נצפו על ידי, קו של 1px בצבע `--ring-seen`.
- הפריט הראשון תמיד שלי, עם התווית "הסטורי שלך". אם אין לי סטורי פעיל: בלי טבעת, ועם עיגול 20px בצבע `--accent` עם `Plus` לבן 14px בפינה השמאלית התחתונה ומסגרת 2px `--bg`. לחיצה מובילה ל-`/new/story`. אם יש לי סטורי פעיל: טבעת, ולחיצה פותחת את הצופה.
- אחריו: משתמשים שאני עוקב אחריהם ויש להם סטורי פעיל. קודם אלה שיש להם משהו שלא ראיתי, לפי הסטורי האחרון שלהם מהחדש לישן, ואחריהם אלה שכבר ראיתי, באותו סדר.
- סטורי פעיל: `expires_at > now()`.

### צופה הסטוריז (`/stories/[username]`)
- מסך מלא ברקע `#000000`, בלי הכותרת העליונה ובלי הסרגל התחתון.
- התמונה ממורכזת עם `object-fit: contain`.
- למעלה, ריפוד 8px: פס התקדמות לכל סטורי של המשתמש, בגובה 2px ברווח 4px. מלא: `#FFFFFF`. ריק: `rgba(255,255,255,0.35)`. הפס של הסטורי הנוכחי מתמלא במשך 5 שניות.
- מתחת לפסים: תמונת פרופיל 32px, שם משתמש (14px, 700, לבן) וזמן (12px, `rgba(255,255,255,0.7)`). בצד שמאל: `X` לבן 28px עם aria-label "סגירה".
- הסטוריז של המשתמש מוצגים מהישן לחדש.
- לחיצה בחצי השמאלי של המסך: הסטורי הבא. לחיצה בחצי הימני: הסטורי הקודם (או השארות בראשון). אחרי 5 שניות עוברים אוטומטית לבא.
- אחרי הסטורי האחרון של המשתמש: עוברים למשתמש הבא בשורת הסטוריז. אחרי המשתמש האחרון: חוזרים ל-`/`.
- החלקה למטה של יותר מ-100px, או `X`: חזרה ל-`/`.
- כל סטורי שמוצג נרשם כנצפה (insert ל-`story_views`, ואם כבר קיים מתעלמים).
- בסטורי שלי: בתחתית, במרכז, כפתור לבן 14px: `Eye` 18px ואחריו "{n} צפיות". לחיצה עוצרת את הטיימר ופותחת bottom sheet עם הכותרת "צפיות" ורשימת הצופים (שורות כמו בחיפוש). סגירת ה-sheet ממשיכה את הטיימר.
- אין עוד שום פעולה בצופה: לא תגובות, לא לייקים, לא מחיקה, ולא עצירה בלחיצה ארוכה.

## 7. דאטהבייס
כל הטבלאות ב-`public`. מזהים מסוג `uuid default gen_random_uuid()`, וזמנים מסוג `timestamptz default now()`.

- `profiles`: `id uuid primary key references auth.users on delete cascade`, `username text unique not null check (username ~ '^[a-z0-9_]{3,20}$')`, `display_name text not null check (char_length(display_name) between 1 and 40)`, `bio text not null default '' check (char_length(bio) <= 150)`, `avatar_path text`, `posts_count int not null default 0`, `followers_count int not null default 0`, `following_count int not null default 0`, `created_at`.
- `posts`: `id`, `user_id uuid not null references profiles on delete cascade`, `image_path text not null`, `aspect_ratio text not null check (aspect_ratio in ('1:1','4:5'))`, `caption text not null default '' check (char_length(caption) <= 2200)`, `likes_count int not null default 0`, `comments_count int not null default 0`, `created_at`. אינדקס על `(user_id, created_at desc)`.
- `likes`: `post_id uuid references posts on delete cascade`, `user_id uuid references profiles on delete cascade`, `created_at`, `primary key (post_id, user_id)`.
- `comments`: `id`, `post_id uuid not null references posts on delete cascade`, `user_id uuid not null references profiles on delete cascade`, `body text not null check (char_length(body) between 1 and 500)`, `created_at`. אינדקס על `(post_id, created_at)`.
- `follows`: `follower_id uuid references profiles on delete cascade`, `following_id uuid references profiles on delete cascade`, `created_at`, `primary key (follower_id, following_id)`, `check (follower_id <> following_id)`.
- `stories`: `id`, `user_id uuid not null references profiles on delete cascade`, `image_path text not null`, `created_at`, `expires_at timestamptz not null default now() + interval '24 hours'`.
- `story_views`: `story_id uuid references stories on delete cascade`, `viewer_id uuid references profiles on delete cascade`, `viewed_at timestamptz default now()`, `primary key (story_id, viewer_id)`.
- `notifications`: `id`, `user_id uuid not null references profiles on delete cascade` (מי שמקבל), `actor_id uuid not null references profiles on delete cascade`, `type text not null check (type in ('like','comment','follow'))`, `post_id uuid references posts on delete cascade`, `comment_id uuid references comments on delete cascade`, `read_at timestamptz`, `created_at`. אינדקס על `(user_id, created_at desc)`.

### Triggers (פונקציות `security definer` עם `set search_path = public`)
- `posts`: insert ו-delete מעדכנים את `profiles.posts_count`.
- `likes`: insert ו-delete מעדכנים את `posts.likes_count`. insert יוצר התראת `like` לבעל הפוסט, אלא אם הוא עצמו עשה את הלייק. delete מוחק את ההתראה הזו.
- `comments`: insert ו-delete מעדכנים את `posts.comments_count`. insert יוצר התראת `comment` עם `post_id` ו-`comment_id`, אלא אם בעל הפוסט עצמו הגיב.
- `follows`: insert ו-delete מעדכנים את `following_count` של העוקב ואת `followers_count` של מי שעוקבים אחריו. insert יוצר התראת `follow`. delete מוחק אותה.
- אין ניקוי מתוזמן של סטוריז. הסינון לפי `expires_at` מספיק.

### Realtime
- מוסיפים ל-publication `supabase_realtime` רק את `posts`, `comments` ו-`notifications`.

## 8. זמן אמת (רק אלה)
- פיד, `/p/[id]` ופרופיל: מנוי ל-`UPDATE` על `posts`. כשמגיע עדכון לפוסט שמוצג, מעדכנים את `likes_count` ואת `comments_count` שלו.
- `/p/[id]`: מנוי ל-`INSERT` ול-`DELETE` על `comments` עם `post_id=eq.{id}`. תגובה חדשה מתווספת לסוף הרשימה, ותגובה שנמחקה יורדת.
- כל האפליקציה (ב-Context): מנוי ל-`INSERT` על `notifications` עם `user_id=eq.{me}`, שמדליק את הנקודה.
- פוסטים חדשים לא מופיעים בפיד בזמן אמת. הם מופיעים אחרי רענון או לחיצה על `Home`.

## 9. הרשאות (RLS פעיל על כל הטבלאות)
| טבלה | select | insert | update | delete |
|---|---|---|---|---|
| `profiles` | כל משתמש מחובר | `id = auth.uid()` | `id = auth.uid()`, רק בעמודות `display_name`, `bio`, `avatar_path` | אסור |
| `posts` | כל משתמש מחובר | `user_id = auth.uid()` | אסור | `user_id = auth.uid()` |
| `likes` | כל משתמש מחובר | `user_id = auth.uid()` | אסור | `user_id = auth.uid()` |
| `comments` | כל משתמש מחובר | `user_id = auth.uid()` | אסור | `user_id = auth.uid()` |
| `follows` | כל משתמש מחובר | `follower_id = auth.uid()` | אסור | `follower_id = auth.uid()` |
| `stories` | כל משתמש מחובר, ורק אם `expires_at > now()` | `user_id = auth.uid()` | אסור | אסור |
| `story_views` | `viewer_id = auth.uid()` או שהסטורי שלי | `viewer_id = auth.uid()` והסטורי פעיל | אסור | אסור |
| `notifications` | `user_id = auth.uid()` | אסור (רק trigger) | `user_id = auth.uid()`, רק בעמודה `read_at` | אסור |

- הגבלת עמודות בעדכון נעשית עם column privileges: `revoke update on profiles from authenticated`, ואז `grant update (display_name, bio, avatar_path) on profiles to authenticated`. אותו דבר ב-`notifications` עם `read_at`.
- למשתמש `anon` אין שום הרשאה על אף טבלה.

### Storage
- באקטים `avatars`, `posts`, `stories`: `public = true`, `file_size_limit = 5242880`, `allowed_mime_types = {image/webp, image/jpeg}`.
- policies על `storage.objects` בכל באקט: insert ו-delete רק למשתמש מחובר, כש-`(storage.foldername(name))[1] = auth.uid()::text`. update אסור.
- המפתח `SUPABASE_SECRET_KEY` מופיע רק ב-`scripts/`, אף פעם לא בקוד של `app/`, `components/` או `lib/`.
- `.env.local` נמצא ב-`.gitignore`. נוצר `.env.example` עם שמות המשתנים מסעיף 1 בלי ערכים.

## 10. PWA
- `app/manifest.ts`: `name` ו-`short_name` "פריים", `lang: 'he'`, `dir: 'rtl'`, `display: 'standalone'`, `start_url: '/'`, `background_color` ו-`theme_color` `#FFFFFF`.
- אייקונים 192 ו-512, וגם `apple-touch-icon` 180: ריבוע ברקע `#E11D74` עם האות "פ" לבנה, Heebo 800, בגובה 60% מהאייקון, ממורכזת. נוצרים כקבצי PNG ב-`public/` עם סקריפט ב-`scripts/` שמשתמש רק ב-Node וב-Next (`ImageResponse` מ-`next/og`), או כ-`app/icon.tsx` ו-`app/apple-icon.tsx`.
- `viewport`: `width=device-width, initial-scale=1, viewport-fit=cover`, ו-`themeColor` לפי מצב בהיר או כהה (`#FFFFFF` או `#000000`).

## 11. דאטה לדמו (`scripts/seed.ts`, מריצים עם `npx tsx scripts/seed.ts`)
- משתמש ב-`SUPABASE_SECRET_KEY`. קודם מוחק את ארבעת משתמשי הדמו אם הם קיימים (לפי האימייל), ואז יוצר אותם מחדש.
- משתמשים (אימייל `{username}@frame.test`, סיסמה `SEED_PASSWORD`, `email_confirm: true`):
  1. `noa_levi`, "נועה לוי", ביו "צלמת חובבת, תל אביב"
  2. `yossi_cohen`, "יוסי כהן", ביו "אוכל, טיולים וקפה"
  3. `maya_bd`, "מאיה בן דוד", ביו "מעצבת. אוהבת ים"
  4. `omer_m`, "עומר מזרחי", ביו "מפתח ביום, רץ בלילה"
- תמונת פרופיל: `https://picsum.photos/seed/avatar-{username}/400/400`, מורדת ומועלית ל-`avatars/{user_id}/{uuid}.jpg`.
- 4 פוסטים לכל משתמש (16 סך הכול), `aspect_ratio` `4:5`, תמונה `https://picsum.photos/seed/frame-{username}-{n}/1080/1350`, מועלית ל-`posts/{user_id}/{uuid}.jpg`. כיתובים לפי n: 1 "בוקר טוב מהמרפסת", 2 "עוד יום של עבודה", 3 "השקיעה של היום", 4 "סופ״ש כמו שצריך". `created_at` של פוסט n של משתמש i (i ו-n מתחילים ב-1): `now() - ((i - 1) * 4 + n) * 3 hours`.
- כל ארבעת המשתמשים עוקבים זה אחרי זה.
- כל פוסט מקבל לייק משלושת המשתמשים האחרים.
- כל פוסט מקבל תגובה אחת, "איזה יופי!", מהמשתמש הבא ברשימה (אחרי 4 בא 1).
- סטורי אחד ל-`noa_levi` ואחד ל-`yossi_cohen`: `https://picsum.photos/seed/frame-story-{username}/1080/1920`, לבאקט `stories`.
- בסוף מדפיס שורה אחת: "seed הושלם".

## 12. בדיקת אבטחה (`scripts/security-check.ts`, מריצים עם `npx tsx scripts/security-check.ts`)
- מתחבר עם `NEXT_PUBLIC_SUPABASE_PUBLISHABLE_KEY` בתור `yossi_cohen` ומנסה את הפעולות האלה. כל אחת מהן חייבת להיכשל או לא להשפיע על אף שורה:
  1. לעדכן את הביו של `noa_levi`
  2. לעדכן את `followers_count` בפרופיל של עצמו
  3. למחוק פוסט של `noa_levi`
  4. ליצור פוסט עם `user_id` של `noa_levi`
  5. לעדכן את `likes_count` בפוסט של עצמו
  6. למחוק תגובה של `noa_levi`
  7. ליצור לייק עם `user_id` של `noa_levi`
  8. ליצור התראה
  9. לקרוא התראות של `noa_levi` (התוצאה חייבת להיות 0 שורות)
  10. להעלות קובץ ל-`posts/{noa_id}/test.webp`
  11. למחוק קובץ של `noa_levi` מהבאקט `posts`
  12. ליצור `story_views` עם `viewer_id` של `noa_levi`
  13. בלי התחברות (anon): לקרוא מ-`posts` (התוצאה חייבת להיות 0 שורות או שגיאה)
- מדפיס `PASS` או `FAIL` לכל בדיקה, ובסוף "{x}/13 עברו". אם משהו נכשל, מתקנים את ההרשאות ומריצים שוב עד 13/13.
- אחרי הבדיקה מריצים שוב את ה-seed, כדי שהדאטה תהיה נקייה.

## 13. סדר בנייה
1. הקמת הפרויקט, מיגרציות (טבלאות, triggers, RLS, storage, realtime), `db push`, seed ובדיקת אבטחה עד 13/13.
2. middleware, הרשמה, התחברות ו-onboarding.
3. מערכת העיצוב (צבעים, פונט, סרגלים, כפתורים), כרטיס פוסט ופיד.
4. העלאת פוסט, לייקים, דאבל טאפ, מחיקה, מסך פוסט ותגובות, וזמן אמת.
5. פרופיל, מעקב, רשימות עוקבים, ועריכת פרופיל והתנתקות.
6. סטוריז: שורה, העלאה, צופה וצפיות.
7. התראות, חיפוש ונקודת ההתראות.
8. PWA, מעבר על כל האפיון מול הקוד, `npm run build`, `npm run lint`, ובדיקת אבטחה שוב עד 13/13, ואז seed מחדש והרצה מקומית.

## 14. מחוץ לתחום (אסור לבנות)
דיפלוי (ל-Vercel או לכל שירות אחר), הודעות פרטיות, וידאו ורילס, קרוסלה, פילטרים ועריכת תמונה מעבר לחיתוך, עריכת פוסט, שמירת פוסטים, שיתוף, לייק לתגובה, תשובה לתגובה, האשטגים, תיוג משתמשים, מיקום, חשבון פרטי, חסימה, דיווח, איפוס סיסמה, התחברות עם Google או כל ספק אחר, אימות אימייל, החלפת שם משתמש, מחיקת חשבון, מחיקת סטורי, מסך הגדרות נוסף, כפתור מצב כהה, ממשק באנגלית, אנליטיקס, התראות פוש או אימייל, Service Worker, דף נחיתה, פאנל ניהול, הגבלת קצב, בדיקות אוטומטיות (חוץ מסעיף 12), Storybook, Docker, CI.

## 15. בדיקת קבלה (הבעלים מריץ ידנית)
1. משתמש א' בטלפון אחד ומשתמש ב' בטלפון שני, שניהם באותה רשת Wi-Fi כמו המחשב, בכתובת `http://<כתובת ה-IP של המחשב>:3000`. כל אחד נרשם ומשלים onboarding.
2. ב' מחפש את א' ועוקב אחריו. אצל א' נדלקת נקודת ההתראות בלי רענון.
3. א' מעלה פוסט מהמצלמה. ב' לוחץ על `Home` והפוסט מופיע ראשון.
4. ב' עושה דאבל טאפ. אצל א' מספר הלייקים עולה והנקודה נדלקת, בלי רענון.
5. ב' מגיב. אצל א', במסך הפוסט, התגובה מופיעה בלי רענון.
6. א' מעלה סטורי. אצל ב' מופיעה טבעת צבעונית, ב' צופה, הטבעת הופכת לאפורה, ו-א' רואה "1 צפיות" ואת ב' ברשימה.
7. בקונסול של הדפדפן אין שגיאות.

## 16. דוח סיום (התשובה האחרונה, בדיוק בסדר הזה)
1. הפקודה להרצה מקומית, וכתובת ה-IP המקומית לפתיחה מהטלפון
2. הפלט של בדיקת האבטחה
3. הפלט של `npm run build` (שורת הסיכום בלבד)
4. התוכן של `DECISIONS.md`
5. README בעברית קיים, עם הקמה, משתני סביבה, seed, בדיקת אבטחה והרצה מקומית: כן או לא

אומרים שלכתוב לקלוד בעברית יקר יותר מאנגלית

הסרטון

אומרים שלכתוב לקלוד בעברית יקר יותר מאנגלית

קורס חדש · בקרוב

בונים עם קלוד, מ-0 ל-100

קורס דיגיטלי שלוקח אתכם מרעיון למערכת שעובדת באוויר, גם בלי לדעת לתכנת. השאירו מייל, ואעדכן כשהוא עולה.

350 ₪ במקום 500 ₪מחיר השקה למי שנרשם עכשיו · כולל מע"מ

ההרשמה לא מחייבת לקנות. המייל נשמר רק בשביל העדכונים על הקורס, ולא עובר לאף אחד אחר.

מה יהיה בקורס