Better Nuxt GraphQL Starter Kit

⚠️ Work in Progress - This project is currently under active development and not yet ready for production use.

A modern, production-ready starter template built with Nuxt 4, featuring GraphQL API, authentication, database management, file uploads, and state management.

🚀 Features

• undefinedNuxt 4 - The latest version of the Vue.js meta-framework
• undefinedNitro GraphQL - Native GraphQL support for Nitro server
• undefinedBetter Auth - Modern authentication system with social providers
• undefinedDrizzle ORM - TypeScript ORM with SQL-like syntax
• undefinedPinia Colada - Smart data fetching and caching for Pinia
• undefinedFile Upload - Built-in image/file upload handling with optimization
• undefinedTypeScript - Full type safety across the stack
• undefinedAuto-imports - Components, composables, and utilities auto-imported
• undefinedSSR/SSG Ready - Server-side rendering and static generation support

📋 Prerequisites

• Node.js 22+
• pnpm +10.13 (recommended) or npm/yarn
• PostgreSQL database (for Drizzle ORM)

🛠️ Installation

1. undefinedClone the repositoryundefined

git clone https://github.com/productdevbook/better-nuxt-graphql-starter-kit.git
cd better-nuxt-graphql-starter-kit

2. undefinedInstall dependenciesundefined

pnpm install

3. undefinedEnvironment Setupundefined

Create a .env file in the root directory:

# Database
DATABASE_URL="postgresql://user:password@localhost:5432/dbname"

# Better Auth
AUTH_SECRET="your-auth-secret-here"
AUTH_URL="http://localhost:3000"

# OAuth Providers (optional)
GITHUB_CLIENT_ID=""
GITHUB_CLIENT_SECRET=""

# File Upload
UPLOAD_DIR="./uploads"
MAX_FILE_SIZE="10485760"  # 10MB in bytes

4. undefinedDatabase Setupundefined

Initialize the database with Drizzle:

pnpm db:generate   # Generate migrations
pnpm db:migrate    # Run migrations
pnpm db:studio     # Open Drizzle Studio (optional)

🚀 Development

Start the development server:

pnpm dev

The application will be available at http://localhost:3000

Available Scripts

pnpm dev          # Start development server
pnpm build        # Build for production
pnpm preview      # Preview production build
pnpm generate     # Generate static site
pnpm typecheck    # Run TypeScript type checking
pnpm lint         # Run ESLint
pnpm lint:fix     # Fix ESLint issues

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

• Nuxt Team for the amazing framework
• UnJS for Nitro and ecosystem tools
• Better Auth for authentication
• Drizzle Team for the ORM
• Vue Team for Vue.js and Pinia

📞 Support

• 🐛 Issues: GitHub Issues

---

Built with ❤️ by productdevbook