English | 日本語
Setsuna(刹那)は、デバイス間でテキストをリアルタイム共有するWebアプリケーションです。
スマートフォンでコピーしたテキストをPCで取得したり、その逆も簡単に行えます。
- シンプル: 6文字のルームコードでデバイス間を接続
- リアルタイム: Server-Sent Events (SSE) による即時同期
- セキュア: 暗号学的に安全な乱数でルームコードを生成
- 一時的: ルームは24時間後に自動削除(プライバシー保護)
- レスポンシブ: スマホでもPCでも快適に使用可能
- ダーク × ブルータリスト: モノスペースフォント、太いボーダー、ネオンアクセント
- 国際化対応: 英語・日本語に対応
- 管理ダッシュボード: パスワード保護された管理画面でルーム監視・削除が可能
┌──────────────────────────────────────────┐
│ [EN][JA] │ ← 言語切替
│ 背景: #0a0a0a │
│ │
│ SETSUNA_ │ ← 白 + 緑カーソル
│ [リアルタイムテキスト共有] │ ← グレー、大文字
│ │
│ 6文字のルームコードを共有するだけで │ ← 説明テキスト
│ 複数デバイス間でテキストを同期 │
│ │
│ ┌────────────────────────────────────┐ │
│ │ 新規ルーム作成 │ │ ← 白ボーダー2px
│ │ ────────────────────────── │ │
│ │ ルームを作成してコードを共有すると │ │ ← 説明
│ │ 別のデバイスからアクセスできます │ │
│ │ ┌──────────────────────────────┐ │ │
│ │ │ ルーム作成 │ │ │ ← 緑背景、黒文字
│ │ └──────────────────────────────┘ │ │
│ └────────────────────────────────────┘ │
│ │
│ ────── または ────── │ ← セパレーター
│ │
│ ┌────────────────────────────────────┐ │
│ │ 既存ルームに参加 │ │
│ │ ────────────────────────── │ │
│ │ ルームコード │ │ ← ラベル
│ │ ┌──────────────────────────────┐ │ │
│ │ │ A B C D 2 3 │ │ │ ← 黒背景、白ボーダー
│ │ └──────────────────────────────┘ │ │
│ │ ┌──────────────────────────────┐ │ │
│ │ │ 参加 │ │ │ ← 白背景、黒文字
│ │ └──────────────────────────────┘ │ │
│ └────────────────────────────────────┘ │
│ │
└──────────────────────────────────────────┘
| カテゴリ | 技術 |
|---|---|
| フレームワーク | Next.js 15 (App Router), React 19 |
| 言語 | TypeScript |
| スタイリング | Tailwind CSS |
| データベース | Turso (SQLite互換) |
| ORM | Prisma |
| リアルタイム通信 | Server-Sent Events (SSE) |
| テスト | Vitest, Testing Library, Playwright |
| Linter/Formatter | oxlint, Prettier |
| Gitフック | husky, lint-staged |
| デプロイ | Vercel |
| 国際化 | next-intl |
- Node.js 20+
- pnpm 10+
# リポジトリをクローン
git clone https://github.com/beagleworks/Setsuna.git
cd Setsuna
# 依存関係をインストール
pnpm install
# Prismaクライアントを生成
pnpm prisma generate
# データベースをセットアップ(ローカルSQLite)
pnpm prisma migrate dev.env.example をコピーして .env を作成します:
cp .env.example .env| 変数名 | 説明 | 必須 |
|---|---|---|
DATABASE_URL |
ローカルSQLiteデータベースのパス | 開発時 |
TURSO_DATABASE_URL |
TursoデータベースのURL | 本番 |
TURSO_AUTH_TOKEN |
Turso認証トークン | 本番 |
CRON_SECRET |
Cronジョブ認証用シークレット | 本番 |
ADMIN_PASSWORD |
管理ダッシュボードのログインパスワード | 任意 |
ADMIN_JWT_SECRET |
JWTトークン署名用のシークレットキー | 管理機能使用時 |
# ローカル開発用
DATABASE_URL="file:./dev.db"
# 管理ダッシュボード(任意)
ADMIN_PASSWORD="your-password"
ADMIN_JWT_SECRET="your-jwt-secret"安全なJWTシークレットを生成するには:
openssl rand -base64 32TURSO_DATABASE_URL="libsql://your-db.turso.io"
TURSO_AUTH_TOKEN="your-token"
CRON_SECRET="your-secret"
# 管理ダッシュボード
ADMIN_PASSWORD="your-secure-password"
ADMIN_JWT_SECRET="your-secure-jwt-secret"注意: 管理ダッシュボード(
/admin)を使用する場合、ADMIN_PASSWORDとADMIN_JWT_SECRETの両方を設定する必要があります。
pnpm devブラウザで http://localhost:3000 を開きます。
# 開発サーバー
pnpm dev
# ビルド
pnpm build
# 本番サーバー
pnpm start
# リント
pnpm lint
pnpm lint:fix
# フォーマット
pnpm format
pnpm format:check
# テスト
pnpm test # 全テスト実行
pnpm test:watch # ウォッチモード(TDD用)
pnpm test:coverage # カバレッジレポート
pnpm test:e2e # E2Eテスト
# データベース
pnpm prisma generate # Prismaクライアント生成
pnpm prisma migrate dev # マイグレーション実行
pnpm prisma studio # DBのGUISetsuna/
├── docs/ # 仕様書
│ ├── SPEC.md # 全体仕様
│ ├── API.md # API仕様
│ ├── DB.md # データベース仕様
│ ├── UI.md # UI/UX仕様
│ └── TEST.md # テスト仕様
├── messages/ # i18n翻訳ファイル
│ ├── en.json # 英語
│ └── ja.json # 日本語
├── prisma/
│ └── schema.prisma # DBスキーマ
├── src/
│ ├── app/ # Next.js App Router
│ │ ├── [locale]/ # ロケール対応ルート
│ │ │ ├── page.tsx # ホームページ
│ │ │ └── room/[code]/ # ルームページ
│ │ └── api/ # APIルート
│ ├── components/ # Reactコンポーネント
│ ├── i18n/ # i18n設定
│ ├── lib/ # ユーティリティ
│ ├── hooks/ # カスタムフック
│ └── types/ # 型定義
├── e2e/ # E2Eテスト
├── middleware.ts # next-intlミドルウェア
└── ...config files
- トップページで「ルームを作成する」をクリック
- 6文字のルームコード(例:
ABCD23)が生成されます - このコードを別のデバイスで入力するか、URLを共有します
- トップページでルームコードを入力
- 「参加する」をクリック
- または、直接URL
/room/ABCD23にアクセス
- ルームページでテキストを入力
- 「送信する」またはCtrl+Enterで送信
- 全参加者にリアルタイムで配信されます
- コピーボタンでクリップボードにコピー可能
| エンドポイント | メソッド | 説明 |
|---|---|---|
/api/rooms |
POST | ルーム作成 |
/api/rooms/[code] |
GET | ルーム情報取得 |
/api/rooms/[code]/messages |
GET | メッセージ一覧取得 |
/api/rooms/[code]/messages |
POST | メッセージ送信 |
/api/sse/[code] |
GET | SSE接続 |
/api/cleanup |
POST | 期限切れルーム削除 |
/api/admin/auth/login |
POST | 管理者ログイン |
/api/admin/stats |
GET | 統計情報取得 |
/api/admin/rooms |
GET | ルーム一覧(管理用) |
/api/admin/rooms/[code] |
DELETE | ルーム削除 |
詳細は API仕様書 を参照してください。
このプロジェクトは TDD(テスト駆動開発) を採用しています。
Red → Green → Refactor
1. 失敗するテストを書く
2. テストを通す最小限のコードを書く
3. コードをリファクタリングする
| 対象 | アプローチ |
|---|---|
src/lib/ |
TDD(テスト先行) |
src/app/api/ |
TDD(テスト先行) |
src/components/ |
後付けテスト |
| E2E | 後付けテスト |
# ユニット/統合テスト(35件)
pnpm test
# E2Eテスト(14件)
pnpm test:e2e
# カバレッジレポート
pnpm test:coverageSetsunaは英語と日本語に対応しています。UIから言語を切り替えられます。
| 言語 | URLパターン |
|---|---|
| 英語 | /en, /en/room/ABCD23 |
| 日本語 | /ja, /ja/room/ABCD23 |
翻訳ファイルは messages/ ディレクトリにあります:
messages/
├── en.json # 英語
└── ja.json # 日本語
MIT License