This project is an application skeleton for a typical React project. It comes bundled with Material-UI, Firebase, and React Router. With Create React App at its core, you can use it to bootstrap your projects and development environment with the same tooling.
React + Material-UI + Firebase comes with a bunch of development and testing tools for instant web development gratification.
- Bootstrapped with Create React App, the same tooling works out-of-the-box
- Scaffolding incorporates Google Material Design principles through Material-UI
- Built on top of Firebase with authentication working from the start
- Robust routing with React Router including error handling (404)
- Extensive mobile support with react-swipeable-views for tabs
Want to see it in action? Take a look at the demo.
You'll need to have Node 8.10.0 or later on your local development machine (but it's not required on the server). You can use nvm (macOS/Linux) or nvm-windows to easily switch Node versions between different projects.
npm installyarn installIf you receive a warning like:
Warning: You are attempting to use a basename on a page whose URL path does not begin with the basename. Expected path "/" to begin with "/react-material-ui-firebase".
You may need to adjust the router to use the correct basename. A basename is the base URL for all locations. In most cases you can just remove the basename attribute from the <Router> element in src/App.js.
If you're still having problems you can read more in React Router's documentation.
Making this boilerplate your starting-point requires you changing its name. There are 4 files you'll need to modify to change the name of the project.
- public/index.html
title
- public/manifest.json
short_namename
- src/App.js
settings.name
- package.json
name
By default, React + Material-UI + Firebase uses a demo Firebase project which you can't manage. You need to create a new Firebase project and replace the credentials with your own. You shouldn't use the demo project for anything more than testing as you have no control over it.
When you've created a Firebase project you can copy-paste your credentials into the config object in src/App.js:
const config = {
apiKey: 'YOUR_API_KEY',
authDomain: 'YOUR_AUTH_DOMAIN',
databaseURL: 'YOUR_DATABASE_URL',
projectId: 'YOUR_PROJECT_ID',
storageBucket: 'YOUR_STORAGE_BUCKET',
messagingSenderId: 'YOUR_MESSAGING_SENDER_ID'
};The sample app uses a blue and red color combination with a light theme type. When a user changes the theme, a local storage object will be created and read on startup. You can change the default theme, which is the theme all users will see before changing it themselves, in src/App.js:
const defaultTheme = {
primaryColor: 'your-primary-color',
secondaryColor: 'your-secondary-color',
type: 'your-type'
};
let theme = createMuiTheme({
palette: {
primary: yourPrimaryColor,
secondary: yourSecondaryColor,
type: type
},
typography: {
useNextVariants: true
}
});Remember to follow the proper casing for color names, there are 2 variants: color strings and color imports. Color strings are within quotes and follow kebab-case and imports are ES6 classes and are written in camelCase.
Available colors:
redpinkpurpledeepPurpleindigobluelightBluecyantealgreenlightGreenlimeyellowamberorangedeepOrangebrowngrayblueGray
Available types:
lightdark
In the project directory, you can run:
Runs the app in the development mode.
Open http://localhost:3000 to view it in the browser.
The page will reload if you make edits.
You will also see any lint errors in the console.
Launches the test runner in the interactive watch mode.
See the section about running tests for more information.
Builds the app for production to the build folder.
It correctly bundles React in production mode and optimizes the build for the best performance.
The build is minified and the filenames include the hashes.
Your app is ready to be deployed!
See the section about deployment for more information.
Note: this is a one-way operation. Once you eject, you can't go back!
If you aren't satisfied with the build tool and configuration choices, you can eject at any time. This command will remove the single build dependency from your project.
Instead, it will copy all the configuration files and the transitive dependencies (Webpack, Babel, ESLint, etc) right into your project so you have full control over them. All of the commands except eject will still work, but they will point to the copied scripts so you can tweak them. At this point you're on your own.
You don't have to ever use eject. The curated feature set is suitable for small and middle deployments, and you shouldn't feel obligated to use this feature. However we understand that this tool wouldn't be useful if you couldn't customize it when you are ready for it.
You can learn more in the Create React App documentation.
To learn React, check out the React documentation.
This section has moved here: https://facebook.github.io/create-react-app/docs/code-splitting
This section has moved here: https://facebook.github.io/create-react-app/docs/analyzing-the-bundle-size
This section has moved here: https://facebook.github.io/create-react-app/docs/making-a-progressive-web-app
This section has moved here: https://facebook.github.io/create-react-app/docs/advanced-configuration
This section has moved here: https://facebook.github.io/create-react-app/docs/deployment
This section has moved here: https://facebook.github.io/create-react-app/docs/troubleshooting#npm-run-build-fails-to-minify