EACM Lab Foraging Platform
Developer and operator documentation for the EACM Lab Foraging Platform — a full-stack web app for behavioral experiments on resource foraging (university studies at UCF and USU).
Older materials may say FIP Experiments; that is the same product under a previous name.
What the platform does
- Consent and multi-survey intake for participants
- Single-player and multiplayer foraging games with live Socket.IO sync
- Optional arithmetic stress task between game phases
- Admin dashboard: experiment management, live monitoring, constants, simulations, data export
- Docker-based deploy behind host Nginx on AWS EC2
Stack (current)
| Layer | Technology |
|---|---|
| Client | Next.js 16 (App Router), React 19, HeroUI, Tailwind |
| Server | Express 4, Socket.IO 4, Prisma 6 (PostgreSQL) |
| Docs | Docusaurus 3 (this site) |
| Deploy | Docker Compose + GHCR + host Nginx |
Workshop path
Read these pages in order:
- Local development
- Repository layout
- Architecture overview
- Client → Server → Realtime sockets
- Game engine → Data model
- Participant journey
- Deployment overview
Related links
- Production: eacmlab.org
- Test: test.eacmlab.org
- Source: github.com/avier99/eacmlab