Prerequisites
- Node.js 18+ - For backend development
- Flutter 3.24.5 - For mobile app (via FVM)
- ESP-IDF 5.4+ - For firmware development
- AWS CLI - For infrastructure deployment
- PostgreSQL - Database (Neon recommended)
Installation
1
Clone Repository
bash
git clone https://github.com/yourusername/stemcell.git cd stemcell npm install
2
Deploy AWS Infrastructure
Deploy AWS resources first (S3 buckets, IAM credentials):
cd infrastructure npm install cdk bootstrap --region ap-southeast-1 cdk deploy StemCellMinimal-dev --region ap-southeast-1
⚠️ Important: Save the output values (FirmwareBucketName, VercelAccessKeyId, VercelSecretAccessKey)
3
Setup Backend
Configure and deploy the Next.js backend:
cd packages/cloud cp .env.example .env # Edit .env with your values npm install npx prisma migrate deploy npm run dev
4
Build Mobile App
Build and run the Flutter mobile app:
cd packages/nucleus fvm flutter pub get fvm flutter run
5
Flash Firmware (Optional)
Build and flash ESP32 firmware:
cd packages/body ./build-target.sh esp32s3 idf.py -p /dev/ttyUSB0 flash monitor