Case Study

What I learned building a small website with AI: the WordRanger experiment

August 25, 2026 · 12 min read
← Back to blog

WordRanger started as a fairly simple idea: build a focused word-finding site, add useful supporting articles, and keep the whole project small enough for one person to understand and maintain.

The website itself was the easy part. The learning curve appeared after the first version worked.

That distinction matters because “build a website with AI” can sound as though the hard work ends when the page appears in a browser. In practice, AI made it possible to build without a traditional software-development background, but publishing and operating the site introduced a second set of skills: GitHub, deployment, automation, Search Console, structured data, canonicals, sitemaps, and troubleshooting.

The main lesson: AI lowered the coding barrier. It did not remove testing, judgment, or the need to understand enough of the system to tell when something was wrong.

What WordRanger was meant to do

WordRanger is a focused word tool with supporting content. That made it a good beginner project because the purpose was easy to describe and the site did not need accounts, payments, a database, or a complex content-management system.

A small static site also has fewer moving parts than many traditional websites. The browser can load ordinary HTML, CSS and JavaScript files directly, while a service such as Cloudflare Pages handles hosting and deployment.

That simplicity is real. It is also incomplete. Once the site needed regular article publishing and search visibility, operations became more important.

What was easier than expected

1. Building the first useful version

AI could generate and revise HTML, CSS and JavaScript, explain unfamiliar code, and help turn a plain idea into a working site. Instead of learning an entire programming language before starting, I could work toward one concrete result and ask questions as problems appeared.

2. Making visual changes

Changing button text, spacing, navigation or article layout was usually a small edit. The useful part was not just getting replacement code. AI could also explain where the styling lived and why a particular change affected the page.

3. Static hosting

Publishing a static site on Cloudflare Pages was much simpler than managing a traditional server. Once the repository and deployment were connected correctly, normal site updates could follow the same version-controlled path.

Where the learning curve actually appeared

AreaWhat I had to learn
GitHubWhat a repository, main branch, commit and workflow actually mean in a live website project.
DeploymentWhy changing a file in GitHub and seeing the new version online are related but separate events.
Scheduled publishingHow a dated article folder, GitHub Actions workflow and production deploy need to work together.
SearchWhy submitting a sitemap does not guarantee indexing and why Search Console statuses require interpretation.
Technical SEOHow canonical URLs, structured data, titles, internal links and sitemap entries help describe the site consistently.

The scheduled-publishing problem was a useful failure

One of the most instructive parts of the WordRanger build was article scheduling. The idea sounded straightforward: place an article in a dated folder, let GitHub Actions check the date, move the file into the public blog folder, and deploy the site.

Then a scheduled run did not happen when expected.

Running the workflow manually helped separate two questions: did the publishing logic work, and did the scheduled trigger run? Those are not the same problem. A workflow can work perfectly when started manually and still have a scheduling issue.

GitHub's own documentation warns that scheduled Actions can be delayed during periods of high load, especially around the beginning of an hour, and that under sufficiently high load some queued jobs may be dropped. Scheduled workflows also run from the default branch. That means a missing run is something to investigate, not immediate proof that the article or YAML is broken.

What AI did well

What AI did not eliminate

The search lesson: technical setup is necessary, but not the whole job

WordRanger also reinforced a basic indexing lesson. A sitemap can help Google discover URLs, but Google explicitly says that sitemap submission does not guarantee crawling, indexing or ranking. A new site may simply need time, and individual pages still need to be technically eligible and useful enough to justify indexing.

That led to a more complete audit process: technical SEO, search intent, query coverage, original usefulness, and a human-writing review. Fixing canonicals or structured data is worthwhile, but neither can turn a replaceable article into a distinctive one.

What I would do differently on the next small site

  1. Use GitHub from the beginning. Moving from local files to a repository later added an extra migration step.
  2. Set up one deployment path. I would decide early which branch represents production and how changes reach the host.
  3. Add the sitemap generator before the article library grows. Manual sitemap editing is easy to forget.
  4. Create an article template with canonical and structured-data fields already included.
  5. Test scheduled workflows manually before trusting the schedule. A manual dispatch is a useful check of the publishing logic.
  6. Keep the first site narrow. The manageable scope made it possible to troubleshoot without needing to understand an enormous codebase.

Would I use AI to build another site?

Yes, but with different expectations.

I would not describe the process as “AI builds the website for you.” A more accurate description is that AI can act as a technical collaborator that lets a motivated beginner do work that previously would have required much more coding experience.

The trade-off is that the beginner still becomes the operator. When the scheduler fails, Google does not index a page, or a deployment behaves differently than expected, somebody has to investigate. AI can help with that investigation, but the project still benefits from a human who understands the goal and checks the result.

If you are building your first small site: choose a project simple enough that you can understand the whole publishing path. The learning is much more valuable when you can connect each error to a system you actually use.

References

Research the idea before building the system

GetNicheIQ helps you pressure-test a niche before you spend weeks building around it.

Validate a niche →