# Popup Studio AI Bkit Codex Bkend Quickstart

> bkend.ai Quick Start

- Skill: `tomevault-io/popup-studio-ai-bkit-codex-bkend-quickstart` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/popup-studio-ai-bkit-codex-bkend-quickstart`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/popup-studio-ai-bkit-codex-bkend-quickstart/raw
- Safety review: pending (external: skill-scanner PASS, skillspector CAUTION)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/popup-studio-ai-bkit-codex-bkend-quickstart

---


# bkend.ai Quick Start

> Get your backend running in 5 minutes with bkend.ai BaaS.

## Actions

| Action | Description | Example |
|--------|-------------|---------|
| `setup` | Initial project setup | `$bkend-quickstart setup` |
| `connect` | Connect MCP server | `$bkend-quickstart connect` |
| `test` | Verify connection | `$bkend-quickstart test` |

## Step 1: Create bkend.ai Project

1. Go to bkend.ai dashboard
2. Click "New Project"
3. Enter project name
4. Copy your **Project ID** and **API URL**

## Step 2: Environment Setup

```bash
# Create .env.local
NEXT_PUBLIC_BKEND_API_URL=https://api.bkend.ai/v1
NEXT_PUBLIC_BKEND_PROJECT_ID=your-project-id
NEXT_PUBLIC_BKEND_ENV=dev
```

## Step 3: Install Client

```bash
npm install @bkend/client
# Or use the built-in fetch wrapper (see references/bkend-patterns.md)
```

## Step 4: Create API Client

```typescript
// lib/bkend.ts
const API_BASE = process.env.NEXT_PUBLIC_BKEND_API_URL!;
const PROJECT_ID = process.env.NEXT_PUBLIC_BKEND_PROJECT_ID!;

async function bkendFetch(path: string, options: RequestInit = {}) {
  const token = localStorage.getItem('bkend_access_token');
  const res = await fetch(`${API_BASE}${path}`, {
    ...options,
    headers: {
      'Content-Type': 'application/json',
      'x-project-id': PROJECT_ID,
      ...(token && { Authorization: `Bearer ${token}` }),
      ...options.headers,
    },
  });
  if (!res.ok) throw new Error(await res.text());
  return res.json();
}
```

## Step 5: Test Connection

```bash
# Test with curl
curl -s https://api.bkend.ai/v1/health \
  -H "x-project-id: your-project-id" | jq .
```

## Step 6: Connect MCP (for Codex)

```json
// .codex/mcp.json
{
  "servers": {
    "bkend": {
      "command": "npx",
      "args": ["@bkend/mcp-server"],
      "env": {
        "BKEND_PROJECT_ID": "your-project-id"
      }
    }
  }
}
```

## What's Next?

- **$bkend-data**: Create tables and manage data
- **$bkend-auth**: Add authentication
- **$bkend-storage**: Handle file uploads
- **$bkend-cookbook**: Follow step-by-step tutorials

## Reference

See `references/bkend-patterns.md` for complete API patterns and code examples.

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/popup-studio-ai) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-13 -->