Dynamic Form Builder Package

A flexible and powerful .NET 9 package for building dynamic forms with rich validation and customization options.

Features

• Create and manage dynamic forms with various question types
• Support for multiple question types:
  • Text (single-line and multi-line)
  • DateTime (with optional time component)
  • Single Choice (dropdown or radio buttons)
  • Multiple Choice (checkboxes)
• Built-in validation framework
• Form submissions storage and retrieval
• Clean Architecture design
• Full UI components for form design and rendering
• API-first approach with Swagger documentation

Architecture

The solution follows Clean Architecture principles with the following projects:

• DynamicFormBuilder.Domain: Core entities and business rules
• DynamicFormBuilder.Application: Use cases, interfaces, and application logic
• DynamicFormBuilder.Infrastructure: Data persistence and external integrations
• DynamicFormBuilder.UI: Razor components for form rendering
• DynamicFormBuilder.Api: RESTful API endpoints

Prerequisites

• .NET 9.0 SDK
• SQL Server (can be run using Docker)
• Visual Studio 2022+ or Visual Studio Code

Installation

1. Clone the repository:

git clone https://github.com/yourusername/form-builder-package.git cd form-builder-package

2. Restore dependencies:

dotnet restore

3. Update database connection string in appsettings.json:

{ "ConnectionStrings": { "DefaultConnection": "Server=localhost;Database=FormBuilder;Trusted_Connection=True;MultipleActiveResultSets=true" } }

4. Apply database migrations:

cd DynamicFormBuilder.Api dotnet ef database update

Usage

API Integration

1. Add package references to your project:

<PackageReference Include="DynamicFormBuilder.Core" Version="1.0.0" /> <PackageReference Include="DynamicFormBuilder.EntityFrameworkCore" Version="1.0.0" />

2. Register services in your Program.cs:

services.AddDynamicFormBuilder(options => { options.UseConnectionString("DefaultConnection"); options.UsePermissions(PermissionScheme.Simple); });

UI Integration

1. Add the UI package:

<PackageReference Include="DynamicFormBuilder.UI" Version="1.0.0" />

2. Use the components in your Razor pages:

<DynamicFormDesigner FormId="@formId" /> <DynamicFormRenderer FormId="@formId" />

API Documentation

The API is documented using Swagger/OpenAPI. When running in development mode, access the Swagger UI at:

https://localhost:5001/swagger

Testing

The solution includes comprehensive tests:

dotnet test

Includes:

• Unit tests for domain logic
• Integration tests for repositories
• End-to-end API tests
• UI component tests

Contributing

1. Fork the repository
2. Create a feature branch
3. Commit your changes
4. Push to the branch
5. Create a Pull Request

License

This project is licensed under the MIT License - see the LICENSE file for details.