Skip to content

docs: modern README with logo, badges, screenshots + Apache-2.0 license#18

Merged
HarryCordewener merged 3 commits into
masterfrom
docs/modern-readme
Jul 1, 2026
Merged

docs: modern README with logo, badges, screenshots + Apache-2.0 license#18
HarryCordewener merged 3 commits into
masterfrom
docs/modern-readme

Conversation

@HarryCordewener

Copy link
Copy Markdown
Member

Reworks README.md into a proper landing page, and adds a license.

README

  • Centered brand logo (the green app icon) + tagline
  • Status badges — CI, latest release, .NET 10, platforms (Android · Web), license
  • Features overview (MU* protocols, ANSI/MXP rendering, triggers & aliases, reconnect, cross-platform, testable core)
  • Screenshots — Mobile / Tablet / Web, captured from the live web client (the session view rendering Convergence's welcome screen)
  • Clearer Install (Android via Obtainium + the Web dotnet run path), Build from source, Architecture (now includes the Web and Data projects the old table omitted), Tech stack, Contributing, License, Acknowledgements
  • Prose reflowed to one line per paragraph (no mid-sentence hard wraps)

License

  • Adds the Apache License 2.0 (LICENSE) and points the README + badge at it.

Assets

  • .github/assets/logo.png — brand mark
  • .github/assets/screenshot-{mobile,tablet,web}.png

No source/csproj changes, so this is independent of the TNC-bump PRs.

🤖 Generated with Claude Code

HarryCordewener and others added 3 commits July 1, 2026 02:21
Rework README.md into a proper landing page: centered logo (the brand-green app
icon), status badges (CI, latest release, .NET 10, platforms), a features
overview, a Screenshots section (Mobile/Tablet/Web), and clearer Install
(Android via Obtainium + Web), Build-from-source, Architecture, Tech stack,
Contributing, License and Acknowledgements sections. Documents the Web head and
the Data project, which the old layout table omitted.

Screenshot images are wired up under .github/assets/ and will be added next.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01HHCRc5CJ6595iMzEgYYdQp
Add the Apache License 2.0 and point the README's License section (and a new
license badge) at it, replacing the earlier "all rights reserved / TBD" note.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01HHCRc5CJ6595iMzEgYYdQp
Capture the session view (Convergence welcome screen) at phone, tablet and
desktop viewports for the Screenshots section, and reflow the prose paragraphs
to one line each (no mid-sentence hard wraps).

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01HHCRc5CJ6595iMzEgYYdQp
Copilot AI review requested due to automatic review settings July 1, 2026 07:45

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR modernizes the repository’s top-level documentation by turning README.md into a more complete landing page (branding, badges, screenshots, install/build/architecture sections) and adds an Apache-2.0 LICENSE file so the project’s licensing is explicit and linkable from the README.

Changes:

  • Reworked README.md structure and content (branding header, badges, features, screenshots, install/build-from-source guidance, architecture/tech stack, contributing, license, acknowledgements).
  • Added Apache License 2.0 text as LICENSE and linked to it from the README/badge.

Reviewed changes

Copilot reviewed 2 out of 6 changed files in this pull request and generated 3 comments.

File Description
README.md Rewritten as a polished landing page with badges, screenshots, and expanded install/build/architecture content.
LICENSE Adds Apache License 2.0 file for repository licensing.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread LICENSE
Comment on lines +1 to +2

Apache License
Comment thread README.md
## Build from source

## Building & testing
The day-to-day loop needs no Android SDK — it runs on the `Core`, `Data` and `UI` projects and the test suites:
Comment thread README.md
```sh
# Core + UI + Tests (no Android SDK required)
dotnet build SharpClient.slnx # note: excludes the App head if it can't build
dotnet build SharpClient.slnx # solution (skips the App head if it can't build)
@HarryCordewener
HarryCordewener merged commit edddc93 into master Jul 1, 2026
3 checks passed
@HarryCordewener
HarryCordewener deleted the docs/modern-readme branch July 1, 2026 07:59
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