◆nav.brand
docs.title/Token Project

Token Project

Live token dashboard with a built-in buy

docs.viewTemplate

docs.h.overview

A branded home for your token: live on-chain stats and a built-in buy that settles through a fixed-price sale contract or routes a swap through a DEX (Uniswap V2-compatible router, or a 1inch/PancakeSwap link).

Token Project gives holders a real dashboard: live price, total supply, their balance and how many tokens are still for sale, all read straight from chain and shown in the chain's native coin (ETH / BNB / POL), with block-explorer links.

The buy panel works two ways. In sale mode it settles through an included fixed-price sale contract, capped to the inventory you fund. In DEX mode it pulls an on-chain quote and swaps via any Uniswap V2-compatible router, with one-click deep links to 1inch and PancakeSwap as a fallback.

The setup wizard lets you point at an existing token or deploy a brand-new ERC-20, then optionally deploy and fund the sale contract — all from your wallet — and prints the .env.

docs.h.included

  • Next.js app (App Router, TypeScript, Tailwind)
  • Token.sol (optional new ERC-20) + FixedPriceSale.sol + Hardhat
  • Setup wizard with in-browser deploy and a fund-the-sale step
  • Dockerfile + docker-compose
  • README + .env workflow

docs.h.contracts

  • Token.sol — an optional plain, fixed-supply ERC-20 minted entirely to your wallet on deploy. Deploy it from the wizard if you don't already have a token (OpenZeppelin ERC20 + Ownable).
  • FixedPriceSale.sol — sells your ERC-20 at a fixed native-coin price; buyers purchase up to the inventory you fund it with, and the owner withdraws proceeds and any unsold tokens (OpenZeppelin Ownable + ReentrancyGuard + SafeERC20).

docs.h.stack

docs.stackLine

docs.chainsLine

docs.h.quickstart

docs.quickstartP

unzip token-project.zip && cd token-project
npm install
npm run dev

docs.quickstartUrl

docs.h.configure

docs.configureP

  1. docs.wizard.1
  2. docs.wizard.2
  3. docs.wizard.3
  4. docs.wizard.4
  5. docs.wizard.5
Tip · docs.configureTip

docs.configureP2

docs.h.customize

docs.h.branding

docs.brandingP

docs.brandingP2

docs.h.languages

docs.languagesP

docs.h.editing

docs.editingP

docs.h.configRef

docs.configRefP

  • docs.configRef.1
  • docs.configRef.2
Tip · docs.configRefTip

docs.h.deployContracts

docs.deployContractsP

# compile + copy artifacts the app/wizard use
npm run compile

# deploy to the network in your .env (RPC_URL + DEPLOYER_PRIVATE_KEY)
npm run deploy

docs.deployContractsP2

docs.h.deployApp

docs.h.vercel

  1. docs.vercel.1
  2. docs.vercel.2
  3. docs.vercel.3

docs.h.docker

docs.dockerP

# build + run; with no .env it opens the setup wizard
docker compose up --build

# once you have a .env, pass it in:
docker run --env-file .env -p 3002:3000 token-project

docs.dockerP2

docs.h.vps

docs.vpsP

npm install
npm run build
npm run start   # serves the production build

docs.h.checklist

  • docs.checklist.1
  • docs.checklist.2
  • docs.checklist.3
  • docs.checklist.4
  • docs.checklist.5

docs.h.support

docs.supportP