※本記事には広告(楽天アフィリエイト)リンクが含まれる場合があります。

Convexは、TypeScript向けに設計されたリアクティブBaaS(Backend as a Service)です。データベース・サーバーレス関数・リアルタイム同期・ファイルストレージ・スケジューリングをひとつのプラットフォームに統合しており、個人開発者がバックエンドインフラを自分で管理せずにフルスタックアプリを構築できます。公式クイックスタートガイドによれば、`npm create convex@latest` の1コマンドだけで開発環境が立ち上がります。2026年11月現在、npmパッケージの最新版は v1.50.0(2026年11月リリース)です。

Supabase・Firebase・PocketBaseなど同カテゴリのサービスと比較したとき、Convexが際立つのは「フロントエンドとバックエンドの型が自動で一致する」エンドツーエンドのTypeScript型安全性と、追加設定なしで実現できるリアルタイム同期です。本記事では、Convexのセットアップから主要機能・料金プラン・他サービスとの比較まで実践コード付きで解説します。

広告・楽天アフィリエイト

プログラミング技術書

実践寄りの技術書・参考書を探す。

楽天ポイント還元

技術書を楽天で見る →

Convexとは|何が解決されるのか

従来のWebアプリ開発では「フロントエンドはReact、バックエンドはExpress、DBはPostgreSQL、リアルタイムはSocket.io」のように複数の技術を組み合わせる必要がありました。それぞれの設定・型定義・デプロイを管理するコストは、特に個人開発者にとって大きな負担です。

Convexはこの複雑さを次の形で整理します。

  • バックエンド関数:TypeScriptで書いた関数がそのままサーバーレスデプロイされる
  • リアクティブDB:クエリが変化を検知してフロントエンドを自動更新する
  • 型安全:スキーマ→バックエンド関数→フロントエンドフックまで自動生成された型で繋がる
  • ゼロコールドスタート:Convex管理のインフラが常時稼働しており、Lambda系の起動遅延がない

バックエンド関数は query(データ読み取り)・mutation(データ書き込み)・action(外部API連携など副作用あり処理)の3種類に分かれており、それぞれ用途が明確に分離されています。

セットアップ|5分でリアルタイムアプリを起動する

React向けクイックスタートに従うと、以下のコマンドだけで動くアプリが手に入ります。

# Vite + React + Convexのテンプレートを一括作成
npm create convex@latest my-app

# または既存プロジェクトに追加
npm install convex
npx convex dev   # Convexアカウントにログインしてローカル開発デプロイを作成

npx convex dev を実行すると、ブラウザでConvexダッシュボードへのログインが求められます。ログイン後、ローカル開発用のデプロイメントが自動作成され、.env.local に VITE_CONVEX_URL が書き込まれます。

フロントエンドのエントリーポイントでプロバイダーを設定します。

// src/main.tsx
import { ConvexProvider, ConvexReactClient } from "convex/react";

const convex = new ConvexReactClient(import.meta.env.VITE_CONVEX_URL);

ReactDOM.createRoot(document.getElementById("root")!).render(
  <ConvexProvider client={convex}>
    <App />
  </ConvexProvider>
);

スキーマ定義|型安全の起点

Convexのスキーマは convex/schema.ts に defineSchema と defineTable で定義します。公式スキーマドキュメントによると、スキーマを定義するとConvexが自動でTypeScriptの型を生成し、バックエンド関数とフロントエンドフック両方に適用されます。

// convex/schema.ts
import { defineSchema, defineTable } from "convex/server";
import { v } from "convex/values";

export default defineSchema({
  messages: defineTable({
    body: v.string(),
    authorId: v.id("users"),
    roomId: v.string(),
    createdAt: v.number(),
  }).index("by_room", ["roomId", "createdAt"]),

  users: defineTable({
    name: v.string(),
    email: v.string(),
    tokenIdentifier: v.string(),
    avatarUrl: v.optional(v.string()),
  }).index("by_token", ["tokenIdentifier"]),
});

各フィールドのバリデータ(v.string()・v.number()・v.id("テーブル名")など)は実行時にも適用されます。v.optional() でオプショナルフィールドを表現でき、_id と _creationTime はConvexが自動付与するため記述不要です。

query|リアクティブなデータ取得

queryはデータベースから値を読み取る関数です。フロントエンドで useQuery フックと組み合わせると、DBの変更が自動でUIに反映されます。WebSocketの設定は不要で、Convexの同期エンジンが差分を配信します。

// convex/messages.ts
import { query } from "./_generated/server";
import { v } from "convex/values";

export const listByRoom = query({
  args: { roomId: v.string() },
  handler: async (ctx, args) => {
    return await ctx.db
      .query("messages")
      .withIndex("by_room", (q) =>
        q.eq("roomId", args.roomId)
      )
      .order("desc")
      .take(50);
  },
});
// フロントエンド(React)
import { useQuery } from "convex/react";
import { api } from "../convex/_generated/api";

function MessageList({ roomId }: { roomId: string }) {
  const messages = useQuery(api.messages.listByRoom, { roomId });

  if (messages === undefined) return <div>読み込み中…</div>;

  return (
    <ul>
      {messages.map((msg) => (
        <li key={msg._id}>{msg.body}</li>
      ))}
    </ul>
  );
}

useQuery の戻り値は最初 undefined(ローディング中)になり、データ取得後に値が入ります。DBに変更があると再レンダリングが自動で走るため、ポーリングもWebSocket管理も不要です。

mutation|トランザクション保証付き書き込み

mutationはACIDトランザクション内でDBを変更する関数です。複数のテーブルへの書き込みを1つのmutationにまとめると、途中で失敗した場合に全体がロールバックされます。

// convex/messages.ts
import { mutation } from "./_generated/server";
import { v } from "convex/values";

export const send = mutation({
  args: {
    body: v.string(),
    roomId: v.string(),
  },
  handler: async (ctx, args) => {
    const identity = await ctx.auth.getUserIdentity();
    if (!identity) throw new Error("認証が必要です");

    const user = await ctx.db
      .query("users")
      .withIndex("by_token", (q) =>
        q.eq("tokenIdentifier", identity.tokenIdentifier)
      )
      .unique();

    if (!user) throw new Error("ユーザーが見つかりません");

    return await ctx.db.insert("messages", {
      body: args.body,
      roomId: args.roomId,
      authorId: user._id,
      createdAt: Date.now(),
    });
  },
});
// フロントエンド
import { useMutation } from "convex/react";
import { api } from "../convex/_generated/api";

function MessageInput({ roomId }: { roomId: string }) {
  const send = useMutation(api.messages.send);

  const handleSubmit = async (e: React.FormEvent<HTMLFormElement>) => {
    e.preventDefault();
    const form = e.currentTarget;
    const body = new FormData(form).get("body") as string;
    await send({ body, roomId });
    form.reset();
  };

  return (
    <form onSubmit={handleSubmit}>
      <input name="body" placeholder="メッセージを入力" />
      <button type="submit">送信</button>
    </form>
  );
}

action|外部API連携と副作用

actionはConvexのトランザクション外で動作する関数で、外部APIへのHTTPリクエスト・AI推論・ファイル変換など副作用のある処理に使います。内部でmutationを呼び出してDBへの書き込みを行うことも可能です。

// convex/ai.ts
import { action } from "./_generated/server";
import { v } from "convex/values";
import { api } from "./_generated/api";

export const summarize = action({
  args: { messageIds: v.array(v.id("messages")) },
  handler: async (ctx, args) => {
    // DB読み取りはrunQueryで
    const messages = await ctx.runQuery(api.messages.getByIds, {
      ids: args.messageIds,
    });

    // 外部API呼び出し(OpenAI等)
    const response = await fetch("https://api.openai.com/v1/chat/completions", {
      method: "POST",
      headers: {
        Authorization: `Bearer ${process.env.OPENAI_API_KEY}`,
        "Content-Type": "application/json",
      },
      body: JSON.stringify({
        model: "gpt-4o-mini",
        messages: [
          {
            role: "user",
            content: `以下の会話を要約してください:\n${messages.map((m) => m.body).join("\n")}`,
          },
        ],
      }),
    });

    const data = await response.json();
    const summary = data.choices[0].message.content;

    // 結果をDBに保存
    await ctx.runMutation(api.summaries.save, { summary });
    return summary;
  },
});

スケジュール実行とCron|バックグラウンド処理

スケジュール関数のドキュメントによると、Convexは2種類の定期実行をサポートします。

  • scheduler.runAfter:指定ミリ秒後に関数を実行(リトライ付きキュー相当)
  • crons:cron構文で繰り返し実行
// convex/crons.ts
import { cronJobs } from "convex/server";
import { api } from "./_generated/api";

const crons = cronJobs();

// 毎日AM9時にレポートを送信
crons.daily(
  "daily-report",
  { hourUTC: 0, minuteUTC: 0 },   // UTC 0:00 = JST 9:00
  api.reports.sendDailyReport
);

// 1時間ごとにキャッシュをクリア
crons.hourly("clear-cache", { minuteUTC: 30 }, api.cache.clear);

export default crons;
// mutation内でmutation完了後に遅延実行する例
export const sendMessage = mutation({
  args: { body: v.string(), roomId: v.string() },
  handler: async (ctx, args) => {
    const id = await ctx.db.insert("messages", { ...args });

    // 5分後に自動削除(エフェメラルメッセージ機能)
    await ctx.scheduler.runAfter(5 * 60 * 1000, api.messages.deleteOne, {
      id,
    });

    return id;
  },
});

ファイルストレージ|画像・動画・ドキュメントの管理

Convexはファイルストレージを内包しており、S3などを別途用意する必要がありません。フロントエンドからアップロードURLを取得→直接アップロード→URLをDBに保存、という流れになります。

// convex/files.ts
import { mutation, query } from "./_generated/server";
import { v } from "convex/values";

// アップロード用URLを生成するmutation
export const generateUploadUrl = mutation({
  args: {},
  handler: async (ctx) => {
    return await ctx.storage.generateUploadUrl();
  },
});

// ストレージIDを受け取ってDBに保存
export const saveFile = mutation({
  args: { storageId: v.id("_storage"), name: v.string() },
  handler: async (ctx, args) => {
    return await ctx.db.insert("files", {
      storageId: args.storageId,
      name: args.name,
    });
  },
});
// フロントエンド:ファイルアップロードの実装
function FileUpload() {
  const generateUploadUrl = useMutation(api.files.generateUploadUrl);
  const saveFile = useMutation(api.files.saveFile);

  const handleUpload = async (file: File) => {
    // 1. ConvexからアップロードURL取得
    const uploadUrl = await generateUploadUrl();

    // 2. 直接PUT
    const result = await fetch(uploadUrl, {
      method: "PUT",
      headers: { "Content-Type": file.type },
      body: file,
    });
    const { storageId } = await result.json();

    // 3. ストレージIDをDBに記録
    await saveFile({ storageId, name: file.name });
  };

  return (
    <input
      type="file"
      onChange={(e) => e.target.files?.[0] && handleUpload(e.target.files[0])}
    />
  );
}

ベクトル検索・AI連携

Convexはベクトルインデックスをネイティブサポートしており、外部のベクトルDB(Pinecone・Weaviateなど)を使わずにRAGを実装できます。埋め込みベクトルをDBフィールドとして保持し、コサイン類似度で近傍検索が可能です。

// convex/schema.ts にベクトルインデックスを追加
export default defineSchema({
  documents: defineTable({
    text: v.string(),
    embedding: v.array(v.float64()),  // 埋め込みベクトル
    source: v.string(),
  }).vectorIndex("by_embedding", {
    vectorField: "embedding",
    dimensions: 1536,   // text-embedding-3-small の次元数
  }),
});
// convex/search.ts
import { action } from "./_generated/server";
import { v } from "convex/values";

export const semanticSearch = action({
  args: { query: v.string(), limit: v.optional(v.number()) },
  handler: async (ctx, args) => {
    // クエリテキストを埋め込みベクトルに変換
    const embedding = await embed(args.query);

    // ベクトル近傍検索
    const results = await ctx.vectorSearch("documents", "by_embedding", {
      vector: embedding,
      limit: args.limit ?? 5,
    });

    return results;
  },
});

料金プラン|無料枠で個人開発は十分動く

Convexの料金ページで確認できる2026年11月時点の料金は以下の通りです。

プラン 月額 関数呼び出し DBストレージ ファイルストレージ
Free & Starter $0 100万回/月 0.5GB 1GB
Professional $25/開発者 2,500万回/月 10GB〜 50GB〜
Business $2,500〜 カスタム カスタム カスタム

無料プランの特徴は、機能制限がないことです。ベクトル検索・ファイルストレージ・認証・スケジュール実行・Cronなど全機能が無料で使えます。制限は呼び出し回数とストレージ容量のみで、副業・ハッカソン・PoC段階であれば十分です。

Professionalプランはログストリーミング・日次バックアップ・カスタムドメイン・メールサポートが追加されます。同時に動かせるクエリ数(並列クエリ)も256に増えます。

Supabase・Firebase・PocketBaseとの比較

観点 Convex Supabase Firebase PocketBase
DB 独自(リアクティブ) PostgreSQL Firestore(NoSQL) SQLite
型安全 ◎(自動生成) ○(Supabase CLI) △(手動定義) △(手動定義)
リアルタイム ◎(ネイティブ) ○(Realtime機能) ◎(onSnapshot) ○(SSE)
バックエンド関数 ◎(TypeScript関数) ○(Edge Functions) ○(Cloud Functions) △(Hooksのみ)
SQLサポート × ◎ × ○
セルフホスト ×(マネージドのみ) ◎ × ◎
無料枠 1M呼び出し/月 500MB DB 1GB / 50K読み取り/日 セルフホスト無料

Convexが向いているケース:TypeScriptで書いたサーバーレス関数をそのまま使いたい・リアルタイム同期が必要・SQLの知識がなくても始めたい・ベクトル検索を組み込みたい。

Convexが向かないケース:既存PostgreSQLへの接続が必要・複雑なJOINやSQL集計が必要・セルフホストしたい・データの完全な所有権が必要。

Next.js / Remix との連携

ConvexはReact(Vite)だけでなく、Next.js App Routerとも連携できます。Server ComponentsからConvexを呼ぶ場合は fetchQuery、Client Componentsでは従来の useQuery を使います。

// Next.js App Router の Server Component
import { fetchQuery } from "convex/nextjs";
import { api } from "@/convex/_generated/api";

export default async function Page() {
  // サーバーサイドでデータ取得(SSR対応)
  const messages = await fetchQuery(api.messages.list);

  return (
    <main>
      {messages.map((m) => (
        <p key={m._id}>{m.body}</p>
      ))}
    </main>
  );
}

まとめ|どんな人にConvexを勧めるか

Convexは「TypeScriptでフルスタック開発したいが、バックエンドインフラの管理に時間を使いたくない」という個人開発者・スタートアップに最適なサービスです。無料枠で全機能が試せるため、まず npm create convex@latest で動かしてみるのが最善の判断材料になります。

一方で、既存のPostgreSQLを使い続けたい場合や、データを自分のサーバーに持ちたい場合はSupabase・PocketBaseを検討してください。

  • チャット・コラボレーション・リアルタイムダッシュボード → Convex一択
  • 既存PostgreSQLの活用・複雑なSQL → Supabase
  • セルフホスト・低コスト → PocketBase
  • Google認証との深い連携 → Firebase

Convex v1.50.0時点では、ベクトル検索・AIアクション・スケジュール実行が揃っており、AIチャットbotやRAGアプリのバックエンドとして使うケースも急増しています。リアルタイム性が求められるプロダクトの選択肢として、Convexは十分に本番投入に値する成熟度に達しています。