zbugs

Welcome

This is the source code for zbugs.

We deploy this continuously (on trunk) to aws and is our dogfood of Zero.

Requirements

• Docker
• Node 20+

Setup

1. Install dependencies

Install and build dependencies the mono repository root:

# In repository root
npm install
npm run build

2. Create env file

In a a new terminal window

Create a .env file in the zbugs directory based on the example:

# In apps/zbugs
cp .env.example .env

3. Run the "upstream" Postgres database

# In apps/zbugs
npm run db-up
# In apps/zbugs in another tab
npm run db-migrate
npm run db-seed

4. Run the zero-cache server

# In apps/zbugs
npm run zero-cache-dev

5. Run the web app

In yet another another terminal window

# In apps/zbugs
npm run dev

After you have visited the local website and the sync / replica tables have populated.

To clear the SQLite replica db:

rm /tmp/zbugs-sync-replica.db*

To clear the upstream postgres database

# In apps/zbugs/docker
docker compose down -v

To run with 1gb test dataset

# In apps/zbugs/db/seed-data/gigabugs
./getData.sh

# In apps/zbugs
npm run db-up
# In apps/zbugs in another tab
npm run db-migrate
ZERO_SEED_DATA_DIR=./db/seed-data/gigabugs/ npm run db-seed