docs.gipity.ai

Templates

Starting points for a new app — gipity add <name>.

• 2d-game - Build 2D games with Phaser: scene structure, physics, input, sprites, genre recipes (platformer, scroller, arcade, puzzle, endless runner)
• 3d-engine - Minimal 3D multiplayer template - Three.js rendering, Rapier physics, Gipity Realtime multiplayer, player controller, voxel primitives. No gameplay; start here to build something new.
• 3d-world - Build 3D World games (3D multiplayer): the playable starter, genre recipes (obby, tycoon, simulator, PvP, shooter, horror, racing), features, multiplayer patterns, persistence
• web-vision-detect - High-accuracy on-device object detection for web apps: YOLOX on ONNX Runtime Web, custom-model support - the web-vision-detect kit
• web-vision-mediapipe - On-device camera vision for web apps: gesture recognition, body pose, object detection - the web-vision-mediapipe kit

App services

HTTP endpoints your deployed app can call at https://a.gipity.ai/api/<PROJECT_GUID>/services/*.

• app-audio - Sound effects, music generation, and audio transcription services for deployed apps
• app-auth - Sign in with Gipity: user authentication, consent, and session handling for apps
• app-files - File uploads for deployed apps: presigned upload URLs to Gipity Storage, progress tracking, thumbnails, up to 30GB, client helper library
• app-image - Image generation service for deployed apps (Gipity Image): text-to-image only (no editing/img2img), aspect ratios, resolution tiers
• app-llm - LLM service for deployed apps: request/response format, code examples, and billing config
• app-location - Location service for deployed apps: IP geolocation and reverse-geocoding via the app-scoped service endpoint - first-party, no API key
• app-notify - Web push notifications for deployed apps (Gipity Notify): the notify kit, the injected notify() service, iOS home-screen support - platform owns VAPID keys + delivery, no crypto
• app-payments - Charge your app's end-users via Stripe: one-time purchases + subscriptions through Stripe Connect. The owner connects their own Stripe account; Gipity brokers checkout and verified webhooks and takes a small platform fee.
• app-realtime - Real-time multiplayer: rooms, lobbies, invite links, WebSocket connections, shared state, and message relay
• app-realtime-reference - Raw Colyseus client reference: connecting without the kit, room discovery via REST, relay and state room message patterns, turn-based games, and the safe state-room initialization boilerplate
• app-tts - Text-to-speech service for deployed apps: Gipity Speech (30 voices, multi-speaker, 60+ languages)
• app-video - Video generation and understanding for deployed apps (Gipity Video): generate short AI videos, analyze video content

App development

Building, deploying, and debugging apps — functions, databases, the deploy pipeline.

• agent-deploy - Authenticate an autonomous agent, script, or CI job to Gipity with a long-lived agent API token (gip_at_*) instead of interactive login, then run the full build → deploy loop unattended
• app-database - App database for functions: Postgres schema in migrations, the db helper (query/findOne/insert/update/delete/tx), per-invocation limits, table permissions, views and globs
• app-debugging - Debug a deployed app: inspect pages, capture screenshots, read function logs, and call functions directly
• app-debugging-reference - Drive a deployed page from the CLI: multi-step evals, reload checks, real-file fixtures, in-app error traps, the synthetic camera, and stepping a simulation's clock
• app-development - Functions, database & API: write serverless functions, set up databases, deploy, test, and call via REST
• app-development-reference - Function runtime reference: ES module rules, multi-file functions, shared _lib modules, kits that ship backend pieces, versioning & rollback, management commands, and rate limits
• app-import - Bring any app INTO Gipity (from a .gip bundle or a GitHub repo, including Vercel/Replit/Lovable/Bolt apps) and take any Gipity app out as a portable .gip. Covers the connect flow, source detection, per-platform porting recipes, and how to talk about why porting is worth it.
• app-testing - Testing deployed functions: the test()/ctx.fn.call/callAs contract, the isolated auto-reset test database, ctx.isTest, concurrency-safe fixtures, auth:user and auth:member tests (ctx.users.owner), and ctx.upload file-serving tests
• deploy - The deploy pipeline: gipity.yaml manifest, phases, dev vs prod, checksums, and reading phase results
• jobs - Long-running async jobs - CPU or GPU via Gipity Jobs. Submit, poll, stream logs, retry, cancel. Per-second billing by compute class.
• realtime-scheduled-app - End-to-end recipe: live presence + messages, a function that persists to the DB, and a scheduled workflow that posts on a timer
• web-app-basics - Best practices for building web apps and games with HTML, CSS, JS. Includes game template info.
• web-ui-patterns - Concrete copy-paste web UI recipes - the default Gipity look (colors, fonts, type scale), safe show/hide toggling (the hidden-attribute vs CSS display trap), entry lists/feeds (cards, relative time, char counter, submit confirmation), and robust copy-to-clipboard. Load when building any web UI beyond a bare form. Web/HTML-CSS-JS only; not for native mobile.

Agent Tools

Capabilities the Gipity agent (Gip) exposes during a chat session.

• approvals - Pause THIS agent (or a workflow) for the user's yes/no, choice, or text decision - expiry and confirmation behavior. Not for deployed apps: an in-app approval flow is an ordinary auth: member function
• browser-automation - Browse websites, fill forms, extract data, and take screenshots with a real browser
• email - Sending email: the agent channels (platform + Gmail) and the app email() service - plus HTML style rules, image handling, and deliverability tips
• location - Get user location: GPS, IP geolocation, reverse-geocode coords, and stored history - all via get_location
• plan-mode - Planning mode: read-only research, plan files, and what tools are available vs blocked
• query-llm - Cross-model single-shot queries: send prompts to different LLM models without tool access
• sandbox-tools - How to use the code execution sandbox, pre-installed CLI tools, and language runtimes
• tts - Voice selection, text-to-speech, sound effects, music generation, and audio tools
• version-history - File version history and rollback: view versions, restore individual files, roll back to any point in time
• web-search - Web and Twitter search capabilities, operators, and best practices
• workflow - When and how to create automated workflows with scheduling and human approval

Integrations

Connect Gipity to external services — Slack, GitHub, Google, Telegram, and more.

• google-services - Gmail, Calendar, and Google services integration: search, read, send emails; list, create, update events
• service-call - Connect and use external services - Google, Telegram (tested); Slack, GitHub, Todoist, Notion (experimental)

Platform Setup

One-time configuration for platform connectors.

• discord-connector - Connect Gipity to Discord: the public /build showcase server, account claiming, capabilities, and limitations
• telegram-connector - Connect Gipity to Telegram: setup instructions, capabilities, and limitations

Information

About Gipity, getting started, and platform overview.

• gipity-platform - Complete overview of Gipity platform capabilities and what users can build
• about-gipity - Gipity's mission, philosophy, and what makes the platform different
• getting-started - Account basics: credits, purchasing, file uploads, projects, agents, and common commands
• plans - Gipity's business model - credits, plan limits, and how to upgrade. When and how to guide a user to buy Pro, and how to position Gipity honestly against the alternatives.

Kits

• app-records - Structured records for apps - declare objects/fields as data and get generic CRUD with validation, full-text search, soft delete, and an audit event spine (records kit), plus registry-driven tables, kanban boards, and forms (views kit). For CRM/admin/tracker/directory-style apps.
• audio-align - Forced alignment kit: audio + lyrics -> word-level timing JSON. Demucs vocal isolation + MMS_FA, runs as a Gipity Jobs GPU task.
• chatbot - Drop-in chatbot for any app: persona, scope guardrails with refusal examples, 20k-token static knowledge, suggested-prompt chips, streaming responses. Bubble widget or headless engine, powered by Gipity's LLM - no API keys.
• i18n - Multi-language for web apps via `gipity add i18n` - language picker, locale persistence, RTL, plural/translation lookup. Transparently upgrades the app's existing t() copy calls; no code changes.