Ballerina

Creating a New Project

When the user asks to create a new project, service, or program from scratch:

bal new <project-name>   # scaffolds main.bal + Ballerina.toml
cd <project-name>

• For a workspace (multiple packages in one repo), see workspace rules in code-rules.md

Writing Ballerina Code

File layout. New code belongs in the file that fits its concern — .bal files and Ballerina.toml show the existing layout (see code-rules.md).

Finding an external connector or library. For a package code-rules.md already names, write the import and let bal build resolve it — bal search and bal pull are Central round-trips for something already decided. Reach for them only for a genuinely unknown connector. Where a ballerinax/* connector and a standalone trigger.* package cover the same events, use the connector — trigger.* is being superseded regardless of modified date.