Development

How to set up your development environment for atopile.

Prerequisites

• Editable atopile install

Dev tools

VSCode is recommended for development. If nothing else, it has heaps of high quality extensions and atopile language support, plus it’s used internally - making it easier to configure for purpose.

You should have at a minimum:

• Cursor or VSCode
• Cursor / VSCode atopile extension (also works for Cursor)

Verbosity

You can increase the verbosity of atopile by using the -v, -vv or -vvv flags, for example ato -vv build

Flags are placed after the ato command and before the command you want to run. For example, ato -vv build runs the build command with the verbose flag set to the highest level, while ato build -vv will not work.

Debugging

You can start the command-line tool in debug mode by using the --debug flag, for example ato --debug build

This runs a debugpy server on port 5678 which you can connect to with the VSCode built-in debugger.

Connect debugger in VSCode

If you’re having trouble with syntax highlighting in the debugger, it might be because VSCode sets up a mapping between the remote and local file paths by default—remove it.