Live data from Hacker News

Show HN: I’m building open-source headless CMS for technical content

vrite.io

1–10 of 54 posts

Show HN: I’m building open-source headless CMS for technical content

#1
In the last few years I've been doing a lot of technical writing, both for my own programming blog and others, and I've noticed there is a lack of good tools for this kind of writing.

Whether that was a programming blog post or documentation, I always had to move back an forth between different editors, and sometimes even other apps for content management and the actual content publication. A lot of copy-pasting, and wasted time.

Based on this experience I decided to try and build a tool that could provide a good experience for this kind of content from writing to publishing. This (I call it Vrite) ended up being essentially a headless CMS, but optimized for technical content and a pretty unique one overall, I'd say.

I tried to combine what can be seen as 3 separate products into one: - WYSIWYG editor (with the addition of code-specific tooling like code editor or formatter) - Kanban dashboard (inspired by my experience of tools like Trello used in larger technical content teams to manage content production process) - The actual headless CMS (content delivery via API, integrations, etc.)

Most recently I decided to open-source it and see if there's any interest in such a tool. Right now the primary focus was my personal use-case (kind-of "promotional" technical writing seen in programming and start-up blogs), but I think, with more customization, something like this could extend to the documentation space and make writing and managing docs a lot easier.

Let me know what do you think about this.

Show HN: I’m building open-source headless CMS for technical content
vrite.io

Re: Show HN: I’m building open-source headless CMS for technical content

#2
FYI, you have to sign in to try out Vrite (easiest through GitHub) but, for the purpose of this post, you can use the following credentials for a quick demo (at https://app.vrite.io):

Email: hello@vrite.io

Password: Hello_2023

Please keep it safe and sane there :) The account will be reset every few hours.

You'll likely also want to read the usage guide before jumping in: https://docs.vrite.io/getting-started

Re: Show HN: I’m building open-source headless CMS for technical content

#4
> I always had to move back an forth between different editors

Yeah, that sucks, it's much easier when you can do everything in VSCode/emacs/vim and don't have to leave your dev environment to write about what you're developing…

> WYSIWYG editor (with the addition of code-specific tooling like code editor or formatter)

…wait, what?

> Kanban dashboard (inspired by my experience of tools like Trello used in larger technical content teams to manage content production process)

But if I'm a lone dev, I have a personal kanban already to cover other things that aren't technical writing, and if I'm in a content team I have a full-blown kanban tool that handles multi-platform publishing. That often includes non-text content, so I wouldn't want to trade that tool for vrite either.

> The actual headless CMS (content delivery via API, integrations, etc.)

If there is to be any point to this, it better have really good integrations into existing documentation solutions.

Yet vrite's own technical documentation ist just outsourced to swagger's online service?

And it's not even good documentation: No description of possible errors, very little to no end point description, no description of what parameters do (or sometimes even are), … I don't think this is a good example for what the future of documentation should be.

Re: Show HN: I’m building open-source headless CMS for technical content

#5
post #4

> I always had to move back an forth between different editors Yeah, that sucks, it's much easier when you can do everything in VSCode/emacs/vim and don't have to leave your dev environment to write about what you're developing… > WYSIWYG editor (with the addition of code-specific tooling like code editor or formatter) …wait, what? > Kanban dashboard (inspired by my experience of tools like Trello used in larger tech…

> If there is to be any point to this, it better have really good integrations into existing documentation solutions.

I'm still trying to understand this product, but it looks like this might be it's best 'feature'. For example writing all your technical Blog posts in `vrite` instance, maybe have a backlog of them managed through the kanban board, and then be able to publish them directly to Medium for example, or codecademy etc.

Not particularly useful to me, but I will play around with local deploy and see if im missing something else.

Re: Show HN: I’m building open-source headless CMS for technical content

#7
post #4

> I always had to move back an forth between different editors Yeah, that sucks, it's much easier when you can do everything in VSCode/emacs/vim and don't have to leave your dev environment to write about what you're developing… > WYSIWYG editor (with the addition of code-specific tooling like code editor or formatter) …wait, what? > Kanban dashboard (inspired by my experience of tools like Trello used in larger tech…

Yeah, the documentation aspect is something that I started thinking about recently. That's why, currently, Vrite is more optimized for programming/developer marketing blogs rather than documentations. I'm working on proper API docs (Swagger is pretty much a better-than-nothing placeholder), these wouldn't be served by Vrite.

In basically all technical marketing teams I've worked in, things weren't as automated as you might think. Kanban was only there to manage content production stages, while the actual content was to be written in the Dropbox Paper, Notion, GDocs, etc. just to be able to collaborate and go through the review process. In the end the content had to be copy-pasted to WordPress, Ghost, etc. in an entirely manual process with many formatting issues happening in the process.

In environment you're describing Vrite would indeed be a much "harder sell". Making users move to new tool is difficult in general. That said, with proper integrations and import tools, Vrite could be an "incrementally-adoptable" CMS, that you can transition to at your own pace.

Re: Show HN: I’m building open-source headless CMS for technical content

#8
I like the approach you've taken here where it's more of the complete content production and publishing service.

Two things I couldn't really sort out from your docs or the site:

1. Is there support for uploading images? How is that handled?

2. Is there support for "table" data. An example: I'd like to have my headless CMS keep a list of conferences with fields for start_date, end_date and other attributes and then reference that in my site.

Thanks!

Re: Show HN: I’m building open-source headless CMS for technical content

#9
post #5
post #4

> I always had to move back an forth between different editors Yeah, that sucks, it's much easier when you can do everything in VSCode/emacs/vim and don't have to leave your dev environment to write about what you're developing… > WYSIWYG editor (with the addition of code-specific tooling like code editor or formatter) …wait, what? > Kanban dashboard (inspired by my experience of tools like Trello used in larger tech…

> If there is to be any point to this, it better have really good integrations into existing documentation solutions. I'm still trying to understand this product, but it looks like this might be it's best 'feature'. For example writing all your technical Blog posts in `vrite` instance, maybe have a backlog of them managed through the kanban board, and then be able to publish them directly to Medium for example, or co…

That's basically the idea. Currently most useful when you're running a technical/developer marketing blog.
Post reply on HN