Skip to content

oslabs-beta/GQLevated

Repository files navigation


Contributors Stargazers Forks Issues MIT License

Table of Contents
  1. About GQLEvated
  2. Background
  3. Getting Started
  4. How Does It Work
  5. Developers
  6. Contributors
  7. License

About GQLevated

GQLevated is an open source GraphQL prototyping tool. Our Web Hosted Development Tool supplies users with customized, production-ready GraphQL code including server-side Types, Root Queries and Mutations as well as client-side Queries and Mutations. This allows developers to spend more time solving problems and less time tediously writing GraphQL code, thus ELEVATING the project as a whole. Here is a medium article describing the inspiration behind GQLevated.

And it’s free to use for everyone - no need to create an account!

Accelerated by OS Labs.


Background

GraphQL is a query language for APIs and can be an ideal method over RESTful architecture for fulfilling queries of your existing data with less API calls. GraphQL provides a complete and understandable description of the data in your API, gives clients the power to ask for exactly what they need and nothing more, makes it easier to evolve APIs over time, and enables powerful developer tools.

However, making the switch to GraphQL on a project that utilizes relational databases and RESTful API is very time consuming and labor intensive due to its redundant structure, requiring a large amount of code to be written.


Let's Get Started

Visit https://GQLevated.dev to launch our web hosted tool.

  • Click the Learn More Button on our landing page to learn what GQLevated can do.
  • Click the Use GQLevated to start using our tool.
  • Go to the Developer's section for instructions on how to contribute.

(back to top)

How Does It Work?


Connect to your database

Enter your PostgreSQL or MongoDB connection string and connect to your database. Don’t have a connection string but still want to see how it works? No problem! Connect to our PostgresQL Sample Database and see GQLevated in action.

(back to top)

Generate your GraphQL code

With one simple click of a button GQLevated connects to your database, parses the data and generates the corresponding GraphQL code for you. This production-ready GraphQL code includes server-side Types, Root Queries and Mutations as well as client-side Queries and Mutations. It is displayed for you in an easy to reason about way and ready to be injected into your own application.

(back to top)

Export your GraphQL code

In addition to copying and pasting the newly generated GraphQL code straight from the browser display, users also have the option to export their customized GraphQL code as individual JavaScript files. Simply click on the ‘Export Code‘ button in the corresponding container of the code that you wish to download.

(back to top)

Visualize your databases

After generating their GraphQL Code, users will have the option to visualize and interact with their PostgreSQL or MongoDB databases!



(back to top)

Developers

This section describes the instructions for developers who would like to download and contribute to the open-source GQLevated project.

Built With

The GQLevated application was built using the following frameworks/libraries:

(back to top)

Project Setup

Required software for setting up this application:

  1. Clone the repo.

    git clone https://github.com/oslabs-beta/GQLevated.git
    cd GQLevated
  2. Install the package dependencies.

    npm install
  3. The application can be run in development mode by running the following command and going to http://localhost:3000/ on your browser.

    npm run dev
  4. Unit testing can be run by the following command:

    npm test

(back to top)

Contributors

John Alicastro @JohnAlicastro

Johnson Che @JohnsonChe

Nicholas Gonzalez @Nikootz

Quyen Calixto @QtieCoder

(back to top)

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement". Don't forget to give the project a star! Thanks again!

  1. Fork the Project
  2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
  3. Commit your Changes (git commit -m 'Add some AmazingFeature')
  4. Push to the Branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

(back to top)

License

This project is licensed under the MIT License - see the LICENSE.md file for details.