Get up and running with TAC development quickly by building your first hybrid dApp. This guide will take you from zero to a working application that connects TON wallets with EVM smart contracts in just a few minutes.

Install create-tac-app

The fastest way to bootstrap a TAC project is using our CLI tool:

npx create-tac-app my-tac-project

This creates a new directory with a fully configured TAC project including:

  • Smart contracts with proxy implementation
  • Frontend with TAC SDK integration
  • TON wallet connection setup
  • Cross-chain messaging examples

Configure your environment

Make sure you have the required tools and accounts:

  • Node.js v18.0.0 or higher
  • Blockchain Accounts:
    • Ethereum wallet with testnet TAC tokens for deployment
    • TON wallet for testing (Tonkeeper or TON Space recommended)
  • Get Testnet Tokens:

Deploy smart contracts

Navigate to the contracts directory and deploy to TAC testnet:

cd my-tac-project/contracts
npm install
npx hardhat run scripts/deploy.js --network tacTestnet

Take note of the deployed addresses:

  • SimpleMessage contract address
  • MessageProxy contract address

These will be displayed in your console after successful deployment.

Update frontend configuration

Open lib/contract_addresses.ts and update with your deployed contract addresses:

export const CONTRACT_ADDRESSES = {
  simpleMessage: "0xYourSimpleMessageAddress",
  messageProxy: "0xYourMessageProxyAddress"
};

This connects your frontend to the smart contracts you just deployed.

Start the development server

Return to the project root and start the Next.js development server:

cd ..
npm install
npm run dev

Your TAC application is now running at http://localhost:3000.

You should see a clean interface with TON Connect integration and example messaging functionality.

Connect your TON wallet

Open your application in the browser and:

  1. Click the “Connect Wallet” button
  2. Choose your TON wallet (Tonkeeper, TON Space, etc.)
  3. Approve the connection in your wallet
  4. Verify your wallet address appears in the interface

The starter app includes a messaging example that demonstrates cross-chain communication from TON to your EVM smart contracts.

Test cross-chain functionality

Try the example functionality:

  1. Send a Message: Use the message form to send data from TON to your EVM contract
  2. Track Status: Watch the transaction progress through cross-chain stages
  3. View Results: See the message stored on the EVM side

This demonstrates the complete flow of hybrid dApp interaction.

Build your dApp

Now start customizing for your use case:

Smart Contracts (contracts/ directory):

  • Modify SimpleMessage.sol for your business logic
  • Update MessageProxy.sol for custom cross-chain handling
  • Add new contracts as needed

Frontend (pages/ and components/ directories):

  • Customize the UI components
  • Add new pages and functionality
  • Integrate additional TAC SDK features

Cross-Chain Features:

  • Asset bridging between TON and EVM
  • Multi-step cross-chain workflows
  • Advanced transaction tracking

Next Steps

Common Issues & Solutions