Vibecod.io
Documentation

How vibecod.io works

Everything you need to know about how your token is created, what you own, and how your money is protected.

From sentence to token

You describe your token in plain language — the platform handles everything from there. Here's what happens step by step:

1
You describe your token

A name, a symbol, a supply, and optionally mechanics like burn, mint, or transfer tax. Plain language — no coding needed.

2
The contract is assembled

VibecodAI reads your description and maps it to a structured configuration. That configuration selects from a library of pre-written, audited Solidity modules — think Lego bricks that snap together. No code is generated from scratch.

3
You review, then deploy from your own wallet

The compiled contract is shown to you with a summary of its features. You connect your wallet (MetaMask, Coinbase Wallet, etc.) and sign the deployment transaction yourself. The platform never touches your private key.

4
Your token is live — with a landing page

Once confirmed on Base, your token gets a public page at <symbol>.vibecod.io. The contract is automatically submitted for source code verification on BaseScan.

VibecodAI doesn't write the Solidity code

This is the most important thing to understand about how vibecod.io works — and it's what makes it safe.

AI models are excellent at understanding language and extracting intent. But asking an AI to write financial smart contract code from scratch is risky: it can introduce subtle bugs or logic errors that look fine at first glance but cause real losses.

On vibecod.io, VibecodAI's only job is to read what you wrote and identify which features you want. The actual Solidity code comes from a fixed library of pre-written, human-authored modules — each one focused on a single feature (burn, mint, tax, etc.) and reviewed for correctness. The assembler combines the relevant modules. No Solidity is invented on the fly.

All generated contracts are based on OpenZeppelin v5 — the industry-standard library for ERC-20 tokens, used by thousands of production projects and audited independently.

You own everything — we own nothing

Your private key never leaves your wallet

Vibecod.io never asks for, receives, or stores your private key. The deployment transaction is signed in your browser wallet (MetaMask, Coinbase Wallet, etc.) and broadcast directly to Base. The platform only registers your token's address after the deployment is confirmed on-chain.

You are the contract owner

The wallet you use to deploy becomes the owner of the contract. This means only you can call owner-only functions like mint(), pause(), or blacklist(). Vibecod.io has no special access to your contract — once deployed, it's fully autonomous on Base.

The contract is open-source and verified

After deployment, the source code is automatically submitted to BaseScan for verification. Anyone can read exactly what your contract does — including your token holders.

Available features

Every token includes a standard ERC-20 base (OpenZeppelin v5) with an owner. You can add any combination of the following:

FeatureWhat it doesWho can call it
Burn Any holder can permanently destroy their own tokens, reducing total supply. Any holder
Mintable New tokens can be created after deployment, up to any supply cap you set. Owner only
Tax A percentage fee (in basis points) is deducted from every transfer and sent to a wallet you choose. Automatic on transfer
Pausable All transfers can be paused and resumed — useful during launches or emergencies. Owner only
Blacklist Specific addresses can be blocked from sending or receiving the token. Owner only
Max Wallet No single address can hold more than a set amount — anti-whale protection. Enforced automatically
Max Supply A hard cap on how many tokens can ever exist, even via minting. Enforced automatically
Airdrop Send tokens to multiple addresses in a single transaction. Owner only
One thing vibecod.io never adds: a platform fee on token transfers. Your contract has no hidden royalty, no platform cut on trades, no backdoor. What you see is what gets deployed.

Your landing page

Every deployed token gets a public landing page — a shareable URL you can send to early holders, post on Twitter, or link in your project's announcement.

What's on the pageFreePremium
Token name, symbol, supply
Contract address with BaseScan link
Deployer address
Feature overview
Your logo
og:image for social sharing (1200×630)
Custom domain (symbol.vibecod.io)
Project description
Twitter, Telegram, Website links
Live swap widget (Uniswap)
DexScreener chart

Management token

After deployment, you receive a private management URL containing a secret token. This token proves you created the contract and unlocks the edit interface. Save it — it cannot be recovered. We don't collect your email address, so there's no account to log in to.

Fees & payments

WhatAmountWhen
Deploy fee 0.003 ETH Paid once at deployment, in the same wallet transaction
Premium landing page 0.006 ETH or ~€20 by card Optional, one-time. Can be bundled with deployment or added later.
Gas costs ~$0.05–$0.50 on Base Paid to the Base network (not to vibecod.io)

How ETH payments are verified

When you pay in ETH, the platform independently checks the transaction on-chain before activating anything. It verifies the recipient address, the amount sent, and that the transaction was actually confirmed on Base. Your payment is never taken on trust from the browser — it's always verified server-side.

Deploy + Premium in one transaction

At the deploy confirmation screen, you can opt to include the premium upgrade in the same payment. Instead of two separate transactions, you send 0.009 ETH (0.003 + 0.006) in a single step and your token launches with a premium landing page already active.

Why Base?

Base is a Layer 2 blockchain built by Coinbase on top of Ethereum. Your token is a real ERC-20 contract, fully compatible with all Ethereum tooling (MetaMask, Uniswap, DexScreener, etc.) — just at a fraction of the cost.

BaseEthereum mainnet
Deploy cost~$0.05–$0.50$20–$150+
Transaction speed~2 seconds~12 seconds
Wallet supportMetaMask, Coinbase, Rainbow…Same
EVM compatibility100%Native
SecurityBacked by Ethereum L1Ethereum L1
You need ETH on Base — not Ethereum mainnet ETH. You can get it by bridging from Ethereum at bridge.base.org, or by buying ETH directly on Coinbase and withdrawing to Base.

After deploying — giving your token real value

Your contract is live and your landing page is up. Here's what to do next to turn it into a token people can actually discover, buy, and trade.

1. Add liquidity on Uniswap

Without a liquidity pool, your token has no price. Nobody can buy it on a DEX, and it won't appear on DexScreener or CoinGecko. Adding liquidity takes 5 minutes and you can start with as little as €50–100.

  1. Go to app.uniswap.org and connect your wallet on Base network
  2. Click Pool → New position
  3. Select ETH as the first token, then paste your contract address as the second
  4. Choose fee tier: 1% (best for new tokens)
  5. Set price range to Full range (min 0, max ∞)
  6. Enter your ETH amount — Uniswap calculates how many tokens to pair
  7. Approve your token, then click Add liquidity
The ratio of ETH to tokens you deposit sets the initial price of your token. There's no "right" price — choose based on your total supply and what feels right for your project.

For a full walkthrough with examples, read our guide: How to add liquidity on Uniswap (Base) →

2. Get listed on DexScreener

Once your Uniswap pool is live, DexScreener picks it up automatically within minutes. No submission required. Your token will have a live price chart, volume, and liquidity depth visible to anyone.

Your DexScreener URL will be:
dexscreener.com/base/<your-contract-address>

If you have a Premium landing page on vibecod.io, the DexScreener button is already wired up and will activate automatically once your pool exists.

3. Share your landing page

Your vibecod.io landing page is your token's public face. Share the URL — it already shows the contract address, deployer, supply, and features. With a Premium page, you can add a description, social links, and a live Uniswap swap widget so visitors can buy directly from your page.

4. Verify on BaseScan

vibecod.io automatically submits your contract source code to BaseScan for verification after deployment. Once verified (usually within a few minutes), anyone can read your contract's source code directly on BaseScan — a strong trust signal.

Check your contract at:
basescan.org/address/<your-contract-address>

5. Build your community

A token without a community is just a contract. Consider:

  • Creating a Telegram group or Twitter/X account for your token
  • Adding those links to your Premium landing page
  • Posting your DexScreener and vibecod.io links where your audience already is

Your data

DataDo we store it?Notes
Contract addressYesThis is public blockchain data
Token name, symbol, supplyYesUsed to render your landing page
Deployer wallet addressYesPublic blockchain data — visible to anyone
Your logoYesDisplayed on your landing page
Description & social linksYes (Premium only)Displayed on your landing page — editable
Your email addressYesRequired at deploy — used for deploy confirmation and to access your tokens later at vibecod.io/manage. No marketing, ever.
Your IP addressNoUsed only for rate limiting, never persisted
Your private keyNeverWe never receive it — signing is done in your wallet
Cookies / session dataNeverNo persistent sessions
Remember: everything deployed on Base is public and permanent. The association between your wallet address and your deployed token is visible to anyone on BaseScan — this is a property of public blockchains, not specific to vibecod.io.