Recommend an extension to use

[gajus]

There is no official recommendation for what file extension to use to store GraphQL schemas/ queries. I am assuming it would be either .graphql or .gql.

Making an official recommendation would increase consistency across all projects.

[gajus]

Based on this conversation:

File extension is recommended to be .graphql - .js should never be treated as GraphQL.

github-linguist/linguist#2637

I am assuming it is .graphql. However, I did not find this referenced in the documentation.

[iwaldman]

What would be the downside to shortening the extension to just .gql?

[gajus]

For one, it is used by another software http://filext.com/file-extension/GQL. Albeit, it seem to no longer be an active use.

On Aug 24, 2016, at 16:47, Irvin Waldman notifications@github.com wrote:

What would be the downside to shortening the extension to just .gql?

—
You are receiving this because you authored the thread.
Reply to this email directly, view it on GitHub, or mute the thread.

[alangenfeld]

We use .graphql internally at Facebook

[Vadorequest]

For the record, .graphql is natively recognised by the Intellij IDEA suite.

[trevorlasn]

Is this still being developed? Most example projects and articles still use .js. Which one is the correct way?

[leebyron]

I’m happy to entertain a formal RFC to add errata to the spec to explain that .graphql is the preferred extension when saving files in the graphql language. Of course .js should only be used for JavaScript files

On Fri, Jul 19, 2019 at 9:46 AM Indrek Lasn ***@***.***> wrote: Is this still being developed? Most example projects and articles still use .js. Which one is the correct way? — You are receiving this because you modified the open/close state. Reply to this email directly, view it on GitHub <#203?email_source=notifications&email_token=AAAMHUVOUQW7YHZG23EYPYLQAHVX7A5CNFSM4CNHUZE2YY3PNVWWK3TUL52HS4DFVREXG43VMVBW63LNMVXHJKTDN5WW2ZLOORPWSZGOD2ME6OI#issuecomment-513298233>, or mute the thread <https://github.com/notifications/unsubscribe-auth/AAAMHUUMZ65XRVFLAQNWBO3QAHVX7ANCNFSM4CNHUZEQ> .

-- Lee Byron

[cbrunnkvist]

I'm confused by the apparent implicit consensus to use .graphql both for the GraphQL schema language, and seemingly also for files containing GraphQL queries? Or maybe saving (named) queries in separate files is somehow not common practice?

[sungam3r]

These are two parts of one GraphQL language. The same situation with SQL: Data Manupulation Language (DML) and Data Definition Language (DDL) - both have .sql extension.

[Stalinko]

For the record, .graphql is natively recognised by the Intellij IDEA suite.

Let me correct you. It is not natively recognised, but there is an extension for GraphQL language which enables recognition of graphql files. At least that's the case for PHPStorm which is the same platform.
That's why I finally decided to not install one more extension just to have highlighting for these files.