Giter VIP home page Giter VIP logo

space's Introduction

S P A C E

cover

Chat application for developers

If you want to chat up, join the room test on the app.

There is a known bug in firebase; it doesn't have permission to read certain users' display name. I've stored their email ID instead of the name.

Website

spacedev.herokuapp.com

Although this is a desktop application made with electron, it runs on the web as well.

About

A real-time chat application made using React, Redux, Electron and Firebase.

Right now, it's just a barebones chat app, but developer-friendly features will be arriving soon.

Running locally for direct usage

You can download the executables from the following links:

Linux

Windows

Mac

(I haven't been able to test the app on mac yet, so if there's any problem,feel free to open an issue).

Contributing

This is a good first project to contribute to if you've recently learned react and redux, or want to learn the same.

If you're well-versed with these frameworks, you can help by improving the current app, or adding new features!

If you want to get into the code and start contributing, you need to do a little bit of setup for your machine:

Setting up firebase

First, download/clone this repository and cd into it:

git clone [email protected]:sar-gupta/space.git
cd space

Create a new project in firebase by heading over to console.firebase.google.com

Head over to the authentication tab, click on Sign in method and select Github. Click on enable. Copy the authorization calback URL that's provided to you right there.

After this, you need to register the app with github. Head over to https://github.com/settings/applications/new and fill in details. App homepage can be literally any valid URL, it doesn't matter as long as the URL is valid. Here, in the authorization callback URL, paste the URL that you copied from firebase to your clipboard. Click on Register Application.

You'll be redirected to a page that has a client ID and a client secret. Copy those and paste them where they are required in firebase, and click on Save. Github authentication should now be enabled.

Now, localhost should be an authorized domain by default, but if it isn't there, just click on Add domainand enter localhost.

Then, go to the database tab, click on real-time database and select Start in test mode. Go to Rules, they should look like this:

{
  "rules": {
    ".read": "auth!=null",
    ".write": "auth!=null"
  }
}

Now go the Project Overview and click on Add firebase to web app. You'll be promted with a screen that has a config object like this:

config oject

Now, back in your code editor, create a new file .env.development in the root of the project, and enter the following contents in this file:

FIREBASE_API_KEY=
FIREBASE_AUTH_DOMAIN=
FIREBASE_DATABASE_URL=
FIREBASE_PROJECT_ID=
FIREBASE_STORAGE_BUCKET=
FIREBASE_MESSAGING_SENDER_ID=

Enter the values from the firebase config object here (without the double quotes), and save the file.

Running locally for development

To start the desktop application, run the following commands from the root directory of the project:

yarn
yarn run electron

To create various executables or packaged files for the desktop application, run any of the following depending on your target platform:

yarn run package-linux
yarn run package-win
yarn run package-mac

It will put the output in the release-builds/ directory inside the root of the project.

NOTE: If you're building for windows in a non-windows environment, you need to have wine installed.

If you want to run just the web version, run the following commands:

yarn
yarn run dev-server

The app will be live on localhost:4172

And you're good to go!

You can view the database contents in your firebase project's database tab.

If you want to contribute to this project (solve a bug or implement a new feature), feel free to create an issue and/or submit a pull request.

NOTE

I recently learned React, Redux, Electron and Firebase, and this is my first project using these technologies/frameworks. So, you'll find some instances where performance of the application can be improved. Feel free to open an issue/submit pull requests if you find any such instance :)

Usage

After logging in with github, you can create new rooms or join existing ones. I've only allowed unique room names for a better user experience.

NOTE: Number of unread messages don't go to 0 when you click on the chat name (that's intentional). It goes to 0 if you send a message to that room, or if you click on the number of unread messages.

Author

Sarthak Gupta

Article

I also wrote an article about this project. Feel free to read it to get a general idea. It'll also be helpful if you want to start contributing to this app!

It has been published on Hackernoon.

You can read it here:

https://hackernoon.com/https-medium-com-sargupta-how-i-built-a-real-time-chat-app-using-react-and-firebase-dc8690bf41f7

space's People

Contributors

sar-gupta avatar andrewjmead avatar

Watchers

James Cloos avatar athiwatp avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.