{"id":29150584,"url":"https://github.com/geldata/nextjs-gel-basic-template","last_synced_at":"2025-10-12T18:11:22.598Z","repository":{"id":257441623,"uuid":"851113081","full_name":"geldata/nextjs-gel-basic-template","owner":"geldata","description":"This starter is designed to help you get up and running with Gel and Next.js quickly. It includes a basic Gel schema and a UI to get you started.","archived":false,"fork":false,"pushed_at":"2025-04-04T12:14:36.000Z","size":85,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-06-25T19:15:04.390Z","etag":null,"topics":["gel","nextjs","starter","template","vercel"],"latest_commit_sha":null,"homepage":"https://nextjs-gel-basic-template.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/geldata.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,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-09-02T12:56:40.000Z","updated_at":"2025-06-18T02:11:15.000Z","dependencies_parsed_at":"2024-09-25T01:52:28.043Z","dependency_job_id":"485b3911-5b43-45d4-9acf-cbae078988e7","html_url":"https://github.com/geldata/nextjs-gel-basic-template","commit_stats":null,"previous_names":["edgedb/nextjs-edgedb-basic-template","geldata/nextjs-gel-basic-template"],"tags_count":0,"template":true,"template_full_name":null,"purl":"pkg:github/geldata/nextjs-gel-basic-template","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/geldata%2Fnextjs-gel-basic-template","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/geldata%2Fnextjs-gel-basic-template/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/geldata%2Fnextjs-gel-basic-template/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/geldata%2Fnextjs-gel-basic-template/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/geldata","download_url":"https://codeload.github.com/geldata/nextjs-gel-basic-template/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/geldata%2Fnextjs-gel-basic-template/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":262868624,"owners_count":23377270,"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":["gel","nextjs","starter","template","vercel"],"created_at":"2025-06-30T23:34:29.398Z","updated_at":"2025-10-12T18:11:22.529Z","avatar_url":"https://github.com/geldata.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🎉 Gel + Next.js template\n\nThis starter is designed to help you get up and running with Gel and Next.js quickly. It includes a basic Gel schema and a UI to get you started. Below you can find the steps to set up the project and start building your app as well as some ideas for extending it further.\n\n[![Deploy with Vercel](https://vercel.com/button)](https://vercel.com/new/clone?repository-url=https%3A%2F%2Fgithub.com%geldata%2Fnextjs-gel-basic-template\u0026stores=%5B%7B%22type%22%3A%22integration%22%2C%22integrationSlug%22%3A%gel%22%2C%22productSlug%22%3A%gel%22%7D%5D)\n\nThis template includes:\n\n- [Next.js](https://nextjs.org) for React framework\n- [Gel](https://geldata.com) for database\n- [Tailwind CSS](https://tailwindcss.com) for utility-first CSS framework\n- [ESLint](https://eslint.org) for linting\n\n## 🧐 What's inside?\n\n```sh\n.\n├── README.md\n├── app\n│   ├── favicon.ico\n│   ├── globals.css\n│   ├── layout.tsx\n│   └── page.tsx\n├── components/\n├── src/\n├── public/\n├── dbschema\n│   ├── default.esdl\n├── gel.toml\n├── eslint.config.js\n├── next-env.d.ts\n├── next.config.js\n├── package.json\n├── pnpm-lock.yaml\n├── postcss.config.js\n├── tailwind.config.ts\n└── tsconfig.json\n```\n\nDirectory structure:\n\n- `app/` - Next.js pages and components\n- `public/` - static assets\n- `components/` - React components\n- `src/` - utility functions\n- `dbschema/` - Gel schema and migrations\n- `gel.toml` - Gel configuration\n- `gel.ts` - Gel client\n- `eslint.config.js` - ESLint configuration\n- `next-env.d.ts` - Next.js types\n- `next.config.js` - Next.js configuration\n- `package.json` - npm dependencies\n- `pnpm-lock.yaml` - pnpm lockfile\n- `postcss.config.js` - PostCSS configuration\n- `tailwind.config.ts` - Tailwind CSS configuration\n- `tsconfig.json` - TypeScript configuration\n\n## 🚀 Quick start\n\nTo get started with this template, you need to:\n\n### 1. Clone the repository \u0026 install dependencies\n\n```sh\ngit clone https://github.com/geldata/nextjs-gel-basic-template.git\ncd nextjs-gel-basic-template\n\npnpm i\n```\n\nYou can also click the \"Use this template\" button to create a new repository based on this template.\n\n### 2. Install Gel CLI (optional)\n\nYou can just use `npx gel`, it would do the right thing\nto automatically install and run Gel CLI for you.\n\nThis README will use `npx gel \u003ccommand\u003e` style, but if you have\nthe CLI installed you can use it directly, like this: `gel \u003ccommand\u003e`.\n\n\u003cdetails\u003e\u003csummary\u003eHowever, you can install the CLI manually\u003c/summary\u003e\n\n```sh\ncurl --proto '=https' --tlsv1.2 -sSf https://sh.geldata.com | sh\n```\n\nFor more installation options, see the [Gel installation guide](https://docs.geldata.com/cli).\n\n\u003c/details\u003e\n\n### 3. Initialize Gel project\n\nTo run this project, you need to initialize a new Gel project. Run the following command:\n\n```sh\nnpx gel project init\n```\n\n### 4. Generate types\n\nThis template includes a script to generate TypeScript types from the Gel schema. Run the following command:\n\n```sh\npnpm generate:all\n```\n\n### 5. Start the development server\n\n```sh\npnpm dev\n```\n\nFollow the instructions in the terminal to open the app in your browser.\n\n### 6. Open the Gel UI\n\nTo view the database in the Gel UI run:\n\n```sh\nnpx gel ui\n```\n\n## ✨ Next steps\n\n### Extend the Gel schema\n\nOpen the `dbschema/default.gel` file and add your own types and\nfields. You can start by adding a `Post` type with a\n`title` and `content` field. For example:\n\n```sql\ntype Post {\n  # Add your new fields here:\n  required title: str;\n  required content: str;\n}\n```\n\n### Edit the Gel query\n\nOpen the `app/page.tsx` file and update the query\nto include your new type.\n\n```ts\nconst postsQuery = e.select(e.Post, (_post) =\u003e ({\n  id: true,\n  title: true,\n  content: true,\n  // Add your other fields here\n}))\n```\n\n## 👩‍🏫 Learn More\n\nExplore a list of resources to help you get started with Gel and Next.js:\n\n- [Generative UI with Vercel AI SDK and Gel](https://www.geldata.com/blog/generative-ui-with-vercel-ai-sdk-and-edgedb)\n- [Stop building auth, start building apps with Gel and Next.js](https://www.geldata.com/blog/stop-building-auth-start-building-apps-with-edgedb-and-next-js)\n- [Building a simple blog application with Gel and Next.js](https://docs.geldata.com/guides/tutorials/nextjs_app_router)\n- [Integrating Gel with tRPC](https://docs.geldata.com/guides/tutorials/trpc)\n- [The ultimate TypeScript query builder](https://www.geldata.com/blog/designing-the-ultimate-typescript-query-builder)\n\nTo learn more about Next.js, take a look at the following resources:\n\n- [Next.js Documentation](https://nextjs.org/docs) - learn about Next.js features and API.\n- [Learn Next.js](https://nextjs.org/learn) - an interactive Next.js tutorial.\n\nYou can also check out the [Gel documentation](https://geldata.com/docs) to learn more about Gel and Gel Auth.\n\n## ☁️ Deployment\n\nFollow the deployment instructions in the [Gel documentation](https://docs.geldata.com/guides/tutorials/nextjs_app_router#deploying-to-vercel) to deploy your Next.js app to Gel Cloud and Vercel.\n\nOr \n\n[![Deploy with Vercel](https://vercel.com/button)](https://vercel.com/new/clone?repository-url=https%3A%2F%2Fgithub.com%geldata%2Fnextjs-gel-basic-template\u0026stores=%5B%7B%22type%22%3A%22integration%22%2C%22integrationSlug%22%3A%gel%22%2C%22productSlug%22%3A%gel%22%7D%5D)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgeldata%2Fnextjs-gel-basic-template","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgeldata%2Fnextjs-gel-basic-template","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgeldata%2Fnextjs-gel-basic-template/lists"}