GitHub - preetramsha/lambda-api-hono-learning

🚀 Lambda API with Hono

A minimal and powerful REST API built using Hono and deployed to AWS Lambda. This setup includes a full development workflow, local testing with tsx, and automated deployment using the AWS CLI.

🧰 Prerequisites: Set Up AWS Lambda

1. Go to the AWS Console → Lambda → Create function.
2. Choose Author from scratch.
3. Give your Lambda function a name, e.g., lambda-api-hono-learning.
4. Set your desired timeout (e.g., 10 seconds).
5. Set your desired memory allocation (e.g., 256 MB).
6. Click Create Function.

🛠️ Optional: AWS CLI Setup (One-Time Only)

1. Go to AWS IAM and create a new IAM user.
2. Attach the AdministratorAccess policy (since this is your private laptop).
3. Generate an Access Key ID and Secret Access Key.
4. Choose Command Line Interface (CLI) as the usage method.
5. On your terminal, run:
   • Enter your Access Key ID
   • Enter your Secret Access Key
   • Enter your default region name (e.g., us-east-1)
   • Enter your default output format (recommended: json)

AWS CLI configuration is now complete.

📂 Project Structure

.
├── src/
│   └── index.js         # Main API logic (Hono app)
├── runlocal.js          # Starts server locally using @hono/node-server
├── dist/                # Build output (after bundling)
├── lambda.zip           # Zip file for Lambda upload
├── temp-deploy-logs/    # Deployment logs with timestamps
├── package.json

🚀 Quick Start

1. Clone and Install

git clone <your-repo-url>
cd lambda-api-hono-learning
npm install

🧪 Local Development

Test your Hono app locally using tsx and @hono/node-server.

1. Start the server

The server will run at:

Test endpoints like:

• GET /add/2/3
• GET /subtract/5/1
• GET /multiply/4/2
• GET /divide/8/2
• GET /test-query-data?name=John
• POST /test-form-data with JSON body

☁️ AWS Lambda Deployment

1. Modify the Function Name and Region

Edit the update script in package.json:

"update": "... --function-name <your-lambda-function-name> --region <your-region> ..."

2. Deploy with One Command

This runs:

• build – Bundle the app using esbuild
• zip – Create lambda.zip from the bundle
• update – Upload it to your Lambda function
• Saves logs in temp-deploy-logs/output_<timestamp>.log

Ensure your Lambda handler is set to index.handler and runtime to node.js 20.x.

🍕 Customize

• Change API logic in src/index.js
• For more routes and features, refer to: Hono Docs

🔗 Resources

• Hono Docs: https://hono.dev/docs/
• AWS CLI Docs: https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-quickstart.html
• Lambda Docs: https://docs.aws.amazon.com/lambda/latest/dg/welcome.html

😆 Template made by

Preet Jariwala ❤️

📝 License

MIT