Communitygithub.com

evalix098/tiktoklive

Utiliser Neon Postgres (la base de données) dans cette application TanStack Start. À utiliser lorsque l'application a besoin de stocker ou interroger des données, de persister l'état, ou de conserver des données par utilisateur. Se déclenche sur les termes « base de données », « Postgres », « Neon », « enregistrer des données », « stocker des données », « persister », « tables », « SQL », « requête », « migrations ».

Qu'est-ce que tiktoklive ?

Cette compétence permet aux agents IA d'intégrer une base de données relationnelle dans une application TanStack Start, en utilisant **Neon Postgres** en production et un fallback **PGLite** (WASM Postgres) en environnement de prévisualisation. Elle est activée par des termes comme « base de données », « SQL », ou « persister ». Compatible avec Claude Code, Cursor et Codex, elle fournit une API unifiée via `@/lib/db` (exportant `getSql()`). Le développeur n'a pas besoin de gérer les variables d'environnement manuellement : la plateforme injecte `DATABASE_URL` en déploiement, et le fallback local s'active automatiquement en prévisualisation. L'agent doit utiliser cette compétence exclusivement dans des fonctions serveur (`createServerFn`), et respecter les règles de sécurité : limiter les requêtes à l'utilisateur authentifié via `authMiddleware` si la connexion est activée, et ne jamais exposer la base de données côté client. Le schéma est défini dans des fichiers SQL versionnés dans `migrations/`, avec des instructions idempotentes. L'agent doit également suivre les bonnes pratiques : utiliser `user_id text` (et non UUID) pour la compatibilité avec le mode prévisualisation, éviter les extensions Postgres, et ne pas dépendre des états de session (Neon utilisant un pool sans état de session).

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

Demander à votre IA préférée

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

Documentation

Neon Postgres

La base de données est optionnelle (AGENTS.md §0.5) : utilisez-la uniquement lorsque l'application a besoin de données qui survivent à une session de navigateur ou qui sont partagées entre appareils. Sinon, n'envoyez pas de migrations, n'importez pas @/lib/db, et conservez l'état dans localStorage / zustand.

Ce modèle fournit une intégration de base de données double mode prête à l'emploi :

  • Configuré (variable d'environnement définie, par ex. déployé) : vrai Neon Postgres.
  • Non configuré (prévisualisation en direct dans le bac à sable) : la base de données tombe en recours sur un PGLite local (Postgres WASM embarqué), de sorte que la prévisualisation s'affiche toujours. Construisez votre code contre l'assistant @/lib/db ; les deux modes fonctionnent avec la même API.

Les packages sont préinstallés — ne lancez pas npm install : pg (node-postgres, le pilote Postgres standard) et @electric-sql/pglite (recours local de base de données).

Pour les comptes utilisateurs, la connexion et la lecture de l'utilisateur courant, consultez la compétence auth séparée — cette compétence ne concerne que la base de données.

Activer la base de données

Définissez deploy.database sur true dans .grok/app-env.json :

{ "VITE_AUTH_ENABLED": "false", "deploy": { "database": true } }

C'est ce qui indique à la plateforme de provisionner Neon pour l'application déployée ; laissez false et le déploiement n'obtiendra pas de DATABASE_URL, l'application s'exécutera donc silencieusement sur un PGLite jetable qui perdra ses lignes. Envoyer des fichiers migrations/*.sql, ou activer la connexion, provisionne une base de données indépendamment de ce drapeau — ce drapeau est destiné aux applications qui interrogent @/lib/db sans l'un ni l'autre. Ce n'est pas une clé VITE_ et n'atteint jamais le navigateur.

Variables d'environnement — ne créez pas de fichier .env

N'écrivez jamais de fichier .env / .env.local / .env.example pour la base de données. Dans la prévisualisation en direct du bac à sable, laissez DATABASE_URL non définie — @/lib/db utilise automatiquement PGLite embarqué. Lorsque l'application est déployée, la plateforme injecte DATABASE_URL (Neon) ; vous ne la provisionnez ni ne l'écrivez vous-même.

VarEmplacementObjectif
DATABASE_URLserveurChaîne de connexion Neon en déploiement (optionnelle — recours PGLite si non définie)

Ne la codez jamais en dur ; n'exposez jamais de variables non VITE_ au client.

Base de données (serveur uniquement)

@/lib/db exporte getSql() et dbSource : un pilote Postgres standard (node-postgres, pg) utilisant DATABASE_URL, ou un recours local PGLite lorsqu'elle n'est pas définie. Même API dans les deux cas — un modèle avec balises (et .query()) résolvant en rows[]. Appelez UNIQUEMENT depuis un gestionnaire createServerFn / chargeur serveur, jamais depuis un composant client. Définissez le schéma dans migrations/, pas en ligne.

import { createServerFn } from "@tanstack/react-start";
import { getSql } from "@/lib/db";

export const listPosts = createServerFn({ method: "GET" }).handler(async () => {
  const sql = await getSql();
  // Tapez la forme de la ligne — la valeur de retour d'une fonction serveur doit être prouvablement sérialisable.
  return sql<{ id: number; title: string }>`select id, title from posts order by id desc`;
  // ou : return sql.query<{ id: number; title: string }>("select id, title from posts where id = $1", [id]);
});

Données par utilisateur (uniquement une fois que l'application a la connexion). Un pilote standard a un accès complet à la base de données, donc limitez chaque requête à l'utilisateur authentifié côté serveur — ne faites jamais confiance à un identifiant envoyé par le client. Utilisez le authMiddleware pré-câblé pour obtenir un context.userId vérifié, puis filtrez par celui-ci. Le modèle complet (intergiciel, appel depuis le code client, sémantique de fermeture en cas d'échec) se trouve dans la compétence auth :

import { authMiddleware } from "@/lib/auth/middleware";

export const listTodos = createServerFn({ method: "GET" })
  .middleware([authMiddleware])
  .handler(async ({ context }) => {
    const sql = await getSql();
    return sql<{ id: number; title: string }>`select id, title from todos where user_id = ${context.userId} order by id desc`;
  });
// les mutations doivent également limiter les écritures : `... where id = ${id} and user_id = ${context.userId}`

Sans connexion (par défaut), n'utilisez PAS authMiddleware / requireUserId. L'utilisateur de développement auquel ils recourent est une commodité limitée à la prévisualisation. Le VITE_AUTH_ENABLED d'une application déployée est défini par la plateforme, pas par cet espace de travail (aujourd'hui, le déployeur le met toujours à "true"), donc une fois déployé, les deux rejettent chaque visiteur — et une application sans authentification n'offre pas de route de connexion pour qu'ils puissent récupérer. Une application utilisant uniquement la base de données conserve ses lignes sans propriétaire : pas de colonne user_id, ou une constante littérale. Ajoutez l'intergiciel dans le cadre de l'activation de la connexion (les étapes de mise à niveau de la compétence auth), et ré-affectez ou supprimez ces lignes à ce moment-là.

Les lignes sans propriétaire sont lisibles et modifiables par le monde entier via vos fonctions serveur publiques : ne persistez jamais de données personnelles ou sensibles (noms, e-mails, texte libre sur une personne) dans ce mode, et évitez les mutations destructrices en masse (supprimer tout, remplacer tout) — si l'application en a besoin, proposez plutôt la connexion.

Migrations

Les fichiers migrations/*.sql sont la source unique du schéma. Ils s'appliquent à Neon lors du déploiement (npm run build exécute db:migrate contre DATABASE_URL, donc Vercel livre le schéma prêt) et à la prévisualisation PGLite automatiquement au démarrage, de sorte que le développement corresponde à la production.

Aucun des deux applicateurs ne descend dans les sous-répertoires, donc le schéma Better Auth dans migrations/auth/0001_auth.sql n'est pas appliqué à moins que l'application n'active la connexion et ne le copie (ne le modifiez pas — voir la compétence auth). Placez le schéma de votre application dans de NOUVEAUX fichiers ordonnés commençant à 0002 :

-- migrations/0002_schema.sql — exemple pour une application de tâches ; utilisez LES TABLES de VOTRE application
create table if not exists todos (
  id         serial primary key,
  user_id    text not null,
  title      text not null,
  done       boolean not null default false,
  created_at timestamptz not null default now()
);
create index if not exists todos_user_id_idx on todos (user_id);

Ne modifiez jamais un fichier déjà appliqué — il est suivi par nom dans _migrations et ne sera pas réexécuté (ajoutez plutôt un nouveau fichier ; les nouveaux fichiers s'appliquent à la prévisualisation en cours d'exécution lors de la prochaine requête). Préférez les instructions idempotentes (… if not exists). Les tables contenant des données par utilisateur doivent avoir une colonne user_id text not null (TEXT, pas UUID — l'identifiant de l'utilisateur de développement en prévisualisation est la chaîne 'dev-user').

Parité prévisualisation ↔ production

getSql() normalise les types de résultat pour que les deux moteurs renvoient des formes identiques et sûres pour JSON : bigint/count(*) → number, date → chaîne 'YYYY-MM-DD', interval → texte, numeric → chaîne. Différences restantes à respecter :

  • Les bigint dépassant 2^53 perdent en précision en tant que nombre — castez ::text si vous avez besoin d'entiers très grands (les comptages de lignes sont corrects).
  • La base de données de prévisualisation est en mémoire : effacée au redémarrage du serveur de développement, connexion unique (pas de conflit de verrouillage ni de conflit d'écriture concurrente), et ne charge aucune extension — n'utilisez pas create extension ; contentez-vous du Postgres de base.
  • Le point de terminaison poolé de Neon ne conserve pas d'état de session — ne comptez pas sur SET, LISTEN/NOTIFY, ou les verrous consultatifs de session.
  • Conservez les colonnes user_id en text — la prévisualisation utilise 'dev-user', la production utilise les identifiants textuels de Better Auth ; une colonne uuid casse les insertions en prévisualisation.
  • Les requêtes Neon déployées traversent le réseau (et peuvent être reprises à froid) — évitez les motifs de requête N+1 qui semblent gratuits contre la base de données de prévisualisation en processus.

Individual skills in this repo

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

evalix098/tiktoklive

Add user accounts and sign-in to this TanStack Start app. Use when the app needs authentication, sign-in, user accounts, protected routes, or per-user data. Triggers on "auth", "login", "log in", "sign in", "sign up", "account", "users", "authentication", "protected", "who is logged in", "current user", "per-user".

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

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