Get Started

Before You Begin

Setting up a poko website is straightforward, but you'll need to be comfortable creating accounts and navigating web service settings. If you've set up a GitHub repository or configured hosting before, you'll be fine.

Time required: ~15-30 minutes for first-time setup

What you'll need:

• A GitHub account (free)
• A Cloudflare Pages account (free) or other static hosting provider
• Your domain name (optional, can add later)

Setup Guide

Detailed step-by-step instructions coming soon.

Overview of the process:

1. Fork the poko website builder repository on Github.

• ℹ️ What is a 'Fork'?
• ⚡️ Quick link: Fork m4rrc0/poko-website-builder

2. Create a new fine-grained Github personal access token

• ℹ️ What is a 'Personal Access Token' on Github?
• ⚡️ Quick link to a pre-filled token creation form
  • If you forked the repository inside an organization, change the Resource Owner to match your organization name
  • Feel free to set an expiration date or restrict the Repository access to specific repositories
• Copy the token value and save it in a safe place (like a password manager)
  • ⚠️ Do not share this token with anyone
  • ⚠️ You will not be able to read the token from Github after you leave the page (you can always create a new one though)

3. Create a new project on Cloudflare Pages from the forked repository

• ⚠️ Make sure you are using a 'Pages' project, not a 'Workers' project
• Choose 'Import an existing Git repository'
• Select the forked repository as the source
• Choose a 'production' branch (usually main)
• Configure the build settings:
  • Build command: bun run cf-build
  • Publish directory: dist
• Click 'Create project' and wait for the first build to finish (~30 seconds)

4. Connect to the CMS

• Find the URL of your Cloudflare Pages project (e.g. https://project-name.pages.dev)
• Open the URL in your browser and add /admin to the end (e.g. https://project-name.pages.dev/admin). You should see the CMS login screen.
• Choose 'Sign in with GitHub Using a PAT' and enter the token you created earlier
• The page should reload and you should be logged in
• Note: The token is saved in your browser's local storage so you won't have to enter it again in that browser. But you will need it again if you sign in from another device or browser.

5. Start editing your content

• On the first load (and only then), you will only be able to edit your 'Global Settings'. Fill in the required fields and save. You will need to wait for your site to re-build before you can see the changes.
• You can now explore the CMS interface to edit your content.
• Check out our User Guide for more information. (Coming soon)

Video Walkthrough

Video tutorial coming soon to guide you through the entire setup process.

Next Steps

Once your site is up and running:

• Explore the CMS interface to edit your content
• Customize your design and branding
• Add pages and create your site structure
• Check out our User Guide and Documentation for more information. (Coming soon)

Need Help?

Stuck on something? Here are your options:

• Professional setup: Contact us for hands-on assistance
• Community support: Join our GitHub discussions

Want to help us?

Give us a Star on Github

We're always looking for help with testing, documentation, and community support. If you're interested, please reach out by email or come discuss on Github.

Want to work with us?

If you are a freelancer or agency looking for a website builder to offer to your clients, we'd love to hear from you! Contact us right away.