# Aztec Boilerplate

**URL:** <https://forum.aztec.network/t/aztec-boilerplate/7999>\
**Category:** Aztec\
**Created:** [June 16, 2025, 4:34pm UTC](https://forum.aztec.network/t/aztec-boilerplate/7999 "2025-06-16T16:34:54Z")\
**Posts on this page:** 1\
**Page:** 1

<div class="post-metadata">

**Author:** ![wonderland](https://dub1.discourse-cdn.com/flex013/user_avatar/forum.aztec.network/wonderland/32/2437_2.png) [@wonderland](https://forum.aztec.network/u/wonderland)\
**Post date:** [June 16, 2025, 4:34pm UTC](https://forum.aztec.network/t/aztec-boilerplate/7999/1 "2025-06-16T16:34:54Z")

</div>

# Introducing the Aztec Boilerplate

We’ve just released a clean starter template to help you get building on Aztec faster. The `aztec-boilerplate` includes everything you need to start developing privacy-preserving smart contracts while applying the most up-to-date industry standards.

## What’s included

The boilerplate includes a **Counter Contract** written in Noir that shows private-to-public execution and owner access control. The key examples are:

- **Owner Initialization:** Sets an owner’s address for restricted actions.
- **Counter Management:** Functions to increment and retrieve the counter value, demonstrating privacy-preserving state changes.

It integrates with the **Aztec.js SDK** for TypeScript bindings and utilities, enabling easy contract interaction.

### Testing Suite

A full test suite with Noir unit tests and TypeScript integration tests using Jest is included. To run tests use the following commands:

```bash
// Run all tests
yarn test

// Run noir tests
yarn test:nr

// Run js tests
yarn test:js

```

 ![Tests](https://europe1.discourse-cdn.com/flex013/uploads/aztec/original/2X/c/c9b43b3ca9b43663d6a82866374f17064b22ffd4.png)

### Automated benchmarking

Using the [Aztec Benchmark CLI](https://github.com/defi-wonderland/aztec-benchmark), Automated benchmarking measures performance metrics like Gates, DA Gas, and L2 Gas, with GitHub Actions comparing metrics across pull requests.

Whenever you push a commit to a PR, the action will run benchmarks and compare the metrics, and as a result, it will comment a table showing the difference in metrics between the base branch and your current PR. Allowing developers to optimize their code and build efficient applications.

 ![benchmarks-14-54.png](https://europe1.discourse-cdn.com/flex013/uploads/aztec/original/2X/3/39e3ad128061be1301c9e1c7586eac9881c4e0de.png)

You can also run the benchmark locally (it currently doesn’t generate the comparison table, but it will soon!).

```bash
yarn benchmark

```

 ![benchmark-run.png](https://europe1.discourse-cdn.com/flex013/uploads/aztec/original/2X/6/67f64c6b36643acd64c72a3418c3a1bddde9f706.png)

Whether you are learning Aztec, participating in a hackathon, prototyping something fast, or starting the next revolutionary project for Aztec, the boilerplate is the best starting pack for it!

## Get started

Visit the [Aztec Boilerplate Repository](https://github.com/defi-wonderland/aztec-boilerplate) to start building privacy-preserving applications. Drop your projects or questions below!

Built with \<3 by [Wonderland](https://wonderland.xyz/)