Your browser doesn't have JavaScript enabled. Please enable JavaScript or switch to a browser that supports it.

Create Your Own Unblocked Games Site

A complete guide to building your site with GRAPES OS

GRAPES OS is open source and free to use! This guide will walk you through creating your own unblocked games website using our codebase. No advanced coding skills required.

📋 What You'll Need

  • GitHub Account — Free account at github.com
  • Text Editor — We recommend VS Code (free)
  • Git — Download from git-scm.com
  • Basic HTML/CSS knowledge — Helpful but not required
💡 New to coding? Don't worry! This guide is beginner-friendly. We'll walk you through each step.

🚀 Step-by-Step Guide

1Fork the Repository

"Forking" creates your own copy of GRAPES OS that you can customize.

  1. Go to github.com/grapes-os/grapes-os.github.io
  2. Click the "Fork" button in the top right
  3. Choose your account as the destination (this creates yourusername/grapes-os.github.io)
✅ Success! You now have your own copy of the GRAPES OS codebase.

2Rename Your Repository

Give your site a unique name.

  1. Go to your forked repository on GitHub
  2. Click "Settings"
  3. Change the repository name to yourusername.github.io (replace "yourusername" with your actual username)
  4. Click "Rename"
💡 Why this name? GitHub automatically hosts repositories named username.github.io as websites at that URL!

3Enable GitHub Pages

Make your site live on the internet.

  1. In your repository, go to "Settings"
  2. Scroll down to "Pages" in the left sidebar
  3. Under "Source", select "main" branch
  4. Click "Save"
  5. Wait 1-2 minutes, then visit https://yourusername.github.io
🎉 Your site is live! You now have a working unblocked games website.

4Clone to Your Computer

Download the code so you can edit it locally.

git clone https://github.com/yourusername/yourusername.github.io.git
cd yourusername.github.io

5Customize Your Site

Make it your own! Here are the key files to edit:

index.html

Main homepage. Change the title, description, and hero text.

about.html

About page. Update with your site's story and mission.

assets/css/main.css

Styling. Change colors by editing the --primary-color variable.

assets/img/grapes_mascot.png

Logo. Replace with your own logo image.

README.md

Update with information about your site.

assets/js/index.js

Footer content. Update site name, stats, and links.

6Push Your Changes

Upload your customizations to GitHub.

git add .
git commit -m "Customized my site"
git push origin main

Wait 1-2 minutes and your changes will appear at https://yourusername.github.io

🎨 Customization Ideas

Change Colors

Edit assets/css/main.css and change the color values:

:root {
  --primary-color: #0066ff; /* Change to your color */
  --accent-color: #00ff00; /* Change accent color */
}

Change Site Name

Search and replace "GRAPES OS" with your site name in:

  • index.html
  • about.html
  • assets/js/index.js
  • All meta tags

Custom Domain

Want a custom domain like mygames.com?

  1. Buy a domain from Namecheap, Google Domains, etc.
  2. Add a CNAME file to your repo with your domain
  3. Configure DNS settings ( GitHub guide)

⚠️ Important Notes

⚠️ Copyright
While GRAPES OS's code is open source, game content may have different licenses. Always respect copyright and licensing terms.

📚 Additional Resources

GitHub Pages Docs

Official documentation for hosting on GitHub

HTML & CSS Tutorial

W3Schools — Free web development tutorials

Git Tutorial

Learn Git basics for version control

VS Code Tutorial

Getting started with Visual Studio Code

💬 Need Help?

If you get stuck or have questions:

💡 Pro Tip: Start small! Get the basic site working first, then gradually add your own features and customizations.

🎉 What's Next?

Now that you have your site, here are some ideas:

  • 🎮 Add your favorite games
  • 🎨 Create a unique design and color scheme
  • 📱 Share on social media
  • 👥 Build a community around your site
  • 🔧 Add new features and functionality
  • 📊 Track your site stats with Google Analytics
🌟 Share Your Creation!
Built something cool? We'd love to see it! Share in our Discord community.
View on GitHub Back to GRAPES OS