Target Beginners // Switch to Docs-First Mentality // Copy Laravel docs strategy // Rename project

[whatnickcodes]

@lukeed,

Cool project! I followed your svelte-worker-ssr demo a while back and some other Svelte stuff before. Super cool you joined Cloudflare and congrats. Rooting for your success here.

I think for this to truly take off, regardless of how awesome you make this code-wise, it needs clear documentation that targets absolute beginners. I think the pros will go elsewhere (for short term at least).

I am flagging this now because I think docs should be rolled out alongside the features you’re adding. And I think the features should start easiest first.

For example, I just want a dead-simple, suggested, and very opinionated solution that someone smarter than me has designed that’s easy to get started on.

So let’s say I want a static website and I want to host on Cloudflare Pages. This isn’t very exciting or groundbreaking. I could use a million tools to generate this.

Now, let’s add just one dynamic route. What if I want to go all-in with Workers? Well, kind of SOL from a getting starting stand point. It’s just one dynamic route, but now I’m using other community frameworks, third party adaptors that might break, the HTML rewriter in a messy file setup I threw together and all sorts of tools to use but not just an easy “here’s a super simple Cloudflare way of project where to put backend logic that meets your front end template”.

The PHP framework Larval comes to mind for something to draw inspiration from. It’s something that goes out of the way for their noobiest customer can pick up and do just basic routing to full blown crazy web apps. In fact, setup is just like 2 routes I think until you add on.

Check out their documentation and getting started process (yes, php); https://laravel.com/docs.

They have clean and easy explainers for everything. The code is painfully simple. This is a route code sample. This is a dynamic route code sample. This is a 404 route code sample. This is authenticated route code sample. This is POST example with formData. Etc…

It’s not “production-sass” demo that I think Worker audience needs and instead is a “Cloudflare-official-worker-app-starter”. Hopefully you see my point I am trying to make.

Just my annoying thoughts on direction you all are going. Congrats again. You’re a legend and excited to see your work!