This is a Next.js project bootstrapped with create-next-app.
Getting Started
First, run the development server:
npm run dev
# or
yarn dev
# or
pnpm dev
# or
bun dev
Open http://localhost:3000 with your browser to see the result.
You can start editing the page by modifying app/page.tsx. The page auto-updates as you edit the file.
This project uses next/font to automatically optimize and load Geist, a new font family for Vercel.
Worktree Local Test Automation (mingle-app + mingle-stt + mingle-messaging)
To automatically isolate local test environments per branch and worktree:
scripts/devbox init
# Bootstrap shared root values and service env values into Vault, then install deps
scripts/devbox bootstrap
# Reboot recovery: start local Vault and seed the main root/service env values
scripts/devbox vault-up --seed
# Optional: override the shared Vault path used by bootstrap
# scripts/devbox bootstrap --vault-path secret/mingle/dev
scripts/devbox up --profile local
scripts/devbox up --profile device
scripts/devbox up --profile device --tunnel-provider cloudflare
# cloudflare named tunnel (fixed hostname) - reads shared values from the
# main worktree root .env.local or Vault
# scripts/devbox up --profile device --tunnel-provider cloudflare
scripts/devbox up --profile device --device-app-env dev
scripts/devbox up --profile device --device-app-env prod --with-ios-install --with-ios-clean-install --ios-configuration Release
# Build and install mobile apps too when a connected test phone is available
# scripts/devbox up --profile device --with-mobile-install
# Install only iOS
# scripts/devbox up --profile device --with-ios-install
# Archive/export an RN iOS IPA for App Store or TestFlight
# scripts/devbox ios-rn-ipa --device-app-env prod
# scripts/devbox ios-rn-ipa-prod
# Write full logs to a file
# scripts/devbox --log-file auto up --profile device --with-ios-install
# Tests
scripts/devbox test --target app
# Live STT integration tests require an explicit flag
# scripts/devbox test --target app --with-live
scripts/devbox status
- Detailed guide:
docs/worktree-devbox.md
- Railway single-service deployment guide:
docs/railway-single-service.md
scripts/devbox bootstrap does not modify .env.local, but it uploads shared values
from the MAIN worktree root .env.local (required) and, when they still exist, legacy
service-specific values from mingle-app/.env.local / mingle-stt/.env.local /
mingle-messaging/.env.local to the shared Vault record before installing dependencies.
The MAIN worktree is the one with main checked out, or the primary checkout when no
worktree is on main.
The --vault-push option is retained as a backward-compatible no-op.scripts/devbox vault-up --seed starts the local Homebrew Vault service and safely
seeds/patches the same MAIN root/service env values into secret/mingle/dev.- The three local services share one development Vault record:
secret/mingle/dev.
Production mobile URL overrides remain separate in secret/mingle/prod.
- If a target path does not exist yet, devbox creates it once with
kv put.
If the path already exists, devbox keeps using kv patch and refuses destructive overwrite fallback.
- If Vault CLI environment variables (
VAULT_ADDR, VAULT_NAMESPACE) exist in the MAIN
worktree root .env.local (or the service env files), devbox automatically picks them up.
scripts/devbox gateway --mode dev|run integrates gateway execution from /Users/nam/openclaw into devbox commands.- Devbox keeps only worktree-local runtime settings in
.devbox.env; persistent shared settings
(Cloudflare token/hostnames, optional fallback URL overrides, AdMob IDs, the shared Vault path, Team ID, and machine-wide
paths) belong in the MAIN worktree root .env.local and Vault. Service .env.local files
remain for service-specific values and are only legacy fallbacks for shared keys.
- Frontend and app build entrypoints read the main root
.env.local for shared values and .devbox.env
for worktree URLs/ports, so pnpm dev, pnpm build, pnpm start, React Native Android builds,
and RN iOS flows resolve the current worktree runtime without duplicating shared settings.
scripts/devbox up, init, and mobile do not upload or synchronize .env.local;
is the explicit main-root/service-env-to-Vault synchronization step.
Learn More
To learn more about Next.js, take a look at the following resources:
You can check out the Next.js GitHub repository - your feedback and contributions are welcome!
Deploy on Vercel
The easiest way to deploy your Next.js app is to use the Vercel Platform from the creators of Next.js.
Check out our Next.js deployment documentation for more details.
License
This repository is licensed under the GNU General Public License v3.0 (GPL-3.0-only). See LICENSE.
