I like short
README's so here we go 😎
Just run this command:
npx create-react-app test-app --scripts-version rmw-react-scripts
Here you go DEMO. The DEMO is just a DEMO. It has no real purpose "to do" some usefull stuff. Just to show you what your project could look like.
React Most Wanted is a react Starter Kit based on Create React App and Material-UI that uses Firebase.
Check this out:
- it is build with CRA and even if you use this Starter Kit your CRA scripts will work properly. You will be able to make every CRA update as if you have started with it. We don't eject anyone from CRA 😄
- it is based on a library rmw-shell witch keeps your project up to date when we make bugfixes or add new features. It is like a
shell
for your project where the hard work is already done for you. - there is a simple script to start a fresh project without forking anything
npx create-react-app test-app --scripts-version rmw-react-scripts
- it has all "MOST WANTED" features build in. That is where the name comes from 😉 We come to the features a little bit later.
- it is customisable
- it uses Firebase 😄
- it is Best Practice Project PWA (Progressive Web Application)
- you will love it once you start using it 😄
Let's take a look at some of them:
- Material UI
- code splitting
- redux implementation
- firebase to redux sync
- authentication
- authorisation
- push notifications UI integration
- theming
- internationalisation
- build in CI (Continuouos Integration)
- build in CD (Continuouos Deployment)
- realtime forms (isn't that awesome 😄 )
- ... and lot more I just can't remember
Sure. It is a project made over years and still fully supported. Reason for that is that we use it in our company for production projects so it has to work for at least some years. Good enough for the JavaScript ecosystem 😉
The informations you are seeking are skatered over some Medium articles writen by me at the time I was working on solving some problems in this project. So they should explain some core parts in detail:
- Beyond create-react-app
- Organising your Firebase CLoud Functions
- Firekit concepts to sync Firebase and redux
- Firebase and react Continuous Deployment
- Redux simple values
- React Most Wanted
Nice project and easy to start but it starts with the React Most Wanted Firebase project. How can I make it my? We got you covered 😄 First install the firebase CLI tools and sing in to firebase over them. More about that here. After we have them installed and are signed in just run this command in the project folder:
firebase use --add
After that you can select a project from all of your firebase projects. If you don't have one create it 😉
After selecting one you will be asked to add an alias
for your selected project. This is very importand! To add a project that will start only in development we add the alias dev
and for a project that will start only in production we run the same command but add the production project and use the alias prod
. Just to get all covered I prefer to add the development project also under the alias default
.
With that you are ready 😄
It depends on your problem. If you have a question please join our gitter room. If you notice a issue in the project don't hasitate to fill out a issue report to this project here.
YEEEEEEES 😄 Everyone is welcome to send PRs and if you don't know where to start just write to me on twitter. There is always some work to do.
And if you don't have time to code with use show some 💙 and give this project a ⭐ and tell the 🌍 about it
YES!
Thank you to BrowserStack for providing the infrastructure that allows us to test in real browsers. Thanks to @SiradDev for creating the logo for this project 😄
- finish tests
MIT