learn.md

layout	title	description	keywords	permalink	intro	redirect_from
ballerina-learn-landing-page	Learn	Ballerina is a comprehensive language that is easy to grasp for anyone with prior programming experience. Start learning with the material below.	ballerina, learn, documentation, docs, programming language	/learn/	Ballerina is a comprehensive language that is easy to grasp for anyone with prior programming experience. Let's start learning Ballerina.	/learn-beta2-column /learn-beta2-column/ /learn

<style> :not(pre) > code[class*="language-"], pre[class*="language-"]{ background: #e0dede !important; } .cBallerina-io-Gray-row.cLandingPageintro{ padding-bottom:0; } .cBallerina-io-Home-Middle-col{ padding-left:15px !important; } .column-gray-box{ padding: 40px 25px 15px 25px; background-color:#fff; height: 100%; } .row h2{ display:block; margin-top:10px; } .card h3{ font-size:20px; margin:0px !important; } .card p{ margin-top:15px !important; margin-bottom:0px !important; } .card{ border: none; margin: 10px 40px 15px 0px; padding: 0px 0px; /* max-width: 530px; */ } .card:hover{ color:#464646 !important; /* background-color:#F8F8F8; */ } .column-gray-box-row{ display: -webkit-box; display: -ms-flexbox; display: flex; -ms-flex-wrap: wrap; flex-wrap: wrap; margin-right: -15px; margin-left: -15px; margin-top: -15px; } .column-gray-box-grid{ -webkit-box-flex: 0; -ms-flex: 0 0 100; flex: 0 0 100; max-width: 100; padding-left:15px; padding-right:15px; padding-top:15px; } /* Add para height to keep consistency Medium devices (landscape tablets, 768px and up) */ @media only screen and (min-width: 768px) { .card{ max-width: 700px !important; } } /* Add para height to keep consistency in Large devices (laptops/desktops, 992px and up) */ @media only screen and (min-width: 992px) { .card p{ height:54px !important; } .card{ max-width: 450px !important; } } /* Add para height to keep consistency in Extra large devices (large laptops and desktops, 1200px and up) */ @media only screen and (min-width: 1200px) { .card p{ height:54px !important; } .card{ max-width: 550px !important; } } </style>

Get started

Install Ballerina

Set up the Ballerina development environment.

Get started with Ballerina

Write your first Ballerina program and create your first Ballerina package.

Language basics

Get started with the basics that are common to all C-family programming languages.

Write a RESTful API with Ballerina

Understand the basics of Ballerina constructs, which allow you to write RESTful APIs.

Write a GraphQL API with Ballerina

Understand the basics of Ballerina constructs, which allow you to write GraphQL APIs.

Write a gRPC service with Ballerina

Write a simple Ballerina gRPC service and invoke the service through a Ballerina gRPC client.

Work with data using queries in Ballerina

Use Ballerina query expressions to filter, sort, and join different iterable collections.

Deploy Ballerina on Kubernetes

Dockerize your application and deploy it on Kubernetes.

Build a data service in Ballerina

Connect to a MySQL database and execute queries using an HTTP RESTful API.

Guides

Distinctive language features

A guide to the language features that make Ballerina distinctive.

Organize Ballerina code

Basics of projects, packages, and modules.

Test Ballerina code

Details of writing automated tests using the built-in test framework.

Generate code documentation

The usage of the bal doc CLI command.

Configure Ballerina programs

The language support for configurability.

Observe Ballerina programs

Basics of the observability functionalities that are provided for Ballerina programs.

Run Ballerina programs in the cloud

The cloud offerings for running Ballerina programs.

Manage dependencies

Details of declaring and managing dependencies and using the local repository.

Publish packages to Ballerina Central

Details of publishing your library package to Ballerina Central.

Call Java code from Ballerina

Details of calling Java code from Ballerina using Java interoperability.

Debug Ballerina programs

Details of tooling support for troubleshooting Ballerina applications.

Ballerina Shell

Details of the Read-Evaluate-Print Loop (REPL) for Ballerina.

Visual Studio Code extension

Details of the Ballerina Visual Studio Code extension.

OpenAPI tool

Details of the Ballerina OpenAPI tool.

GraphQL client tool

Details of the Ballerina GraphQL client tool.

AsyncAPI tool

Details of the Ballerina AsyncAPI tool.

References

Ballerina by Example

A series of guided examples to learn the language.

Library documentation

Ballerina library API documentation.

CLI documentation

Details of the CLI commands of the bal tool.

Platform specifications

Details of the Ballerina language specifications and proposals.

Style guide

Best practices to follow when formatting Ballerina code.

Java interoperability

Instructions on the supported Java interoperability features.

Package references

References related to Ballerina Packages.

Talks

Language walkthrough

A video series, which explains the language and its reference slide deck.