◆nav.brand
docs.title/Token Project

Token Project

Live token dashboard with buy via sale contract or DEX

docs.viewTemplate

docs.h.overview

A token stats dashboard with a built-in buy widget. Sell from a fixed-price sale contract or route swaps through a DEX aggregator (1inch / PancakeSwap).

Token Project gives holders a real dashboard: live price, supply, holders, market cap and a price chart, plus a buy panel that works two ways — a fixed-price on-chain sale contract, or a market swap routed through 1inch or PancakeSwap.

The setup wizard guides you through token address, sale parameters and DEX routing, deploys the sale contract if you want one, and emits the .env.

Designed so a holder community has a single, branded home for the token.

docs.h.included

  • Next.js 16 app (App Router, TypeScript, Tailwind)
  • FixedPriceSale.sol + Hardhat project
  • 1inch & PancakeSwap routing adapters
  • Dockerfile + docker-compose
  • README + setup wizard

docs.h.contracts

  • FixedPriceSale.sol — sells your ERC-20 at a fixed native-coin price; owner withdraws proceeds and 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