FluxSwap | BSC DEX Script with Liquidity Manager & Dev Fee

What's included

• Complete React/TypeScript dApp (Vite, Tailwind, shadcn-ui): Swap, Pools, Add/Remove Liquidity, Find Pool, Settings, Transaction modals, Token selector, Navbar/Footer.
• BSC-ready smart contract (FluxSwap_v1): supports swap routing via V2 routers, optional fee-on-transfer tokens, add-liquidity helpers, and developer fee (percent + fixed fee) with owner controls.
• Wagmi + Web3Modal wallet connect (MetaMask and more) with network switch UI.
• Light/Dark theme + brand color via CSS variables (neon-blue by default) for instant white-label branding.
• Internationalization (i18n) with polished, professional English copy ready to extend.
• Clean animations & micro-interactions for a premium feel without compromising performance.

Key features

• V2 swap flow: token search, instant quoting, min-received, slippage tolerance, route label, and transaction status modal.
• Liquidity manager: add/remove V2 liquidity, import existing pools, share of pool, per-token receipts, and price breakdown.
• Developer fees: owner-settable swap fee percent and add-liquidity fixed fee routed to your fee wallet.
• Non-custodial by design: users stay in control; the app talks directly to the chain and router contracts.
• Responsive + mobile-first: modern navigation, beautiful mobile sheet menu, and accessible controls.
• Config-driven: update Router/Factory/Swap/WETH addresses per chain (BSC out of the box).

How FluxSwap works

The front-end (React + Tailwind) provides the full DEX experience and connects to EVM networks via Wagmi/Web3Modal. Swaps and liquidity actions are executed against V2-compatible routers/factories you configure (e.g., Pancake-style). The included FluxSwap_v1 contract exposes swap and add-liquidity helpers, calculates developer fees, and forwards to the underlying router. Ownership can be transferred at any time, and fee parameters can be updated by the owner wallet.

Admin controls & fees

• Owner-only setters: setFeePercent, setFeeAccount, setLiquidtyFee, setRouterWeth.
• Developer fee: percentage on swaps + fixed fee for add-liquidity (in native coin), paid to the configured fee account.
• Ownership: initially the deployer; you can transfer ownership to a treasury, multisig, or another wallet later.
• Emergency helpers: owner can withdraw stuck tokens or native coin (guard rails for operations).

Tech stack

• Frontend: React + TypeScript, Vite, Tailwind CSS, shadcn-ui, lucide-react icons.
• Web3: wagmi, viem, Web3Modal (WalletConnect v2).
• Contracts: Solidity (OpenZeppelin libraries), V2-router compatible integration.
• i18n: ready-to-extend translation JSON with professional defaults.

What you need to launch

1. A BSC wallet (MetaMask) with a small amount of BNB for gas.
2. Deploy the included FluxSwap_v1 contract to BSC, set your feeAccount and fee parameters.
3. Update config in the app with your chain Router, Factory, WETH and your deployed swapAddress.
4. Create a WalletConnect project and paste the key in .env (VITE_WALLET_CONNECT_PROJECT_ID).
5. Build & host the front-end on any static host (Vercel, Netlify, S3, etc.).

Branding & customization

• Change the logo, name (FluxSwap is fully white-label), and token list.
• Tweak the brand color via a single CSS variable (--brand) and switch light/dark globally.
• Edit copy in the translation file; add new languages as needed.

Why teams choose FluxSwap

• Time-to-market: ship a beautiful, battle-tested DEX UI in days—not weeks.
• Professional UX: clean visuals, subtle animations, and strong accessibility.
• Own your fees: flexible developer fee model wired into the contract.
• BSC-focused: configuration, defaults, and flows tailored for Binance Smart Chain.

Note: You are responsible for your own deployments, fee settings, compliance, and audits. The app is non-custodial; users transact directly from their wallets. Ownership of the contract can be transferred later to any wallet or multisig you choose.