{"id":26267918,"url":"https://github.com/oslabs-beta/graphql-blueprint","last_synced_at":"2025-04-30T19:22:00.958Z","repository":{"id":47664844,"uuid":"365875167","full_name":"oslabs-beta/GraphQL-Blueprint","owner":"oslabs-beta","description":"GraphQL Blueprint: a software developer tool for engineers that want to quickly generate React/Express, Apollo and GraphQL boilerplate code using a data modeling interface. Watch your queries, mutations, and schema update in realtime with our code preview feature and finally, export it when you're ready to begin building the rest of your app!","archived":false,"fork":false,"pushed_at":"2021-08-19T02:03:55.000Z","size":23692,"stargazers_count":74,"open_issues_count":10,"forks_count":8,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-04-08T10:53:16.973Z","etag":null,"topics":["apollo","boilerplate","create-react-app","data-modeling","graphql","mongodb","node","post","postgresql","react","sql"],"latest_commit_sha":null,"homepage":"http://graphqlblueprint.xyz","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/oslabs-beta.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2021-05-10T00:23:25.000Z","updated_at":"2024-05-05T12:13:08.000Z","dependencies_parsed_at":"2022-08-21T09:40:39.014Z","dependency_job_id":null,"html_url":"https://github.com/oslabs-beta/GraphQL-Blueprint","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oslabs-beta%2FGraphQL-Blueprint","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oslabs-beta%2FGraphQL-Blueprint/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oslabs-beta%2FGraphQL-Blueprint/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oslabs-beta%2FGraphQL-Blueprint/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/oslabs-beta","download_url":"https://codeload.github.com/oslabs-beta/GraphQL-Blueprint/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":251767286,"owners_count":21640488,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["apollo","boilerplate","create-react-app","data-modeling","graphql","mongodb","node","post","postgresql","react","sql"],"created_at":"2025-03-14T04:18:44.569Z","updated_at":"2025-04-30T19:22:00.941Z","avatar_url":"https://github.com/oslabs-beta.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# GraphQL Blueprint\n\n[GraphQL Blueprint](http://graphqlblueprint.xyz) helps you build full stack apps with boilerplate code. Currently on a React, Express, Apollo stack, you can template out GraphQL code by modeling your database schema with our easy-to-use interface.\n\nOur interface provides you the ability, with a few simple inputs, to auto generate boilerplate code for download. As you can see in the video below, it resembles the activity of data modeling (another use case of GraphQL Blueprint). The boilerplate code gives you a head start to develop your new application including GraphQL root queries, schemas, mutations, and client queries. Also available for download are the NoSQL schemas or SQL build scripts, and a server file. Neat, right?\n\n\nhttps://user-images.githubusercontent.com/5971166/126023310-2eefd773-9848-4f79-8760-1a3b86df954c.mp4\n\n\n## Background\n\nGraphQL is an open source data query and manipulation language that can be a preferred method over RESTful architecture, fulfilling queries with less API calls, and limiting over-fetching and under-fetching of data. Although GraphQL is a powerful query language, starting a new GraphQL application can be time consuming due to its redundant structure. This repetitive code can make developing a GraphQL application more intuitive, but this could also mean that for every GraphQL type created, a large amount of additional code would be required.\n\nFor example, adding a new GraphQL type \"User\" with the fields \"id\", \"age\", and \"messages\" may require the following:\n- A root query for an individual User by id\n- A root query for all the Users\n- Mutation to create a User with an id, age, and messages\n- Mutation to select a User by id, and update their age or messages\n- Mutation to delete a User by id\n- Client queries for User and the particular fields\n- A NoSQL schema or SQL create script for User\n\nYou will notice that all these items revolve around a similar piece of information - User and its fields: id, age, and messages.\n\nGraphQL Blueprint solves this repetition by requiring the developer just to enter the information once. Once a GraphQL type is created on this platform, root queries, mutations, client queries, and a NoSQL schema or SQL create script is auto generated and ready for download. After download, the code can be simply dragged and dropped into your code base or favorite text editor!\n\n## How To Use\n\nVisit [GraphQL Blueprint](http://graphqlblurprint.xyz/) and choose one or many database models to implement (MongoDB, PostgreSQL or MySQL). our application will generate the code for your database schemas, build scripts and GraphQL resolvers.\n\nNext create a table for every GraphQL type your application will need. Each table created will also represent the structure of your NoSQL schema or SQL table. Each created table in our application can have several fields, which not only becomes a GraphQL field, but a SQL column or NoSQL key as well. \n\n![](Screenshots/Screenshot-SchemaUpdated.png)\n![](Screenshots/Screenshot-TableSchemaUpdated.png)\n\nThe fields can be customized to meet your desired database structure, and using relations, can dynamically make the resolvers for each GraphQL type. By default at this point, our application can auto generate a server file, database setup code, and GraphQL types, root queries, mutations, and client queries.\n\n![](Screenshots/Screenshot-CodeUpdated.png)\n\nLastly export your code! The download folder will contain a readme file that describes the organization of the boilerplate code is organized and how to run it.\n\nCheck out our issues panel to learn how you can contribute and if you like our app, please give it a star!\n\n## GraphQL Blueprint Authors\n\n[Sean Yalda](https://www.linkedin.com/in/sean-yalda/)\n[@seanathon](https://github.com/Seanathon)\n\n[Ethan Yeh](https://www.linkedin.com/in/ethan-yeh-171391172/)\n[@ehwyeh](https://github.com/ehwyeh)\n\n[Kevin Berlanga](https://www.linkedin.com/in/kevinberlanga/)\n[@kevinberlanga](https://github.com/kevinberlanga)\n\n[Dylan Li](https://www.linkedin.com/in/dli107/) \n[@dylan2040](https://github.com/dylan2040)\n\n[Newas Azad](https://wwwlinkedin.com/in/newas-azad-0b0152134/) [@nazad23](https://github.com/nazad23)\n\n\n### GraphQL Blueprint is forked and iterated upon from a previous open source project called GraphQL Designer. \nMore information: [GraphQL Designer](http://graphqldesigner.com/) is a prototyping tool to develop full-stack GraphQL applications. It allowed you to model one database schema. We expanded upon it by allowing a multi-database schema, syntax highlighting, graph view, and persistant state with local storage among other things.\n\n### GraphQL Designer Authors\n\n[James Sieu](https://www.linkedin.com/in/james-sieu/) [@jamessieu](https://github.com/jamessieu)\n\n[Patrick Slagle](https://www.linkedin.com/in/patrickslagle/) [@patrickslagle](https://github.com/patrickslagle)\n\n[Greg Shamalta](https://www.linkedin.com/in/gregory-shamalta/) [@grs83](https://github.com/grs83)\n\n[Tsion Adefres](https://www.linkedin.com/in/tadefres/) [@Tsionad](https://github.com/Tsionad)\n\n## Running Your Own Version\n\nAdd `webpack\": \"webpack --watch --hot` to package.json file in scripts for hot module reloading. After adding, be sure to uncomment out \"devtool\" and \"watch\" keys from webpack.config file. \n\nBe sure to undo above actions when creating pull request to pass Circle.Ci tests.\n\nTo start the server:\n```\nnpm install\nnpm run pack\nnpm run server\n```\n\n## License\n\nThis project is licensed under the MIT License - see the [LICENSE.md](https://github.com/oslabs-beta/GraphQL-Blueprint/blob/main/LICENSE.md) file for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Foslabs-beta%2Fgraphql-blueprint","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Foslabs-beta%2Fgraphql-blueprint","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Foslabs-beta%2Fgraphql-blueprint/lists"}