Skip to main content

How to Fork Skatehive 🛹

We are going to make this tutorial to anyone that wants to create his own skatehive powered portal like https://skatehive.app

You are going to have to install some stuff in your machine to get your development enviroment ready.

The code is still a little messy but I invite you to be part of this learning journey with us. This doc will always be updated at: https://docs.skatehive.app

Index​

  • Install Git and set Github account
  • Set up Github SSH Keys
  • Forking the Repository
  • Clone/Download the Repository
  • Download and Install NodeJs
  • Install Yarn
  • Install Dependencies with yarn
  • Change .env variables
  • Run it with yarn dev
  • Made some modification just 4 fun
  • Push your changes to github
  • Putting it online, deploy your version with vercel

Install Git and set Github account​

Download and install Git in your local machine. That will enable you to execute git commands in your terminal, like git clone and other wizardlies

Download Git Learn More about git and its instalation

Create a Github Account​

Just sign up

Set up Github SSH keys​

In order to make the process more smooth we are going to set up an SSH connection by generating SSH keys.

  1. Open you terminal

  2. Type the following command

    use the same email you used to create the github account

ssh-keygen -t ed25519 -C "your_email@example.com"

This creates a new SSH key, using the provided email as a label.

  1. Start the ssh-agent in the background
eval "$(ssh-agent -s)"
  1. Copy the contents of the id_ed25519.pub file to your clipboard

  • For Mac users: pbcopy < ~/.ssh/id_ed25519.pub

  • For Windows users: clip < ~/.ssh/id_ed25519.pub

and give it a Title and paste the contet in Key reference link

Full SSH Tutorial

Fork the repository​

Click Fork Button

reference link

This will create your own version of the repo in your account:

Ok, now you are going to clone the repository of files into your machine, which is basically download the app: 

git clone git@github.com:<your-username>/<your-fork>.git

Now navigate to the cloned repository by: 

cd <your-fork>

In this case, 

cd skateapp

For the next step we are going to need to install some more programs in your machine to complete your enviroment and finally install and run the application.

Download and install Node.Js​

Nothing fancy here, just install and make sure you leave the add to path option marked.

Install pnpm Here or​

npm install -g pnpm

More ways to install Yarn

If you got Nodejs, npm, yarn and weed/coffee you can now install and and run it on your local machine.

Back to Terminal...​

In the repository folder

pnpm i

Note: This command will automatically install all the required JavaScript packages and dependencies for your project, as specified in the package.json file. Yarn will download and configure everything needed to run your Skatehive portal. This step ensures that you have all the necessary libraries and tools in your development environment to build and run the application.

Wait a little, drink some "coffee"...

You should see that when its over:

If you get an error in any step you can throw it in chat-gpt or ask us in skatehive discord and see which one helps you faster

Rename .env.example to .env​

Rename .env.example and choose the hive community you want to get/upload content from/to. For example, if you use hive-173115 you get skatehive, if you use hive-141964 in community field you get surfhive

Now run the application you just installed: 

pnpm dev

Now open https://localhost:5173 and you are going to see the same app as https://skatehive.app

That means that you are running the app using your own computer as a server through the port 5173

You can now try to edit your code in a code editor, I recommend VSCode, but my Jedi Master recommends JetBrains

I usually use code . command in the terminal folder to easily open the folder I am working in VScode

Make a silly change, like change the footer of it.

This project is built with TypeScript and incorporates Chakra UI for the frontend. For Hive-related tasks, we rely on the Keychain SDK and dhive libraries. Additionally, to facilitate interactions with Ethereum, Bitcoin, and various other blockchains, we leverage the capabilities of Pioneer-React.

Stage Changes:

Before sending to github its good to: 

pnpm build:turbo

and test its build locally !

git add .

to prepare your changes for commit.

Commit Changes:

git commit -m "Changed header color".

Commit with a message

Push to GitHub:

git push origin main

Push your changes

Now you can go to your github account and check if the it was updated

Putting your website online​

Go to vercel.com​

  1. Make an account with your github account

  2. Install Github Extension it offers

  3. Select the repository

  4. Click in Deploy

You should see something like this:

You can navigate now to:

https://your-repo.vercel.app

and see your own hive community.

Congrats! That's so cool, you put a permissionless website online! Go show your mama, say that I miss her.