Skip to main content

Quick Start

Whether you're using React or another JavaScript framework, this guide will help you get started with Fireproof quickly and efficiently. If you're using React, you might find our React tutorial more relevant.

Install the Package

The first step is to add Fireproof to your project. You can do this by running the following command in your project directory:

npm install @fireproof/core

Or, if you're using Yarn:

yarn add @fireproof/core

Import Fireproof

Next, you'll need to import Fireproof into your project. Add the following line to the top of your file:

import { fireproof } from '@fireproof/core'

You can import use-fireproof instead of @fireproof/core if you're using React, it also exports the fireproof function as above.

Create a Database

Now, let's create your first database. You can do this with the following line of code:

const db = fireproof("my-database")

The fireproof function takes a single argument, the name of your database. It is safe to call this function multiple times with the same name. If the database already exists, it will be opened. If it doesn't exist, it will be created. The database connection is cached, so subsequent calls to fireproof with the same name will return the same database object, making it safe to call fireproof with every render.

Create and Read Documents

With your database set up, you can now create your first document. Here's how:

const ok = await db.put({ hello: "world" })

To read your first document, use the following code:

const doc = await db.get(ok.id)

Update Documents

Updating your document is just as easy. Here's how you can do it:

doc.hello = "universe"
const ok2 = await db.put(doc)

Query Documents

Finally, you can query all documents or query documents by a specific field. Here's how:

const docs = await db.allDocs()
const docs = await db.query('hello') // This will return documents with 'world' and 'universe'.

And that's it! You've successfully set up Fireproof in your project. Happy coding!

See the React tutorial for a more complete example, or the database basics section for more details on how to use Fireproof. Check out the GitHub Discussions for example apps and more help.