Your Friendly Neighborhood Network — a location-based ephemeral social app.

Create short posts near you, discover what’s happening nearby, swing in to chat with post owners, and stay in touch in real time — all without polling.

• Posts (webs) — Create posts with location and visibility radius; they expire after 30–120 min
• Feed — Browse posts within 0.5–10 mi of you (geo-indexed for scalability)
• Sense (radar) — Visual radar for post direction and distance
• Swing-in — One swing per post; swinging in opens a chat with the post owner
• Chat — Messaging with post owners after swing-in
• Real-time — WebSocket push for new posts and messages (targeted by location)
• Profile — My posts, sign-out

• Node.js 20+
• AWS account with AWS CLI configured

See docs/AWS_SETUP.md for first-time AWS setup (account, IAM, CLI, CDK bootstrap).

git clone <repo-url>
cd spidey-social

cd infrastructure
npm install
npx cdk bootstrap   # once per account/region
npx cdk deploy --require-approval never

cd frontend
npm install
./scripts/deploy.sh

The deploy script fetches stack outputs, builds the app with the correct env vars, syncs to S3, and invalidates CloudFront. The site URL will be printed at the end. Use OpsDashboardUrl to view operational metrics (latency, invocations, errors) in CloudWatch.

Create frontend/.env.local with stack outputs (or copy from deploy output):

VITE_API_URL=https://xxx.execute-api.region.amazonaws.com/prod
VITE_WS_URL=wss://xxx.execute-api.region.amazonaws.com/prod
VITE_COGNITO_USER_POOL_ID=us-east-1_xxx
VITE_COGNITO_CLIENT_ID=xxx

Then run:

cd frontend
npm run dev

spidey-social/
├── frontend/           # React SPA (Vite, TypeScript, Tailwind)
│   ├── api/            # REST API client
│   ├── lib/            # WebSocket, auth, geolocation
│   ├── components/     # UI components
│   └── scripts/        # Deploy script
├── infrastructure/     # AWS CDK stack (TypeScript)
│   ├── lib/            # spidey-social-mvp-stack.ts
│   └── lambdas/        # Lambda handlers
└── docs/
    ├── ARCHITECTURE.md # Architecture, data model, API, flows
    ├── AWS_SETUP.md    # AWS account and CLI setup
    └── MVP_DEPLOY.md   # Legacy minimal deploy

MIT