Hapi is a simple to use configuration-centric framework with built-in support for input validation, caching, authentication, and other essential facilities for building web and services applications. hapi enables developers to focus on writing reusable application logic in a highly modular and prescriptive approach.

What does this come with?

• Hapi Hello World
• Deployed with node server
• Dockerfile (automatically used by Hasura for deployment)

FROM mhart/alpine-node:7.6.0

WORKDIR /src

ADD src/package.json /src/
#install node modules
RUN npm install

# Add app source files
ADD src /src

CMD ["node", "server.js"]

Deployment instructions

Basic deployment:

• Press the Clone & Deploy button and follow the instructions.
• The hasura quickstart command clones the project repository to your local computer, and also creates a free Hasura cluster, where the project will be hosted for free.
• A git remote (called hasura) is created and initialized with your project directory.
• Run git add ., git commit, and git push hasura master.
• Run the below command to open your deployed hapi app.

$ hasura microservice open api

Making changes and deploying

• To make changes to the project, browse to /microservices/api/src and edit the server.js file in according to your app.
• Commit the changes, and perform git push hasura master to deploy the changes.

Local development

To test and make changes to this app locally, follow the below instructions.

• Open Terminal and cd into the project folder
• Run npm install to install all the project dependencies
• Run npm start in the terminal to run it.
• Make changes to the app, and see the changes in the browser

View server logs

You can view the logs emitted by the node server by running the below command:

$ hasura microservice logs api

You can see the logs in your terminal, press CTRL + C to stop logging.

Managing app dependencies

• System dependencies, like changing the web-server can be made in the Dockerfile
• npm/yarn deps can be managed by editing package.json.

If changes have been done to the dependencies, git commit, and perform git push hasura master to deploy the changes.

Migrating your existing hapi.js app

• If you have an existing hapi.js app which you would like to deploy, replace the code inside /microservices/api/src/ according to your app.
• You may need to modify the Dockerfile if your package.json or the build directory location has changed, but in most cases, it won't be required.
• Commit, and run git push hasura master to deploy your app.

Adding backend features

Hasura comes with BaaS APIs to make it easy to add backend features to your apps.

Add instant authentication via Hasura’s web UI kit

Every project comes with an Authentication kit, you can restrict the access to your app to specific user roles. It comes with a UI for Signup and Login pages out of the box, which takes care of user registration and signing in.

Follow the Authorization docs to add Authentication kit to your app.

Add a custom API

Hasura project is composed of a set of microservices. These include certain Hasura microservices like postgres, nginx, data API, auth API and more but can also include your own microservices.

• Check out docs on adding another microservice Adding Microservice

Add data APIs

Hasura comes with set of Data APIs to access the Postgres database which comes bundled with every Hasura cluster. Detailed docs of data APIs can be found here.