appwrite / website

The Appwrite website, docs and blog 🏠
https://appwrite.io
203 stars 193 forks source link

📚 Documentation: Deep dive authentication recipe with Next.js #91

Open gewenyu99 opened 1 year ago

gewenyu99 commented 1 year ago

💭 Description

Goal

Deep dive tutorial for beginners to learn Appwrite Authentication in depth with Next.js.

Content

  1. The end product should be a functional app with auth screens.
  2. Step by step from setup. If there will be test data, provide a Server SDK script with instructions.
  3. Format should be similar to /docs/tutorials/sveltekit
  4. Should contain the following content
    1. Sign up
    2. Log in
    3. Verification
    4. Recovery
    5. Conditional routing based on auth state
    6. Preferences
    7. Delete account

How to contribute

Pitch an outline detailing each page you plan to add and headings within, and ask to be assigned. Open a PR after the outline has been approved.

The Appwrite team will collaborate with you on the outline and PR.

Thanks for taking the time to make our documentation better 🙏

👀 Have you spent some time to check if this issue has been raised before?

🏢 Have you read the Code of Conduct?

Nishantjain10 commented 1 year ago

Hey @gewenyu99 and @Haimantika, I would like to contribute to this issue! Here's the detailed outline for the docs!

Outline: Deep Dive Authentication Recipe with Next.js Documentation

1. Introduction

2. Prerequisites

3. Setting Up the Next.js Project

4. Creating the Sign-up Page

5. Implementing the Login Page

6. User Verification

7. Password Recovery

8. Conditional Routing Based on Authentication State

9. User Preferences

10. Account Deletion

11. Testing and Deployment

12. Conclusion

13. How to Contribute

14. Troubleshooting

15. Additional Resources

Here is my past work, that I've done for appwrite:

Blogs:

Video

PS. Also, made a lot of memes in discord xd!

Nishantjain10 commented 1 year ago

Hey, any updates @Haimantika @gewenyu99?

gewenyu99 commented 1 year ago

@Nishantjain10 What will you be using for routing?

gewenyu99 commented 1 year ago

I would suggest revising your tutorial to be a smaller scope, closer to the suggested set of content :)

suryanshsoni120 commented 1 year ago

If the issue hasn't been resolved, I would like to work on this. Can you assign it to me?

Nishantjain10 commented 1 year ago

Hey, I've already started working on it!

image image

If the issue hasn't been resolved, I would like to work on this. Can you assign it to me?

gewenyu99 commented 1 year ago

@Nishantjain10 can you make sure the contents covered are:

Thanks!

Gilbishkosma commented 1 year ago

hi @gewenyu99 @Haimantika , i want to contribute to this one, you can assign it to me if no one else is working on it, thanks.

gewenyu99 commented 1 year ago

I decided to do an example project, this way all the guides can be consistent. Please follow the outline and format here: https://github.com/appwrite/website/issues/89

hey-nicolasklein commented 1 year ago

@gewenyu99 @Haimantika hey DevRel could you make sure to use the new App Router for the tutorial? I'm currently searching for a reliable way to integrate authentication with the new App Router, and for React Server Components as well as Client Components. Could you make sure to touch that topic in the guide 🙏

Supabase has a few tutorials online, but they define custom auth helpers to work with the React Server Components and React Client Components.

Haimantika commented 1 year ago

@Nishantjain10 do you have an update?Will have to reassign the issue to the next person due to inactivity from your end

Nishantjain10 commented 1 year ago

@Nishantjain10 do you have an update?Will have to reassign the issue to the next person due to inactivity from your end

Hey, sorry, I had some problem with my laptop. I'm working on it.

gewenyu99 commented 1 year ago

@gewenyu99 @Haimantika hey DevRel could you make sure to use the new App Router for the tutorial? I'm currently searching for a reliable way to integrate authentication with the new App Router, and for React Server Components as well as Client Components. Could you make sure to touch that topic in the guide 🙏

Supabase has a few tutorials online, but they define custom auth helpers to work with the React Server Components and React Client Components.

I'll tag you for review 😆 I'm more of a Svelte/Vue person than Next.js.

Thanks for the suggestion :)

Nishantjain10 commented 1 year ago

@gewenyu99 @Haimantika hey DevRel could you make sure to use the new App Router for the tutorial? I'm currently searching for a reliable way to integrate authentication with the new App Router, and for React Server Components as well as Client Components. Could you make sure to touch that topic in the guide 🙏

Supabase has a few tutorials online, but they define custom auth helpers to work with the React Server Components and React Client Components.

Sure I will keep that in mind, going to use app router only!

Nishantjain10 commented 1 year ago

Hey @gewenyu99, would it be okay if I use Tailwind CSS or custom CSS to improve the design of the login form?

image
gewenyu99 commented 1 year ago

@Nishantjain10 I would rather have no CSS than tailwind. It's unrelated and unnecessary complexity.