Giter VIP home page Giter VIP logo

altair's Introduction

FOSSA Status Crowdin

Chrome Web Store Mozilla Add-on npm Altair GraphQL Client GitHub release Github All Releases

Backers on Open Collective Sponsors on Open Collective

Maintenance

Deploying?

set url

Altair is a beautiful feature-rich GraphQL Client IDE for all platforms. Available for MacOS, Windows, Linux, Chrome, Firefox. It enables you interact with any GraphQL server you are authorized to access from any platform you are on.

-- the GraphQL IDE that does not require running a web server

Features

Altair provides several features that make developing with GraphQL very efficient and friendly. These features include:

  • setting headers
  • setting variables
  • creating environments
  • viewing response stats
  • viewing schema docs
  • advanced schema docs search
  • dynamically adding/generating queries and/or fragments from schema docs
  • file upload via GraphQL
  • autocompletion of queries
  • autofill all query fields at cursor
  • automatic schema refreshing using GraphQL Event Stream protocol
  • automatic refactoring of query
  • prerequest scripts
  • multiple windows, multiple languages
  • importing and exporting collections of queries
  • multiple themes
  • plugin system for extensibility
  • and many more features (really there's a lot more!).

See more here: https://altair.sirmuel.design/docs/features

Missing feature?

Is there a feature that is missing? You can let us know by creating a new issue or you can add the feature by creating a Pull Request.

Sponsors

Thanks to all our sponsors for sponsoring this project! Do you use Altair GraphQL client at your company? Consider supporting this project as a major sponsor (primary, gold, silver or bronze) on open collective.

Primary Sponsor

XKojiMedia

To be a primary sponsor, reach out to us.

Gold Sponsor

Become a Gold sponsor of Altair to appear here.

Usage

For mac users, you can also install using cask:

$ brew install --cask altair-graphql-client

For linux users, you can also install using snap:

$ snap install altair

For arch linux users, an AUR package aur/altair exists:

$ yay -S altair

For windows users, you can install using appget:

$ appget install altair-graphql

or chocolatey:

$ choco install altair-graphql

Usage with express

You can use altair with an express server using altair-express-middleware. Read more about how to use this here.

Usage with koa

You can use altair with a koa server using altair-koa-middleware. Read more about how to use this here.

Usage with Fastify

You can use altair with a Fastify server using altair-fastify-plugin. Read more about how to use this here.

Usage with Laravel (PHP)

You can use altair in a Laravel project using xkojimedia/laravel-altair-graphql:

$ composer require xkojimedia/laravel-altair-graphql

You can find other available integrations here: https://altair.sirmuel.design/docs/integrations

Configuration Options

When using a custom instance of Altair, there are couple of options you can use to customize Altair based on your needs:

  • endpointURL string - URL to set as the server endpoint
  • subscriptionsEndpoint string - URL to set as the subscription endpoint
  • initialSubscriptionsProvider "websocket" | "graphql-ws" | "app-sync" | "action-cable" - Initial subscriptions provider
  • initialQuery string - Initial query to be added
  • initialVariables string - Initial variables to be added (in JSON format) e.g. '{ "var1": "first variable" }'
  • initialPreRequestScript string - Initial pre-request script to be added e.g. 'altair.helpers.getEnvironment("api_key")'
  • initialHeaders IDictionary - Initial headers object to be added
{
  'X-GraphQL-Token': 'asd7-237s-2bdk-nsdk4'
}
  • initialEnvironments IInitialEnvironments - Initial Environments to be added
{
  base: {
    title: 'Environment',
    variables: {}
  },
  subEnvironments: [
    {
      title: 'sub-1',
      variables: {}
    }
  ]
}
  • instanceStorageNamespace string - Namespace for storing the data for the altair instance. Use this when you have multiple altair instances running on the same domain. e.g. 'altair_dev_'

Example usage:

AltairGraphQL.init({
  endpointURL: 'https://www.example.com/graphql',
  initialVariables: '{ "username": "imolorhe" }',
});

Supported Browsers

Altair has been tested in the latest versions of Google Chrome and Mozilla Firefox. It might not work as expected in other browsers like Safari and Edge.

Community 🙏🏾

You can learn more about how to get help here.

Contributing

Would you like to help with translations? https://altair-gql-translate.surge.sh/ Click here.

Donate to Altair

Learn more about contributing to Altair here and here.

Development

Read more here.

License

FOSSA Status

altair's People

Contributors

allcontributors[bot] avatar amrmak avatar andrewhyi avatar bartosz6 avatar connorads avatar dependabot[bot] avatar eokoneyo avatar fluorescenthallucinogen avatar greenkeeper[bot] avatar imolorhe avatar jaydenseric avatar joseph-so avatar kawarimidoll avatar lenartbezek avatar lon-io avatar macjuul avatar mathewthecoder avatar mbao01 avatar mokeyish avatar monkeywithacupcake avatar pabloszx avatar paulomcnally avatar qonn avatar rfigueroa avatar salbertson avatar seanonthenet avatar sganz avatar snyk-bot avatar tizmagik avatar vrobik avatar

Watchers

 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.