Hey Indie Hackers
In my day job, I am a freelance developer working for Meta/Facebook as the Docusaurus maintainer.
It's a quite flexible opportunity (3d/week) and allows me to work on my indie React newsletter (thisweekinreact.com) on the side (2d/week)
We launched v2.0 on Monday on:
It was a big launch for us considering the v2 was being in alpha/beta for... 4 years!
I optimized the launch to perform on Product Hunt, and we got the 1st spot!
Product of the day with 900+ upvotes! (which looks like a great score in August)
If you build a product, make sure to try Docusaurus for your documentation! 👌
You can start very start simple: just write Markdown files. Then it scales with your usage and really permits your docs to respect your product's branding and have a customized design.
Think of it like the Pareto principle: get great results for a minimal effort. IMHO it is perfect for Indie Hackers :)
Some of our best sites:
Some Indie Hackers here already use it! 😏
Why did I choose Monday to launch?
I really wanted Docusaurus to be the product of the day on Product Hunt. I believe it's an awesome doc tool and it's already quite popular in the frontend/React ecosystem but it's not (yet) widely known among product builders from Product Hunt or Indie Hackers/
I choose Monday because I got a commitment from large tech newsletters to cover our launch, and their publication time was a good fit to drive traffic in a very short time to the blog post. And the blog post was driving traffic to Product Hunt (see our blog post)
As you know, for a Product Hunt successful launch you need to collect as much upvotes/comments as possible during a 24h time frame, starting 00:01 PST
I also have my own 10k newsletter (ThisWeekInReact.com) that I would also send at the ideal time: 00:01 PST is the morning in Europe where I have many very engaged subscribers
I was hoping to be featured in TLDR.tech on Monday (300k subs), but it didn't happen as the founder Dan only included us on Tuesday (still awesome 🙌).
I knew that other newsletters would be interested to cover the story, but they were either smaller (React Status, Wednesday, 55k subs), or the audience would be a bit too diverse (JavaScript Weekly, 300k, Friday) and the link wouldn't make the headline. With Bytes + Sidebar both on the same day, it looked really better to launch on Monday.
Of course, I also prepared a Twitter thread (with FeedHive, great indie product!) which also brought a lot of traffic to the blog post + Product Hunt
The Hacker News launch was a flop. After a bad start, I had to link directly to the HN post, and we did reach the front page (apparently direct upvotes still work? 🤔) for a few hours but the mod edited my longer title to just "Docusaurus 2.0" and then nobody cared anymore. Still drove a bit of traffic but I expected more.
In terms of Google Analytics, we can clearly see peaks of traffic that seem related to the publication of large newsletters :)
Some of this traffic would clearly lead to upvotes on Product Hunt, which in turn helped us become the product of the day!
Note: newsletters are not only creating some traffic peaks, but not all subscribers would open the email as soon as they receive it, so it also contributes to good traffic distributed over time!
Considering we launched everything at once, it's hard to know exactly which action lead to which traffic peak so this is only a guess.
I believe a good newsletter timing really helped us become the product of the day, and I would definitively recommend you to try the same strategy:
What's next? In the following days, I continued to reach out to all relevant newsletter authors I know. We still got included in many other newsletters that I contacted, and we continue to receive traffic (React Status, Frontend Focus...).
Now I hope that our launch will also be featured in the largest tech newsletters as well: GitHub, StackOverflow, freeCodeCamp, Smashing Magazine... I pitched them all, and it looks like it could happen, we'll see soon 😉
Let me know if you have any question!
Have a great day indies 👋
Congrats🚀
Thanks 🤗
Cool newsletter strategy @sebastienlorber. Definitely got me thinking a little different about our PH launch. What was the lead time like to connect and agree on a date? Was there any prior connection?
Thanks @ChrisEvans :)
I am a React newsletter author for 2 years now and usually get in touch with other smaller and larger newsletter authors just because I am curious of how things are going in their business. Sometimes we are direct competitors (React Newsletter, React Status, React Digest), but in a friendly way. It does not mean that those newsletters would exclude my story just to block me. And Docusaurus is not directly related to my own React newsletter so including it is not harmful to them.
I did reach out to the newsletters 2 weeks before the launch, to confirm if launching on a Monday was a good choice. Otherwise, I would probably have picked another date like Wednesday (React Status day). I would probably have contacted them earlier if I could: maybe we'd have been featured on TLDR on the PH launch day if I did. I wasn't sure Dan from TLDR would be willing to feature us, so I contacted him only 4 days before and then 1 day before launch => apparently too short.
Also note that the week just before the launch, we weren't 100% sure of launching on 1st August. I'd recommend scheduling your launch and giving you enough time so that you are 100% confident about your launch date. Otherwise, newsletter authors may write your story and then you complicate their life if you decide to postpone it.
Thanks for the detailed response. A lot of great insights in here! Keep charging with the Newsletter!
Congrats. It seems like really well polished project, and good to see it is both sustainable while giving you room for other ventures.
And I'm curious, how do you get a large company to fund such a project? Did you approach them? Or on the other hand did the project start there and you joined as they needed help to keep it alive? Or something else entirely?
Thanks!
The project has always been from Facebook. And it's now considered as one of their most successful open-source project 🤟
They were looking for a better solution to document all their internal and external projects, to focus on content and avoid creating an expensive custom stack everytime.
They started copy/pasting a Jekyll boilerplate but it was not really maintainable, so they created Docusaurus v1 in 2017
I was just lucky and joined the v2 project in 2020 as a contractor, thanks to Twitter 😄 At that time 2 Meta employees kind of left the project (one died 😢)
More personal details in my React newsletter
https://www.getrevue.co/profile/thisweekinreact/issues/this-week-in-react-114-official-launch-of-docusaurus-2-0-1273933
Thanks a lot for sharing this, really appreciate. Both tragic and fascinating.
Congratulation!
I voted on Product Hunt :)
Thanks @marta_tasks_ninja :)