Token Dashboard

Project Structure

• contracts/ – Foundry project preconfigured with forge-std for Solidity development.
• frontend/ – React + TypeScript single-page app bootstrapped with Vite and styled with Tailwind CSS.

Getting Started

Prerequisites

• Node.js (v18 or newer recommended)
• npm or compatible package manager
• Foundry toolchain (forge, cast, anvil)

Install Dependencies

# Install frontend dependencies
cd frontend
npm install

Foundry projects vendor dependencies via git submodules, so no additional install step is required for contracts/ after cloning the repo.

Run the Frontend

cd frontend
npm run dev

This starts the Vite development server on http://localhost:5173 with Tailwind CSS support.

Smart Contract Tooling

Run Forge commands from the contracts/ directory, for example:

cd contracts
forge test

You can also start a local Anvil node with anvil and deploy scripts using forge script.

Environment Tips

• Use npm run build inside frontend/ to create a production-ready bundle.
• Customize Tailwind design tokens in frontend/tailwind.config.js.
• Add Solidity contracts under contracts/src/ and Forge tests in contracts/test/.

License

MIT