https://github.com/devmarkson/a-story-book-app

The StoryBook App is a web application that empowers users to create, explore, and share captivating stories. It was built with NodeJs, Express and MongoDB. I also integrated the Google and Microsoft Auth for Sign in.
https://github.com/devmarkson/a-story-book-app

Last synced: 9 months ago
JSON representation

The StoryBook App is a web application that empowers users to create, explore, and share captivating stories. It was built with NodeJs, Express and MongoDB. I also integrated the Google and Microsoft Auth for Sign in.

• Host: GitHub
• URL: https://github.com/devmarkson/a-story-book-app
• Owner: DevMarkson
• Created: 2023-07-08T17:02:41.000Z (almost 3 years ago)
• Default Branch: main
• Last Pushed: 2024-04-30T21:22:21.000Z (about 2 years ago)
• Last Synced: 2024-12-28T19:47:26.385Z (over 1 year ago)
• Language: JavaScript
• Homepage: https://story-book-app-markson.onrender.com
• Size: 400 KB
• Stars: 1
• Watchers: 1
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

          
# StoryBooks App

## Overview

StoryBooks is a CRUD (Create, Read, Update, Delete) application that allows users to create and manage their stories. It leverages Express as the framework, MongoDB as the database, and Handlebars as the template engine. The original implementation incorporated Google OAuth for user authentication. This modified version extends the authentication options to include Microsoft OAuth.

## Screenshot of my deployed app

![The Login Page](./screenshots/Storybook-login.png)

![The Public stories section](./screenshots/public-stories.png)

## Features

- User authentication with both Google OAuth and Microsoft OAuth

- Creation and management of public and private stories

- Addition of new pages to stories

- Persistent storage of user data, stories, and sessions in MongoDB

## Setup Instructions

1. Clone the repository or download the source code.

2. Install Node.js if you haven't already. Visit [nodejs.org](https://nodejs.org) to download and install Node.js.

3. Open the project in your preferred code editor.

4. Install the project dependencies by running the command `npm install` in the project's root directory.

5. Create a `.env` file in the `config` folder and add the following variables:

   - `PORT` - Set the desired port for running the application (e.g., 3000).

   - `MONGO_URI` - Set the MongoDB connection string obtained from MongoDB Atlas.

   - `GOOGLE_CLIENT_ID` - Set the Google Client ID obtained from the Google Developers Console.

   - `GOOGLE_CLIENT_SECRET` - Set the Google Client Secret obtained from the Google Developers Console.

   - `MICROSOFT_CLIENT_ID` - Set the Microsoft Client ID obtained from the Microsoft Azure portal.

   - `MICROSOFT_CLIENT_SECRET` - Set the Microsoft Client Secret obtained from the Microsoft Azure portal.

   - `MICROSOFT_CALLBACK_URL` - Set the callback URL for Microsoft OAuth authentication (e.g., `http://localhost:3000/auth/microsoft/callback`).

6. Start the application by running the command `npm start` or `npm run dev` (for development mode) in the project's root directory.

7. Access the application in your web browser using the specified port (e.g., `http://localhost:3000`).

Please ensure that you have followed the steps mentioned above and provided the necessary values for the environment variables in the `.env` file. The Google Client ID and Client Secret are required for Google OAuth authentication, while the Microsoft Client ID, Client Secret, and Callback URL are required for Microsoft OAuth authentication.

**Note:** This modified version of the StoryBooks app includes both Google OAuth and Microsoft OAuth authentication. The original application and the tutorial were created by Brad Traversy, and I extend my appreciation to him for his exceptional tutorial and guidance throughout this project.