Feature: Multi-Client Foundation

[0xklkuo]

Multi-client foundation release

This release expands Markdown Typer from a web-first learning app into a small multi-client full-stack TypeScript learning platform.

Highlights

• added a macOS-first Electron desktop shell
• added an iOS-first NativeScript mobile client
• introduced shared note-domain packages for:
  • shared types
  • reusable note utilities
  • reusable notes API client logic
• refreshed documentation, CI alignment, and release-readiness guidance

---

Included in this release

Backend and shared foundation

• backend remains the source of truth for note behavior and title derivation
• shared note-domain code now supports reuse across clients through:
  • packages/shared-types
  • packages/shared-notes

Web

• web remains the primary reference client
• markdown preview remains supported on web

Desktop

• desktop is now available through a thin Electron shell over the web app
• desktop intentionally stays minimal and web-backed

Mobile

• iOS-first NativeScript client is now included
• current mobile scope supports:
  • list notes
  • open a note
  • create a note
  • edit note content
  • autosave
  • mobile-friendly list/detail navigation

Documentation and quality

• root docs refreshed to reflect actual multi-client support
• architecture and roadmap docs updated
• publish checklist updated for the multi-client repository state
• CI updated to align with workspace validation flow

---

Proven current support

Client	Status	Notes
API	Supported	NestJS + Prisma backend
Web	Supported	Primary reference client
Desktop	Supported, limited	Electron shell over web
Mobile iOS	Supported, limited	NativeScript iOS-first client
Mobile Android	Not supported	Deferred

---

Known limitations

• desktop is intentionally a thin shell over the web app
• mobile is currently iOS-first only
• mobile markdown preview is intentionally deferred for now
• Android support is not included yet
• packaging and store distribution workflows are outside the current scope
• single-user local mode remains the operating model
• auth, sync, and collaborative editing remain deferred

---

Validation summary

The repository was validated through:

• pnpm check
• pnpm test
• pnpm build
• manual verification of web, desktop, and mobile flows

---

Project direction

This release is intentionally framed as a foundation milestone, not full cross-platform parity.

The goal is to keep the repository:

• clear
• minimal
• maintainable
• educational
• incrementally extensible