Awesome
<p align="center"> <img src="resources/readme/fullstackreact-yelp-clone-tutorial.png" alt="Fullstack React Yelp Clone Tutorial" /> </p>React Tutorial: Build a Yelp Clone
tl;dr - This is the code for our blog post which will guide you through building a full React app, even with little to no experience in the framework. We're going build a Yelp clone in React
See the demo and accompanying blog post.
Let's build a lightweight clone of Yelp using React.
In this tutorial we'll talk about:
- How to setup a new React project from scratch
- How to create a basic React component
- How to write modular CSS using
postcss
- How to setup testing
- How route to different pages with
react-router
- How to integrate with Google Maps
- How to write a Google Maps React component
- How to write a five-star rating component
We'll be tying in a lot of different pieces of React together to build a full-sized React app. This post will guide you through building a full React app, even with little to no experience in the framework.
<p align="center"> <img src="resources/readme/app-screenshot.png" /> </p>Quickstart
First, clone the repository:
git clone https://github.com/fullstackreact/react-yelp-clone.git react-yelp-clone
cd react-yelp-clone
# install the dependencies
npm install
# copy configuration (see below)
cp .env.example .env
# start the server
npm start
Configuring the Application
This app uses dotenv for configuration. In order to configure the application for your own api access, grab an api token from Google here and set it in a file called .env
at the root for a key called __GAPI_KEY__
.
For instance, say that your gapi key is: abc123
. Your .env
file should look like:
GAPI_KEY=abc123
You can also create this file by copying the .env.example
file at the root:
cp .env.example .env
Starting the Application
npm install
npm start
Libraries We'll Use
This app uses the following technologies:
- webpack
- postcss
- hjs-webpack
- react.js
- react-router
- Google Maps API
- google-maps-react npm
- enzyme
- chai
- And much much more
Running the Tests
The application is built using tests, including the fantastic enzyme and chai libraries. To run the tests, use the npm
test script:
npm run test
Check out the blog post for more information on how this app was built and a complete tutorial on using React to build your own apps.
Contributing
git clone https://github.com/fullstackio/yelp-clone.git yelp
cd yelp
npm install
npm start
Fullstack React Book
<a href="https://fullstackreact.com"> <img align="right" src="resources/readme/fullstack-react-hero-book.png" alt="Fullstack React Book" width="155" height="250" /> </a>This app was built alongside the blog post React Tutorial: Cloning Yelp.
This repo was written and is maintained by the Fullstack React team. In the book we cover many more projects like this. We walk through each line of code, explain why it's there and how it works.
This app is only one of several apps we have in the book. If you're looking to learn React, there's no faster way than by spending a few hours with the Fullstack React book.
<div style="clear:both"></div>