Bubble IDX

A real-time bubble chart visualization for IDX stocks.

• Node.js (v18+)
• Docker Desktop (to run local database and caching instances)

From the root workspace directory (where docker-compose.yml is located), spin up the local PostgreSQL and Redis containers:

docker compose up -d postgres redis

Inside the bubble-idx directory, create a .env or .env.local file (it is automatically ignored by Git):

DATABASE_URL="postgresql://postgres:root@localhost:5433/bubble_db?schema=public"
REDIS_URL="redis://localhost:6379"
NODE_ENV=development

Navigate into the bubble-idx directory and install the packages:

npm install

Reset your local database to a clean state, apply schemas, and populate it with 150 sample historical records so you can test features instantly without running the scraper:

# Push Prisma schema to DB
npx prisma db push --force-reset

# Seed Master Data + Sample History
npx prisma db seed

npm run dev

Open http://localhost:3000 in your browser.

If you modify prisma/schema.prisma:

1. Generate and run a migration locally:

   npx prisma migrate dev --name <change_description>