How do I add Google OAuth to nextjs-starter?

You need to manually configure NextAuth.js by adding Google provider credentials to the environment variables and updating the API routes, as it's not included by default. Refer to NextAuth.js documentation for specific steps, but be prepared to modify the authentication setup.

Can I use MongoDB instead of Fauna DB with this starter?

Switching to MongoDB requires significant rework, as the starter is tightly integrated with Fauna's schema and migration tools. You'd need to replace database queries, remove Fauna dependencies, and set up a new database connection, which defeats the purpose of using this boilerplate.

How to deploy nextjs-starter to Netlify since the guide is TBD?

Since the README lacks deployment instructions, you'll need to adapt general Next.js Netlify deployment guides, ensuring environment variables are set and the build configuration aligns with the starter's dependencies. This may involve trial and error due to the missing documentation.

Is nextjs-starter better than using create-next-app with manual setup?

nextjs-starter saves time if you need its specific stack (Fauna, NextAuth, React Query), but create-next-app offers more flexibility for custom tooling. Choose this starter only if you're committed to its pre-configured choices; otherwise, manual setup allows finer control.

How to customize the authentication flow in nextjs-starter?

You can modify the NextAuth.js configuration in the API routes to adjust callbacks, sessions, or UI, but changes may break existing integrations. Since it's pre-configured, deep customization requires understanding of NextAuth.js internals and careful testing.

Open-Awesome

nextjs-starter

MITJavaScript

A Next.js starter kit with authentication, TypeScript, Tailwind CSS, React Query, and Fauna DB.

Visit Website GitHub

453 stars43 forks0 contributors

What is nextjs-starter?

nextjs-starter is a pre-configured boilerplate for Next.js applications that includes authentication, TypeScript, Tailwind CSS, and React Query. It solves the problem of repetitive setup by providing a ready-to-use foundation with modern tooling and database integration, allowing developers to start building features immediately.

Target Audience

Frontend and full-stack developers building Next.js applications who want a production-ready starting point with authentication and modern tooling already configured.

Value Proposition

Developers choose this starter because it bundles essential tools like authentication, database integration, and code quality tools in one package, saving hours of configuration time while following best practices.

Overview

A starter project for next js with authentication - Contains React 17 + Typescript + Tailwind CSS 2 + React Query 3 + GitHub Auth + LinkedIn Auth + Password-less Auth + Fauna DB + ESLint + Prettier + Husky

Use Cases

Best For

Quickly prototyping Next.js applications with authentication
Building full-stack TypeScript applications with serverless databases
Starting new projects with pre-configured Tailwind CSS and React Query
Learning modern Next.js stack with real-world tooling
Creating applications requiring multiple OAuth providers
Setting up projects with enforced code quality standards

Not Ideal For

Teams planning to use a relational database like PostgreSQL instead of Fauna DB
Projects requiring authentication via providers like Google or custom OAuth not pre-configured
Developers seeking a lightweight starter without pre-integrated tools like React Query or Tailwind CSS

Pros & Cons

Pros

Integrated Authentication

Includes NextAuth.js with GitHub, LinkedIn, and passwordless email auth out of the box, reducing OAuth setup time and complexity.

Serverless Database Setup

Pre-configured with Fauna DB and fauna-schema-migrate tools, offering easy schema migrations and a serverless database solution.

Enforced Code Standards

Uses ESLint, Prettier, and Husky pre-commit hooks to ensure consistent code formatting and quality from the start.

Cons

Fauna DB Lock-in

Heavy reliance on Fauna DB makes it difficult to switch to other databases without significant code changes and migration effort.

Setup Complexity

Requires multiple environment variables and optional Docker setup for local Fauna, which can be overwhelming for quick starts.

Incomplete Documentation

Key sections like deployment guides and contributing are marked as 'TBD' in the README, leaving users to fill in gaps themselves.

Frequently Asked Questions

Related Projects

next-postgres-graphql

Blazing fast, instant realtime GraphQL APIs on all your data with fine grained access control, also trigger webhooks on database events.

💼 An enterprise-grade Next.js boilerplate for high-performance, maintainable apps. Packed with features like Tailwind CSS, TypeScript, ESLint, Prettier, testing tools, and more to accelerate your development.

Stars7,391

Forks1,978

Last commit5 days ago

Nextron

⚡ Next.js + Electron ⚡

Stars4,414

Forks256

Last commit1 month ago

RAN!

:zap: RAN! React . GraphQL . Next.js Toolkit :zap: - SEO-Ready, Production-Ready, SSR, Hot-Reload, CSS-in-JS, Caching, CLI commands and more...

Stars2,207

Forks159

Last commit3 months ago

Community-curated · Updated weekly · 100% open source

Found a gem we're missing?

Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.

Submit a project Star on GitHub