Both gatsby and next.js as well as other open source projects have an
/examples folder at the root of the repo, showing off various setups and combining them with other tools. Example:
We also have an “examples” folder but there are 2 problems with it, I think:
The examples in the folder do not have any JS/TS files. This is because both the
twentytwenty-theme-examplelink to their respective theme files located in
I think this is very confusing for new users as the vast majority of devs are not familiar with
lernaand monorepos. It makes it seem like the examples are incomplete or at best difficult to understand.
Because of that, the examples also look different than what you get if you just run
npx frontity create <my-app>. If you run that, your starter theme is “copied” into your machine and you can go ahead and edit it.
I propose that we create self-contained examples in the
/examplesfolder that do not depend on anything in the
/packages. Then, we could move the current examples to another folder like
/dev-examples(or some better name) so that we can continue to develop our themes against the latest version of the framework as we have so far.
Currently we only have 3 examples whereas next / gatsby have in the order of a 100 examples each . I know that each theme contains many use cases, but I would suggest moving some of the examples from the
frontity-demosrepo into the
examplesfolder. Those should have proper READMEs and
As a bonus, I believe this doing this would make our examples more accessible and reduce the amount of repetitive questions on the forum about common problems.