Skip to content

Latest commit

 

History

History
30 lines (27 loc) · 2.87 KB

getting-started.md

File metadata and controls

30 lines (27 loc) · 2.87 KB
Raw

Getting Started

If you want to learn the tools and resources necessary to be successful at this hackathon, consider attending one or more workshops to level up your skils. Here are some tools and resources to help you get started:

Docs

  1. Beginners: Thinking in React
  2. Beginners: ES6 Guide
  3. Beginner - Advanced: Official React Docs
  4. Intermediate: Official Redux Docs
  5. Advanced: Intro to Reactive Programming
  6. Advanced: RxJS Exercises

Boilerplates

Boilerplates are great to get started, and to learn how someone uses certain tech and architects in a specific way. However, since you didn't make these choices on your own, you lose the education of why someone chose to build their app in this manner, and it may actually slow you down or frustrate you in the long run.
TLDR: Boilerplates are great for hackathons, bad for production. Use with caution.

1. Create-React-App

This is the official boilerplate created by members of the React Core Team at Facebook with the help of open-source contributors. It is the easiest of all boilerplates, as it hides most of the configuration files to narrow your focus. You can get started in the CLI with:

npm install -g create-react-app
create-react-app my-app
cd my-app/
npm start

Create-React-App helps you to create a React project without worrying too much about configuration. To customize your boilerplate, you can "eject". Learn more about this and other features of create-react-app here https://github.com/facebookincubator/create-react-app

2. React Static Boilerplate

We recommend this boilerplate, or something similar, especially if you're looking to use the APIs Serverless and Netlify.
As with any boilerplate, it is opinionated. Fortunately the docs have descriptions and benefits of each of these choices, and you can easily change them, if you know what you're doing. If you're not comfortable with ES6, configuring webpack, architecting a React app, or controlling state with Redux, we recommend that you sign up for one of our workshops.

3. GraphQL Hackathon Kit

If you've been itching to try out GraphQL, this kit gives you a create-react-app client and GraphQL server to start playing around with. The kit includes information in the READMEs about how the different components fit together, and how you can extend them to build the hackathon app of your dreams.