Communitygithub.com

evalix098/tiktoklive

Ajouter des comptes utilisateurs et la connexion à cette application TanStack Start. À utiliser lorsque l'application nécessite une authentification, une connexion, des comptes utilisateurs, des routes protégées ou des données par utilisateur. Déclenché par « auth », « login », « log in », « sign in », « sign up », « account », « users », « authentication », « protected », « who is logged in », « current user », « per-user ».

Qu'est-ce que tiktoklive ?

Cette compétence, pour les applications TanStack Start, intègre un système d'authentification complet via Better Auth, fédéré à un broker d'authentification Grok partagé. Elle permet d'activer la connexion avec Google, X ou email/mot de passe, et gère les routes protégées, les données par utilisateur, et la déconnexion. Prête à l'emploi, elle ne nécessite aucune installation de package supplémentaire et est désactivée par défaut, ce qui permet de l'activer uniquement lorsque nécessaire. Les développeurs peuvent l'utiliser via des hooks et composants React dédiés, tandis que le sandbox et le déploiement gèrent l'environnement sans configuration manuelle de variables.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/evalix098/tiktoklive/tree/HEAD/.grok/skills/auth

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Authentification

Cette application exécute son propre Better Auth à /api/auth/*, en se fédérant au broker d'authentification Grok partagé (auth.grok.me) via le plugin genericOAuth. Ce modèle intègre Google et X.

Méthodes de connexion prises en charge — utilisez UNIQUEMENT ces trois méthodes ; rien d'autre n'est pris en charge : Google, X et email/mot de passe. Aucun autre fournisseur social/OAuth (GitHub, Apple, Discord, …), aucun lien magique, clé d'accès, OTP, téléphone/SMS ou connexion anonyme. Ne pas ajouter d'entrées à GROK_PROVIDERS. Détail des méthodes et l'interrupteur email/mot de passe (modifier uniquement src/lib/auth/email-password.ts) : references/sign-in-methods.md. Exception — les spectateurs de la porte sont déjà connectés ; NE JAMAIS afficher de boutons de connexion/ré-authentification pour eux. Applications connecteur / données d'application : UNIQUEMENT la porte « Continuer avec Grok », pas de boutons Google/X : references/grok-identity.md.

La connexion est DÉSACTIVÉE par défaut — le modèle fournit .grok/app-env.json avec {"VITE_AUTH_ENABLED": "false"}, donc n'ajoutez des comptes que lorsque la demande l'exige (AGENTS.md §0.5). L'activer correspond à « Activer la connexion » ci-dessous.

Une fois activée, la connexion est RÉELLE — y compris dans l'aperçu en direct du sandbox. Ne PAS créer d'utilisateurs de démonstration/maquette/codés en dur. Aperçu : popup + client d'aperçu intégré ; déployé : client par application + DATABASE_URL + connexion porte sans clic (references/prewired-and-env.md).

Lorsqu'elle est DÉSACTIVÉE (VITE_AUTH_ENABLED=false), un utilisateur de développement est renvoyé pour qu'une application sans authentification s'affiche sans visiteur connecté — développement et aperçu uniquement. Lorsqu'elle est déployée, le drapeau est celui de la plateforme (toujours "true"), donc requireUserId rejette tout visiteur — les applications sans authentification ne l'utilisent ni n'utilisent authMiddleware.

Tout est préinstallé et pré-câblé dans src/lib/auth/ — ne pas npm install quoi que ce soit ; better-auth est le seul package d'authentification (jamais @neondatabase/*, @stackframe/*, ou @clerk/*). Ne pas modifier ni réécrire de fichier dans src/lib/auth/ — server.ts encore moins — sauf email-password.ts pour son unique drapeau. Carte par fichier : references/prewired-and-env.md.

/auth/popup est déjà géré par le plugin Vite du modèle (vite.config.ts → popup.server.ts) : il n'affiche jamais l'application React. Ne PAS créer src/routes/auth/popup.tsx (ni aucune page React / OAuth client à ce chemin) — cela affiche l'application complète dans la popup, le mode d'échec courant.

Ne jamais écrire de fichier .env / .env.local / .env.example dans ce sandbox : l'aperçu en direct a besoin de zéro configuration d'environnement et une application déployée reçoit ses variables injectées par la plateforme. Les boutons existants se trouvent dans references/prewired-and-env.md — ne jamais exposer une variable non VITE_ au client.

migrations/auth/0001_auth.sql est le schéma Better Auth — ne pas modifier. Il se trouve en dehors du répertoire migrations/ (aucun applicateur ne descend), donc il n'est pas appliqué aux applications sans connexion ; « Activer la connexion » le copie vers le haut.

Activer la connexion

Faites tout cela — les routes seules affichent la branche désactivée :

  1. Drapeau : supprimez la clé VITE_AUTH_ENABLED de .grok/app-env.json et redémarrez le serveur de développement. Vite lit l'environnement au démarrage, donc HMR ne le détectera pas. npm run dev, npm run build et npm run preview lisent tous ce fichier via scripts/with-app-env.mjs, donc l'aperçu et la sortie compilée basculent ensemble — ne démarrez jamais Vite directement.
  2. Schéma : cp migrations/auth/0001_auth.sql migrations/0001_auth.sql, puis redémarrez pour qu'il s'applique. Il est suivi par nom de base dans _migrations, donc une base de données qui l'a déjà ne le réexécutera pas.
  3. Routes : ajoutez src/routes/api/auth/$.ts + src/routes/login.tsx — copiez les deux depuis references/wiring.md (la route API générique est ce qui rend /api/auth/* et le rappel du broker fonctionnels).
  4. Déconnexion : une connexion sans moyen de sortie n'est pas terminée — affichez <UserButton /> depuis @/lib/auth/gates (câble signOut() ; masque la déconnexion pour les sessions de porte).
  5. Données existantes : enveloppez les fonctions serveur de l'application dans authMiddleware (une application sans authentification n'a pas dû l'utiliser — voir la compétence neon). Les lignes antérieures à l'existence de la connexion sont des données de développement : supprimez-les et recréez-les sauf si l'utilisateur dit le contraire — ne les remettez pas à celui qui se connecte en premier.

Construire dessus une fois qu'il est activé

  • Connexion / Déconnexion : signIn(providerId) et signOut() depuis @/lib/auth/client ; GROK_PROVIDERS affiche les boutons. La popup, le transfert de jeton porteur et l'attachement de requête sont internes — laissez-les tranquilles. Préférez <UserButton /> (il gère les états en attente et d'échec) ; signOut() rejette lorsqu'il est déployé si le serveur ne confirme jamais — interceptez-le. Ne jamais authClient.signOut() : il laisse le jeton porteur d'aperçu attaché à chaque requête ultérieure, donc le visiteur reste connecté.
  • Lire l'utilisateur : useCurrentUser() est en lecture seule (null signifie chargement OU déconnecté, donc ne redirigez jamais uniquement sur celui-ci) ; protégez-vous avec useCurrentUserState()'s isPending à la place. Les portes (SignedIn, SignedOut, SignInGate, RedirectToSignIn, UserButton) vivent dans @/lib/auth/gates. Règles strictes pour l'appel à l'action, le squelette et le SSR sans flash avec cookie : references/session-ui.md.
  • Données par utilisateur (obligatoire) : chaque fonction serveur qui touche aux données par utilisateur doit utiliser le authMiddleware pré-câblé et limiter chaque lecture et écriture à context.userId — un pilote Postgres a un accès complet à la base de données, donc rien d'autre ne limite la requête. Conservez les colonnes user_id en TEXT ; ne faites jamais confiance à un identifiant utilisateur fourni par le client ; en mode déconnecté, le middleware lève UnauthorizedError (401). Code et sémantique en mode désactivé : references/per-user-data.md.
  • Modèle de sécurité : broker sans tête, cookies __Host- + trustedOrigins, et isolation des frères Fetch-Metadata sont déjà câblés — ne les affaiblissez jamais pour faire disparaître une erreur (references/sign-in-methods.md couvre le modèle et le correctif « Invalid origin »).

Individual skills in this repo

This repo contains 17 individual skills — each has its own dedicated page.

evalix098/tiktoklive

Build browser games and interactive/canvas/3D experiences in this TanStack Start + React app. Use for any game, simulation, or WebGL/Canvas experience — 2D or 3D, single-player. Covers the game loop & timing, 3D orientation/camera conventions, collision, performance, assets, audio, save, game feel, and per-genre playbooks. For WASD / vehicle / flight **input signs and inverted A/D**, open the **`controls`** skill — do not rely on this file or racing-kart alone. Triggers on "game", "minecraft", "fps", "platformer", "racing", "tetris", "snake", "shooter", "3d", "three.js", "canvas", "voxel", "physics".

evalix098/tiktoklive

Player-facing input signs for browser games: WASD, vehicles, flight, FPS mouse-look, and the #1 failure mode (inverted A/D). Mandatory control self-tests and a tiny test interface so you can verify A turns left before shipping. Load for ANY game with movement, steering, flying, driving, tanks, boats, mechs, drones, planes, karts, third-person follow cams — not only racing. Triggers on "controls", "WASD", "inverted", "steer", "flight", "airplane", "kart", "vehicle", "yaw", "roll", "pitch", "mouse look", "A/D".

evalix098/tiktoklive

Design and build polished, non-generic UI for this TanStack Start + React + Tailwind v4 + shadcn/Radix app. Use whenever you create or restyle any interface surface — pages, landing pages, dashboards, forms, modals, nav, and game overlays (start screens, HUD, menus). Covers design tokens, layout, typography, color, spacing, motion, and the anti-"AI-slop" rules that keep output from looking generic. Triggers on "design", "UI", "make it look good", "polish", "landing page", "theme", "style", "redesign", "ugly", "clean up".

evalix098/tiktoklive

Deep guide for game ANIMATION assets: motion cycles, action keyframes, effect sequences, and animation sprite sheets — built around a video-first pipeline. In this app-builder sandbox, execute via the video2dsprite / generate2dsprite skills (magenta + scripts), not ad-hoc ffmpeg. Use whenever generating anything that moves: walk/run cycles, attacks, idles, FX, flags, fire, animation sheets. Complements game-asset-core.

evalix098/tiktoklive

Core discipline for ANY game-asset generation with Imagine tools: the engine-ready defaults users don't state, spec checklists, style anchoring, read-back verification, honest defect flagging. Use whenever generating any game art (sprites, sheets, animations, tiles, UI, FX) — then ALSO load the matching specialist skill: game-animation-frames for anything that moves, game-tilesets for tiles/terrain, game-character-consistency for recurring characters, game-ui-icons for UI and icons.

evalix098/tiktoklive

Deep guide for CHARACTER IDENTITY across images: turnarounds (front/side/ back), state and damage variants, palette swaps, equipment changes, and same-character-in-context sets. Use whenever generating character turnarounds, character sheets, variants of an existing sprite, or any same-subject multi-image set. Complements game-asset-core.

evalix098/tiktoklive

Deep guide for game TILE assets: seamless tileable textures, terrain transition tilesets, autotiles, and ground/platform tiles. Use whenever generating tileable textures, tilesets, terrain transitions, or seamless patterns. Complements game-asset-core.

evalix098/tiktoklive

Deep guide for game UI assets: buttons with interaction states, panels, bars, wordmark logos, and icon sets. Use whenever generating game UI elements, HUD assets, inventory icons, icon sets, buttons, or title logos. Complements game-asset-core.

evalix098/tiktoklive

Generate production-oriented 2D game maps with `imagine_text_to_image`: RPG/top-down maps, side-scroller parallax stages, tilemaps, layered raster maps, prop packs, collision zones, and walkable areas. Use when building browser games that need real map art (not pure code-drawn tiles), layered props, or map collision metadata. Triggers on "map", "level", "stage", "tilemap", "overworld", "dungeon", "side scroller background", "prop pack", "2D map".

evalix098/tiktoklive

Generate and postprocess 2D game sprites and animation sheets: pixel-art characters, NPCs, creatures, spells, projectiles, impacts, props, summons, and transparent PNG/GIF exports. Use when building browser games that need real sprite sheets (not code-drawn placeholders), matching a map art style, or producing magenta-background sheets for chroma-key cleanup. Triggers on "sprite", "sprite sheet", "animation sheet", "pixel art character", "walk cycle", "attack animation", "projectile sprite", "2D game asset".

evalix098/tiktoklive

How to use the Imagine tools in Grok Build: imagine_text_to_image, imagine_image_to_image, imagine_reference_to_image, imagine_text_to_video, imagine_image_to_video, imagine_reference_to_video, and render_file for chat previews. When to build a visual with code instead of generating it, prompt-craft, reference-first handling of real people, factual grounding, and asset-consistency. Load this whenever generating or editing an image or video is on the table. Tool-usage-driven, not triggered by a user merely mentioning images.

evalix098/tiktoklive

Peer-to-peer realtime multiplayer over WebRTC data channels: every user of the deployed app connects directly to every other user (full mesh), the server only brokers the handshake at /api/rtc. Lowest possible latency, zero per-message server cost. Use for 2-8 player co-op/casual realtime: shared cursors, drawing, party games, casual action. Triggers: p2p, peer to peer, webrtc, low latency multiplayer, direct connection.

evalix098/tiktoklive

Use Neon Postgres (the database) in this TanStack Start app. Use when the app needs to store or query data, persist state, or keep per-user data. Triggers on "database", "Postgres", "Neon", "save data", "store data", "persist", "tables", "SQL", "query", "migrations".

evalix098/tiktoklive

Share-link previews and app identity for apps on *.grok.me: the injector-owned og:image card, the SVG favicon, and PWA icons for installable apps. Use when scaffolding, renaming, or restyling the app — and for share / unfurl / OG / Twitter card questions. A custom 1200×630 card from the app's own art is the default — games of every kind (DOM board/word games included), whimsical apps, creative tools, and brand-forward pages; only plain utilities keep the placeholder. Always run the brand-asset pass as a `task` subagent and never wait for it. Triggers on "share", "rename", "app name", "OG", "Open Graph", "twitter card", "unfurl", "og:image", "og:type", "x:game:image", "x-banner", "link preview", "social card", "thumbnail", "preview image", "favicon", "app icon", "PWA", "manifest", "installable", "home screen", "SEO", "meta description".

evalix098/tiktoklive

Official Three.js API and TSL (Three.js Shading Language) reference for LLM code generation. Load when writing or debugging three.js / WebGL / WebGPU / custom materials / shaders / GLTF / advanced three APIs beyond basic game loop/controls. Prefer building-games for game correctness (loop, WASD, camera, orientation); use this skill for full API/TSL depth. Triggers on "three.js", "threejs", "WebGPU", "TSL", "NodeMaterial", "shader", "GLTF", "MeshStandard", "OrbitControls", "WebGLRenderer".

evalix098/tiktoklive

Grok Build only. Turn a 2D character still into denser animation sprites via imagine_text_to_image base → imagine_image_to_video (6s/10s run-in-place) → ffmpeg frames → magenta chroma-key → dense sampled strips/grids/GIFs. Use when the user wants video-to-sprite, smoother run/walk cycles, or denser intermediate poses. Prefer generate2dsprite for crisp production pixel sheets. Triggers on "video to sprite", "imagine_image_to_video sprite", "dense walk cycle", "smooth run animation from video".

evalix098/tiktoklive

Call the xAI API (Grok) from this app's server code using the injected XAI_API_KEY: chat/LLM features, image and video generation (Imagine), and voice (text-to-speech). Use when the app needs any "AI" / "assistant" / "chatbot" / "Grok" functionality, runtime image/video generation, or speech. Triggers on "AI", "LLM", "chatbot", "assistant", "Grok", "xAI", "generate text", "summarize", "generate image", "AI video", "voice", "text to speech", "TTS", "OpenAI" (use xAI instead).

Skills associés