Skip to content

Repository files navigation

OnChain Blog - Monad

A fully on-chain blogging platform built on Monad blockchain. All content is stored directly on-chain with no external dependencies.

Features

  • Fully On-Chain - All posts stored directly on Monad blockchain
  • User Profiles - On-chain user profiles with display names and bios
  • Markdown Support - Write posts with markdown formatting and code blocks
  • Wallet Connect - Connect with MetaMask (Desktop & Mobile)
  • Mobile Compatible - Full support for MetaMask mobile via deep linking
  • Dark Mode - Beautiful dark/light theme support
  • Censorship Resistant - Once published, content lives forever

Tech Stack

  • Frontend: Next.js 15, React 19, TailwindCSS
  • Blockchain: Monad (Testnet/Mainnet)
  • Smart Contracts: Solidity 0.8.28, Hardhat
  • Web3: ethers.js v6

Quick Start

1. Install Dependencies

npm install

2. Configure Environment

Create a .env file:

PRIVATE_KEY=your_private_key_here
MONAD_RPC_URL=https://testnet-rpc.monad.xyz

Create a .env.local file:

NEXT_PUBLIC_CONTRACT_ADDRESS=0xYourContractAddress
NEXT_PUBLIC_EXPLORER_URL=https://testnet.monadvision.com

3. Deploy Contract

npm run compile
npm run deploy:testnet

Copy the contract address to .env.local

4. Run Application

npm run dev

Visit http://localhost:3000

Mobile Support

The app fully supports MetaMask mobile! See MOBILE_GUIDE.md for:

  • How to connect on mobile devices
  • Deep linking setup
  • Troubleshooting tips
  • Best practices for mobile user

Commands

  • npm run dev - Run development server
  • npm run build - Build for production
  • npm run compile - Compile smart contracts
  • npm run deploy:testnet - Deploy to Monad Testnet
  • npm run deploy:mainnet - Deploy to Monad Mainnet

Networks

Testnet: Chain ID 10143, https://testnet-rpc.monad.xyz
Mainnet: Chain ID 143, https://rpc.monad.xyz

License

MIT

About

A fully on-chain blogging platform built on Monad blockchain. All content is stored directly on-chain with no external dependencies.

Topics

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages