├── .gitattributes ├── .gitignore ├── README.md ├── Screen Shot 2019-09-25 at 1.59.32 AM.png ├── package.json ├── public ├── favicon.ico ├── index.html ├── logo192.png ├── logo512.png ├── manifest.json └── robots.txt ├── src ├── AddThing.js ├── App.css ├── App.js ├── App.test.js ├── ThingList.js ├── ThingListItem.js ├── index.css ├── index.js ├── logo.svg └── serviceWorker.js └── yarn.lock /.gitattributes: -------------------------------------------------------------------------------- 1 | # Auto detect text files and perform LF normalization 2 | * text=auto 3 | -------------------------------------------------------------------------------- /.gitignore: -------------------------------------------------------------------------------- 1 | # See https://help.github.com/articles/ignoring-files/ for more about ignoring files. 2 | 3 | # dependencies 4 | /node_modules 5 | /.pnp 6 | .pnp.js 7 | 8 | # testing 9 | /coverage 10 | 11 | # production 12 | /build 13 | 14 | # misc 15 | .DS_Store 16 | .env.local 17 | .env.development.local 18 | .env.test.local 19 | .env.production.local 20 | 21 | npm-debug.log* 22 | yarn-debug.log* 23 | yarn-error.log* 24 | -------------------------------------------------------------------------------- /README.md: -------------------------------------------------------------------------------- 1 | ## react-course-firebase-hooks-app 2 | This project was bootstrapped with [Create React App](https://github.com/facebook/create-react-app). 3 | 4 | --- 5 |

6 | 7 |

8 |

9 | Click To View Ionic React Video Playlist 10 |

11 | --- 12 | 13 | > Make sure you check the branches, there are different feature implemented in the branches 14 | > - Master - implements react firebase hooks for reading and writing data to firebase 15 | > - With Authentication - implements a Firebase Login Flow 16 | > - Capacitor Ionic - implements the solution using ionic framework components and capacitor for mobile deployment 17 | > - Capacitor - implements the solution using capacitor for mobile deployment 18 | 19 | Sample app integrating firebase with a react application using react hooks api and [React Firebase Hooks](https://github.com/CSFrequency/react-firebase-hooks) - A set of reusable [react hooks](https://reactjs.org/docs/hooks-intro.html) for [Firebase](https://firebase.google.com/docs/web/setup?authuser=0). 20 | 21 | 22 | 23 | 24 | ## Getting A Collecting of Things 25 | 26 | This is from firebase-hooks, it allows us to query all of the item from the `things` collection in the database in descending order based on the creation data. the `value` will containg the results of the query that we will loop through to render the list items 27 | ```javascript 28 | const [value, loading, error] = useCollection( 29 | firebase 30 | .firestore() 31 | .collection("things") 32 | .orderBy("createdOn", "desc"), 33 | { 34 | snapshotListenOptions: { includeMetadataChanges: true } 35 | } 36 | ); 37 | ``` 38 | ## Getting a Specific Thing 39 | 40 | We use the firebase-hooks to get a specific object using the id of the object we want to retrieve 41 | ```javascript 42 | // get a document if there is an initial value 43 | const [value, loading, error] = useDocument( 44 | firebase.firestore().doc("things/" + objectId), 45 | { 46 | snapshotListenOptions: { includeMetadataChanges: true } 47 | } 48 | ); 49 | ``` 50 | 51 | ## Adding Or Updating a Specific Thing 52 | 53 | if editing then we use the firebase-hooks to get the specific object using the 54 | `initialValue` property that is passed to the component 55 | ```javascript 56 | // get a document if there is an initial value 57 | const [value, loading, error] = useDocument( 58 | firebase.firestore().doc("things/" + initialValue), 59 | { 60 | snapshotListenOptions: { includeMetadataChanges: true } 61 | } 62 | ); 63 | ``` 64 | When saving the thing, determine if it is a new object or an existing object by checking to see if there was an `initialValue` provided as a property. If there was, then we have an object id so we need to update the object and not create a new object 65 | ```javascript 66 | /** 67 | * on save determine if it is a new object or an existing object 68 | * by check to see if there was an initial value provided 69 | */ 70 | const onSave = async () => { 71 | let collectionRef = firebase.firestore().collection("things"); 72 | 73 | if (initialValue) { 74 | await collectionRef 75 | .doc(initialValue) 76 | .set({ name: thing, updatedOn: new Date().getTime() }, { merge: true }); 77 | setThing(""); 78 | clear(); 79 | } else { 80 | await collectionRef 81 | .doc(initialValue) 82 | .add({ name: thing, createdOn: new Date().getTime() }); 83 | setThing(""); 84 | clear(); 85 | } 86 | }; 87 | ``` 88 | 89 | ## Deleting A Specific Thing 90 | There is no firebase-hook to delete an object, we just used the firebase javascript api to remove the object 91 | ```javascript 92 | /** 93 | * deletes item from firebase database using the id 94 | * of teh object 95 | * 96 | * @param {*} id 97 | */ 98 | const doDelete = id => { 99 | firebase 100 | .firestore() 101 | .collection("things") 102 | .doc(id) 103 | .delete(); 104 | }; 105 | ``` 106 | -------------------------------------------------------------------------------- /Screen Shot 2019-09-25 at 1.59.32 AM.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aaronksaunders/react-course-firebase-hooks-app/640489afee5cd8897137cb4eae3ded1bff2a6a51/Screen Shot 2019-09-25 at 1.59.32 AM.png -------------------------------------------------------------------------------- /package.json: -------------------------------------------------------------------------------- 1 | { 2 | "name": "fb-hooks", 3 | "version": "0.1.0", 4 | "private": true, 5 | "dependencies": { 6 | "firebase": "^6.6.2", 7 | "react": "^16.9.0", 8 | "react-dom": "^16.9.0", 9 | "react-firebase-hooks": "^2.1.0", 10 | "react-scripts": "3.1.2" 11 | }, 12 | "scripts": { 13 | "start": "react-scripts start", 14 | "build": "react-scripts build", 15 | "test": "react-scripts test", 16 | "eject": "react-scripts eject" 17 | }, 18 | "eslintConfig": { 19 | "extends": "react-app" 20 | }, 21 | "browserslist": { 22 | "production": [ 23 | ">0.2%", 24 | "not dead", 25 | "not op_mini all" 26 | ], 27 | "development": [ 28 | "last 1 chrome version", 29 | "last 1 firefox version", 30 | "last 1 safari version" 31 | ] 32 | } 33 | } 34 | -------------------------------------------------------------------------------- /public/favicon.ico: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aaronksaunders/react-course-firebase-hooks-app/640489afee5cd8897137cb4eae3ded1bff2a6a51/public/favicon.ico -------------------------------------------------------------------------------- /public/index.html: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 12 | 13 | 17 | 18 | 27 | React App 28 | 29 | 30 | 31 |
32 | 42 | 43 | 44 | -------------------------------------------------------------------------------- /public/logo192.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aaronksaunders/react-course-firebase-hooks-app/640489afee5cd8897137cb4eae3ded1bff2a6a51/public/logo192.png -------------------------------------------------------------------------------- /public/logo512.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aaronksaunders/react-course-firebase-hooks-app/640489afee5cd8897137cb4eae3ded1bff2a6a51/public/logo512.png -------------------------------------------------------------------------------- /public/manifest.json: -------------------------------------------------------------------------------- 1 | { 2 | "short_name": "React App", 3 | "name": "Create React App Sample", 4 | "icons": [ 5 | { 6 | "src": "favicon.ico", 7 | "sizes": "64x64 32x32 24x24 16x16", 8 | "type": "image/x-icon" 9 | }, 10 | { 11 | "src": "logo192.png", 12 | "type": "image/png", 13 | "sizes": "192x192" 14 | }, 15 | { 16 | "src": "logo512.png", 17 | "type": "image/png", 18 | "sizes": "512x512" 19 | } 20 | ], 21 | "start_url": ".", 22 | "display": "standalone", 23 | "theme_color": "#000000", 24 | "background_color": "#ffffff" 25 | } 26 | -------------------------------------------------------------------------------- /public/robots.txt: -------------------------------------------------------------------------------- 1 | # https://www.robotstxt.org/robotstxt.html 2 | User-agent: * 3 | -------------------------------------------------------------------------------- /src/AddThing.js: -------------------------------------------------------------------------------- 1 | import React, { useState, useEffect } from "react"; 2 | import firebase from "firebase"; 3 | // https://github.com/CSFrequency/react-firebase-hooks 4 | import { useDocument } from "react-firebase-hooks/firestore"; 5 | 6 | /** 7 | * 8 | * @param {*} param0 9 | */ 10 | function AddThing({ initialValue, clear }) { 11 | // keep track of the input value 12 | const [thing, setThing] = useState(""); 13 | 14 | // get a document if there is an initial value 15 | const [value, loading, error] = useDocument( 16 | firebase.firestore().doc("things/" + initialValue), 17 | { 18 | snapshotListenOptions: { includeMetadataChanges: true } 19 | } 20 | ); 21 | 22 | // if there is an initial value then load it and setThing with the 23 | // value so it can be in the input field 24 | useEffect(() => { 25 | !loading && initialValue && value.exists && setThing(value.data().name); 26 | }, [loading, initialValue, value]); 27 | 28 | /** 29 | * on save determine if it is a new object or an existing object 30 | * by check to see if there was an initial value provided 31 | */ 32 | const onSave = async () => { 33 | let collectionRef = firebase.firestore().collection("things"); 34 | 35 | if (initialValue) { 36 | await collectionRef 37 | .doc(initialValue) 38 | .set({ name: thing, updatedOn: new Date().getTime() }, { merge: true }); 39 | setThing(""); 40 | clear(); 41 | } else { 42 | await collectionRef.add({ name: thing, createdOn: new Date().getTime() }); 43 | setThing(""); 44 | clear(); 45 | } 46 | }; 47 | 48 | return ( 49 |
50 |

Add A Thing

51 | setThing(e.target.value)} 54 | style={{ 55 | fontSize: 14, 56 | backgroundColor: "lightGrey", 57 | padding: 4, 58 | width: "94%" 59 | }} 60 | /> 61 | 64 | 73 |
74 | ); 75 | } 76 | 77 | export default AddThing; 78 | -------------------------------------------------------------------------------- /src/App.css: -------------------------------------------------------------------------------- 1 | .App { 2 | padding: 20px; 3 | } 4 | 5 | .App-logo { 6 | height: 40vmin; 7 | } 8 | 9 | .App-header { 10 | background-color: #282c34; 11 | min-height: 100vh; 12 | display: flex; 13 | flex-direction: column; 14 | align-items: center; 15 | justify-content: center; 16 | font-size: calc(10px + 2vmin); 17 | color: white; 18 | } 19 | 20 | .App-link { 21 | color: #09d3ac; 22 | } 23 | 24 | .thing-title { 25 | font-weight: bold; 26 | } 27 | 28 | .thing-sub-title { 29 | color: black; 30 | } 31 | 32 | .thing-id { 33 | color: gray; 34 | font-weight: bold; 35 | } 36 | 37 | .thing-wrapper > div { 38 | padding: 4px; 39 | padding-top: 8px 40 | } 41 | 42 | .thing-wrapper { 43 | border-bottom: 1px solid lightgrey; 44 | } 45 | -------------------------------------------------------------------------------- /src/App.js: -------------------------------------------------------------------------------- 1 | import React, { useState } from "react"; 2 | import "./App.css"; 3 | 4 | // importing firebase 5 | import firebase from "firebase/app"; 6 | 7 | // import the components we are rendering on page 8 | import AddThing from "./AddThing"; 9 | import ThingList from "./ThingList"; 10 | 11 | // 12 | // initialize firebase using properties on firebase console 13 | // https://firebase.google.com/docs/web/setup?authuser=0 14 | // 15 | var firebaseConfig = { 16 | }; 17 | // Initialize Firebase 18 | firebase.initializeApp(firebaseConfig); 19 | 20 | function App() { 21 | // track if the user has selected an item to edit 22 | const [current, setCurrent] = useState(null); 23 | 24 | /** 25 | * set the state variable current to the id of the item selected 26 | * for edit, this will cause the AddThing compont to render, ready to 27 | * edit the object 28 | */ 29 | 30 | return ( 31 |
32 | {/* for for editing or creating */} 33 | setCurrent(null)} /> 34 | {/* Renders the list on the page */} 35 | 36 |
37 | ); 38 | } 39 | 40 | export default App; 41 | -------------------------------------------------------------------------------- /src/App.test.js: -------------------------------------------------------------------------------- 1 | import React from 'react'; 2 | import ReactDOM from 'react-dom'; 3 | import App from './App'; 4 | 5 | it('renders without crashing', () => { 6 | const div = document.createElement('div'); 7 | ReactDOM.render(, div); 8 | ReactDOM.unmountComponentAtNode(div); 9 | }); 10 | -------------------------------------------------------------------------------- /src/ThingList.js: -------------------------------------------------------------------------------- 1 | import React, { useState } from "react"; 2 | import "./App.css"; 3 | 4 | import ThingListItem from "./ThingListItem"; 5 | 6 | import firebase from "firebase/app"; 7 | // https://github.com/CSFrequency/react-firebase-hooks 8 | import { useCollection } from "react-firebase-hooks/firestore"; 9 | 10 | export default function ThingList({ doEdit }) { 11 | // this is from firebase-hooks, it allows us to query all of the itemss 12 | // from the `things` collection in the database in desc order based on 13 | // the creation data 14 | const [value, loading, error] = useCollection( 15 | firebase 16 | .firestore() 17 | .collection("things") 18 | .orderBy("createdOn", "desc"), 19 | { 20 | snapshotListenOptions: { includeMetadataChanges: true } 21 | } 22 | ); 23 | 24 | /** 25 | * deletes item from firebase database using the id 26 | * of teh object 27 | * 28 | * @param {*} id 29 | */ 30 | const doDelete = id => { 31 | firebase 32 | .firestore() 33 | .collection("things") 34 | .doc(id) 35 | .delete(); 36 | }; 37 | 38 | return ( 39 | <> 40 |

Things Collection

41 | {value && 42 | value.docs.map(doc => { 43 | return ( 44 | !loading && ( 45 | 51 | ) 52 | ); 53 | })} 54 | 55 | ); 56 | } 57 | -------------------------------------------------------------------------------- /src/ThingListItem.js: -------------------------------------------------------------------------------- 1 | import React from "react"; 2 | import "./App.css"; 3 | export default function ThingListItem({ doEdit, doDelete, doc }) { 4 | let data = doc.data(); 5 | return ( 6 |
7 |
{data.name}
8 |
{new Date(data.createdOn) + ""}
9 |
{doc.id}
10 |

11 | 12 | 13 |

14 |
15 | ); 16 | } -------------------------------------------------------------------------------- /src/index.css: -------------------------------------------------------------------------------- 1 | body { 2 | margin: 0; 3 | font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", "Roboto", "Oxygen", 4 | "Ubuntu", "Cantarell", "Fira Sans", "Droid Sans", "Helvetica Neue", 5 | sans-serif; 6 | -webkit-font-smoothing: antialiased; 7 | -moz-osx-font-smoothing: grayscale; 8 | } 9 | 10 | code { 11 | font-family: source-code-pro, Menlo, Monaco, Consolas, "Courier New", 12 | monospace; 13 | } 14 | -------------------------------------------------------------------------------- /src/index.js: -------------------------------------------------------------------------------- 1 | import React from 'react'; 2 | import ReactDOM from 'react-dom'; 3 | import './index.css'; 4 | import App from './App'; 5 | import * as serviceWorker from './serviceWorker'; 6 | 7 | ReactDOM.render(, document.getElementById('root')); 8 | 9 | // If you want your app to work offline and load faster, you can change 10 | // unregister() to register() below. Note this comes with some pitfalls. 11 | // Learn more about service workers: https://bit.ly/CRA-PWA 12 | serviceWorker.unregister(); 13 | -------------------------------------------------------------------------------- /src/logo.svg: -------------------------------------------------------------------------------- 1 | -------------------------------------------------------------------------------- /src/serviceWorker.js: -------------------------------------------------------------------------------- 1 | // This optional code is used to register a service worker. 2 | // register() is not called by default. 3 | 4 | // This lets the app load faster on subsequent visits in production, and gives 5 | // it offline capabilities. However, it also means that developers (and users) 6 | // will only see deployed updates on subsequent visits to a page, after all the 7 | // existing tabs open on the page have been closed, since previously cached 8 | // resources are updated in the background. 9 | 10 | // To learn more about the benefits of this model and instructions on how to 11 | // opt-in, read https://bit.ly/CRA-PWA 12 | 13 | const isLocalhost = Boolean( 14 | window.location.hostname === 'localhost' || 15 | // [::1] is the IPv6 localhost address. 16 | window.location.hostname === '[::1]' || 17 | // 127.0.0.1/8 is considered localhost for IPv4. 18 | window.location.hostname.match( 19 | /^127(?:\.(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)){3}$/ 20 | ) 21 | ); 22 | 23 | export function register(config) { 24 | if (process.env.NODE_ENV === 'production' && 'serviceWorker' in navigator) { 25 | // The URL constructor is available in all browsers that support SW. 26 | const publicUrl = new URL(process.env.PUBLIC_URL, window.location.href); 27 | if (publicUrl.origin !== window.location.origin) { 28 | // Our service worker won't work if PUBLIC_URL is on a different origin 29 | // from what our page is served on. This might happen if a CDN is used to 30 | // serve assets; see https://github.com/facebook/create-react-app/issues/2374 31 | return; 32 | } 33 | 34 | window.addEventListener('load', () => { 35 | const swUrl = `${process.env.PUBLIC_URL}/service-worker.js`; 36 | 37 | if (isLocalhost) { 38 | // This is running on localhost. Let's check if a service worker still exists or not. 39 | checkValidServiceWorker(swUrl, config); 40 | 41 | // Add some additional logging to localhost, pointing developers to the 42 | // service worker/PWA documentation. 43 | navigator.serviceWorker.ready.then(() => { 44 | console.log( 45 | 'This web app is being served cache-first by a service ' + 46 | 'worker. To learn more, visit https://bit.ly/CRA-PWA' 47 | ); 48 | }); 49 | } else { 50 | // Is not localhost. Just register service worker 51 | registerValidSW(swUrl, config); 52 | } 53 | }); 54 | } 55 | } 56 | 57 | function registerValidSW(swUrl, config) { 58 | navigator.serviceWorker 59 | .register(swUrl) 60 | .then(registration => { 61 | registration.onupdatefound = () => { 62 | const installingWorker = registration.installing; 63 | if (installingWorker == null) { 64 | return; 65 | } 66 | installingWorker.onstatechange = () => { 67 | if (installingWorker.state === 'installed') { 68 | if (navigator.serviceWorker.controller) { 69 | // At this point, the updated precached content has been fetched, 70 | // but the previous service worker will still serve the older 71 | // content until all client tabs are closed. 72 | console.log( 73 | 'New content is available and will be used when all ' + 74 | 'tabs for this page are closed. See https://bit.ly/CRA-PWA.' 75 | ); 76 | 77 | // Execute callback 78 | if (config && config.onUpdate) { 79 | config.onUpdate(registration); 80 | } 81 | } else { 82 | // At this point, everything has been precached. 83 | // It's the perfect time to display a 84 | // "Content is cached for offline use." message. 85 | console.log('Content is cached for offline use.'); 86 | 87 | // Execute callback 88 | if (config && config.onSuccess) { 89 | config.onSuccess(registration); 90 | } 91 | } 92 | } 93 | }; 94 | }; 95 | }) 96 | .catch(error => { 97 | console.error('Error during service worker registration:', error); 98 | }); 99 | } 100 | 101 | function checkValidServiceWorker(swUrl, config) { 102 | // Check if the service worker can be found. If it can't reload the page. 103 | fetch(swUrl) 104 | .then(response => { 105 | // Ensure service worker exists, and that we really are getting a JS file. 106 | const contentType = response.headers.get('content-type'); 107 | if ( 108 | response.status === 404 || 109 | (contentType != null && contentType.indexOf('javascript') === -1) 110 | ) { 111 | // No service worker found. Probably a different app. Reload the page. 112 | navigator.serviceWorker.ready.then(registration => { 113 | registration.unregister().then(() => { 114 | window.location.reload(); 115 | }); 116 | }); 117 | } else { 118 | // Service worker found. Proceed as normal. 119 | registerValidSW(swUrl, config); 120 | } 121 | }) 122 | .catch(() => { 123 | console.log( 124 | 'No internet connection found. App is running in offline mode.' 125 | ); 126 | }); 127 | } 128 | 129 | export function unregister() { 130 | if ('serviceWorker' in navigator) { 131 | navigator.serviceWorker.ready.then(registration => { 132 | registration.unregister(); 133 | }); 134 | } 135 | } 136 | --------------------------------------------------------------------------------