Skip to content

docs(seo): upstream-query landing page + migration guide + comparison post#675

Merged
vieiralucas merged 2 commits intomainfrom
content/upstream-seo-batch1
Apr 22, 2026
Merged

docs(seo): upstream-query landing page + migration guide + comparison post#675
vieiralucas merged 2 commits intomainfrom
content/upstream-seo-batch1

Conversation

@vieiralucas
Copy link
Copy Markdown
Member

@vieiralucas vieiralucas commented Apr 22, 2026

Summary

Batch 1 of the upstream-query SEO/LLM visibility push. Targets the `localstack free alternative` / `replace localstack` / `localstack not free anymore` query cluster that is spiking post-paywall with no dominant canonical winner yet.

  • New landing page /localstack-alternative/ — non-dated, keeps current. Hero + FAQ block seeded with quotable numbers (23 services, 1,680 ops, 54k Smithy test variants, 6 SDK languages) for LLM citation density.
  • New blog post /blog/migrate-from-localstack/ — step-by-step migration w/ copy-paste configs for docker-compose, GitHub Actions, Terraform, CDK, Serverless Framework.
  • New blog post /blog/localstack-alternatives-compared/ — honest fit-based comparison across fakecloud, MiniStack, floci, Moto, LocalStack Pro. No fabricated benchmarks; positioning and architecture only.
  • README — added "Common use cases" table mapping upstream queries (test Lambda locally, mock DynamoDB, fake AWS server, Moto equivalent for Go/Java/Node, integration test AWS in GitHub Actions, etc) to copy-paste commands.
  • Homepage — stats refreshed to current numbers (23 services / 1,680 ops / 6 SDKs, Bedrock and API Gateway v2 rows added to compare table).
  • New template `page.html` for non-dated landing pages (no author/date chrome, unlike blog posts).

Existing `/blog/localstack-alternative/` post left untouched per the "blog posts are point-in-time" rule. The new `/localstack-alternative/` page is a living landing page at a different URL.

Dev.to cross-posts and awesome-list PR bodies are staged locally in `marketing/` (gitignored as usual) for manual publication.

Test plan

  • `zola build` succeeds locally (52 pages, 0 orphan)
  • New pages render at expected paths: `/localstack-alternative/`, `/blog/migrate-from-localstack/`, `/blog/localstack-alternatives-compared/`
  • CI green
  • Merge and wait for fakecloud.dev to deploy; then spot-check the three URLs live
  • Dev.to cross-posts published under Lucas's account (manual)
  • Awesome-list PRs opened (manual, bodies drafted in `marketing/awesome-list-prs.md`)

Summary by cubic

Adds a new LocalStack-alternative landing page and two guides to capture “localstack free alternative/replace localstack” traffic. Also refreshes homepage stats, expands the README with common use cases, and adds a template for evergreen landing pages.

  • New Features

    • New landing page: /localstack-alternative/ with current stats and FAQ.
    • New guide: /blog/migrate-from-localstack/ with copy-paste configs for docker-compose, GitHub Actions, Terraform, CDK, and Serverless Framework.
    • New comparison post: /blog/localstack-alternatives-compared/ (fakecloud, MiniStack, floci, Moto, LocalStack Pro).
  • Site Updates

    • Homepage numbers and compare table updated (23 services, 1,680 ops; added Bedrock and API Gateway v2 rows; added EventBridge Scheduler tile).
    • README gains a “Common use cases” table with commands and links to guides.
    • New page.html template for non-dated landing pages.
    • Docs polish: fixed Serverless Framework example to use AWS_ENDPOINT_URL in the migration guide; removed curl|bash install snippet from the comparison post links in favor of install docs.

Written for commit 6ffb2c0. Summary will update on new commits.

- New landing page /localstack-alternative/ targeting "localstack free alternative",
  "replace localstack", "localstack not free anymore" with current numbers (23
  services, 1,680 ops, 6 SDKs) and an FAQ block to seed LLM citations.
- New blog post /blog/migrate-from-localstack/ with copy-paste configs for
  docker-compose, GitHub Actions, Terraform, CDK, Serverless Framework.
- New blog post /blog/localstack-alternatives-compared/ with an honest fit-based
  comparison across fakecloud, MiniStack, floci, Moto, LocalStack Pro. No
  fabricated benchmarks -- positioning + architecture only.
- README "Common use cases" table maps upstream queries (test Lambda locally,
  mock DynamoDB, fake AWS server, Moto equivalent for Go/Java/Node, integration
  test AWS in GitHub Actions) to copy-paste commands.
- Homepage hero + features + compare table refreshed to current numbers
  (23 services / 1,680 ops / 6 SDK languages, Bedrock and API Gateway v2 rows).
- New page.html template for non-dated landing pages (no author/date chrome).
@codecov
Copy link
Copy Markdown

codecov Bot commented Apr 22, 2026

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!

Copy link
Copy Markdown

@cubic-dev-ai cubic-dev-ai Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

3 issues found across 6 files

Prompt for AI agents (unresolved issues)

Check if these issues are valid — if so, understand the root cause of each and fix them. If appropriate, use sub-agents to investigate and fix each issue separately.


<file name="website/content/blog/migrate-from-localstack.md">

<violation number="1" location="website/content/blog/migrate-from-localstack.md:216">
P2: The `serverless.yml` example uses an unsupported config shape (`custom.endpoints`), so endpoint override will not actually be applied.</violation>
</file>

<file name="website/content/blog/localstack-alternatives-compared.md">

<violation number="1" location="website/content/blog/localstack-alternatives-compared.md:105">
P2: Avoid recommending `curl | bash` in docs; it executes remote content immediately. Use a download-then-run flow so users can inspect the script before execution.</violation>
</file>

<file name="website/templates/index.html">

<violation number="1" location="website/templates/index.html:51">
P2: The added service list now claims EventBridge Scheduler support, but the page’s Supported services section still omits it, creating inconsistent product coverage messaging on the same page.</violation>
</file>

Reply with feedback, questions, or to request a fix. Tag @cubic-dev-ai to re-run a review.

Comment thread website/content/blog/migrate-from-localstack.md Outdated
Comment thread website/content/blog/localstack-alternatives-compared.md Outdated
Comment thread website/templates/index.html
- Fix invalid serverless.yml custom.endpoints example in migration guide;
  use AWS_ENDPOINT_URL env var, which modern Serverless Framework respects
  via AWS SDK v3 (identified by cubic).
- Drop direct curl|bash install snippet from alternatives-compared links
  section; point to install docs so users can inspect before executing
  (identified by cubic).
- Add missing EventBridge Scheduler tile to homepage services grid to
  match the features list and service count (identified by cubic).
@vieiralucas vieiralucas merged commit 0f42905 into main Apr 22, 2026
17 checks passed
@vieiralucas vieiralucas deleted the content/upstream-seo-batch1 branch April 22, 2026 17:32
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant