willink-stack

Next.js + Supabase + Expo + MCP fullstack starter — built for AI-driven teams

A production-ready monorepo scaffold that combines a Next.js web app, a React Native mobile app, a custom MCP server, and AWS infrastructure — all wired together and ready to ship.

日本語は下部を参照 / Japanese readme below ↓

---

What's inside

apps/
├── web/          # Next.js 15 (App Router) + Tailwind CSS + shadcn/ui
├── mobile/       # React Native (Expo) — iOS & Android
└── mcp-server/   # Custom MCP server (stdio) for Claude Code integration

packages/
├── shared/       # Zod schemas, types, domain models
├── ui/           # shadcn/ui shared components
├── db/           # Prisma schema + Supabase client
└── sdk/          # API client (web / mobile / mcp)

infra/            # AWS CDK (TypeScript)
├── dns-stack.ts        # Route 53 custom domain
├── amplify-stack.ts    # Amplify Hosting
├── iam-stack.ts        # GitHub Actions OIDC + MCP server IAM roles
└── monitoring-stack.ts # AWS Budgets + SNS ops alerts

supabase/         # Database migrations + RLS policies

Tech stack

Layer	Technology
Monorepo	Turborepo + pnpm
Web	Next.js 15 (App Router) + React 19 + Tailwind CSS + shadcn/ui
Mobile	React Native (Expo) + Expo Router
Auth	Supabase Auth (Google SSO)
Database	Supabase Postgres + Prisma
Hosting	AWS Amplify Hosting
Infrastructure	AWS CDK (TypeScript)
CI/CD	GitHub Actions (OIDC — no long-lived AWS credentials)
MCP server	@modelcontextprotocol/sdk stdio server

Prerequisites

• Node.js >= 22
• pnpm >= 9
• A Supabase project (free tier works)
• An AWS account (for CDK / Amplify deployment)

Quick start

# 1. Clone and install
git clone https://github.com/i-Willink-LLC/willink-stack.git
cd willink-stack
pnpm install

# 2. Configure environment
cp .env.example .env.local
# Fill in your Supabase URL, keys, and database URLs

# 3. Apply database migrations
pnpm supabase db push

# 4. Start the web app
pnpm dev

Open http://localhost:3000.

MCP server

The MCP server runs locally via stdio and connects to Claude Code.

# Build
pnpm --filter @willink-stack/mcp-server build

Register in your Claude Code config (.claude/mcp.json):

{
  "mcpServers": {
    "willink-stack": {
      "command": "node",
      "args": ["/path/to/willink-stack/apps/mcp-server/dist/index.js"],
      "env": {
        "SUPABASE_URL": "...",
        "SUPABASE_SERVICE_ROLE_KEY": "..."
      }
    }
  }
}

Add your own tools in apps/mcp-server/src/tools/.

AWS deployment

Configure these as GitHub Actions repository variables before deploying:

Variable	Description
AWS_ACCOUNT_ID	Your AWS account ID
AWS_REGION	AWS region (e.g. us-east-1)
PARENT_DOMAIN	Your root domain (e.g. example.com)
APP_SUBDOMAIN	App subdomain (e.g. pm.example.com)
ALERT_EMAIL	Email for budget / ops alerts (optional)

See docs/bootstrap.md for the full initial setup guide.

CI/CD

Branch	What happens
feature/* → develop	PR + CI (lint, type-check, build)
develop → main	PR + CI + CDK diff
push to main	CDK deploy → Amplify auto-builds → git tag + GitHub Release

License

MIT — see LICENSE

---

willink-stack（日本語）

Next.js + Supabase + Expo + MCP フルスタックスターター — AI 駆動チーム向け

Next.js Web アプリ・React Native モバイルアプリ・カスタム MCP サーバ・AWS インフラを一つのモノレポに統合した、本番運用対応のスキャフォールドです。

特徴

• Next.js 15 App Router — Supabase Auth（Google SSO）+ Prisma によるフルスタック Web
• React Native (Expo) — iOS/Android 対応モバイルアプリ
• MCP サーバ雛形 — @modelcontextprotocol/sdk の stdio サーバ。Claude Code からツールとして呼び出せる
• AWS CDK — Route 53 / Amplify Hosting / IAM / 予算アラートをコードで管理
• GitHub Actions OIDC — 長期 AWS クレデンシャル不要
• Turborepo + pnpm — 高速なモノレポビルド

セットアップ

git clone https://github.com/i-Willink-LLC/willink-stack.git
cd willink-stack
pnpm install
cp .env.example .env.local  # 値を入力
pnpm dev

詳細は docs/bootstrap.md を参照してください。

ライセンス

MIT