# Skatehive Developer Documentation

> Technical documentation for developers: forking Skatehive, app features, Hive management, witness setup, curation trails, and Zora integration.

This file contains all documentation content in a single document following the llmstxt.org standard.

## Curation Trail


## How to Join the Skatehive Curation Trail on the Hive Blockchain

The Skatehive curation trail is a way to support skateboarding-related content on the Hive Blockchain by automatically upvoting posts that the Skatehive community values. Joining the trail ensures your voting power helps amplify the voices of skaters and creators within the ecosystem. This tutorial will guide you through the process.

***

#### Step 1: Log in to Hive.vote

Hive.vote is a platform that allows you to automate your voting activity on the Hive Blockchain.

1. Go to [Hive.vote](https://hive.vote).
2. Log in using your Hive credentials (you can use Hive Keychain for a secure login).

***

#### Step 2: Find the Skatehive Curation Trail

1. Once logged in, click on the "Curation Trails" tab in the Hive.vote dashboard.
2. Use the search bar to look for **Skatehive**.
3. Click on the Skatehive trail to view its details.

***

#### Step 3: Join the Skatehive Curation Trail

1. On the Skatehive trail page, click the "Follow" button.
2. Adjust your voting settings:
   * **Voting weight**: Set the percentage of your vote to allocate to the trail (e.g., 50%, 75%, or 100%).
   * **Delay**: Decide if you want your votes to be delayed after the trail votes.
3. Confirm your preferences and save the settings.

***

#### Step 4: Verify Your Participation

1. Return to the Hive.vote dashboard and navigate to "My Trails."
2. Ensure Skatehive appears in your list of followed trails.

***

### Why Join the Skatehive Curation Trail?

#### What Does the Curation Trail Do?

By joining the Skatehive curation trail, your account automatically upvotes the same posts that Skatehive upvotes. This means your voting power contributes to supporting skateboarding-related content that the Skatehive community values. Essentially, you "copy" the likes of the Skatehive account, ensuring you help reward quality creators without needing to manually vote on each post.

#### What Do You Gain?

* **Support the community**: Your votes help grow the skateboarding community on Hive by rewarding creators.
* **Earn curation rewards**: As part of the trail, you earn a portion of the curation rewards generated by upvoting valuable content.
* **Save time**: Instead of manually searching for content to vote on, the trail automates the process, ensuring consistent engagement with the community.

#### Technical Explanation:

The curation trail automates your upvotes to align with Skatehive’s voting activity. This maximizes the distribution of rewards to valuable content while optimizing your voting power. By participating, you contribute to a decentralized and community-driven curation process that highlights skateboarding content within the Hive ecosystem.

***

### Final Tips

* **Engage with the community**: Check out the Skatehive tag on Hive to discover new content.
* **Monitor your voting power**: Keep an eye on your voting power to ensure it doesn’t drop too low.
* **Adjust settings as needed**: You can leave or modify your trail preferences at any time through Hive.vote.

By joining the Skatehive curation trail, you’re actively supporting the skateboarding community and helping Hive grow as a platform for decentralized content. 🛹

---

## Hive Witness

# How to Vote for the Skatehive Witness on the Hive Blockchain

The Hive Blockchain is a decentralized platform that operates with witnesses to keep the network secure and functional. Voting for a witness, such as Skatehive, helps support initiatives that promote decentralization and creativity within the skateboarding community.

***

## Step 1: The Easiest Way—Vote with Skatehive App

**New users can now vote for the Skatehive witness using a much simpler method:**

1. Visit [skatehive.app/witness](https://skatehive.app/witness)
2. Log in with your Hive account using your preferred sign-in method (Hive Keychain, Ecency, etc.).
3. Click the vote button next to the Skatehive witness to cast your vote.
4. Follow any prompts to authorize the transaction using Hive Keychain or your chosen wallet.
5. Done! Verify your vote on the same page.

> **Tip:** This method is recommended for new users because it’s streamlined, mobile-friendly, and guides you through the process directly.

***

## Alternative Methods

If you prefer using other Hive platforms or clients, you can still vote for Skatehive witness via PeakD, Hive Blog, or directly with Hive Keychain.

### Option A: Using PeakD or Hive Blog

1. Go to [PeakD](https://peakd.com) or [Hive Blog](https://hive.blog).
2. Click on the menu or look for the "Witnesses" option.
    * On PeakD, it's in the left-hand sidebar.
    * On Hive Blog, access [https://hive.blog/~witnesses](https://hive.blog/~witnesses)
3. Search for "**skatehive**" in the witness list (Ctrl + F for quick search).
4. Or use this direct link (must be logged in): [https://peakd.com/me/witnesses](https://peakd.com/me/witnesses)
5. Click the vote button next to "skatehive" and confirm your action (Hive Keychain will prompt you to authorize).
6. Verify your vote in your active witness votes.

### Option B: Hive Keychain Extension

- Download and install Hive Keychain (browser extension).
- Log in and navigate to a witness voting platform (such as skatehive.app/witness, PeakD, or Hive Blog).
- Search for "skatehive," click vote, and authorize via Hive Keychain.

***

### Final Tips

* **Why vote for Skatehive?** Skatehive is a witness that promotes the skateboarding community on the Hive Blockchain, fostering decentralization and creativity.
* **Vote limit:** Each account can vote for up to 30 witnesses. Use your votes wisely.
* **Get involved:** Join the Skatehive community and help strengthen the project.

Now that you know how to vote, support Skatehive and become part of this amazing community! 🛹

---

## Learn Hive Tokens


## Manage Hive

#### Manage Your Hive Tokens

You can easily manage your Hive tokens directly from your wallet. When you click on your wallet, you will see five key terms: **Hive**, **Hive Power**, **Hive Dollars**, **Savings**, and **Estimated Account Value**.

![Hive Tokens Overview](../.gitbook/assets/1.png)

***

## 1. **Hive (HIVE)**

HIVE tokens are tradeable and can be transferred at any time. You can also convert HIVE into Hive Power through a process called **Powering Up**.

* **What is Powering Up?**
  * Powering Up is the process of converting HIVE tokens into Hive Power, which is essentially "staking" your tokens. This gives you increased influence and rewards within the Hive ecosystem.

***

## 2. **Hive Power (HP)**

Hive Power represents your stake in the Hive network. The more Hive Power you have, the more influence you have over the platform.

* **Benefits of Hive Power:**
  * **Voting Power:** More Hive Power gives you larger voting power on posts and proposals.
  * **Curation Rewards:** Increased rewards for curating content.
  * **More Resource Credits:** Additional resource credits to perform transactions on the Hive Blockchain.
  * **Hive Governance:** More say in supporting witnesses and projects on Hive.

To increase your Hive Power, you can **Power Up** your HIVE tokens.

***

## 3. **Hive Backed Dollars (HBD)**

HBD is a stablecoin pegged to the US Dollar. Each HBD token is generally worth about **$1.00 USD** in HIVE.

* **Note:** HBD can be converted into HIVE or used within the Hive ecosystem for transactions.

***

## 4. **Savings**

You can transfer your HIVE or HBD to **Savings** for added security. Tokens in savings are subject to a **3-day withdrawal waiting period**.

* **Why use Savings?**
  * Savings provides a safer way to store your tokens, while also offering a **20.00% APR** on your HBD, as defined by the network's witnesses.

***

## 5. **Estimated Account Value**

The **Estimated Account Value** gives you an approximate USD value of the tokens in your wallet based on their average market value. This helps you track the worth of your Hive assets in terms of real-world value.

***

By understanding these five key terms, you can effectively manage your Hive tokens and make the most of the features available on the Hive Blockchain.

---

## Zora Coins

# SkateHive + Zora Integration Guide

## Overview

SkateHive now connects to Zora's platform, letting you turn posts into coins that people can trade.

---

## What is this integration?

SkateHive runs on Hive blockchain. Now it also connects to Ethereum's Base network. Here's what you can do:

- **Post content** on Hive as usual
- **Create coins** from your posts on Base blockchain
- **Trade coins** with ETH or USDC
- **Support creators** by buying their coins

---

## How to create a coin

### What you need

- Ethereum wallet (Base wallet, Metamask, Farcaster wallet...)
- Access to Base network (auto-switches)
- Small amount of ETH for gas (~$0.5-1)

### Steps

1. **Connect wallet** at skatehive.app
2. **Choose method**:
   - Create new coin from scratch
   - Convert existing post to coin
3. **Fill details**:
   - Name and symbol for your coin
   - Description
   - Upload image or video
4. **Confirm transaction**

![create-zora-coin](https://ipfs.skatehive.app/ipfs/QmUW2uCjYFE5VsfsW7qM8CpDdF2Nfvwv8P2ZmVmuUgtUb9)

The system handles the rest - uploads to IPFS, creates the coin contract, posts to Hive.

---

## Media support

### Supported files

- **Images**: JPG, PNG, GIF, WebP
- **Videos**: MP4, WebM, MOV, AVI
- **Storage**: Files stored on IPFS

### Features

- Automatic video thumbnail generation
- Multiple IPFS gateways for reliability
- File compression and optimization

---

## What does "post to coin" mean?

### The basic idea

When you create a coin from a post, you're making that content into something people can buy and sell. Think of it like shares in that specific content.

### How it works

1. You post skating content
2. Community likes it (votes, comments)
3. You or someone else creates a coin from it
4. People can now trade that coin
5. If the content stays popular, coin value might go up

> If user had Ethereum and Hive wallet the coins is posted or edited under user Hive and Ethereum accounts. All your posts will be visible on Zora, Skatehive and all the other hive websites. If the user only has an Ethereum wallet, @SkateDev account will register the Coining on Hive blockchain automatically

---

## How trading works

![Image](https://ipfs.skatehive.app/ipfs/Qmdx5Z1nuP9XgiBqvTiPGGPUmQujthuns52AiEkE3UDogQ)

### For creators

- Make money when people buy your coins
- Earn from price increases if your content stays popular
- SkateHive gets small fee (2.5%) from trades that helps fund the platform
  > **(this fee comes from zora fee not from the creator)**
- Coin holders become more invested in your content

### For coin buyers

- Support creators you believe in
- Might make profit if creator becomes popular
- Get in early on promising skaters
- Future: might get special access or voting rights

### For the platform

- Small fees from trades help keep SkateHive running
- More trading means more activity
- Connects Hive community to Ethereum ecosystem
- Creates new ways for skaters to make money

---

## What's currently working

- Create coins from posts or from scratch
- Upload images/videos (auto-generates thumbnails)
- Trade with ETH or USDC via Zora
- Connect any Ethereum wallet
- Coins show up as previews in posts
- Works with both Hive and Base networks

## Getting started

1. Connect your Ethereum wallet at skatehive.app
2. Browse existing coins to see how it works
3. Try buying a small amount of someone's coin
4. Post some content and create your first coin

**Tips**: Start small, build a following first, focus on quality content

---

---

## Devs


Building on or contributing to SkateHive? Start here.

SkateHive 3.0 is open source (Next.js 15 + Chakra UI, Hive blockchain, with
Farcaster and Ethereum/Base integrations). This section covers how to run, fork,
and extend the app.

- **[Fork SkateHive 3.0](./fork-skatehive)** — beginner-friendly guide to clone,
  configure, and run the app locally.
- **[Application Overview](./app-features)** — a tour of the platform's features
  and how the pieces fit together.

Want to help? Jump into the [repo](https://github.com/SkateHive/skatehive3.0) and
say hi in the community channels.

---

## App Features

# Skatehive 3.0 Application Overview

Skatehive 3.0 is a comprehensive community platform for skaters, built with Next.js 15 and Chakra UI. The application enables users to publish content to the Hive blockchain while seamlessly integrating with Farcaster and Ethereum ecosystems. This overview showcases the key features and functionality available in the platform.

## Posting Composer

The posting composer allows users to create rich content using Markdown syntax, upload multimedia files, and publish directly to the Hive blockchain. The component features real-time preview capabilities and handles image/GIF uploads with integrated media processing hooks.

![Image](https://ipfs.skatehive.app/ipfs/QmbMT47u9nd7zyNYWUCR5hHe1AG6k49xGrPjQcv4mqDr3u)

## Skate Spot Map

An interactive map displays community-submitted skate spots. Skaters submit a spot straight from the Snaps composer on a spot page, and it appears on the map. The map uses dynamic loading to maintain optimal page performance until users access the feature.

![Image](https://ipfs.skatehive.app/ipfs/QmcigkjTTHjm2PXHLzRCAFLBXbjdFyKgd9XVS9yMqQDzdj)

## Bounties

The bounty system gamifies trick challenges where users submit video clips to earn community rewards. Submitting a bounty creates a Snap, while claiming bounties works through upvoting mechanisms. The bounty creator triggers payments when challenges end, automatically generating winner announcements.

![Image](https://ipfs.skatehive.app/ipfs/QmZgF8eKLmtkCDLVRP9Tey9CLjhsWX8gG4fU6ms285QfjK)

## Magazine Mode

Magazine mode transforms community posts into an elegant flipbook-style presentation, highlighting trending content within the Skatehive ecosystem for an immersive reading experience.

![Image](https://ipfs.skatehive.app/ipfs/QmQSiX4dBw9mA4uB8FFemMcLauKfJYg5pS2SU1ND2u4kN1)

## Leaderboard

The leaderboard ranks SkateHive users based on engagement, posting, Hive Power, NFT holdings, treasure donations, witness voting etc.

![Image](https://ipfs.skatehive.app/ipfs/QmekeXkQzMhz6io69k3tpmGN1KcXPv6hgJcYM7aJ83KY7y)

## Invite System

Authenticated users can invite friends by creating new Hive accounts through email invitations. The system constructs and broadcasts the required Hive operations using Keychain integration for secure account creation.

![Image](https://ipfs.skatehive.app/ipfs/QmXWnFG2EpEXpVLtLRYSnPPq5LLgDDoeJvLLmy6VwDnXhR)

## Airdrop

Any user can create airdrops with Hive tokens or whitelisted ERC20 tokens to support or encourage user behavior by filtering the airdrops by leaderboard category.

![Image](https://ipfs.skatehive.app/ipfs/Qma3ViucPUGTtoYQXBbC2y6cBfzHUp1rSvY66MjRy31Jxk)

## Settings and Theme Selection

The platform offers customization through multiple theme options. Creating custom Skatehive themes is straightforward, and while some themes may have minor quirks, they all provide unique visual experiences. Community contributions for new themes are encouraged!

![Image](https://ipfs.skatehive.app/ipfs/QmcZQSbz1ufccTatNk28eZ1W5RE88cYtfBLcB6Mx8hAsac)

## Fast Reply Notification System

The notification page features an integrated SnapComposer for quick replies directly from notifications. This functionality extends to the Farcaster miniapp, enabling seamless communication across platforms.

![Image](https://ipfs.skatehive.app/ipfs/QmS9rJCC8C2HTid4KsXEA8fd1U4TxqEcvGXbUDWjz8phaw)

## Buy Hive Account with ETH

Our OnchainKit-powered webapp (compatible as a Farcaster miniapp) enables users to purchase Hive accounts using ETH or USDC on Base network. All proceeds are directed to the skatehive.eth wallet to support platform development.

![Image](https://ipfs.skatehive.app/ipfs/QmZdaFxbfVCWYUwjHZeiiWtnqHf7ZBZxcARQ7ok3cHmJSy)

## Multichain Wallet

The [`/wallet`](https://skatehive.app/wallet) page provides a unified dashboard for managing balances across Hive, Ethereum, and Farcaster wallets. The SkateBank section offers advanced features including HBD savings, token staking, and Pix integration, creating a comprehensive financial management hub within the application.

![Image](https://ipfs.skatehive.app/ipfs/QmcfDJLwJ25LuPqGt3JvCxabdyhW7rMGtSMbZBPL7tjne2)

## Farcaster Notifications

The platform bridges Hive blockchain events to Farcaster miniapp users through push notifications. Users first add the miniapp in Farcaster to register in our PostgreSQL database via webhook, then visit [`/settings`](https://skatehive.app/settings) to link their Hive account with Farcaster and enable cross-platform mobile notifications.

![Image](https://ipfs.skatehive.app/ipfs/QmRoSSP8oQQRYKoM56r8EpR2qaX7UybTTv87SFpFTHK7gw)

## Auction Platform

As a [Builder DAO](https://docs.nouns.build/), Skatehive operates an [`/auction`](https://skatehive.app/auction) marketplace that fetches auctions from Nouns Builder contracts. The platform includes Farcaster frame metadata, enabling users to collect digital art directly through Farcaster frames for seamless NFT interactions.

![Image](https://ipfs.skatehive.app/ipfs/QmXxhcDdcMewU7MBACAv3WHhaWGGFjrrngt5gaLs3Ff8jt)

## Miniapp Integration

Skatehive functions as a native Farcaster miniapp with intelligent client detection and automatic user authentication. The miniapp components handle seamless account linking without requiring additional sign-in processes, sending welcome notifications upon successful linking.

![Skatehive-miniapp](https://ipfs.skatehive.app/ipfs/QmWof7MSt6KRMM8MbS666VqcJwS4YzzDG3TJSkdCPjmknU)

## Media Upload Infrastructure

The platform utilizes a hybrid approach for media hosting: Hive Images service for standard uploads, and our dedicated IPFS endpoint (ipfs.skatehive.app) for magazine posts and videos. Our Pinata Basic plan ($20/month) ensures optimal video loading performance but public gateways will work as well. Future plans include reintegrating 3Speak functionality as previously implemented.

![Image](https://ipfs.skatehive.app/ipfs/QmP3Vfq8aWadEKj4xQJwj2fJc2azrZdXD2DxuFM8HpMDco)

## GIF Creation Tool

The integrated GIF maker allows users to upload videos and create custom GIFs with up to 30 seconds duration.

![gif-maker](https://ipfs.skatehive.app/ipfs/QmS3J89iM3xKfQTmaSKZPhBBc8uyEdUFGKkxuAGSwSPHso)

## Zora Integration

Ethereum-connected users can mint Zora coins on Base network and promote Hive posts to Zora collectibles. This feature bridges traditional social content with NFT monetization. For detailed implementation information, refer to the dedicated Zora integration documentation.

![Image](https://ipfs.skatehive.app/ipfs/QmUW2uCjYFE5VsfsW7qM8CpDdF2Nfvwv8P2ZmVmuUgtUb9)

## Ethereum Features

If a user is connected solely with their Ethereum wallet and does not have a Hive account, the SnapComposer adapts to display Ethereum-specific actions. This allows users to interact with the platform using their Ethereum identity, providing relevant features and options available on the Ethereum network.

![Image](https://ipfs.skatehive.app/ipfs/QmUsht6Da3h2kFRmc4PfuvDnSzXQoCnoLBkdKEem9FeeEm)

---

---

## Fork Skatehive Guide

# Fork Skatehive 3.0 Guide (Beginner Friendly)
This guide explains how to fork the Skatehive 3.0 repository, run it locally, and optionally enable advanced features.

## 1. Fork the repository on GitHub
1. Sign in to GitHub and visit [`Skatehive/skatehive3.0`](https://github.com/Skatehive/skatehive3.0).
2. Click **Fork** to create your own copy of the repo.
3. Clone your fork:
   ```bash
   git clone https://github.com/<your-username>/skatehive3.0.git
   cd skatehive3.0
   ```
4. (Optional but recommended) keep the original repo as an upstream remote:
   ```bash
   git remote add upstream https://github.com/Skatehive/skatehive3.0.git
   ```
5. Create a feature branch before making changes:
   ```bash
   git checkout -b my-feature
   ```
6. After committing your work, push to your fork and open a pull request.
## 2. Minimal local installation
Skatehive now uses a centralized configuration system where sensible defaults are committed to version control.
1. Copy the example environment file:
   ```bash
   cp .env.local.example .env.local
   ```
2. Edit `.env.local` and set the **only** required variable for basic operation:
   - `HIVE_POSTING_KEY` – your Hive posting key
All other values (Hive tags, app account, theme, URLs, DAO addresses) are pre-configured in `config/app.config.ts`.
3. Install dependencies and start the dev server:
   ```bash
   pnpm install
   pnpm dev
   ```
## 3. Customizing your fork
The application configuration is centralized in `config/app.config.ts`. This file contains:
- `HIVE_CONFIG` – community tags, search tags, default app account
- `DAO_ADDRESSES` – Base Mainnet DAO contract addresses
- `ETH_ADDRESSES` – known Ethereum addresses (multisig, tokens, NFTs)
- `APP_CONFIG` – app name, domain, theme, IPFS gateway, vote weight
- `EMAIL_DEFAULTS` – SMTP configuration defaults
- `EXTERNAL_SERVICES` – DAO GraphQL, Hive signer, signup signer
To fully customize your fork, edit `config/app.config.ts` with your values:
```typescript
export const HIVE_CONFIG = {
  COMMUNITY_TAG: 'hive-your-community',
  SEARCH_TAG: 'your-tag',
  APP_ACCOUNT: 'your-account',
  // ...
};
export const APP_CONFIG = {
  NAME: 'Your Community',
  DOMAIN: 'your-community.app',
  BASE_URL: 'https://your-community.app',
  DEFAULT_THEME: 'your-theme',
  // ...
};
```
Environment variables in `.env.local` are only needed for:
- Secrets (API keys, posting keys)
- Deployment-specific overrides
- Optional feature flags
## 4. Optional advanced configuration
Add these to `.env.local` as needed:
### Supabase / Database
- `NEXT_PUBLIC_SUPABASE_URL`, `NEXT_PUBLIC_SUPABASE_PUBLIC_KEY`, `SUPABASE_SERVICE_ROLE_KEY`
### Web3 / Ethereum
- `NEXT_PUBLIC_WALLETCONNECT_PROJECT_ID`
- `NEXT_PUBLIC_ALCHEMY_KEY`
- `ETHERSCAN_API_KEY`
### Zora
- `NEXT_PUBLIC_ZORA_API_KEY`
### Farcaster Notifications
- `FARCASTER_HUB_URL`
- `FARCASTER_INIT_PASSWORD`
- `ADMIN_USERS`
### Signup / Signer System
- `SIGNER_URL`, `SIGNER_TOKEN`
- `VIP_PEPPER`, `JWT_SECRET`
### Email / SMTP
- `EMAIL_USER`, `EMAIL_PASS`, `EMAIL_RECOVERYACC`
### IPFS / Pinata
- `PINATA_JWT`
See `.env.local.example` for the complete list of optional variables.
EOF