Getting Started

Create a new fate app from a template, or install it in an existing React or Vue project. For an overview of the ideas behind fate, read Why fate?.

Template

Create a new fate app with Vite+:

vp create fate

Explore the fate stack to see the tools included in your new project.

The template selector can create a React or Vue client for a Void app with Drizzle, a tRPC app with Drizzle or Prisma, a GraphQL app with Prisma, or a fate client for an existing GraphQL server. React is the default UI framework; pass --framework vue or choose Vue in the template selector to create a Vue app. The template sources live in the fate repo under packages/create-fate/templates/fate. They feature modern tools to deliver an incredibly fast development experience.

Manual Installation

For a React client, install react-fate. It requires React 19.2+:

npm

npm add react-fate

pnpm

pnpm add react-fate

yarn

yarn add react-fate

For a Vue client, install vue-fate:

npm

npm add vue-fate

pnpm

pnpm add vue-fate

yarn

yarn add vue-fate

If your server is a separate package, install @nkzw/fate there as a runtime dependency too. Install @nkzw/fate on the client only for a barebones integration without a framework adapter:

npm

npm add @nkzw/fate

pnpm

pnpm add @nkzw/fate

yarn

yarn add @nkzw/fate