iblai/vibe

Mirrored from iblai/vibe · README.md. This page is generated — edit it in the repository, not here.

Ship AI-powered apps fast. Backend included.

Next.js TypeScript Tailwind CSS Claude Code Desktop & Mobile License: MIT

Note: This toolkit runs against the hosted iblai.app environment. If you'd like a license to the full platform codebase to run locally or self-host, reach out to our team at ibl.ai/contact.

---

Quick Start

Install Skills

Vibe Skills

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

npx skills add iblai/vibe --all

Once installed, start with /iblai-vibe-ops-init — it bootstraps a new ibl.ai project (or wires up an existing one) and writes the project CLAUDE.md.

Vibe Marketing Skills

For marketing skills — conversion, copywriting, SEO, paid ads, lifecycle, growth (43 skills + 62 platform CLIs + 80 integration guides) — install the companion repo side-by-side:

npx skills add iblai/vibe-marketing

See iblai/vibe-marketing for the full catalogue.

ibl.ai Components for Next.js Apps

Ask Claude to add ibl.ai Chat, Profile, Account, Notification or Analytics component to your Next.js project.

ibl.ai App Template

Ask Claude to start an ibl.ai agent app.

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/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 skills scaffold 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 (Vercel), desktop (macOS/Windows/Linux), and mobile (iOS/Android) via Tauri v2

Built with iblai/vibe

How It Works

1. Scaffold -- run npx create-next-app@latest myapp to generate a full Next.js app.
2. Connect -- Use Claude Code skills to add auth, AI chat, profiles, and more components to your app to connect to iblai.app (or your own instance) for authentication, AI agents, and data
3. Customize -- use the skills to add features, swap components, and adjust business logic
4. Deploy -- ship to the web via ibl.ai hosting (Vercel) or package with Tauri

Install Skills

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

npx skills add iblai/vibe --all

This installs our vibe skills that teach your AI agent how to build with the ibl.ai platform -- authentication, AI chat, profiles, analytics, workflows, and more. Works with Claude Code, Cursor, OpenCode, Copilot, and 15+ other agents.

Skills Usage Guide

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

/iblai-vibe-auth
/iblai-vibe-agent-chat
/iblai-vibe-project
/iblai-vibe-profile
/iblai-vibe-history
/iblai-vibe-account
/iblai-vibe-billing
/iblai-vibe-memory
/iblai-vibe-analytics
/iblai-vibe-notification
/iblai-vibe-invite
/iblai-vibe-workflow
/iblai-vibe-local-llm
/iblai-vibe-course-access
/iblai-vibe-course-create
/iblai-vibe-onboard
/iblai-vibe-ops-build
/iblai-vibe-ops-test
/iblai-vibe-ops-release
/iblai-vibe-ops-upgrade
/iblai-vibe-rbac
/iblai-vibe-agent-search
/iblai-vibe-agent-setting
/iblai-vibe-agent-access
/iblai-vibe-agent-api
/iblai-vibe-agent-billing
/iblai-vibe-agent-dataset
/iblai-vibe-agent-disclaimer
/iblai-vibe-agent-embed
/iblai-vibe-agent-evals
/iblai-vibe-agent-grader
/iblai-vibe-agent-history
/iblai-vibe-agent-llm
/iblai-vibe-agent-lti
/iblai-vibe-agent-memory
/iblai-vibe-agent-prompt
/iblai-vibe-agent-safety
/iblai-vibe-agent-skills
/iblai-vibe-agent-task
/iblai-vibe-agent-tool
/iblai-vibe-agent-support

What each skill does:

• /iblai-vibe-auth -- adds authentication and configures the app for ibl.ai login.
• /iblai-vibe-agent-chat -- adds the full in-process agent chat surface.
• /iblai-vibe-project -- adds the in-process Projects surface (project landing page with chat input, files, instructions, assigned agents).
• /iblai-vibe-profile -- adds profile UI and profile settings flows.
• /iblai-vibe-history -- adds the user profile History surface (review and export your own conversations with AI agents — Conversations tab with filters and a transcript preview, plus an Exports tab of generated reports).
• /iblai-vibe-account -- adds account and organization settings.
• /iblai-vibe-billing -- adds the tenant Billing settings surface (Plan & Credits with Stripe upgrade, add-credits, and auto-recharge; the workspace-wide spend limit; and the Agent Limits table managing every agent's spend cap in one place).
• /iblai-vibe-memory -- adds the tenant Memory settings surface (manage every user's global memories and every agent's memories from one place — Global and Agent tabs with per-user memory toggles and the full per-agent memory manager).
• /iblai-vibe-analytics -- adds analytics dashboards and reporting views.
• /iblai-vibe-notification -- adds notifications UI and notification center flows.
• /iblai-vibe-invite -- adds user invitation dialogs for tenant admin.
• /iblai-vibe-workflow -- adds workflow builder components (sidebar, modals, connectors).
• /iblai-vibe-local-llm -- defines the contract for adding on-device LLM inference (Ollama / Foundry) to a Tauri desktop build: Tauri command names, event names, and the React hook shape the SDK consumes via localLLMProps.
• /iblai-vibe-course-access -- adds edX course-content pages with outline sidebar, tab strip, iframe, and access control.
• /iblai-vibe-course-create -- drives the ibl.ai Course Creation API to programmatically generate, edit, and publish edX courses.
• /iblai-vibe-onboard -- designs and builds a high-converting questionnaire-style onboarding flow.
• /iblai-vibe-ops-build -- builds and runs the app on desktop and mobile (iOS, Android, macOS, Surface).
• /iblai-vibe-ops-release -- generates a Makefile + Fastlane config to build and submit the app to the Apple App Store (TestFlight) and Google Play, including app-record/bundle-id creation and store-credential wiring.
• /iblai-vibe-ops-test -- validates the app before it is presented to the user.
• /iblai-vibe-ops-upgrade -- upgrades the @iblai/iblai-js SDK and vibe skills to the latest versions.
• /iblai-vibe-scaffold -- scaffolds a new app or adds features; holds the base + agent project templates and documents the assembly steps.
• /iblai-vibe-iconography -- generates every app-icon size (Tauri desktop, iOS, Windows MSIX, macOS) from a single source image.
• /iblai-vibe-windows-msix -- builds and distributes a Tauri app as a Windows MSIX package (sideloading or Microsoft Store).
• /iblai-vibe-deslop -- audits and hardens an existing codebase for production readiness (two-phase audit then safety-tiered fixes).
• /iblai-vibe-rbac -- reference for the default RBAC roles (student, tenant admin, mentor editor, analytics viewer, etc.), the platform's action-definitions endpoint, and the SDK components (<Admin>, <RolesTab>, <PoliciesTab>) that render the Roles + Policies management UI.
• /iblai-vibe-agent-search -- adds the agent search/browse page (starred, featured, custom, and default agents).
• /iblai-vibe-agent-setting -- adds the agent Settings tab (name, description, visibility, copy, delete) built on AgentSettingsProvider.
• /iblai-vibe-agent-access -- adds the agent Access tab (role-based access control for editor and chat roles).
• /iblai-vibe-agent-api -- adds the agent API tab (API key management).
• /iblai-vibe-agent-billing -- adds the agent Billing tab (LLM spend limits for the agent and per user, with usage bars, block/alert enforcement, and near-limit alert thresholds).
• /iblai-vibe-agent-dataset -- adds the agent Datasets tab (searchable dataset table with upload).
• /iblai-vibe-agent-disclaimer -- adds the agent Disclaimers tab (user agreement and advisory).
• /iblai-vibe-agent-embed -- adds the agent Embed tab (embed code, custom styling, shareable links).
• /iblai-vibe-agent-evals -- adds the agent Evals tab (benchmark evaluation runs with LLM-as-Judge reviews, manual scores, and CSV export).
• /iblai-vibe-agent-grader -- adds the agent Grader tab (rubric-based grading with a grading toggle, grading setup form, criteria table, and grade results with LMS-synced overrides).
• /iblai-vibe-agent-history -- adds the agent History tab (conversation history with filters and export).
• /iblai-vibe-agent-llm -- adds the agent LLM tab (model provider selection).
• /iblai-vibe-agent-lti -- adds the agent LTI tab (LTI 1.3 launch toggle with agent links, signing keys, tools, and platform endpoints).
• /iblai-vibe-agent-memory -- adds the agent Memory tab (enable/disable memory and manage memories).
• /iblai-vibe-agent-prompt -- adds the agent Prompts tab (system prompts and suggested prompts).
• /iblai-vibe-agent-safety -- adds the agent Safety tab (moderation prompts and flagged content).
• /iblai-vibe-agent-skills -- adds the agent Skills tab (reusable Agent Skills catalog with per-agent assignment, private skills, file resources, and the chat / skill picker).
• /iblai-vibe-agent-task -- adds the agent Tasks tab (schedule automated periodic agent tasks with run logs).
• /iblai-vibe-agent-tool -- adds the agent Tools tab (enable/disable agent tools).
• /iblai-vibe-agent-support -- adds the agent Support tab (human support ticket inbox with availability toggle, filters, ticket detail, status updates, and replies).

Security Skills

8 authorized-use security skills covering reconnaissance, source-code audits (OWASP Top 10), OSINT, disk forensics, incident triage, cloud configuration auditing, dependency vulnerabilities, and prompt-injection testing.

/iblai-vibe-security-recon              /iblai-vibe-security-incident-triage
/iblai-vibe-security-owasp-audit        /iblai-vibe-security-cloud-audit
/iblai-vibe-security-osint-recon        /iblai-vibe-security-dependency-audit
/iblai-vibe-security-disk-forensics     /iblai-vibe-security-prompt-injection

See CLAUDE.md for one-line descriptions.

Marketing Skills

The 43 marketing skills (CRO, copywriting, SEO, paid ads, lifecycle, growth) plus the tools/ directory (62 platform CLIs + 80 integration guides) now live in the companion iblai/vibe-marketing repo.

Install side-by-side with vibe:

npx skills add iblai/vibe-marketing

What You Get

Add to Existing Apps

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

npx skills add iblai/vibe --all

Then add features with the /iblai-vibe-* skills -- each creates the files and wires them in:

• /iblai-vibe-auth — SSO authentication
• /iblai-vibe-profile — user profile dropdown
• /iblai-vibe-history — user chat history (conversations + exports on the profile)
• /iblai-vibe-account — account/organization settings
• /iblai-vibe-billing — tenant billing settings (plan & credits, workspace spend limit, agent limits)
• /iblai-vibe-memory — tenant memory settings (user global memories + agent memories admin)
• /iblai-vibe-analytics — analytics dashboard
• /iblai-vibe-notification — notification bell

(Ensure the @iblai/mcp server + skills are configured in .mcp.json first.)

The iblai Backend

https://api.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", "mentor")   # Generate a page following ibl.ai patterns

Claude Code Skills

The scaffolded app ships with skills that teach Claude how to work with your codebase. Instead of reading docs, you tell Claude what you want and the skills provide the context:

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

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

ibl.ai hosting (recommended)

Deploy through the ibl.ai platform's hosting API (Vercel-backed) -- see /iblai-vibe-ops-deploy. No Vercel account or token: the skill zips your app, uploads it with your platform API key, polls until the build is READY, and returns the live *.vercel.app URL Vercel reports.

Tauri (Desktop & Mobile)

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

Add the Tauri shell (see /iblai-vibe-ops-build), then:

pnpm exec tauri build           # Desktop build for current platform
pnpm exec tauri ios init        # iOS project setup

Ship to the App Store & Google Play

Once the Tauri shell is in place, /iblai-vibe-ops-release generates a Makefile + Fastlane config that builds and submits your app to both stores from one command. Tauri produces the .ipa / .aab; Fastlane creates the app records and uploads the binaries.

Run the skill, then fill in fastlane/.env with your store credentials (App Store Connect API key + Google Play service-account JSON -- see the skill's references/credentials.md):

make doctor            # verify tooling + credentials are in place
make ios-create        # create the App Store Connect app record + bundle id
make ios-release       # build the .ipa and upload to TestFlight
make android-release   # build the .aab and upload to the Play internal track
make release-all       # ship to both stores

Two platform constraints to know up front:

• Google Play cannot create the app listing or accept the first upload via API -- create the app in the Play Console and push one .aab by hand once, then make android-release handles every release after that.
• Apple uploads run unattended with the API key, but creating the app record (make ios-create) may prompt for Apple-ID auth; the skill documents the app-specific-password fallback.

make *-submit pushes to TestFlight / the Play internal track -- promoting to public App Store review or production stays a deliberate step in the consoles.

Signed desktop releases (macOS DMG + Windows NSIS)

/iblai-vibe-ops-build also ships signed, distributable desktop builds — a notarized universal macOS .dmg (Intel + Apple Silicon) and signed NSIS installers for Windows x64 + arm64. Run them two ways:

• CI — copy the tauri-release-macos-dmg.yml / tauri-release-windows.yml workflows into .github/workflows/, then push an app-v* tag. Each build is signed (macOS also notarized + stapled) and attached to that tag's GitHub Release. Great for producing macOS + Windows (+ arm64) from a single push.

• Local (no CI) — copy desktop-release.mk to your project root and build on your own machine:

  make -f desktop-release.mk macos-dmg      # signed + notarized universal DMG
  make -f desktop-release.mk windows-nsis   # signed NSIS installer (on Windows)

Credentials (Apple Developer ID cert + notarization password; optional Windows cert) are the same for both paths — full setup in references/signed-release.md. For a Windows Store / sideload MSIX package instead, see /iblai-vibe-windows-msix.

Resources

• @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 --all
• Skills Reference -- documentation for all bundled Claude Code skills

License

MIT -- ibl.ai