Skip to main content

Quick Start

Deploy a Serverless Node.js REST API to AWS in 3 Minutes Using Less.

In this tutorial, we'll guide you through creating and deploying a "Hello, world" REST API, demonstrating the ease of use of Less. With automatic cloud resource provisioning, infinite auto-scaling, security best practices, fault-tolerance, and more by default, it's never been easier to get code to production!

Create your Less project​

mkdir less-quick-start
cd less-quick-start

Install the Less CLI​

npm i -g @chuva.io/less-cli

Create your REST API route​

Run the following command to create a GET /hello route in Javascript.

less-cli create route --name demo --language js --verb get --path /hello

This will create the following route.

less/apis/demo/hello/get.js
exports.process = async (request, response) => {
  response.body = 'Hello, world.';
  return response;
};
Learn more about creating API routes.

You can run the following command to learn more about the options provided above.

less-cli create route --help

Test your project locally​

Less allows you to preview your project locally before deploying to AWS. Let's see how to build and run your project.

Build​

Less allows you to create a named build locally which makes it possible to run multiple versions of the same project. This allows you to run the same project with different environment variables or code versions.

less-cli build getting-started

Run​

Once you have built your project you can run it with the following command.

less-cli run getting-started

Running your project produces the following output.

[less-local] App "getting-started" is running ✅
[less-local] Resources:
[less-local]   List of APIs:
[less-local]     - demo: http://localhost:3333
[less-local] 🇨🇻

Test​

Now that we have our project running locally let's test it. Run the following command to test it using CURL in your terminal.

curl localhost:3333/hello

Deploy to production​

You can deploy your project to production with a single command.

less-cli deploy getting-started

🚀 Congratulations! You have deployed your Serverless REST API to AWS!

🤩 Does it get any easier than that?!

You will need to be logged in to your Less account in order to deploy.

If you don't have a Less account you can create one and log in using the following commands.

less-cli register
less-cli login
Learn more about building REST APIs in Less.

Check out our REST API documentation to learn how to process your request parameters, create dynamic routes, create middleware functions, and more.

Learn how to add more Less features to your project.

Adding other Less features is just as easy. Learn how to add Web Sockets, Topics/Subscribers (Pub/Sub), CRON Jobs, Key-Value Stores, File Storage, and more in our docs!