ChefClaude is a smart recipe generator that takes a list of ingredients and crafts a full recipe just for you. It's built with React and Node.js, and deployed on AWS using S3, CloudFront, API Gateway, Lambda, and EC2.
- React (Vite)
- CSS Modules
- Node.js with Express
- AWS Lambda
- AWS API Gateway
- S3 + CloudFront (Static React app)
- API Gateway + Lambda (Serverless backend)
- EC2 (Optional workers or dev utilities)
- Route 53 / Squarespace (Domain management)
- ✅ Ingredient validation from Spoonacular API ingredients list
- ✅ AI-generated recipes using Claude (Anthropic)
- ✅ Fully serverless backend (API Gateway + Lambda)
- ✅ Modern UI with responsive layout
- ✅ Hosted entirely on AWS
- Node.js (v18 or newer recommended)
- npm or yarn
- Git
- (Optional) Credentials for API testing
chefclaude/
├── Frontend/ # React frontend (Vite)
├── Backend/ # Node.js backend (Express)
└── README.md
git clone https://github.com/chrislpjones/chefclaude.git
cd chefclaudecd Frontend
npm install
npm run dev- Starts the frontend on:
http://localhost:5173
cd ../Backend
npm install
node index.js- Starts the backend on:
http://localhost:3001
Create .env files in both Frontend/ and Backend/.
PORT=3001
CLAUDE_API_KEY=your_claude_api_keyVITE_API_BASE_URL=http://localhost:3001-
Frontend:
- Build React app with
npm run build - Upload
dist/to S3 bucket - Invalidate CloudFront cache
- Build React app with
-
Backend:
- Deploy Lambda via zip or tools (Serverless Framework, AWS SAM, etc.)
- API Gateway routes requests to Lambda
-
Domain:
- Use Route 53 or configure Squarespace to point to CloudFront distribution
Questions or feedback? Reach out at [email protected]
MIT License.