Vibekits

# Vibekits

AI Summary

Purpose:

• Capture durable knowledge about vibekits, a personal random tools and

casual browser games project under ~/hw/project.

Key points:

• The README describes Vibekits as random decision tools and casual browser

games built with React, TypeScript, Vite, TailwindCSS, i18n, and Supabase-ready auth primitives.

• Current MVP evidence includes language-prefixed routes, roulette, Flappy

Bird, Supabase Auth hook, ranking placeholder, ad placeholder, and share button.

• The current repository contains many tests and additional games/tools beyond

the README MVP, including Canvas games, 3D/physics dependencies, ranking wiring, analytics, ads, and share/ranking components.

• Live at https://vibekits.org/ko (owner-confirmed 2026-06-12). Traffic,

revenue, and real ranking/AdSense status are Needs confirmation.

Relevant when:

• Generating personal project portfolio material.
• Working on casual web games, random tools, i18n, ranking, ads, or Supabase

safety boundaries.

Do not read full document unless:

• You need route lists, game architecture rules, or test commands.

Linked documents:

• ai/repo-notes/vibekits.md
• ai/workspace/repos.md
• ai/wiki/projects/index.md

Open Questions

• ~~Production URL and deployment status~~ — resolved 2026-06-12: live at

https://vibekits.org/ko (owner-confirmed).

• Whether global ranking is deployed with RLS and Edge Function validation:

Needs confirmation.

• Whether AdSense is live or still placeholder wiring: Needs confirmation.
• Traffic, revenue, and user metrics: Needs confirmation.

Details

Product shape

Vibekits targets general users who need random decision tools and short casual browser games. The repo guidance describes a product direction around random tools, 2D/3D casual games, sharing, ads, Supabase auth, and rankings.

Verified MVP facts

From README:

• Language-prefixed Korean and English routes, with Japanese and Traditional

Chinese resource files prepared.

• Roulette at /ko/tools/roulette and /en/tools/roulette.
• Flappy Bird at /ko/games/flappy-bird and /en/games/flappy-bird.
• Supabase Auth hook, ranking placeholder, ad placeholder, and share button.

From package/tests:

• React 19, TypeScript, Vite, TailwindCSS, React Router, react-i18next,

Supabase, Three.js, cannon-es, Vitest, Testing Library, and Playwright.

• Test files cover app routes, lazy loading, ads, analytics, i18n, ranking,

Supabase config, game pages, and pure game engines.

Engineering constraints

Repo AGENTS.md defines a clear boundary:

• React owns UI, ads, ranking, sharing, routing, login state, and lifecycle.
• Game engine classes own loops, input, collision, scoring, rendering, resource

cleanup, and local high scores.

• Game logic files should not import React.

Security and data constraints:

• Supabase secret/service-role keys must not be placed in browser-exposed

VITE_* variables.

• Browser direct score inserts are unsafe; global score submission should go

through a secure Edge Function and RLS path.

Portfolio positioning

Suggested Korean portfolio angle:

• "다국어 랜덤 도구·캐주얼 웹게임 서비스"
• Highlight React/Vite, i18n, Canvas/Three.js game architecture, ranking/ad/share

primitives, and test coverage.

• Keep public metrics and monetization status as Needs confirmation.