AlgoKit Commands
Standard commands for Algorand development with AlgoKit CLI.
Overview / Core Workflow
- •Write contract code
- •Build:
algokit project run build - •Write tests using generated clients
- •Test:
algokit project run test - •Deploy:
algokit project deploy localnet
How to proceed
- •
Build contracts:
bashalgokit project run build
This compiles contracts via Puya, generates ARC56 specs, and creates typed clients.
- •
Run tests:
bashalgokit project run test
Executes the test suite using Vitest.
- •
Start localnet (if needed):
bashalgokit localnet start
- •
Deploy to localnet:
bashalgokit project deploy localnet
- •
Check build artifacts:
- •
artifacts/— Compiled contracts, ARC56 specs - •Generated client files for TypeScript/Python
- •
Important Rules / Guidelines
- •Always build before testing — Tests use generated clients
- •Only deploy when explicitly requested — Don't auto-deploy
- •Check localnet status before deployment operations
- •Reset localnet if you need a clean state
Common Variations / Edge Cases
| Scenario | Command |
|---|---|
| Start local network | algokit localnet start |
| Stop local network | algokit localnet stop |
| Reset network state | algokit localnet reset |
| Check network status | algokit localnet status |
| Build fails | Check Puya compiler errors, fix contract code |
| Tests fail | Check test assertions, fix contract or test code |