README.md

Todo App

A simple AWS-powered Todo application. This project demonstrates how to build, deploy, and manage a serverless todo app using AWS services.

Features

• Add, update, and delete todo items
• Serverless backend (AWS Lambda, API Gateway, DynamoDB)
• JavaScript frontend
• Scalable and cost-effective
• Infrastructure as Code with Terraform
• Automated testing with GitHub Actions

Getting Started

1. Clone the repository

   git clone https://github.com/dewhallez/todo-serverless.git
   cd todo-serverless

2. Backend Setup

   • Install Python 3.11+
   • Install dependencies:

     cd backend
     pip install -r requirements.txt

   • Run tests:

     pytest

3. Infrastructure Deployment

   • Install Terraform
   • Configure your AWS credentials
   • Deploy resources:

     cd terraform
     terraform init
     terraform plan
     terraform apply

4. Frontend Setup

   • See /frontend/README.md for instructions.

Project Structure

.
├── backend/      # Python Lambda functions & tests
├── frontend/     # JavaScript frontend app
├── terraform/    # Infrastructure as Code
├── .github/      # GitHub Actions workflows
└── README.md

Contributing

Contributions are welcome! Please open issues or submit pull requests.

License

MIT License

---