Skip to content

Conversation

@rorychatt
Copy link

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

@skwasjer
Copy link
Owner

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?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants