Qards is a blogging platform focused on performance and on closing the gap between content publishers and developers: https://qards.io
Qards has not yet been officially released. Even though the code has been public all this time I am still working on breaking changes. You can deploy it but be advised that certain things might not work at all.
There's nothing to install and you can get started right away by clicking on the "deploy to Netlify" button above.
Qards is using Netlify CMS to create content. For now, this is the only source of content. We have a separate branch with Contentful code but it was put on hold until some features become available on their side.
Netlify CMS will remain the default "manager" of content because it's free and operates by integrating with Gihub. This means that you can run your website completely free and also benefit from a versioned system.
After installing, make sure to invite yourself by navigating to the identity tab. You can try setting up external auth provider such as Github or Google but I didn't have any luck making that work. It's something I have to solve and there's an issue created if you want to track it.
To be able to persist your changes on Github you will also need to enable
Git Gateway by navigating to
Settings > Services. This way, non-Github
users can create and manage content inside Netlify CMS.
Once everything is configured, you can navigate to the url assigned to you
by Netlify and append
/admin/ to it. You can login using your credentials.
How to update
Since we're updating a lot of code quite frequently I advise you to avoid modifying core code (unless you want to part free from Qards of course) so you can upgrade to latest versions easily.
I advise you to fork this repo and then add a new remote to it where you will pull updates from:
git remote add upstream https://github.com/QardsJs/qards
This way you can push custom code into your own repo and still be able to update Qards by issuing:
git pull upstream master which will create a merge between your current
code and what we have in our own repo. You can then push changes into your
own repo with
git push origin master
Where to create custom pages/code/components?
I added a special directory for creating pages and other custom code at
src/app. Custom pages can be added inside
src/app/pages where you will
find an example page. Rename that from
to have the root
/ url path enabled. Our main page does not point to
because we don't want to reserve that route as I'm sure you will appreciate
being in control of it. The Qards main route sits at
src/app you can create your components, pages and whatever else
you need to bring your app to production.
I want to customize Qards and still be able to update
That's easier said than done at this moment. My goal is to give you more tools to customize rather than being forced to change core code and not be able to upgrade because of that. If you feel like something is wrong or should behave differently please open a pull request and we can take it from there. Making Qards more adaptable and configurable is my priority and this is the only way forward because I want projects to be able to upgrade to latest code without too many issues.