認証
このアプリは、独自の Better Auth を /api/auth/* で実行し、genericOAuth プラグインを介して共有Grok認証ブローカー(auth.grok.me)に連携します。このテンプレートは Google と X を接続します。
サポートされているサインイン方法 — これら3つのみを使用してください。それ以外はサポートされていません:Google、X、メール/パスワード。 他のソーシャル/OAuthプロバイダー(GitHub、Apple、Discordなど)、マジックリンク、パスキー、OTP、電話/SMS、匿名サインインはありません。GROK_PROVIDERS にエントリを追加しないでください。方法の詳細とメール/パスワードの切り替え(編集するのは src/lib/auth/email-password.ts のみ):references/sign-in-methods.md。
例外 — ゲートビューアーは既にサインインしています。彼らにログイン/再認証ボタンを表示しないでください。コネクタ/アプリデータアプリ:「Continue with Grok」ゲートのみ、Google/Xボタンはありません:references/grok-identity.md。
サインインはデフォルトでオフ — テンプレートは .grok/app-env.json に {"VITE_AUTH_ENABLED": "false"} を同梱しているため、アカウントが必要な場合にのみ追加します(AGENTS.md §0.5)。オンにするには、以下の「サインインをオンにする」を参照してください。
オンにすると、サインインは本物です — サンドボックスのライブプレビューでも同様です。 デモ/モック/ハードコードされたユーザーを準備しないでください。プレビュー:ポップアップ + 組み込みプレビュークライアント;デプロイ時:アプリごとのクライアント + DATABASE_URL + ゼロクリックゲートサインイン(references/prewired-and-env.md)。
オフの間(VITE_AUTH_ENABLED=false)は、認証がないアプリがサインインしていない訪問者でもレンダリングできるように、開発ユーザーが返されます — 開発とプレビューのみ。デプロイ時、フラグはプラットフォームのもの(常に "true")であるため、requireUserId はすべての訪問者を拒否します — 認証オフのアプリはそれと authMiddleware の両方を使用しません。
すべては src/lib/auth/ に事前インストールおよび事前配線済み — npm install は何も実行しないでください;better-auth が唯一の認証パッケージです(決して @neondatabase/*、@stackframe/*、@clerk/* は使用しません)。src/lib/auth/ 以下のファイルは編集または書き換えしないでください — server.ts はなおさらです — email-password.ts の1つのフラグを除きます。ファイルごとのマップ:references/prewired-and-env.md。
/auth/popup はテンプレートViteプラグインによって既に処理されています(vite.config.ts → popup.server.ts):Reactアプリを描画することはありません。src/routes/auth/popup.tsx を作成しないでください(またはそのパスでのReactページ/クライアントOAuth) — これによりポップアップ内に完全なアプリが表示され、一般的な障害モードになります。
このサンドボックスでは .env / .env.local / .env.example を決して作成しないでください:ライブプレビューにはゼロの環境設定が必要で、デプロイされたアプリはプラットフォームによって変数が注入されます。存在するノブは references/prewired-and-env.md にあります — クライアントに非 VITE_ 変数を公開しないでください。
migrations/auth/0001_auth.sql はBetter Authのスキーマです — 編集しないでください。これはグロブされる migrations/ ディレクトリの外にあるため(どちらのアプライヤーも降りません)、サインインのないアプリには適用されません。「サインインをオンにする」で上にコピーします。
サインインをオンにする
以下のすべてを実行してください — ルートだけでは無効なブランチがレンダリングされます:
- フラグ:
.grok/app-env.jsonからVITE_AUTH_ENABLEDキーを削除し、開発サーバーを再起動してください。Viteは起動時に環境変数を読み取るため、HMRでは反映されません。npm run dev、npm run build、npm run previewはすべてscripts/with-app-env.mjsを介してそのファイルを読み取るため、プレビューとビルド出力は一緒に切り替わります — Viteを直接起動しないでください。 - スキーマ:
cp migrations/auth/0001_auth.sql migrations/0001_auth.sqlを実行し、再起動して適用します。これは_migrationsでベース名により追跡されるため、既に持っているデータベースでは再実行されません。 - ルート:
src/routes/api/auth/$.ts+src/routes/login.tsxを追加 — 両方をreferences/wiring.mdからコピーします(キャッチオールAPIルートにより/api/auth/*とブローカーコールバックが機能します)。 - サインアウト: 出口のないログインは不完全です —
@/lib/auth/gatesから<UserButton />をレンダリングします(signOut()を配線;ゲートセッションのサインアウトを非表示にします)。 - 既存データ: アプリのサーバー関数を
authMiddlewareでラップします(認証オフのアプリはそれを使用していなかったはずです —neonスキルを参照)。サインインが存在する前の行は開発データです:ユーザーが特に指示しない限り、削除して再作成してください — 最初にサインインした人にそれらを渡さないでください。
オンにした後の構築
- サインイン/サインアウト:
@/lib/auth/clientからのsignIn(providerId)とsignOut();GROK_PROVIDERSがボタンをレンダリングします。ポップアップ、ベアラートークンの受け渡し、リクエストのアタッチメントは内部処理です — そのままにしておいてください。<UserButton />を優先します(保留中および失敗状態を処理します);signOut()は、サーバーが確認しない場合、デプロイ時に拒否します — キャッチしてください。authClient.signOut()は絶対に使用しないでください:後のすべてのリクエストにプレビューベアラートークンがアタッチされたままになるため、訪問者はサインイン状態を維持します。 - ユーザーの読み取り:
useCurrentUser()は表示専用です(nullは ロード中 または サインアウト中 を意味するため、これだけでリダイレクトしないでください);代わりにuseCurrentUserState()のisPendingでガードします。ゲート(SignedIn、SignedOut、SignInGate、RedirectToSignIn、UserButton)は@/lib/auth/gatesにあります。CTAハードルール、スケルトン、クッキーSSRゼロフラッシュ:references/session-ui.md。 - ユーザーごとのデータ(必須): ユーザーごとのデータにアクセスするすべてのサーバー関数は、事前配線された
authMiddlewareを使用し、すべての読み取りおよび書き込みをcontext.userIdにスコープする必要があります — Postgresドライバーはデータベースへの完全なアクセス権を持つため、クエリを制限するものは他にありません。user_idカラムはTEXTのままにしてください;クライアントから提供されたユーザーIDを決して信頼しないでください;サインアウト中、ミドルウェアはUnauthorizedError(401)をスローします。コードと無効モードのセマンティクス:references/per-user-data.md。 - セキュリティモデル: ヘッドレスブローカー、
__Host-クッキー +trustedOrigins、およびFetch-Metadata兄弟分離は既に配線済みです — エラーを消すためにこれらを弱めないでください(references/sign-in-methods.mdにモデルと「Invalid origin」の修正が記載されています)。