Table of Contents
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.
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.
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.
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.
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.
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.
After generating their GraphQL Code, users will have the option to visualize and interact with their PostgreSQL or MongoDB databases!
This section describes the instructions for developers who would like to download and contribute to the open-source GQLevated project.
The GQLevated application was built using the following frameworks/libraries:
- Next.js
- React
- Redux Toolkit
- Typescript
- GraphQL
- Apollo
- Node.js
- Express
- MongoDB
- Mongoose
- PostgreSQL
- ReactFlow
- NextUI
- FramerMotion
- ReactSyntaxHighlighter
- Jest
- Supertest
- Crypto.js
Required software for setting up this application:
-
Clone the repo.
git clone https://github.com/oslabs-beta/GQLevated.git cd GQLevated
-
Install the package dependencies.
npm install
-
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
-
Unit testing can be run by the following command:
npm test
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!
- Fork the Project
- Create your Feature Branch (
git checkout -b feature/AmazingFeature
) - Commit your Changes (
git commit -m 'Add some AmazingFeature'
) - Push to the Branch (
git push origin feature/AmazingFeature
) - Open a Pull Request
This project is licensed under the MIT License - see the LICENSE.md file for details.