Vibe

Ship AI-powered apps fast. Backend included.

Source: github.com/iblai/vibe

Developer

---

Quick Start

Install Skills

Add ibl.ai skills to any project with one command:

npx skills add iblai/vibe

ibl.ai App Template

Get a complete app with auth, AI chat, profiles, and more in one command:

npx @iblai/cli startapp agent -o iblai-init
cp -a iblai-init/<app-name>/. . && rm -rf iblai-init
rm -rf node_modules && pnpm install
cp .env.example .env.local
pnpm dev

Open http://localhost:3000. You will be redirected to iblai.app for login -- sign in or create a free account, and you are back in your app with a fully authenticated session.

---

What is Vibe

A developer toolkit for vibe coding with the ibl.ai platform. Vibe gives you a production-ready scaffold powered by the @iblai/cli command line tool, the @iblai/iblai-js SDK, pre-built components, Claude Code skills, and a full backend at iblai.app. You go from zero to a deployed AI app in minutes -- authentication, AI chat, profiles, notification, and analytics are already wired up. No API tokens to manage.

Why it matters:

• Start building in minutes, not days -- the CLI scaffolds a complete app with auth, AI chat, and a dashboard out of the box
• Backend included -- iblai.app provides SSO auth, AI agent infrastructure, analytics, and tenant management (free tier available)
• Client-side auth via SSO -- no API tokens to store, rotate, or leak
• Claude Code skills guide every step -- adding features is a conversation, not a scavenger hunt through docs
• shadcn/ui fills in UI gaps -- consistent design language without the overhead of a custom design system
• Ship everywhere -- web (platform hosting, your own container, or a static host), desktop (macOS/Windows/Linux), and mobile (iOS/Android) via Tauri v2

---

How It Works

1. Scaffold -- run npx @iblai/cli startapp agent to generate a full Next.js app with auth, AI chat, profiles, and more
2. Connect -- your app connects to iblai.app (or your own tenant) for authentication, AI agents, and data
3. Customize -- use Claude Code skills to add features, swap components, and adjust business logic
4. Deploy -- ship through the platform's hosting API, run it in your own container, or package it with Tauri

---

What You Get

---

Skills

After installing the skills, use them directly in your AI agent with / commands.

Project and operations

App features

Agent tabs

Monetization

Design and code quality

Security

Skills are in skills/ (symlinked to .claude/skills/). Read them, extend them, or write your own.

---

Add to Existing Apps

Already have a project? Install the skills and let your AI agent add features:

npx skills add iblai/vibe

Then use the CLI to add features:

iblai add mcp            # MCP servers + skills (run first)
iblai add auth           # SSO authentication
iblai add chat           # AI chat with streaming
iblai add profile        # User profile dropdown
iblai add account        # Account/organization settings
iblai add analytics      # Analytics dashboard
iblai add notification   # Notification bell

CI/CD

Use --yes to skip interactive prompts:

npx @iblai/cli startapp agent --yes --platform acme --agent my-id --app-name my-app -o iblai-init
cp -a iblai-init/my-app/. . && rm -rf iblai-init
rm -rf node_modules && pnpm install
cp .env.example .env.local

---

The iblai Backend

iblai.app is the production backend that powers every Vibe app. You do not need to build, host, or maintain any backend services.

What iblai.app provides:

• SSO Authentication -- OAuth-based login with session management, RBAC, and multi-tenant user isolation
• AI Agent Infrastructure -- create, configure, and serve AI agents with streaming responses, tool use, and RAG
• Analytics -- track user activity, conversation metrics, and engagement across your app
• Tenant Management -- each tenant gets its own users, agents, branding, and configuration

---

AI-Assisted Development

Vibe is designed to be built with AI. The @iblai/mcp server gives Claude Code deep knowledge of the ibl.ai platform, and the bundled skills guide you through every common task.

MCP Server

Add this to your .mcp.json at the project root:

{
  "mcpServers": {
    "iblai": {
      "command": "npx",
      "args": ["-y", "@iblai/mcp"]
    }
  }
}

This gives your AI assistant access to:

get_component_info("ChatWidget")              # Props, usage, examples for any component
get_hook_info("useAdvancedChat")              # Hook parameters and return types
get_api_query_info("useGetUserMetadataQuery") # RTK Query endpoint details
get_provider_setup("auth")                    # Provider hierarchy and setup code
create_page_template("Dashboard", "agent")   # Generate a page following ibl.ai patterns

---

Platform Capabilities

iOS & Android SSO limitation: Mobile WebViews use a non-standard user-agent that SSO providers reject. Completing the OAuth flow requires a system browser popup (ASWebAuthenticationSession on iOS, Chrome Custom Tabs on Android). This is not yet implemented -- mobile users must authenticate via another method for now.

---

Deploy Anywhere

Platform hosting (default)

/iblai-vibe-ops-deploy ships the app through the ibl.ai platform's own hosting API. The platform holds the hosting credential for your tenant, so the only configuration you need is the DOMAIN, PLATFORM, and TOKEN already in iblai.env — no third-party hosting account, token, or CLI. The skill zips the app, posts it to the hosting endpoint, and polls until the build is ready; redeploying is the same call with the same project slug.

Your own infrastructure

When the app has to run where you control it — your own server, on-premise, Kubernetes, Cloud Run, or air-gapped — deploy it as a container. The same skill covers this path, and a project that already carries a Dockerfile deploys the way it already deploys.

docker build -t my-vibe-app .
docker run -p 3000:3000 my-vibe-app

A static host is the third option, for an app with no server-side runtime at all.

Where deployment is a data-residency or compliance decision rather than a convenience one, the choice belongs to the organization — the tooling supports all three targets equally.

Tauri (Desktop & Mobile)

Build native apps for macOS, Windows, Linux, iOS, and Android:

iblai add builds              # Add Tauri support
iblai builds build            # Desktop build for current platform
iblai builds ios init         # iOS project setup
iblai builds ci-workflow --all  # GitHub Actions for all platforms

/iblai-vibe-ops-build covers signed and notarized macOS and Windows release builds; /iblai-vibe-ops-release generates the Makefile and Fastlane configuration for submitting to the Apple App Store and Google Play, and /iblai-vibe-windows-msix packages a build as a Windows MSIX for sideloading or the Microsoft Store.

---

Resources

• @iblai/cli -- the CLI that scaffolds Vibe apps
• @iblai/iblai-js -- unified SDK for data, UI components, and auth utilities
• @iblai/iblai-api -- auto-generated API types
• @iblai/mcp -- MCP server for AI-assisted development
• skills.sh/iblai/vibe -- install skills with npx skills add iblai/vibe