Prerequisites

• Node.js (v20+ recommended)
• Docker + Docker Compose
• (Optional) DBGate for Cassandra GUI

Clone & Install

git clone <https://github.com/your-repo/janusgraph-node-boilerplate.git>
cd janusgraph-node-boilerplate/app
npm install

🐳 Running the Stack

1. Start Docker services

docker-compose up --build

This launches:

Cassandra (port 9042)

JanusGraph/Gremlin Server (port 8182)

Kafka Broker (port 9092) + Zookeeper (2181)

Prometheus (port 9090)

The Node.js app runs locally on port 3030

1. Start the app in dev mode

npm run dev

Create a .env file in app/:

APP_PORT=3030

GOOGLE_CLIENT_ID=mock-client
GOOGLE_CLIENT_SECRET=mock-secret
SESSION_SECRET=keyboardcat

GREMLIN_HOST=localhost
GREMLIN_PORT=8182
GREMLIN_TRAVERSAL_SOURCE='g'
GREMLIN_MIMETYPE=application/vnd.gremlin-v3.0+json

# Kafka (used in dev and production modes)
KAFKA_MODE=local
KAFKA_BROKER_LOCALHOST=localhost:9092
KAFKA_BROKER_DOCKER=kafka:9092