Gatsby Yuque Starter is a lightweight blog starter that lets you write posts in Yuque and publish them as a Gatsby-powered static site styled with Tailwind CSS.
What is Gatsby Yuque Starter?
Gatsby Yuque Starter is an open-source blog starter template for Gatsby that uses the gatsby-source-yuque plugin to pull documents from the Yuque knowledge base and render them as blog posts. It is built on Gatsby, a React-based static site generator, and uses Tailwind CSS for styling. The project is maintained by Raincal and is distributed as a GitHub repository under the topic "gatsby-starter". A new site is created with the command gatsby new my-blog-starter https://github.com/Raincal/gatsby-yuque-starter, and development begins with gatsby develop, which serves the site at http://localhost:8000 and exposes a GraphiQL data explorer at http://localhost:8000/___graphql.
Key Features
- Yuque content source — blog posts are created from Yuque documents through the gatsby-source-yuque plugin, so writers never leave Yuque to update their blog.
- Tailwind CSS styling — the starter ships with Tailwind CSS for utility-first styling, configured for custom design.
- RSS feeds — built-in RSS generation lets readers subscribe to your posts.
- Offline support — the blog becomes available offline via service worker support (part of Gatsby's PWA capabilities).
- Web App Manifest — the site can be installed as a web app with a manifest file.
- Google Analytics support — integrated Google Analytics for visitor tracking.
- Netlify deployment — the README includes a one-click Deploy to Netlify button pointing at the repository.
Who is it for?
- Writers using Yuque — create and manage content in Yuque, and publish it to a standalone blog without manual copying.
- Gatsby developers — want a minimal, cleanly structured blog starter to customize; the quick start shows exactly where to edit the main page (src/pages/index.js).
- Indie bloggers / technical writers — can set up a blog with RSS, offline support, and analytics in a few steps.
What can you do with Gatsby Yuque Starter?
- Yuque-based blogging: write in Yuque, then build and deploy your blog; the site re-fetches Yuque content at build time.
- PWA blog setup: take advantage of offline support and Web App Manifest to give visitors an app-like reading experience.
- Learning Gatsby: use the starter to explore Gatsby's development loop, GraphiQL query tool, and plugin ecosystem.
How does the starter work?
- Create a new Gatsby site with
gatsby new my-blog-starter https://github.com/Raincal/gatsby-yuque-starter. - Run
gatsby developto start a local development server athttp://localhost:8000. - Edit
src/pages/index.jsto customize the homepage; the browser hot-reloads. - When ready, build and deploy — a Netlify deploy button is included in the README.
FAQ
Does the starter support RSS feeds?
Yes, RSS feeds are one of the listed features, so readers can subscribe to your blog's new posts.
Can I use the starter for free?
The starter is available as a public GitHub repository, so you can clone or use it with the Gatsby CLI at no cost.
What does the starter use for styling?
It uses Tailwind CSS, which is listed as one of the template's core features.
How do I write posts?
You write posts in Yuque; the gatsby-source-yuque plugin then imports your Yuque documents into Gatsby at build time, turning them into blog posts.
Does it work on Netlify?
Yes, the README includes a Netlify deployment button that sets up the repository.
