🚀 Welcome to BeWith

Welcome to the team! This guide will get you from zero to productive.

The repositories — what lives where

The map of the bewith-dev org, grouped by surface. The Agent column is the platform expert that owns that surface (see /agents + the agent taxonomy).

Backend (NestJS)

Repo	What it is	Agent
backend-services	The NestJS monorepo — 20+ apps (auth, communities, orders, payments, notifications, vector-search, assistant-ai, gateways). The core.	backend-developer
sqs-consumer	Async hub — consumes the SQS queues (notifications, OTP, campaigns, …).	async-messaging · notifications
migrations-tool	CLI for DB migrations (Mongo + Aurora + Cognito).	database

Web frontends (React / Next)

Repo	What it is	Agent
organization-dashboard	Next.js SSR — community managers create/manage events.	frontend-developer
management-webapp	Internal management app (Next + MobX).	frontend-developer
bewith-consumer-frontend	Consumer app — Next 15 + Zustand + Tailwind (the modernization path).	frontend-developer
support-tool-frontend	Internal support tool (CRA).	frontend-developer
facility-rentals	Facility rentals (Next 15).	frontend-developer
superco-management	Angular 8 — legacy / deprecation target.	frontend-angular

Mobile (Flutter)

Repo	What it is	Agent
leaders-app	Community-leaders app (GetX, region-aware, SSE, QR).	mobile-developer
consumer-mobile	Consumer app "coing" (Provider/Riverpod, Dio).	mobile-developer

Design / UI

Repo	What it is	Agent
design-system	@bewith-dev/design-system — shared components, tokens, Storybook (the UI SoT).	design-system
with-calendar	Embeddable calendar widget (iframe into the PHP consumer).	frontend-developer (embed rule)

Legacy (Yii2 PHP — deprecation targets)

Repo	What it is	Agent
superco-consumer	Yii2 consumer backend + web.	legacy-php-guide

Infra / DevOps

Repo	What it is	Agent
IAC-Terraform	Terraform — EKS (primary), AWS resources.	devops-infra
Kubernetes-deployments	Pulumi + Helm + ArgoCD GitOps.	devops-infra
cdk-infra	CDK — ECS (secondary).	devops-infra
nestjs-docker-base · consumer-php-base	Shared container base images.	devops-infra
loki-cloudwatch-forwarder	Log forwarding (Loki/CloudWatch — vendor-neutral obs).	observability
cognito-lambdas	Cognito passwordless auth triggers.	auth-security
onboarding	Dev-environment bootstrap scripts.	devops-infra

AI

Repo	What it is	Agent
with-agents-platform	Python/FastAPI agent runtime (Bedrock).	ai-llm
with-agents	TS multi-agent (AWS Strands: orchestrator/query/summarize/visualize).	ai-llm
ai-codereviewer	GPT-4 PR-review GitHub Action.	ai-llm

AI also lives inside backend-services — apps/assistant-ai (LLM) → ai-llm, apps/vector-search (OpenSearch + Voyage) → search-vector.

Integrations / tooling / platform

Repo	What it is	Agent
crm-integration	Monday.com CRM sync (Python/Flask).	integrations
eslint-plugin	@bewith-dev/eslint-plugin — shared lint rules.	devops-infra (coding-standards)
bewith-docs	This repo — the engineering platform + knowledge base.	—
cursor-rules	Legacy Cursor rules (reference; being folded into the platform).	—

Many older repos in the org are archived or inactive — the list above is the live, daily-touched set.

Key links

Resource	Link
Architecture overview	/architecture
Active PRDs	/prds
ADRs	/adrs
Jira board	https://bewith.atlassian.net
GitHub org	https://github.com/bewith-dev
Figma	(link in Slack #design)

Documentation conventions

When you write docs here:

• Use the templates in /templates
• Every doc needs status, owner, and updated in the frontmatter
• PRDs in Draft must move to In Review within 5 business days
• Merge via PR — at least one reviewer from the relevant team

Who to ask

Topic	Person
Product / specs	@product-team
Backend architecture	@eng-lead
Frontend	@frontend-lead
DevOps / infra	@devops
Design	@design-lead

Getting unstuck

Stuck? Don't wait more than 30 minutes before asking. Post in the relevant Slack channel with a short summary of what you tried. We don't judge — we've all been new.