Get Started
Install and configure fu
Install and configure fu: A multi-app codebase sharing a Convex backend across its application surfaces.
Follow the source instructions for fu. Read the prerequisites and configuration steps before running an example.
Prerequisites
- Node.js (recommended: LTS)
- npm (repo uses npm + lockfiles)
- A Convex project/deployment (or create one via the Convex CLI)
Installation
Install dependencies in the repo root (Convex tooling) and in each app you intend to run:
# backend tooling + shared dependencies
npm install
# seller dashboard
cd seller-provider && npm install
# services dashboard
cd ../ServicesProviders && npm install
# mobile app
cd ../min-app && npm installConfiguration
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:3000Check the installation
After setup, continue with the first example. If a command fails, compare the runtime version, working directory, and required configuration with the original README before changing dependencies.
Source and help
Source captured: 2026-10-11
