Guides
Use and adapt fu
Use and adapt fu: A multi-app codebase sharing a Convex backend across its application surfaces.
Use the documented interfaces and source layout for fu. The sections below retain the README’s examples and configuration details.
Usage
Run Convex backend (root)
cd fu
npm run devRun seller-provider (Next.js)
cd seller-provider
npm run devRun ServicesProviders (Next.js)
cd ServicesProviders
npm run devRun mobile app (Expo)
cd min-app
npm run startUsage Examples
Calling a Convex function from the CLI
npx convex run myFunctions:myQuery '{"first": 1, "second": "Hello"}'Calling Convex from a React component (example)
import { useQuery } from "convex/react";
import { api } from "@/convex/_generated/api";
export function Example() {
const profile = useQuery(api.users.getUserProfile, { userId: "user_123" });
if (profile === undefined) return <div>Loading…</div>;
if (profile === null) return <div>Not found</div>;
return <div>{profile.name}</div>;
}Configuration
Convex (backend)
You configure Convex through the CLI and your Convex dashboard:
- Dashboard: https://dashboard.convex.dev
- Docs: https://docs.convex.dev
Common commands:
# from repo root
npx convex dev
npx convex codegenObservability (Sentry)
- Issues dashboard: https://avyren.sentry.io/projects/javascript-nextjs/issues/
seller-provider environment variables
Create seller-provider/.env.local and follow:
At minimum, seller-provider expects:
NEXT_PUBLIC_CONVEX_URL=https://your-deployment.convex.cloud
NEXT_PUBLIC_CONVEX_SITE_URL=https://your-deployment.convex.site
NEXT_PUBLIC_BETTER_AUTH_BASE_URL=http://localhost:3000Commands in the root manifest
The captured package.json declares the following scripts. Run them from the directory containing that manifest.
| Command | Script |
|---|---|
npm run dev | convex dev |
npm run lint | tsc -p convex && eslint . --report-unused-disable-directives --max-warnings 0 |
Troubleshoot a local change
- Reproduce the smallest example from the quick-start guide.
- Compare required configuration and dependency versions with the README.
- Check the linked issue tracker for the same error. Include the command, runtime version, and relevant error when reporting a problem; omit credentials.
Source and help
Source captured: 2026-10-11
