Prepare SGuard for initial release:

- Add NuGet metadata and icon files.
- Introduce CONTRIBUTING.md for contribution guidelines.
- Enhance documentation with badges and corrections.
- Update source code for extensibility and multi-version .NET support.

Author: selcukgural

CONTRIBUTING.md

@@ -0,0 +1,41 @@
+# Contributing to SGuard.DataAnnotations
+
+Thank you for your interest in contributing to SGuard! We welcome contributions from everyone. This guide will help you get started.
+
+## How to Contribute
+
+1. **Fork the repository**
+    - Click the "Fork" button at the top of the GitHub page to create your own copy.
+2. **Clone your fork**
+    - `git clone https://github.com/selcukgural/SGuard.DataAnnotations.git`
+3. **Create a branch**
+    - `git checkout -b my-feature-branch`
+4. **Make your changes**
+    - Add your improvements, bug fixes, or documentation updates.
+5. **Test your changes**
+    - Ensure all tests pass and your code is robust.
+6. **Commit and push**
+    - `git commit -am "Describe your change"`
+    - `git push origin my-feature-branch`
+7. **Open a Pull Request**
+    - Go to your fork on GitHub and click "New Pull Request."
+
+## Code Style
+- Follow .NET and C# best practices.
+- Write clear, concise, and well-documented code.
+- Add XML comments for public APIs.
+
+## Reporting Issues
+- Use GitHub Issues to report bugs, request features, or ask questions.
+- Please provide as much detail as possible.
+
+## Community Standards
+- Be respectful and inclusive.
+- Follow the [Code of Conduct](.github/CODE_OF_CONDUCT.md).
+
+## License
+By contributing, you agree that your contributions will be licensed under the MIT License.
+
+---
+
+Thank you for helping make SGuard.DataAnnotations better!

README.md

@@ -1,8 +1,14 @@
 # SGuard.DataAnnotations
 
+![CI](https://github.com/selcukgural/SGuard.DataAnnotations/actions/workflows/ci.yml/badge.svg)
+[![NuGet Version](https://img.shields.io/nuget/v/SGuard.DataAnnotations.svg?style=flat-square)](https://www.nuget.org/packages/SGuard.DataAnnotations/)
+[![NuGet Downloads](https://img.shields.io/nuget/dt/SGuard.DataAnnotations.svg?style=flat-square)](https://www.nuget.org/packages/SGuard.DataAnnotations/)
+[![Coverage](https://codecov.io/gh/selcukgural/SGuard.DataAnnotations/branch/main/graph/badge.svg)](https://codecov.io/gh/selcukgural/SGuard.DataAnnotations)
+
+
 **SGuard.DataAnnotations** provides localized and extensible DataAnnotations support for .NET, including:
 - Localizable validation attributes (with robust fallback and custom error handling)
-- Collection, conditional, and property comparison validators not found in standard DataAnnotations
+- Collection, conditional, and property comparison validators are not found in standard DataAnnotations
 - Guard pattern (`Is.*` for boolean return, `ThrowIf.*` for exception-throwing) for model validation
 - Seamless integration with DataAnnotations and SGuard's fail-fast/callback philosophy
 - Well-tested and extensible for real-world application scenarios
@@ -74,35 +80,34 @@ SGuard.DataAnnotations ships with built-in resource support for the following la
 > **Note:**
 > - If the current UI culture is not found, SGuard will fallback to English or to the fallback message if provided.
 > - You can add your own resource files to support additional languages.
-> - [How to add your own language?](#how-to-add-custom-language)
-
+> - [How to add your own language?](#how-to-add-a-custom-language)
 ---
 
 ## Supported Attributes
 
 ### String & Common Validators
 
-| Attribute                             | Purpose                                       | Supported Types                   | Example Usage |
-|----------------------------------------|-----------------------------------------------|-----------------------------------|---------------|
-| `SGuardRequiredAttribute`              | Required field (localized)                    | Any                              | `[SGuardRequired(typeof(Resources.SGuardDataAnnotations), "Username_Required")]` |
-| `SGuardMinLengthAttribute`             | Minimum string length                         | `string`, `array`, `ICollection` | `[SGuardMinLength(5, typeof(Resources.SGuardDataAnnotations), "Username_MinLength")]` |
-| `SGuardMaxLengthAttribute`             | Maximum string length                         | `string`, `array`, `ICollection` | `[SGuardMaxLength(20, typeof(Resources.SGuardDataAnnotations), "Username_MaxLength")]` |
-| `SGuardStringLengthAttribute`          | Min/max string length                         | `string`                         | `[SGuardStringLength(12, typeof(Resources.SGuardDataAnnotations), "Username_MaxLength")]` |
-| `SGuardRegularExpressionAttribute`     | Regex pattern                                 | `string`                         | `[SGuardRegularExpression("^[a-zA-Z0-9_]+$", typeof(Resources.SGuardDataAnnotations), "Username_InvalidCharacters")]` |
-| `SGuardEmailAddressAttribute`          | Email format                                  | `string`                         | `[SGuardEmailAddress(typeof(Resources.SGuardDataAnnotations), "Email_InvalidFormat")]` |
-| `SGuardPhoneAttribute`                 | Phone format                                  | `string`                         | `[SGuardPhone(typeof(Resources.SGuardDataAnnotations), "Profile_Phone_Invalid")]` |
-| `SGuardUrlAttribute`                   | URL format                                    | `string`                         | `[SGuardUrl(typeof(Resources.SGuardDataAnnotations), "Common_Url_Invalid")]` |
-| `SGuardCreditCardAttribute`            | Credit card format                            | `string`                         | `[SGuardCreditCard(typeof(Resources.SGuardDataAnnotations), "Common_CreditCard_Invalid")]` |
-| `SGuardRangeAttribute`                 | Value must be within a numeric range          | `int`, `double`                  | `[SGuardRange(1, 10, typeof(Resources.SGuardDataAnnotations), "Common_Range")]` |
+| Attribute                          | Purpose                              | Supported Types                  | Example Usage                                                                                                         |
+|------------------------------------|--------------------------------------|----------------------------------|-----------------------------------------------------------------------------------------------------------------------|
+| `SGuardRequiredAttribute`          | Required field (localized)           | Any                              | `[SGuardRequired(typeof(Resources.SGuardDataAnnotations), "Username_Required")]`                                      |
+| `SGuardMinLengthAttribute`         | Minimum string length                | `string`, `array`, `ICollection` | `[SGuardMinLength(5, typeof(Resources.SGuardDataAnnotations), "Username_MinLength")]`                                 |
+| `SGuardMaxLengthAttribute`         | Maximum string length                | `string`, `array`, `ICollection` | `[SGuardMaxLength(20, typeof(Resources.SGuardDataAnnotations), "Username_MaxLength")]`                                |
+| `SGuardStringLengthAttribute`      | Min/max string length                | `string`                         | `[SGuardStringLength(12, typeof(Resources.SGuardDataAnnotations), "Username_MaxLength")]`                             |
+| `SGuardRegularExpressionAttribute` | Regex pattern                        | `string`                         | `[SGuardRegularExpression("^[a-zA-Z0-9_]+$", typeof(Resources.SGuardDataAnnotations), "Username_InvalidCharacters")]` |
+| `SGuardEmailAddressAttribute`      | Email format                         | `string`                         | `[SGuardEmailAddress(typeof(Resources.SGuardDataAnnotations), "Email_InvalidFormat")]`                                |
+| `SGuardPhoneAttribute`             | Phone format                         | `string`                         | `[SGuardPhone(typeof(Resources.SGuardDataAnnotations), "Profile_Phone_Invalid")]`                                     |
+| `SGuardUrlAttribute`               | URL format                           | `string`                         | `[SGuardUrl(typeof(Resources.SGuardDataAnnotations), "Common_Url_Invalid")]`                                          |
+| `SGuardCreditCardAttribute`        | Credit card format                   | `string`                         | `[SGuardCreditCard(typeof(Resources.SGuardDataAnnotations), "Common_CreditCard_Invalid")]`                            |
+| `SGuardRangeAttribute`             | Value must be within a numeric range | `int`, `double`                  | `[SGuardRange(1, 10, typeof(Resources.SGuardDataAnnotations), "Common_Range")]`                                       |
 
 ### Collection Validators
 
-| Attribute                                 | Purpose                                                         | Supported Types                | Example Usage |
-|--------------------------------------------|-----------------------------------------------------------------|-------------------------------|---------------|
-| `SGuardRequiredCollectionAttribute`        | Collection must not be null/empty                               | `IEnumerable`, arrays, etc.   | `[SGuardRequiredCollection(typeof(Resources.SGuardDataAnnotations), "Common_Collection_Required")]` |
-| `SGuardMinCountAttribute`                  | Minimum item count in collection                                | `IEnumerable`, arrays, etc.   | `[SGuardMinCount(2, typeof(Resources.SGuardDataAnnotations), "Common_Collection_MinCount")]` |
-| `SGuardMaxCountAttribute`                  | Maximum item count in collection                                | `IEnumerable`, arrays, etc.   | `[SGuardMaxCount(5, typeof(Resources.SGuardDataAnnotations), "Common_Collection_MaxCount")]` |
-| `SGuardCollectionItemsMatchAttribute`      | Each item must match one/more validators (e.g. regex, required) | `IEnumerable`, arrays, etc.   | `[SGuardCollectionItemsMatch(typeof(EmailAddressAttribute), typeof(Resources.SGuardDataAnnotations), "Email_InvalidFormat", AggregateAllErrors = true)]` |
+| Attribute                             | Purpose                                                         | Supported Types             | Example Usage                                                                                                                                            |
+|---------------------------------------|-----------------------------------------------------------------|-----------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------|
+| `SGuardRequiredCollectionAttribute`   | Collection must not be null/empty                               | `IEnumerable`, arrays, etc. | `[SGuardRequiredCollection(typeof(Resources.SGuardDataAnnotations), "Common_Collection_Required")]`                                                      |
+| `SGuardMinCountAttribute`             | Minimum item count in collection                                | `IEnumerable`, arrays, etc. | `[SGuardMinCount(2, typeof(Resources.SGuardDataAnnotations), "Common_Collection_MinCount")]`                                                             |
+| `SGuardMaxCountAttribute`             | Maximum item count in collection                                | `IEnumerable`, arrays, etc. | `[SGuardMaxCount(5, typeof(Resources.SGuardDataAnnotations), "Common_Collection_MaxCount")]`                                                             |
+| `SGuardCollectionItemsMatchAttribute` | Each item must match one/more validators (e.g. regex, required) | `IEnumerable`, arrays, etc. | `[SGuardCollectionItemsMatch(typeof(EmailAddressAttribute), typeof(Resources.SGuardDataAnnotations), "Email_InvalidFormat", AggregateAllErrors = true)]` |
 
 **Details:**
 - `SGuardCollectionItemsMatchAttribute` can take multiple validators and will apply them to each item.
@@ -111,18 +116,18 @@ SGuard.DataAnnotations ships with built-in resource support for the following la
 
 ### Conditional Validators
 
-| Attribute                       | Purpose                                         | Supported Types | Example Usage |
-|----------------------------------|-------------------------------------------------|----------------|---------------|
-| `SGuardRequiredIfAttribute`      | Field required if another property equals value | Any            | `[SGuardRequiredIf("Country", "USA", typeof(Resources.SGuardDataAnnotations), "Address_Required")]` |
+| Attribute                   | Purpose                                         | Supported Types | Example Usage                                                                                       |
+|-----------------------------|-------------------------------------------------|-----------------|-----------------------------------------------------------------------------------------------------|
+| `SGuardRequiredIfAttribute` | Field required if another property equals value | Any             | `[SGuardRequiredIf("Country", "USA", typeof(Resources.SGuardDataAnnotations), "Address_Required")]` |
 
 ### Comparison Validators
 
-| Attribute                              | Purpose                                  | Supported Types      | Example Usage |
-|-----------------------------------------|------------------------------------------|---------------------|---------------|
-| `SGuardCompareAttribute`                | Values must be equal (like CompareAttribute) | Any              | `[SGuardCompare("Password", typeof(Resources.SGuardDataAnnotations), "Password_Mismatch")]` |
-| `SGuardBetweenAttribute`                | Value must be between two properties     | IComparable types   | `[SGuardBetween("Min", "Max", true, typeof(Resources.SGuardDataAnnotations), "Common_Between")]` |
-| `SGuardGreaterThanAttribute`            | Value must be greater than another property | IComparable types | `[SGuardGreaterThan("MinAge", typeof(Resources.SGuardDataAnnotations), "Profile_BirthDate_MinimumAge")]` |
-| `SGuardLessThanAttribute`               | Value must be less than another property | IComparable types   | `[SGuardLessThan("MaxAge", typeof(Resources.SGuardDataAnnotations), "Profile_BirthDate_MaximumAge")]` |
+| Attribute                    | Purpose                                      | Supported Types   | Example Usage                                                                                            |
+|------------------------------|----------------------------------------------|-------------------|----------------------------------------------------------------------------------------------------------|
+| `SGuardCompareAttribute`     | Values must be equal (like CompareAttribute) | Any               | `[SGuardCompare("Password", typeof(Resources.SGuardDataAnnotations), "Password_Mismatch")]`              |
+| `SGuardBetweenAttribute`     | Value must be between two properties         | IComparable types | `[SGuardBetween("Min", "Max", true, typeof(Resources.SGuardDataAnnotations), "Common_Between")]`         |
+| `SGuardGreaterThanAttribute` | Value must be greater than another property  | IComparable types | `[SGuardGreaterThan("MinAge", typeof(Resources.SGuardDataAnnotations), "Profile_BirthDate_MinimumAge")]` |
+| `SGuardLessThanAttribute`    | Value must be less than another property     | IComparable types | `[SGuardLessThan("MaxAge", typeof(Resources.SGuardDataAnnotations), "Profile_BirthDate_MaximumAge")]`    |
 
 **Supported types:** `int`, `double`, `decimal`, `DateTime`, `string`, etc. (anything implementing `IComparable`)
 
@@ -184,7 +189,7 @@ SGuard.DataAnnotations ships with built-in resource support for the following la
 #### Exception Details
 
 - Throws `DataAnnotationsException` by default, which contains all validation errors.
-- Extract errors (see also [`SGuard.DataAnnotations.Extensions`](src/Extensions/DataAnnotationsExceptionExtensions.cs)):
+- Extract errors (see also [`SGuard.DataAnnotations.Extensions`](./SGuard.DataAnnotations/src/Extensions/DataAnnotationsExceptionExtensions.cs)):
     ```csharp
     catch (DataAnnotationsException ex)
     {
@@ -222,8 +227,8 @@ SGuard.DataAnnotations ships with built-in resource support for the following la
 
 ## Extending SGuard.DataAnnotations
 
-Want to add your own fully-localized validation attribute?  
-Just inherit from `SGuardValidationAttributeBase` and implement `IsValid`:
+Want to add your own fully localized validation attribute?  
+Inherit from `SGuardValidationAttributeBase` and implement `IsValid`:
 
 ```csharp
 public class MyCustomLocalizedAttribute : SGuardValidationAttributeBase

SGuard.DataAnnotations.sln

@@ -14,8 +14,8 @@ Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "Solution Items", "Solution
 		.gitignore = .gitignore
 		CHANGELOG.md = CHANGELOG.md
 		LICENSE = LICENSE
+		CONTRIBUTING.md = CONTRIBUTING.md
 		.github\CODE_OF_CONDUCT.md = .github\CODE_OF_CONDUCT.md
-		.github\CONTRIBUTING.md = .github\CONTRIBUTING.md
 		.github\SECURITY.md = .github\SECURITY.md
 		README.md = README.md
 	EndProjectSection

SGuard.DataAnnotations/SGuard.DataAnnotations.csproj

@@ -4,6 +4,24 @@
         <TargetFrameworks>net6.0;net7.0;net8.0;net9.0</TargetFrameworks>
         <ImplicitUsings>enable</ImplicitUsings>
         <Nullable>enable</Nullable>
+        <GeneratePackageOnBuild>true</GeneratePackageOnBuild>
+        <!-- NuGet Metadata -->
+        <PackageId>SGuard.DataAnnotations</PackageId>
+        <Version>0.1.0</Version>
+        <Authors>Selçuk Güral</Authors>
+        <Company>Selçuk Güral</Company>
+        <Description>Advanced, extensible, and multilingual data validation and guard clause library for .NET. Includes custom validation attributes, guard helpers, and resource-based error messages for enterprise-grade applications.</Description>
+        <PackageTags>validation;data-annotations;guard;multilingual;localization;attributes;.NET;enterprise;library</PackageTags>
+        <PackageProjectUrl>https://github.com/selcukgural/SGuard.DataAnnotations</PackageProjectUrl>
+        <RepositoryUrl>https://github.com/selcukgural/SGuard.DataAnnotations</RepositoryUrl>
+        <RepositoryType>git</RepositoryType>
+        <PackageLicenseUrl>https://opensource.org/licenses/MIT</PackageLicenseUrl>
+        <PackageLicenseExpression>MIT</PackageLicenseExpression>
+        <PackageIcon>icon.png</PackageIcon>
+        <Copyright>Copyright © 2025 Selçuk Güral</Copyright>
+        <PackageReleaseNotes>Initial release. Supports .NET 6, 7, 8, 9. Multilingual validation, guard clauses, and CI/CD integration.</PackageReleaseNotes>
+        <Title>SGuard.DataAnnotations - Advanced Multilingual Validation &amp; Guard Library for .NET 
+</Title>
     </PropertyGroup>
 
     <ItemGroup>