{"id":21529075,"url":"https://github.com/newbeea/nuxt3-apollo-starter","last_synced_at":"2025-07-17T06:05:25.568Z","repository":{"id":41202263,"uuid":"441431945","full_name":"newbeea/nuxt3-apollo-starter","owner":"newbeea","description":"nuxt3 starter: apollo server \u0026 client for graphql, i18n(internationalization), vueuse, pinia, unocss engine, aws lambda supported.","archived":false,"fork":false,"pushed_at":"2022-07-13T05:46:09.000Z","size":2088,"stargazers_count":61,"open_issues_count":3,"forks_count":7,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-04-09T23:43:46.954Z","etag":null,"topics":["apollo-client","apollo-server","aws","i18n","lambda","nuxt3","nuxt3-apollo","nuxt3-apollo-starter","nuxt3-apollo-template","serverless-render"],"latest_commit_sha":null,"homepage":"https://nuxt3-apollo-starter.vercel.app","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/newbeea.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2021-12-24T10:05:57.000Z","updated_at":"2025-01-24T18:34:24.000Z","dependencies_parsed_at":"2022-07-14T10:31:24.466Z","dependency_job_id":null,"html_url":"https://github.com/newbeea/nuxt3-apollo-starter","commit_stats":null,"previous_names":[],"tags_count":0,"template":true,"template_full_name":null,"purl":"pkg:github/newbeea/nuxt3-apollo-starter","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/newbeea%2Fnuxt3-apollo-starter","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/newbeea%2Fnuxt3-apollo-starter/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/newbeea%2Fnuxt3-apollo-starter/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/newbeea%2Fnuxt3-apollo-starter/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/newbeea","download_url":"https://codeload.github.com/newbeea/nuxt3-apollo-starter/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/newbeea%2Fnuxt3-apollo-starter/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":265571236,"owners_count":23790045,"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-client","apollo-server","aws","i18n","lambda","nuxt3","nuxt3-apollo","nuxt3-apollo-starter","nuxt3-apollo-template","serverless-render"],"created_at":"2024-11-24T01:55:45.410Z","updated_at":"2025-07-17T06:05:25.540Z","avatar_url":"https://github.com/newbeea.png","language":"TypeScript","funding_links":[],"categories":["TypeScript"],"sub_categories":[],"readme":"\n\u003ch2 align=\"center\"\u003e\nNuxt3 + Apollo Starter\n\u003c/h2\u003e\u003cbr\u003e\n\n## Preview\n[Netlify](https://nuxt3-apollo.netlify.app/)\n[Vercel](https://nuxt3-apollo-starter.vercel.app/)\n[Server](https://ssr-cdn-node.fameandpartners.com/)\n[Serverless(aws lambda)](https://ssr-sls.fameandpartners.com/)\n## Features\n\n- 💚 [Nuxt 3](https://v3.nuxtjs.org) - SSR, ESR, File-based routing, components auto importing, modules, etc.\n\n- 🌞 [@nuxt3/apollo-module](https://github.com/newbeea/nuxt3-apollo-module) - composable query, multiple [apollo clients](https://www.apollographql.com/docs/react/), ssr or client mode\n  For example:\n  ```js\n  import { useCountryQuery, usePersonQuery } from '@/generated/operations' // generated by @nuxt3/graphql-codegen-module\n\n  const { result: client, loading: queryLoading } = await useCountryQuery({\n    clientId: 'trevorblades',\n    prefetch: false, // clientMode, need validate result in template\n  })\n\n  const { result: server, loading: jumpLoading, error } = await usePersonQuery({\n    personInput: {\n      name: 'Phil Xu',\n    },\n  }, {\n    prefetch: true, // ssrMode, default: true\n  })\n\n  const { mutate: login, onDone } = useLoginMutation()\n  const { $apolloHelpers } = useNuxtApp()\n  onDone((res) =\u003e {\n    $apolloHelpers.onLogin(res.data.login.token)\n  })\n  const logout = () =\u003e {\n    $apolloHelpers.onLogout()\n  }\n\n  // use clients directly $apollo.default  $apollo.trevorblades\n  // const { $apollo } = useNuxtApp()\n  ```\n\n- 💻 [TypeGraphql](https://typegraphql.com/docs/introduction.html) + [Apollo Server](https://www.apollographql.com/docs/apollo-server/) \n\n- 💼 [@nuxt3/graphql-codegen-module](https://github.com/newbeea/nuxt3-graphql-codegen-module) - generate types and apollo composable query code on every build\n\n- 🌏 [i18n](https://github.com/intlify/nuxt3) customized intlify i18n - set preferred language according to browser, and save user's preferred language to cookie.\n\n- 🧩 Use svg by file name\n  For example:\n  ```\n  // svg file in @/assets/svgs/apollo.svg\n  \u003cSvgIcon name=\"apollo\" /\u003e\n  ```\n\n- ⚡️ Vite - Instant HMR\n\n- 🎨 [UnoCSS](https://github.com/antfu/unocss) - The instant on-demand atomic CSS engine.\n\n- 😃 Use icons from any icon sets in Pure CSS, powered by [UnoCSS](https://github.com/antfu/unocss)\n\n- 🛠 [VueUse](https://github.com/vueuse/vueuse) - collection of useful composition APIs\n\n- 🔥 The `\u003cscript setup\u003e` syntax\n\n- 🍍 [State Management via Pinia](https://pinia.esm.dev/)\n\n- 📥 APIs auto importing - for Composition API, VueUse and custom composables.\n\n- 🏎 Zero-config cloud functions and deploy\n\n- 🦾 TypeScript, of course\n## IDE\n\nWe recommend using [VS Code](https://code.visualstudio.com/) with [Volar](https://github.com/johnsoncodehk/volar) to get the best experience (You might want to disable Vetur if you have it).\n\n\n## Develop\n### Clone to local\n\nIf you prefer to do it manually with the cleaner git history\n\n```bash\nnpx degit newbeea/nuxt3-apollo-starter my-nuxt3-apollo-app\n\n```\n\n### Dev\n```\ncd my-nuxt3-apollo-app\nyarn # npm pnpm may not work properly in production mode\nyarn run dev\n```\nWebsite: http://localhost:3000\nGraphql Playground: http://localhost:3000/api/playground\n\n### Deploy\n#### Normal server\n\n#### Setup URL environment variable (if you want to use graphql server in server/api/graphql)\n\nsetup URL environment when build\nfor example:\nadd in package.json\n```\n\"build\": \"cross-env URL=https://xxx.yourdomain.com nuxi build\"\n```\nbuild\n```\nyarn run build\n```\nstart\n```\nyarn run start\n```\n#### Serverless(aws lambda) mode\n\n##### Setup cdn \nset cdnURL in nuxt.config.ts\n\n#### Setup URL environment variable (if you want to use graphql server in server/api/graphql)\n\nsetup URL environment when build\nfor example:\nadd in package.json\n```\n\"build:sls\": \"cross-env NITRO_PRESET=lambda URL=https://xxx.yourdomain.com nuxi build\"\n```\n##### build with lambda preset\n```\nyarn run build:sls\n```\n##### upload static files\nupload .output/server/public/* to cdn (cdnURL)\n\n##### custom domain (optional) \nconfig customDomain in serverless.yml\n```\ncustom:\n  customDomain:\n    http:\n      domainName: xxx.yourdomain.com\n      endpointType: regional\n      certificateName: yourdomain.com\n      createRoute53Record: true\nplugins:\n  - serverless-domain-manager\n```\nthen\n```\nyarn run domain\n```\n#### deploy\n```\nyarn run deploy\n```\nthen visit xxx.yourdomain.com\n\n\n\n\n\n### Inspiration\n[antfu/vitesse-nuxt3](https://github.com/antfu/vitesse-nuxt3)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnewbeea%2Fnuxt3-apollo-starter","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnewbeea%2Fnuxt3-apollo-starter","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnewbeea%2Fnuxt3-apollo-starter/lists"}