Merge branch 'master' of https://github.com/gillkyle/sol-journal
This commit is contained in:
36
README.md
36
README.md
@@ -26,6 +26,18 @@ There are 2 ways to get started using Sol Journal:
|
|||||||
|
|
||||||
Sol Journal uses firebase to support offline functionality and authentication, meaning a new Firebase app will need to be setup with Firestore as a database if you wish to host it yourself. Be sure to add documents for `users` and `entries`, as well as enabling email for user authentication.
|
Sol Journal uses firebase to support offline functionality and authentication, meaning a new Firebase app will need to be setup with Firestore as a database if you wish to host it yourself. Be sure to add documents for `users` and `entries`, as well as enabling email for user authentication.
|
||||||
|
|
||||||
|
## Features
|
||||||
|
|
||||||
|
In the spirit of minimalism, key features are what are in place for a quick, lightweight journaling experience that can work across devices, including:
|
||||||
|
|
||||||
|
- 🔥 Authentication: Cloud firestore persists registered users to a users document and saved journal entries to an entries document
|
||||||
|
- 🎨 Dark Theme: the `src/styles/theme.js` file contains a set of colors and default styles that are applied to components with Emotion. A default light and dark theme are already in the file
|
||||||
|
- 🔍 Search: full-text search of a user's entries stored in Firestore for quick access to past entries
|
||||||
|
- 🖥 Mobile Friendly: designed to look great on mobile as well as desktop, with easy navigation on both
|
||||||
|
- 💡 PWA: being a progressive web app makes it installable from Chrome/Safari on desktop, or be added to the homescreen on iOS/Android
|
||||||
|
- 🔌 Offline Support: read/write when you're offline and let the updates happen when your connection is restored
|
||||||
|
- 🗄 Export: backup all of your entries at any time to save your data
|
||||||
|
|
||||||
## Developing
|
## Developing
|
||||||
|
|
||||||
Clone the project:
|
Clone the project:
|
||||||
@@ -46,12 +58,16 @@ or
|
|||||||
yarn
|
yarn
|
||||||
```
|
```
|
||||||
|
|
||||||
Then configure a file in a new `.env` file with the following keys from firebase:
|
Then configure a file in a new `.env` file (using the `.env.sample` file as a reference) with the following keys from the firebase console:
|
||||||
```env
|
```env
|
||||||
REACT_APP_FIREBASE_API_KEY=<BUNCHofRandomNumbersAndChars>
|
REACT_APP_FIREBASE_API_KEY=<BUNCHofRandomNumbersAndChars>
|
||||||
REACT_APP_DEV_AUTH_DOMAIN=<your-id.firebaseapp.com>
|
REACT_APP_DEV_AUTH_DOMAIN=<name>.firebaseapp.com
|
||||||
REACT_APP_DEV_DATABASE_URL=<https://your-id.firebaseapp.com>
|
REACT_APP_DEV_DATABASE_URL=https://<name>.firebaseio.com
|
||||||
REACT_APP_DEV_PROJECT_ID=<your-id>
|
REACT_APP_DEV_PROJECT_ID=<name>
|
||||||
|
REACT_APP_DEV_STORAGE_BUCKET=<name>.appspot.com
|
||||||
|
REACT_APP_DEV_MESSAGING_SENDER_ID=############
|
||||||
|
|
||||||
|
REACT_APP_CONFIRMATION_EMAIL_REDIRECT=https://<name>.firebaseapp.com
|
||||||
```
|
```
|
||||||
|
|
||||||
Navigate into the project directory, and then launch the site with this command:
|
Navigate into the project directory, and then launch the site with this command:
|
||||||
@@ -64,18 +80,6 @@ The site will be opened up in your default browser on http://localhost:3000
|
|||||||
|
|
||||||
Edit code in the `/src`, save your changes, and they'll reload instantly in the browser.
|
Edit code in the `/src`, save your changes, and they'll reload instantly in the browser.
|
||||||
|
|
||||||
## Features
|
|
||||||
|
|
||||||
In the spirit of minimalism, key features are what are in place for a quick, lightweight journaling experience that can work across devices, including:
|
|
||||||
|
|
||||||
- 🔥 Authentication: Cloud firestore persists registered users to a users document and saved journal entries to an entries document
|
|
||||||
- 🎨 Dark Theme: the `src/styles/theme.js` file contains a set of colors and default styles that are applied to components with Emotion. A default light and dark theme are already in the file
|
|
||||||
- 🔍 Search: full-text search of a user's entries stored in Firestore for quick access to past entries
|
|
||||||
- 🖥 Mobile Friendly: designed to look great on mobile as well as desktop, with easy navigation on both
|
|
||||||
- 💡 PWA: being a progressive web app makes it installable from Chrome/Safari on desktop, or be added to the homescreen on iOS/Android
|
|
||||||
- 🔌 Offline Support: read/write when you're offline and let the updates happen when your connection is restored
|
|
||||||
- 🗄 Export: backup all of your entries at any time to save your data
|
|
||||||
|
|
||||||
## Deploy
|
## Deploy
|
||||||
|
|
||||||
To create an optimized build of the site run this command:
|
To create an optimized build of the site run this command:
|
||||||
|
|||||||
Reference in New Issue
Block a user