Skip to content
🌍 GraphQL server for Express, Connect, Hapi, Koa and more
Branch: master
Clone or download
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.circleci Add support for Jest JUnit test output for consumption by CircleCI. Sep 26, 2018
.github Set GH CODEOWNERS and update the README (#2034) Nov 28, 2018
.vscode Add TypeScript watch as default build task Oct 12, 2018
__mocks__ Fix `apollo-server-env` mock Oct 11, 2018
docs Small documentation update (#2376) Feb 27, 2019
packages apollo-server-core: fix plugins that depend on `this` (#2470) Mar 19, 2019
types Switch `json-stable-stringify` to `fast-json-stable-stringify`. (#2065) Dec 19, 2018
.gitignore remove .DS_Store (#2055) Nov 30, 2018
.prettierignore Move prettier file globs into `.prettierrc.js` file. Sep 26, 2018
.prettierrc.js Move prettier file globs into `.prettierrc.js` file. Sep 26, 2018
CHANGELOG.md apollo-server-core: fix plugins that depend on `this` (#2470) Mar 19, 2019
CONTRIBUTING.md Tick off Prettier checkmarks, which were present on CI but not locall… Mar 16, 2018
DESIGN.md Tick off Prettier checkmarks, which were present on CI but not locall… Mar 16, 2018
LICENSE cherry-pick changes from master Jul 5, 2016
README.md Use the README.md from `packages/apollo-server` as the monorepo root … Feb 26, 2019
ROADMAP.md Setup prettier (#724) Jan 8, 2018
codecov.yml Allow 0.5% drop in codecov since it sometimes drops by tenths of perc… Oct 30, 2018
jest.config.base.js Migrate apollo-graphql package to apollo-tooling repo (#2316) Feb 14, 2019
lerna.json
netlify.toml
package-lock.json chore(deps): update dependency yup to v0.27.0 (#2463) Mar 17, 2019
package.json chore(deps): update dependency yup to v0.27.0 (#2463) Mar 17, 2019
renovate.json
tsconfig.base.json Enable `forceConsistentCasingInFileNames` in `tsconfig.base.json` Oct 11, 2018
tsconfig.build.json Merge branch 'master' into re-stage-pr-1971 Feb 14, 2019
tsconfig.json Remove test dependencies from non-test `tsconfig.json` files Oct 11, 2018
tsconfig.test.base.json Expose global `fetch` and `URL` types to avoid relying on `dom` lib Oct 11, 2018
tsconfig.test.json Merge branch 'master' into re-stage-pr-1971 Feb 14, 2019

README.md

Apollo Server

GraphQL Server for Express, Koa, Hapi, Lambda, and more.

npm version Build Status Join the community on Spectrum

Apollo Server is a community-maintained open-source GraphQL server. It works with pretty much all Node.js HTTP server frameworks, and we're happy to take PRs for more! Apollo Server works with any GraphQL schema built with GraphQL.js, so you can build your schema with that directly or with a convenience library such as graphql-tools.

Principles

Apollo Server is built with the following principles in mind:

  • By the community, for the community: Apollo Server's development is driven by the needs of developers.
  • Simplicity: By keeping things simple, Apollo Server is easier to use, easier to contribute to, and more secure.
  • Performance: Apollo Server is well-tested and production-ready.

Anyone is welcome to contribute to Apollo Server, just read CONTRIBUTING.md, take a look at the roadmap and make your first PR!

Getting started

Apollo Server is super easy to set up. Just npm install apollo-server-<integration>, write a GraphQL schema, and then use one of the following snippets to get started. For more info, read the Apollo Server docs.

There are two installation patterns:

  • Standalone: To get started without integrating with an existing web framework, use the apollo-server package.
  • Integrations: For applications which have already use a web framework (e.g. express, koa, hapi, etc.), use the appropriate Apollo Server integration package.

Installation: Standalone

In a new project, install the apollo-server and graphql dependencies using:

npm install apollo-server graphql

Then, create an index.js which defines the schema and its functionality (i.e. resolvers):

const { ApolloServer, gql } = require('apollo-server');

// The GraphQL schema
const typeDefs = gql`
  type Query {
    "A simple type for getting started!"
    hello: String
  }
`;

// A map of functions which return data for the schema.
const resolvers = {
  Query: {
    hello: () => 'world',
  },
};

const server = new ApolloServer({
  typeDefs,
  resolvers,
});

server.listen().then(({ url }) => {
  console.log(`🚀 Server ready at ${url}`);
});

Due to its human-readability, we recommend using schema-definition language (SDL) to define a GraphQL schema but a GraphQLSchema object from graphql-js can also be specified in place of typeDefs and resolvers using the schema property:

const server = new ApolloServer({
  schema: ...
});

Finally, start the server using node index.js and open your web-browser to the URL which is output on the console.

For more details, check out the Apollo Server Getting Started guide of the documentation, or for a more comprehensive understanding, see the fullstack tutorial.

For questions, the Apollo commuinty on Spectrum.chat is a great place to get assistance.

Installation: Integrations

While the standalone installation above can be used without making a decision about which web framework to use, the Apollo Server integration packages are paired with specific web frameworks (e.g. Express, Koa, hapi).

The following web frameworks have Apollo Server integrations, and each of these linked integrations has its own installation instructions and examples on its package README.md:

See the links above for more details on a specific integration.

Context

A request context is available for each request. When context is defined as a function, it will be called on each request and receive an object containing a req property which represents the request.

By returning an object from the context function, it will be available as the third positional paramter of the resolvers:

new ApolloServer({
  typeDefs,
  resolvers: {
    Query: {
      books: (parent, args, context, info) => {
        console.log(context.myProperty); // Will be `true`!
        return books;
      },
    }
  },
  context: async ({ req }) => {
    return {
      myProperty: true
    };
  },
})

Documentation

The Apollo Server documentation contains many of the details which are necessary to get started with both GraphQL and Apollo Server.

The raw source content of that documentation is available within the docs/ directory of this monorepo, but the Edit on GitHub buttons at the bottom of each page can be used to contribute suggestions or improvements to the published content.

Development

If you want to develop or contribute to Apollo Server itself, we suggest the following:

  • Fork this repository

  • Install the Apollo Server project in your computer

git clone https://github.com/[your-user]/apollo-server
cd apollo-server
npm install
cd packages/apollo-server-<integration>/
npm link
  • Install your local Apollo Server in other App
cd ~/myApp
npm link apollo-server-<integration>

For more help with contributing, visit the Contributing channel on the Apollo community in Spectrum.chat.

Maintainers

You can’t perform that action at this time.
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session.