graphql-engine/community/sample-apps/nuxtjs-postgres-graphql/README.md

nuxtjs-postgres-graphql

Boilerplate to get started with Nuxt.js, Hasura GraphQL engine as CMS and postgres as database using the create-nuxt-app and @nuxtjs/apollo module.

Tutorial

• Deploy GraphQL Engine on Hasura Cloud and setup PostgreSQL via Heroku:

  

• Get the Hasura app URL (say nuxtjs-graphql.hasura.app)

• Create author table:

  Open Hasura console: visit https://nuxtjs-graphql.hasura.app on a browser
  Navigate to Data section in the top nav bar and create a table as follows:

  

• Insert sample data into author table:

  

  Verify if the row is inserted successfully

  

• Similarly, create an article table with the following data model: table: article columns: id, title, content, author_id (foreign key to author table's id)

• Clone this repo:

  git clone https://github.com/hasura/graphql-engine
  cd graphql-engine/community/sample-apps/nuxtjs-postgres-graphql
  

• Install npm modules:

  npm install
  

• Open apollo/clientConfig.js and configure Hasura's GraphQL Endpoint as follows:

  
    import { InMemoryCache } from "apollo-cache-inmemory";
    export default function(context){
      return {
            httpLinkOptions: {
                uri: 'https://nextjs-graphql.hasura.app/v1/graphql',
                credentials: 'same-origin'
            },
            cache: new InMemoryCache(),
            wsEndpoint: 'ws://nextjs-graphql.hasura.app/v1/graphql',
      }
    }
  

• We have defined the graphql query in apollo/queries/fetchAuthor.gql.

  • GraphQL query

  
  query {
    author {
      id
      name
    }
  }
  
  

  • In pages/index.vue, we import author query.

  
  <script>
  import author from '~/apollo/queries/fetchAuthor'
  
  export default {
    apollo: {
      author: {
        prefetch: true,
        query: author
      }
    },
    head: {
      title: 'Authors of Blog'
    }
  }
  </script>
  
  

• Run the app:

  npm run dev
  

• Test the app Visit http://localhost:3000 to view the app

For detailed explanation on how things work, checkout Nuxt.js docs.