CrewQuery

CrewQuery is a multilingual Next.js app for organization-based chat, document workflows, and AI-assisted collaboration. It uses Convex for the backend, Better Auth for authentication, and Google Gemini for chat/document processing.

Tech Stack

• Next.js 16 + React 19
• Convex
• Better Auth
• next-intl for localization
• Tailwind CSS and shadcn/ui-style components
• Google Gemini

Getting Started

1. Install dependencies.

bun install

2. Make sure your local environment is configured.

3. Start the Convex backend in one terminal.

bunx convex dev

4. Start the Next.js app in another terminal.

bun dev

5. Open the app at http://localhost:3000.

Environment Variables

Create or update .env.local with values like these:

CONVEX_DEPLOYMENT=dev:your-convex-deployment
NEXT_PUBLIC_CONVEX_URL=https://your-project.convex.cloud
NEXT_PUBLIC_CONVEX_SITE_URL=https://your-project.convex.site
NEXT_PUBLIC_SITE_URL=http://localhost:3000
SITE_URL=http://localhost:3000
GEMINI_API_KEY=your-gemini-api-key

Notes:

• CONVEX_DEPLOYMENT is used by convex dev.
• NEXT_PUBLIC_CONVEX_URL is used by the client Convex provider and auth helpers.
• NEXT_PUBLIC_CONVEX_SITE_URL must point to the .convex.site endpoint.
• NEXT_PUBLIC_SITE_URL is the public app URL used by the client.
• SITE_URL is used by the Better Auth server configuration.
• GEMINI_API_KEY is required for Gemini-backed features.

Common Commands

bun dev
bun run build
bun run lint
bunx convex dev

What This App Contains

• Locale-aware landing, sign-in, and sign-up pages.
• Organization management, including creation, members, channels, and data views.
• Chat pages backed by Convex streaming.
• Invitation-based organization joining.
• Better Auth integration with Convex-backed session handling.

Main Routes

• /{locale}: landing page
• /{locale}/signin: sign in
• /{locale}/signup: sign up
• /{locale}/organization: organization list
• /{locale}/organization/new: create an organization
• /{locale}/organization/{slug}: organization overview
• /{locale}/organization/{slug}/channels: channel management
• /{locale}/organization/{slug}/data: document and data management
• /{locale}/organization/{slug}/members: team members
• /{locale}/chat/{slug}: organization chat
• /{locale}/invite/{invitationId}: invitation acceptance

Localization

Supported locales are de, en, fr, nl, pl, and tr.

Troubleshooting

• If auth fails, confirm SITE_URL and NEXT_PUBLIC_CONVEX_SITE_URL are both set and that the Convex site URL ends in .convex.site.
• If chat or document features fail, check that GEMINI_API_KEY is present.
• If Convex types or generated files look stale, rerun bunx convex dev.