Hello All,
I have developped a small app that use Frappe as CMS and then build the pages using Astro (apparently that was the goto for fast publishing and good SEO).
My use case was that I needed to develop a website to present an app I am currently developing and also that would allow me to create the documentation. Ifitwala Doc, the app, intends to do that and it is for people who have created an Frappe App and want to present it (market it) and have documentation pages. It is a mix of basically Frappe Web Pages and Frappe Wiki but with a unified theme and ASTRO rendered.
It is really build for my own need but I thought some of you might be interested in something similar.
We have few doctypes for the documentation side of things: Documentation, Doc Category and Docs Screenshot (child table to keep track of all images ). On the website side of things, we have a few more doctypes: Ifitwala Web Page, Ifitwala Web Page Section, Feature highlight and Hero block
I have to say that I have developed that using almost exclusively AI. So I’ll be curious if there are obvious shortcomings, big red flags that you see in terms of security, and also server efficiency, or any other blind spot.
After you create pages (documentation or website), you do have at the moment to run the ./deploy_docs.sh script. I’ll change that later but for now it allows me to better track error when building the pages in Astro.
See screenshot below for my chosen color theme.
Documentation Pages
Documentation Main page with cards for each documentation category. The search bar is not yet functional.
All the documentation pages that belong to a certain category
A documentation page. We have added some of our own callout like in quarto for info, tips, warning. ToC on the left side with links.
And for the website, we have the main page with a Hero Block and some feature highlight.
Hero section
And feature section (with lucide icon)
And here is the workspace:
Of course it is very much a work in progress (far from being polished and production ready, just a start I wanted to share).
Feel free to re-use and provide feedback. GitHub - fderyckel/ifitwala_doc: app to create docs for ifitwala_ed