Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/oslabs-beta/artemisql

ArtemisQL is a GraphQL migration tool and database visualizer that empowers developers to build and implement GraphQL with ease.
https://github.com/oslabs-beta/artemisql

graphiql graphql graphql-migration-assistance graphql-resolver graphql-schema graphql-typedefs postgresql-database

Last synced: about 1 month ago
JSON representation

ArtemisQL is a GraphQL migration tool and database visualizer that empowers developers to build and implement GraphQL with ease.

Awesome Lists containing this project

README 

        


  

  
ArtemisQL



  
A GraphQL migration tool and relational database visualizer



[![Contributors][contributors-shield]][contributors-url]

[![Stargazers][stars-shield]][stars-url]

[![Issues][issues-shield]][issues-url]

[![LinkedIn][linkedin-shield]][linkedin-url]






## 🔎 Overview

ArtemisQL is an open-source web application providing a SQL (Postgres) database GUI and custom-generated GraphQL schema (type defs, queries, mutations) and resolvers created by developers for developers, to ease the transition from REST to GraphQL. 



Read more on Medium.


Accelerated by OS Labs.



## ⚙️ Getting Started

### Visit ArtemisQL.io to utilize the tool.



#### Connect to a database

* Input your PostgreSQL URI

* OR use the sample database to view data rendered in an interactive diagram.







#### Visualize your data

* Easily view the relationships between the tables via the links that highlight the foreign key constraints.

* Move any table and arrange them to optimally view the structure of the database and the relationships between the tables.

  





#### Generate GraphQL Schema

* View the generated GraphQL schema, including the types and associated resolvers.

* Use the copy button to effortlessly integrate the code into your project.







#### GraphQL Sandbox

* Interactively construct full queries using the sample database.

* Use the "Docs" to explore the possible queries, fields, types, mutations, and more.







## 🏗️ For Developers - How to Contribute

We would love for you to test our application and submit any issues you encouter. Please feel free to fork your own repository to and submit your own pull requests.



How you can contribute:

- Submitting or resolving GitHub issues

- Implementing features

- Helping market our application



Please make sure you have the following:

- [NodeJS](https://nodejs.org/en/)

- [NPM ](https://www.npmjs.com/)



1. Clone the repo.

   ```sh

   git clone https://github.com/oslabs-beta/ArtemisQL.git

   ```

2. Install the package dependencies.

   ```sh

   npm install

   ```

3. Create an `.env` file in the project root directory and initialize PG_URI constant. If you want to use your own PostgresQL database, feel free to put your URI here. If you would like to use our sample Starwars database, please contact us at [email protected].

   ```sh

   PG_URI= 

   ```

4. To run the application in development mode, please run following command and navigate to http://localhost:8080/.



   ```sh

   npm run dev

   ```



5. To run the application in production mode, please run the following commands and navigate to http://localhost:3000/.

   ```sh

   npm start



   npm run build

   ```



6. To run the application against our testing suite, please run the following command.

   ```sh

   npm run test

   ```

## 🧬 Built With



- [React](https://reactjs.org/)

- [React Flow](https://reactflow.dev/)

- [React Router](https://reactrouter.com/)

- [Material UI](https://mui.com/)

- [GraphQL](https://graphql.org/)

- [TypeScript](https://www.typescriptlang.org/)

- [Node](https://nodejs.org/)

- [Express](https://expressjs.com/)

- [PostgreSQL](https://www.postgresql.org/)



## 🤖 Developers



[![JohnnyBryan][johnny-bryan-shield]][johnny-bryan-linkedin-url] 


[![JenniferChau][jennifer-chau-shield]][jennifer-chau-linkedin-url] 


[![JohnLin][john-lin-shield]][john-lin-linkedin-url] 


[![TarasSukhoverskyi][taras-sukhoverskyi-shield]][taras-sukhoverskyi-linkedin-url]



## License 

This product is licensed under the MIT License.



[contributors-shield]: https://img.shields.io/github/contributors/oslabs-beta/artemisql.svg?style=for-the-badge

[contributors-url]: https://github.com/oslabs-beta/artemisql/graphs/contributors

[stars-shield]: https://img.shields.io/github/stars/oslabs-beta/artemisql.svg?style=for-the-badge

[stars-url]: https://github.com/oslabs-beta/artemisql/stargazers

[issues-shield]: https://img.shields.io/github/issues/oslabs-beta/artemisql.svg?style=for-the-badge

[issues-url]: https://github.com/oslabs-beta/artemisql/issues

[linkedin-shield]: https://img.shields.io/badge/-LinkedIn-black.svg?style=for-the-badge&logo=linkedin&colorB=555

[linkedin-url]: https://www.linkedin.com/company/artemisql



[johnny-bryan-shield]: https://img.shields.io/badge/-Johnny%20Bryan-black.svg?style=for-the-badge&logo=linkedin&colorB=555

[johnny-bryan-linkedin-url]: https://www.linkedin.com/in/john-bryan-10a3bbb9/

[jennifer-chau-shield]: https://img.shields.io/badge/-Jennifer%20Chau-black.svg?style=for-the-badge&logo=linkedin&colorB=555

[jennifer-chau-linkedin-url]: https://www.linkedin.com/in/jenniferchau512/

[john-lin-shield]: https://img.shields.io/badge/-John%20Lin-black.svg?style=for-the-badge&logo=linkedin&colorB=555

[john-lin-linkedin-url]: https://www.linkedin.com/in/john-lin-/

[taras-sukhoverskyi-shield]: https://img.shields.io/badge/-Taras%20Sukhoverskyi-black.svg?style=for-the-badge&logo=linkedin&colorB=555

[taras-sukhoverskyi-linkedin-url]: https://www.linkedin.com/in/taras-sukhoverskyi-628642145/