IbanNet icon indicating copy to clipboard operation
IbanNet copied to clipboard

Add WebApp example demonstrating IBAN validation and generation

Open rorychatt opened this issue 2 months ago • 1 comments

Summary

This PR adds a new interactive web application example (examples/WebApp) that demonstrates IBAN validation and generation using IbanNet integrated with Ivy Framework. This example showcases how to build a modern, interactive web UI entirely in C# using IbanNet's core features.

image

What's Included

  • Interactive IBAN Management Application: A full-featured web app that allows users to:

    • Validate IBAN numbers with real-time feedback
    • Generate test IBANs for any supported country (100+ countries)
    • View detailed IBAN structure analysis including country information, BBAN, bank identifiers, and SEPA membership status
    • Copy IBAN numbers in multiple formats (Electronic, Print, Obfuscated)
  • Technical Implementation:

    • Uses IbanValidator for robust validation
    • Implements IbanGenerator for test IBAN creation
    • Leverages IbanParser for detailed structure analysis
    • Integrates SwiftRegistryProvider and WikipediaRegistryProvider for comprehensive country data
    • Built with Ivy Framework for a modern, responsive UI with card-based layout

Why This Example?

This example complements the existing examples (AspNetCore, AutoMapper, GenerateIbans, LimitCountries) by providing:

  • A modern web application demonstration using a cutting-edge framework
  • Interactive UI showcasing IbanNet's validation and parsing capabilities
  • A practical tool for developers to test and validate IBAN numbers
  • An example of integrating IbanNet with modern web frameworks

Requirements

  • .NET 9.0 SDK or later
  • Ivy Framework (automatically restored via NuGet)

How to Run

cd examples/WebApp dotnet restore dotnet watchThen open your browser to the URL shown in the terminal (typically http://localhost:5010).

Files Added

  • examples/WebApp/ - Complete web application example
    • Program.cs - Application entry point
    • Apps/IbanNetDemoApp.cs - Main application UI and logic
    • GlobalUsings.cs - Global using statements
    • IbanNetExample.csproj - Project file with dependencies
    • README.md - Comprehensive documentation

Testing

The application has been tested with:

  • Valid IBAN numbers from various countries
  • Invalid IBAN numbers to verify error handling
  • IBAN generation for multiple countries
  • Real-time validation feedback

rorychatt avatar Nov 03 '25 10:11 rorychatt

Hi there, I appreciate the effort but I don't believe it adds much value over the existing examples. And rather, I believe an example of this kind fits better in your own repository?

skwasjer avatar Nov 12 '25 05:11 skwasjer