Communitygithub.com

Neon Postgres

Nutze Neon Postgres (die Datenbank) in dieser TanStack Start App. Verwende es, wenn die App Daten speichern oder abfragen, Zustand persistieren oder benutzerspezifische Daten aufbewahren muss. Auslöser sind „Datenbank“, „Postgres“, „Neon“, „Daten speichern“, „Daten persistieren“, „Tabellen“, „SQL“, „Abfrage“, „Migrationen“.

Was ist Neon Postgres?

Dieses Skill integriert eine vollständig vorkonfigurierte, duale Datenbanklösung in eine TanStack Start App. Es bietet eine Neon Postgres (server-seitige, vollwertige Postgres-Datenbank) für bereitgestellte Umgebungen und fällt bei nicht gesetzter `DATABASE_URL` automatisch auf ein lokales, eingebettetes PGLite (WASM-basiertes Postgres) zurück – die Live-Vorschau im Sandkasten funktioniert so immer. Entwickler interagieren über einen einheitlichen, server-seitigen `@/lib/db` Helper (mittels `getSql()` oder `dbSource`) und müssen niemals manuell `.env`-Dateien erstellen; die Datenbankverbindung wird automatisch über die Bereitstellungsplattform via `DATABASE_URL` injiziert. Das Skill behandelt Datenbank-Migrationen (`migrations/*.sql`), die automatisch bei Build (`npm run build`) auf Neon und beim Start der Live-Vorschau auf PGLite angewendet werden, sowie die wichtige Unterscheidung zwischen unangemeldeten (kein `authMiddleware`, unowned rows) und angemeldeten Nutzern (mit `authMiddleware`, `user_id` Filterung). Es legt großen Wert auf Parität zwischen Vorschau und Produktion: Typen wie `bigint`, `date`, `numeric` werden normalisiert, und es gibt klare Einschränkungen (z. B. kein Session-State auf Neon, kein `create extension` in PGLite, `user_id` als TEXT). Das Skill implementiert selbst keine Authentifizierung – dafür ist das separate Auth-Skill zuständig –, sondern stellt nur die Datenbankebene bereit.

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

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Was macht Neon Postgres?

Die Datenbank ist opt-in (AGENTS.md §0.5): Verwende sie nur, wenn die App Daten benötigt, die eine Browser-Sitzung überdauern oder geräteübergreifend geteilt werden. Andernfalls versende keine Migrationen, importiere kein @/lib/db und behalte den Zustand in localStorage/zustand.

Diese Vorlage enthält eine vorgefertigte, zweigleisige Datenbankintegration:

  • Konfiguriert (Umgebungsvariable gesetzt, z. B. bereitgestellt): Echte Neon Postgres.
  • Nicht konfiguriert (Sandbox-Live-Vorschau): Die Datenbank fällt auf ein lokales PGLite (eingebettetes WASM Postgres) zurück, sodass die Vorschau immer rendert. Entwickle gegen den @/lib/db-Helfer; beide Modi arbeiten mit derselben API.

Pakete sind vorinstalliert — npm install sie nicht: pg (node-postgres, der normale Postgres-Treiber) und @electric-sql/pglite (lokaler DB-Fallback).

Für Benutzerkonten, Anmeldung und Lesen des aktuellen Benutzers siehe das separate auth-Skill – dieses Skill ist nur die Datenbank.

Datenbank einschalten

Setze deploy.database in .grok/app-env.json auf true:

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

Das sagt der Plattform, dass sie Neon für die bereitgestellte App bereitstellen soll; lass es auf false und die Bereitstellung bekommt keine DATABASE_URL, sodass die App stillschweigend auf einem flüchtigen PGLite läuft, das seine Zeilen verliert. Das Ausliefern von migrations/*.sql oder einer Anmeldung stellt unabhängig davon eine bereit – dieses Flag ist für eine App, die @/lib/db abfragt, ohne eines von beidem zu haben. Es ist kein VITE_-Schlüssel und erreicht nie den Browser.

Umgebungsvariablen — keine .env-Datei erstellen

Erstelle niemals eine .env / .env.local / .env.example für die Datenbank. In der Sandbox-Live-Vorschau lasse DATABASE_URL ungesetzt – @/lib/db verwendet automatisch die eingebettete PGLite. Wenn die App bereitgestellt wird, injiziert die Plattform DATABASE_URL (Neon); du stellst sie nicht selbst bereit oder schreibst sie.

VarWoZweck
DATABASE_URLServerNeon-Verbindungszeichenfolge bei Bereitstellung (optional – PGLite-Fallback, wenn nicht gesetzt)

Hartcodiere sie niemals; setze niemals Nicht-VITE_-Variablen dem Client aus.

Datenbank (nur Server)

@/lib/db exportiert getSql() und dbSource: einen normalen Postgres-Treiber (node-postgres, pg) gegen DATABASE_URL oder einen lokalen PGLite-Fallback, wenn nicht gesetzt. In beiden Fällen dieselbe API – ein getaggtes Template (und .query()), das zu rows[] auflöst. Rufe NUR innerhalb eines createServerFn-Handlers / Server-Loaders auf, niemals in einer Client-Komponente. Definiere das Schema in migrations/, nicht inline.

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

export const listPosts = createServerFn({ method: "GET" }).handler(async () => {
  const sql = await getSql();
  // Typisiere die Zeilenform – der Rückgabewert einer Server-Funktion muss nachweislich serialisierbar sein.
  return sql<{ id: number; title: string }>`select id, title from posts order by id desc`;
  // oder: return sql.query<{ id: number; title: string }>("select id, title from posts where id = $1", [id]);
});

Benutzerspezifische Daten (nur wenn die App eine Anmeldung hat). Ein normaler Treiber hat vollen DB-Zugriff. Daher begrenze jede Abfrage serverseitig auf den authentifizierten Benutzer – vertraue niemals einer vom Client gesendeten ID. Verwende die vorgefertigte authMiddleware, um eine verifizierte context.userId zu erhalten, und filtere dann danach. Das vollständige Muster (Middleware, Aufruf vom Client-Code, Fail-Closed-Semantik) ist im auth-Skill:

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`;
  });
// Mutationen müssen ebenfalls Schreibvorgänge begrenzen: `... where id = ${id} and user_id = ${context.userId}`

Ohne Anmeldung (Standard) verwende NICHT authMiddleware / requireUserId. Der Entwickler-Benutzer, auf den sie zurückfallen, ist ein reiner Vorschau-Komfort. VITE_AUTH_ENABLED einer bereitgestellten App wird von der Plattform gesetzt, nicht von diesem Workspace (heute setzt der Deployer sie immer auf "true"). Daher weisen beide, wenn sie bereitgestellt sind, jeden Besucher ab – und eine App ohne Authentifizierung liefert keine Anmelderoute, um sich davon zu erholen. Eine reine Datenbank-App behält ihre Zeilen ohne Besitzer: keine user_id-Spalte oder eine einzige literale Konstante. Füge die Middleware als Teil des Einschaltens der Anmeldung hinzu (die Upgrade-Schritte des auth-Skills) und passe dann den Gültigkeitsbereich dieser Zeilen an oder verwerfe sie.

Unbesitzerte Zeilen sind über deine öffentlichen Server-Funktionen weltweit les- und schreibbar: Persistiere in diesem Modus niemals persönliche oder sensible Daten (Namen, E-Mails, freier Text über eine Person) und verzichte auf zerstörerische Massenmutationen (alle löschen, alle überschreiben) – wenn die App sie benötigt, schlage stattdessen eine Anmeldung vor.

Migrationen

migrations/*.sql sind die einzige Schema-Quelle. Sie werden bei Bereitstellung auf Neon (npm run build führt db:migrate gegen DATABASE_URL aus, sodass Vercel mit dem fertigen Schema ausgeliefert wird) und auf der PGLite-Vorschau automatisch beim Start angewendet, sodass Entwicklung und Produktion übereinstimmen.

Keiner der Anwender durchsucht Unterverzeichnisse, daher wird das Better-Auth-Schema in migrations/auth/0001_auth.sql nicht angewendet, es sei denn, die App schaltet die Anmeldung ein und kopiert es nach oben (bearbeite es nicht – siehe das auth-Skill). Platziere das Schema deiner App in NEUEN, nummerierten Dateien, beginnend mit 0002:

-- migrations/0002_schema.sql — Beispiel für eine Todo-App; verwende die Tabellen DEINER App
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);

Bearbeite niemals eine angewendete Datei – sie wird namentlich in _migrations verfolgt und nicht erneut ausgeführt (füge stattdessen eine neue Datei hinzu; neue Dateien werden bei der nächsten Anfrage auf die laufende Vorschau angewendet). Bevorzuge idempotente Anweisungen (… if not exists). Tabellen mit benutzerspezifischen Daten sollten eine user_id text not null-Spalte enthalten (TEXT, nicht UUID – die Vorschau-Entwickler-Benutzer-ID ist der String 'dev-user').

Vorschau ↔ Produktionsparität

getSql() normalisiert Ergebnistypen, sodass beide Backends identische, JSON-sichere Formen zurückgeben: bigint/count(*) → number, date → 'YYYY-MM-DD'-String, interval → Text, numeric → String. Verbleibende Unterschiede, die zu beachten sind:

  • bigint jenseits von 2^53 verliert Genauigkeit als Zahl – wandle mit ::text um, falls du jemals große Ganzzahlen benötigst (Zeilenanzahlen sind in Ordnung).
  • Vorschau-DB ist im Arbeitsspeicher: wird bei Neustart des Entwicklungsservers gelöscht, Einzelverbindung (keine Sperrkonflikte oder gleichzeitige Schreibkonflikte) und lädt keine Erweiterungen – führe kein create extension aus; bleibe bei Kern-Postgres.
  • Neons gepoolter Endpunkt behält keinen Sitzungszustand – verlasse dich nicht auf SET, LISTEN/NOTIFY oder Sitzungsberatungssperren.
  • Halte user_id-Spalten als text – die Vorschau verwendet 'dev-user', die Produktion Better Auths Text-IDs; eine uuid-Spalte bricht Vorschau-Einfügungen.
  • Bereitgestellte Neon-Abfragen durchlaufen das Netzwerk (und können kalt neu starten) – vermeide N+1-Abfragemuster, die sich gegen die prozessinterne Vorschau-DB kostenlos anfühlen.

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).

Verwandte Skills