Convex Fullstack App

This example demonstrates a fullstack application built with Convex, React, Next.js, and Auth0.

The app is a very simple Asana-style task management app that allows users to create, view, and manage tasks. The app features:

• Basic Authentication & Authorization, implemented with Auth0 and Convex
• Task creation, where each task may have:
  • Owner
  • Title
  • Description
  • Status (New | In Progress | Done | Cancelled)
  • Comments
  • File attachments (from a fixed collection to prevent abuse)
• Task management, allowing users/task owner to:
  • Add a comment
  • Change status (owner only)
  • Reassign ownership (owner only)
• Filter tasks by ticket status or owner
• Search tasks by title, description, or comments
• Infinite-scroll pagination to support very large task collections

---

How to use

Run

npm run dev

to run next dev and a Convex file watcher at the same time. This command will log you into Convex, so you'll need to create a Convex account if this is your first project.

Once everything is working, commit your code and deploy it to the cloud with Vercel (Documentation).

Use npx convex deploy && npm run build as the build command and set the CONVEX_DEPLOY_KEY environmental variable in Vercel (Documentation).

What is Convex?

Convex is a hosted backend platform with a built-in database that lets you write your database schema and server functions in TypeScript. Server-side database queries automatically cache and subscribe to data, powering a realtime useQuery hook in our React client. There are also Python, Rust, ReactNative, and Node clients, as well as a straightforward HTTP API.

The database support NoSQL-style documents with relationships and custom indexes (including on fields in nested objects).

The query and mutation server functions have transactional, low latency access to the database and leverage our v8 runtime with determinism guardrails to provide the strongest ACID guarantees on the market: immediate consistency, serializable isolation, and automatic conflict resolution via optimistic multi-version concurrency control (OCC / MVCC).

The action server functions have access to external APIs and enable other side-effects and non-determinism in either our optimized v8 runtime or a more flexible node runtime.

Functions can run in the background via scheduling and cron jobs.

Development is cloud-first, with hot reloads for server function editing via the CLI. There is a dashbord UI to browse and edit data, edit environment variables, view logs, run server functions, and more.

There are built-in features for reactive pagination, file storage, reactive search, https endpoints (for webhooks), streaming import/export, and runtime data validation for function arguments and database data.

Everything scales automatically, and it’s free to start.