Welcome to the Authentication Project! This project provides a robust and secure authentication system, including user registration, email verification, and sign-in functionalities. It's designed to be a foundational component for web applications requiring user authentication.
- User Registration: Allows users to create an account with their personal details and password.
- Email Verification: Sends a verification code to the user's email address to confirm their identity.
To set up the project locally, follow these steps:
- Clone the Repository:
git clone https://github.com/johneliud/authentication-project.git
- Navigate to the Project Directory:
cd authentication-project
- Set Up Environment Variables:
- Create a
.env
file in the root directory. - Add the following environment variables:
SMTP_EMAIL=your-email@example.com SMTP_PASSWORD=your-email-password SMTP_SERVER=smtp.gmail.com SMTP_PORT=587
- Create a
Note: Replace placeholder values like your-email@example.com
and your-username
with your actual information when setting up the project.
- Run the Application:
go run .
- Sign-Up: Users can register by providing their first name, last name, email, and password. Upon successful registration, a verification code is sent to their email.
- Email Verification: After registration, users should enter the verification code received via email to verify their account.
- Sign-In: Once verified, users can sign in using their email and password.
We welcome contributions to enhance the Authentication Project. To contribute, please follow these guidelines:
- Fork the Repository: Click on the 'Fork' button at the top right corner of the repository page to create a copy of the repository in your GitHub account.
- Clone Your Fork:
git clone https://github.com/your-username/authentication-project.git
- Create a New Branch:
git checkout -b feature/your-feature-name
- Make Your Changes: Implement your feature or fix the identified issue.
- Commit Your Changes:
git commit -m "Add your commit message here"
- Push to Your Fork:
git push origin feature/your-feature-name
- Submit a Pull Request: Navigate to the original repository and click on 'New Pull Request'. Provide a clear description of your changes and submit the pull request for review.
Please ensure your contributions align with the project's coding standards and include appropriate tests.
This project is licensed under the MIT License. See the LICENSE file for more details.
For any questions or suggestions, please contact me.