Nudge

Minimal API client. A clean, minimal online request tester built with Blazor WebAssembly and ASP.NET Core, with support for Collections.

Important

NUDGE just released Collections, a way to group your APIs into folders for better organizations. It's still early, but we're excited for you to try it!

Table of Contents

1. Features
2. Live Demo
3. Screenshots
4. Tech Stack
5. Repository Structure
6. Getting Started
7. Code Style & Practices
8. License

---

Features

Status	Feature
✅	Compose requests: Set method, URL, and body
✅	Organise into Collections: Organise your API requests into collections
✅	Displays response: Status, headers, content
✅	Shared Library: DTOs and Models in Nudge.Lib
✅	Responsive layout: Mobile and desktop support

---

Live Demo

🔗 nudge-client.azurewebsites.net

---

Screenshots

Click to view screenshots

---

Tech Stack

Layer	Technology
Client	Blazor WebAssembly (.NET 9)
Server	ASP.NET Core Web API (Controllers/)
Shared Models	.NET Class Library (Nudge.Lib)
Hosting	Azure App Service

---

Repository Structure

Nudge/
├── Nudge.Client/                # Blazor WASM frontend
│   ├── Pages/                  # Main Razor pages (e.g. Home.razor)
│   ├── Services/               # HttpClient logic (ApiService)
│   ├── Shared/                 # Shared UI components (e.g. NewRequest, NewCollection)
│   ├── Program.cs              # WASM bootstrapping
│   └── wwwroot/                # Static assets & settings

├── Nudge/                       # ASP.NET Core backend
│   ├── Controllers/            # API proxy logic (RequestManagerController, CollectionManagerController)
│   ├── Repositories/           # Repository Interfaces and Implementations (IRequestRepository, ICollectionRepository, Dapper-based Implementations)
│   ├── Components/             # Razor layout & routing (App.razor etc.)
│   └── Program.cs              # API startup & configuration

├── Nudge.Lib/                  # Shared DTOs and models
│   ├── Dtos/                   # Request/response contract classes
│   ├── Models/                 # Domain-level models
│   └── Nudge.Lib.csproj

├── Screenshots/               # UI images for README
├── Nudge.sln                  # Solution file
└── README.md

---

Getting Started

Prerequisites

• [.NET 9 SDK]
• Git

Local Development

# 1. Clone the repository
$ git clone https://github.com/abhinav-0401/Nudge.git
$ cd Nudge


$ dotnet user-secrets init
# sets the Azure DB connection string in user directory
$ dotnet user-secrets set "AzureSqlNudge" "DB_CONNECTION_STRING"

# (runs the project on localhost:5014)
$ dotnet run --project Nudge

---

Code Style & Practices

• C#: Follow the Microsoft C# style guide.
• Shared contracts are declared in Nudge.Lib to avoid duplication
• Backend uses Dapper for lightweight DB operations
• Razor component logic is co-located with markup
• Separation of layers:
  • Frontend (Nudge.Client)
  • Backend (Nudge)
  • Shared library (Nudge.Lib)

---

License

This project is licensed under the MIT License.

---