search

gatsbyjs / gatsby

The best React-based framework with performance, scalability and security built in.
https://www.gatsbyjs.com
MIT License
55.26k stars 10.32k forks source link

New themes/example sites for 1.0 #447

Closed KyleAMathews closed 6 years ago

KyleAMathews commented 8 years ago

Currently we have three starters which also serve as examples. Once a theme system lands, we'll be converting starters to themes. We should create more themes + example sites to demo what you can do with Gatsby especially new capabilities coming with 1.0.

What sort of sites should we build? Add in the comments some of your favorite sites to copy or open source themes we should port over. Also crazy stuff that'd really push Gatsby. Animations, client-side interactivity, examples of pulling in code from the wider React ecosystem, etc.

KyleAMathews commented 8 years ago

Here's a list I've been accumulating:

KyleAMathews commented 8 years ago

Once an alpha or two more has been released and things are fleshed out a bit more and more usable I'll start building these and putting them in an examples folder. Please volunteer to take one from my list or one of your own!

fk commented 8 years ago

I would love to help out here, but I think both time and my limited React knowledge would cause me to be more of a pain than a help.

I loved discovering the reference to https://www.atlassian.com/git/ in the original "Braindump of Ideas" issue and if something like "Low Hanging Animation Options" or a basic implementation example in one of the starters would have existed back when I first stumbled across Gatsby, I would most probably have started using it for some of the static site stuff I have been building in the meantime…

Since I do not really have something valuable to add here, let me close by stating that seeing this issue and the roadmap for 1.0 are great (great!) news, especially when seen from a "user" instead of "developer" perspective!

KyleAMathews commented 8 years ago

@fk thanks for the validation on this issue! And I think you will quite easily be able to help. The theme system in Gatsby will be composable meaning someone can publish a theme and you'll be able to easily remix it into something similar but different or the same but extended. So it should be fairly easy to come up with compelling but unique themes in the future.

My first goal with these examples (and eventually themes) is to push the boundaries of Gatsby to make sure we can do these types of sites. But later, once the technical foundations of Gatsby are solid, there'll be lots of theme exploration to do.

fk commented 8 years ago

And I think you will quite easily be able to help.

Yay! I'd be happy to give things a try, and I'm sure I will do sooner or later! However I think I won't be of any help for issues like the aforementioned https://github.com/gatsbyjs/gatsby/issues/429 until my React-foo improves drastically – which I would love to.

This might be a stupidly vague question, but: Is there are starter you would recommend to take a closer look at for now – without composable themeing yet working – to sharpen my understanding of React in general as well as extending the default Gatsby behavior?

KyleAMathews commented 8 years ago

Have you looked through the starters on the README? The blog starter might be a good place to start as it's focused and simple.

I'd start by looking first in the /pages directory then the /wrappers directory (these are React.js components that wrap static pages like markdown), and then finally the html.js. You can read the code and then explore the different imports and go read up on what they do.

codinronan commented 7 years ago

Hey @KyleAMathews do you have any documentation of any kind on how to build a theme? I'm assuming that code is written, just not documented... possible a bad assumption.

I'll volunteer to build one, I'm building a new site now so it won't be alot of extra effort to learn that too along the way.

KyleAMathews commented 7 years ago

@ronanwize the theme stuff isn't written yet — that's probably going to come post 1.0 release e.g. 1.1 or 1.2.

But in the meantime we have the concept of "starters". Would totally love it if you published one. Starters are pretty simple. They're just a github repo with a partially-built Gatsby site. The Gatsby CLI has support for cloning a repo like this and setting things up for you.

Would love it if you published a new starter. When you do, just add a PR to add your repo to the list here: https://github.com/gatsbyjs/gatsby#gatsby-starters

Once theme support is added, starters can be converted to themes (though there still might be a place for starters even w/ themes, TBD).

codinronan commented 7 years ago

Hey @KyleAMathews sounds good. When I finish the design I'll publish it as a starter!

KyleAMathews commented 7 years ago

@ronanwize great! Great themes/starters really help ease the onboarding for people new to Gatsby.

oliverbenns commented 7 years ago

I think that depends on the future vision of Gatsby. Themes often come about with CMS solutions, of which Gatsby (right now at least), is not.

With that said, I think the demo sites like the current starter one is a great reference point and I used it as a basis to start myself. I'm not sure on the value of having more than 2 or 3 though if we're strictly talking about the education purpose of them.

KyleAMathews commented 7 years ago

@oliverbenns Gatsby's "CMS" is static files :-)

michael-martin-al commented 7 years ago

@KyleAMathews will there be any major differences in starters for 1.0 vs 0.12.x? I am building a starter based on 0.12.x branch, but I could upgrade to have it 1.0 ready.

KyleAMathews commented 7 years ago

@michael-martin-al many things will remain the same — the main differences will be the new plugin system, programmatic routes, and the new graphql data layer. I anticipate/hope that the upgrade path will be fairly straightforward though. I have an idea for a compatibility plugin which emulate the "wrapper" concept in 0.x

I'd build the starter for 0.12.x for now and once the first beta lands, start upgrading then.

Looking forward to seeing your starter!

stale[bot] commented 6 years ago

This issue has been automatically marked as stale because it has not had recent activity. It will be closed if no further activity occurs. Thank you for your contributions.

stale[bot] commented 6 years ago

This issue has been automatically closed due to inactivity.