Code Monkey home page Code Monkey logo

gitconnect's Introduction

gitconnect.

Version License: MIT license Twitter: collinsmuriuki_

A simple github user search tool.

alt text

alt text

Author

๐Ÿ‘ค Collins Muriuki

Description

gitconnect is an app that allows a user to search for GitHub users and display their profile information as well as a glimpse of their repositories.

Features

Here are the features in summary:

  • A minimalistic landing page with a button that navigates user to the search page.
  • A search page which allows the user to search for github users by typing in their usernames.
  • A minimalistic display of the github user information and their repositories ordered alphabetically

Behaviour Driven Development (BDD)

Behaviour Input Output
Page loads, user arrives in the landing page, on clicking the begin search button, they are taken to the search page. The user , once in the search page, can search github usernames on the search box. The profiles of the users as well as their repos are displayed upon submission.

Requirements

  • To run this app on your text editor, you will need the following:
    • Node: for installation instructions follow this link
    • Angular CLI version 8.0.3: installation of Angular is described here
    • A github developer API token, clientId and client secret, all these can be gotten after creating an application on github

Installation and Set-up

To view the app, open the live site link provided below on the README. Here is a run through of how to set up the application:

  • Step 1 : Clone this repository using git clone https://github.com/collinsmuriuki/gitconnect.git, or downloading a ZIP file of the code.
  • Step 2 : The repository, if downloaded as a .zip file will need to be extracted to your preferred location and opened
  • Step 3 : Open the terminal, go to the project directory and download the dependencies in the package.json using npm install
  • Step 4 : On the root of the src directory, create an environments directory; inside, create two files, environment.ts and environment.prod.ts
    • In environments.ts copy this code:
          export const environment = {
          production: false,
          token: 'YOUR_TOKEN',
          clientId: 'YOUR_CLIENTID',
          clientSecret: 'YOUR_CLIENTSECRET',
          };
    • And finally in environment.prod.ts, copy the above code but change production key from false to true
  • Step 5 : Run ng serve on the terminal for a dev server. Navigate to http://localhost:4200/. The app will automatically reload if you change any of the source files

Known Bugs

  • Error messeage on typing in a username that cannot be found, is inconsistent.

Technologies Used

  • Angular CLI version 8.3.6.
  • HTML
  • CSS
  • Javascript
  • Bootstrap 4.3.1
  • font-awesome

Support and contact details

You can provide feedback or raise any issues/ bugs through the following means:

Live Site link

You can view the live application by following this link.

Show your support

Give a โญ๏ธ if this project helped you!

๐Ÿ“ License

Copyright ยฉ 2019 Collins Muriuki.
This project is MIT license licensed.

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.