Installation & Setup

Installation & Setup: Accessing OmniSocial

Getting started with OmniSocial is simple—whether you're a user joining via the web app or a developer running the platform locally.

---

🌐 Access via Web App (Recommended for Most Users)

The fastest way to experience OmniSocial is through our hosted web application:

👉 https://omnisocial.dev

✅ Prerequisites:

• A Polygon-compatible wallet (e.g. MetaMask, Rabby, WalletConnect)

• Switch your wallet to Polygon zkEVM (you’ll be prompted if not already connected)

• A small amount of testnet ETH or OMNI tokens (we’ll auto-fund you if needed)

🧑‍💻 Local Developer Setup (For Builders)

Want to customize, contribute, or build on OmniSocial? You can run the full stack locally.

🛠️ Requirements:

• Node.js v18+

• Yarn or npm

• Git

• A Polygon wallet with testnet access (for deployments)

• Optional: Hardhat, Foundry, The Graph, and Docker (for full-node or subgraph environments)

📦 Clone the repo:

git clone https://github.com/OmniSocialBlockchain/dapp.git
cd dapp
yarn install

🧪 To run locally:

# Start the dev server
yarn dev

Visit http://localhost:3000 in your browser. The app will connect to the testnet by default.

🧬 Contracts & Subgraph:

• Smart contracts are in contracts/

• Deployment via Hardhat (yarn deploy)

• Subgraph templates available in /subgraph

🌍 Supported Wallets

OmniSocial supports:

• MetaMask

• WalletConnect (including mobile wallets)

• Coinbase Wallet

• Brave Wallet

• Ledger/Trezor (via WalletConnect)

If you're using a browser wallet like MetaMask, you’ll be prompted to add the Polygon zkEVM network when you first connect.

---