# Milesoft

> Innovative, clean, and efficient software solutions for everyday challenges.

## Our Story
Milesoft was born in a healthcare facility to solve a manual scheduling headache for RNs and CNAs. From that original solution, we've grown into a suite of "software with a soul," building professional tools and games for the people we love.

## App Portfolio at a Glance

| App Name | Core Audience | The "Milesoft" Touch | Primary Benefit |
| :--- | :--- | :--- | :--- |
| **Milesoft Schedule** | Healthcare & SME Admins | "Paperless Power" designed by a former administrator. | Eliminates the "juggling act" of shift management. |
| **Milesoft Offerings** | Churches & Non-profits | Built for a best friend to simplify donation tracking. | Secure, transparent financial management. |
| **Milesoft Connections** | General Users | Relational graph engine for social topology. | Visualize and manage your network of people. |
| **Milesoft Sudoku** | Logic Enthusiasts | Zero-bloat, minimalist interface. | Pure focus on the puzzle, no distracting "freemium" noise. |
| **Milesoft Words** | Word Game Lovers | Clean, elegant design for daily play. | Sharpens vocabulary without the clutter. |
| **Milesoft Dots** | Gamers & Superhero Fans | Physics-based mechanics with a fun, heroic aesthetic. | Tactical mental exercise with high-energy visuals. |
| **Milesoft Reveal** | Parents & Young Children | Simple, tactile discovery mechanics. | Safe, engaging digital exploration for kids. |
| **Milesoft CLI** | Developers & AI Agents | Dual-mode CLI + Model Context Protocol (MCP) server. | Secure terminal control and AI programmatic platform access. |

## Our Core Applications

### Milesoft Schedule
Professional-grade employee shift scheduling software and roster management.
- **URL:** https://milesoft.io/schedule
- **Purpose:** Digitize workforce management with "Paperless Power."
- **Key Features:** Realtime phone notifications, automated shift trades, and volunteer requests.
- **Reporting:** Detailed attendance tracking (Came In/No Show) with CSV exports.
- **Target:** Businesses looking to streamline employee coordination without the clutter.

### Milesoft Offerings
Secure church donation management and member tracking software.
- **URL:** https://milesoft.io/offerings
- **Purpose:** Built for a best friend to simplify church donation tracking and community management.
- **Key Features:** Record offerings, member/household directory, and integrated calendar for church events.
- **Reporting:** One-click CSV exports for financial transparency and audits.
- **Security:** Role-based access control for Admins, Deacons, and Secretaries.

### Milesoft Connections (BETA)
Relational graph engine for mapping the important people in your life.
- **URL:** https://milesoft.io/connections
- **Purpose:** Visualize and manage your personal and professional social topology.
- **Key Features:** Dynamic SVG graph rendering, automated vertical/horizontal layouts, and enriched metadata storage.
- **Actions:** One Tap, Quick Action (Call, Text, Email, and Directions directly from node-based contacts).
- **Status:** Currently in Beta access.

### Milesoft Sudoku
A high-performance tactical Sudoku engine for pilots of all skill levels.
- **URL:** https://milesoft.io/sudoku
- **Tactical Systems:** Switch between **Efficiency (number-first)** and **Precision (cell-first)** navigation protocols.
- **Advanced Assistance:** The **Copilot** provides real-time system diagnostics, interactive laser beam hints, and logical parity coloring for complex chains.
- **Strategic Tools:** Deploy the **Quantum Palette** for note coloring and use the **Flight Recorder** for full history rewind/replay.
- **Terminal Authorization:** Master Advanced missions to unlock the **System Architect** terminal for heuristic re-sequencing.
- **Experience:** Pure, zero-bloat logic with a persistent **Streak-Link**, galactic rank progression, and full offline play support.
- **Supported Solving Techniques (56):**
  - **Placements (11):** Last Digit, Full Box, Full Line, Box-Line, Line-Line, Line-Box, Box-Lines, Line-Lines, Line-Boxes, Intersection, Counting.
  - **Reductions (45):** Exposed Single, Hidden Single, Pointing Line, Claiming Line, Exposed Pair, Hidden Pair, Exposed Triple, Hidden Triple, Exposed Quad, Hidden Quad, X-Wing, Skyscraper, 2-String Kite, Empty Rectangle, Swordfish, Finned X-Wing, Sashimi X-Wing, Jellyfish, Finned Swordfish, Sashimi Swordfish, Finned Jellyfish, Sashimi Jellyfish, Unique Rectangle T1-T6, Hidden Rectangle, Binary Universal Grave +1 (BUG+1), XY-Wing, XYZ-Wing, W-Wing, Sue de Coq T1-T3, Remote Pairs, Simple Coloring, X-Chain, 3D Medusa, XY-Chain, Alternate Inference Chain T1-T2, Discontinuous Nice Loop, Continuous Nice Loop.

### Milesoft Words
A multiplayer word logic game designed for daily mental exercise.
- **URL:** https://milesoft.io/words
- **Gameplay:** Guess hidden words using logic hints (correct spot, wrong spot, not in word).
- **Social:** Daily challenges, friend challenges, and global leaderboards.
- **Design:** Sharpens vocabulary using a clean, elegant Lexicon-based interface.

### Milesoft Dots
A tactical strategy game focused on simplicity and spatial reasoning.
- **URL:** https://milesoft.io/dots
- **Gameplay:** Explosive chain reactions of dots in a "superhero playground."
- **Villains:** Specialized threats like Wizards, Healers, and Clockwork units.
- **Research Lab:** Permanent upgrades for speed and power, plus advanced unlocks like Quickdraw.
- **Power-ups:** Strategic use of Block, Shockwave, Freeze, Duplicate, and Magnetism.
- **Social:** Compete on weekly and permanent leaderboards.

### Milesoft Reveal
A relaxing image reveal game designed for stress relief and sensory engagement.
- **URL:** https://milesoft.io/reveal
- **Focus:** ASMR-style relaxation. Gently wipe away digital paint to reveal beautiful images.
- **Hay Economy:** Unlock themed content (Beach, Forest, Snow) using Piece, Gift, or Bales of Hay.
- **Safety:** Parental Gate protected by bunny-themed math challenges for secure play.
- **Privacy:** Local-first architecture; use your own photos without them ever leaving your device.

### Milesoft CLI & MCP Server
A secure administrative command-line interface and Model Context Protocol server.
- **[CLI Command Reference](https://milesoft.io/docs/cli/cli-overview)**: Comprehensive CLI usage instructions and command reference guide.
- **Purpose:** Provide secure terminal controls for human engineers and stdio-based JSON-RPC tools for AI agents.
- **Key Features:** Secure keyring storage, silent token refresh middleware, and interactive multi-app context switching.
- **MCP Server:** Exposes programmatic tools like list_accounts, list_users, search_docs, and view_docs to AI clients.
- **Safety:** Redirection of standard loggers keeps standard output clean for error-free JSON-RPC message transport.

## Platform Developer Documentation
We provide a comprehensive developer portal detailing onboarding, core concepts, and SDK integration:

### 1. Developer Onboarding
- **[Platform Prerequisites](https://milesoft.io/docs/onboarding/prerequisites)** — Configure workstation, CLIs (gcloud/milesoft), and local runtimes.
- **[Platform Architecture Overview](https://milesoft.io/docs/onboarding/platform)** — Understand Gateway routing, JWT token propagation, and multi-tenant isolation.
- **[Artifact Registry Setup](https://milesoft.io/docs/onboarding/artifact-registry)** — Learn how Gradle resolves private Milesoft libraries and dependencies under the hood.
- **[Getting Started Guide](https://milesoft.io/docs/onboarding/getting-started)** — Step-by-step instructions to bootstrap a new Spring Boot application.

### 2. Platform SDKs
- **[Accounts SDK](https://milesoft.io/docs/sdks/accounts-sdk)** — Strongly-typed client for user directories, identity management, and credentials.
- **[Contacts SDK](https://milesoft.io/docs/sdks/contacts-sdk)** — Programmatic interface to the relational graph engine.
- **[Games SDK](https://milesoft.io/docs/sdks/games-sdk)** — Sync progression, manage leaderboards, and process challenge metadata.
- **[Liquid SDK](https://milesoft.io/docs/sdks/liquid-sdk)** — Low-latency Liquid compiling and dynamic PDF/document layouts.
- **[Notifications SDK](https://milesoft.io/docs/sdks/notifications-sdk)** — Dispatch transactional cross-channel alerts (SMS, Email, Push).

### 3. Core Frameworks & Extensions
- **[App-Stack Library](https://milesoft.io/docs/libraries/app-stack)** — Core framework scaffolding, tenancy filters, and Jackson serializers.
- **[Cloud Extensions](https://milesoft.io/docs/cli/sdks)** — Production-grade connectors for Firestore, IAM, Pub/Sub, Secrets, Storage, OpenAI, Vertex AI, QuickBooks, Square, Twilio, and Stripe.

## Tech Stack & Philosophy
We build with a "performance-first" mindset. Our apps prioritize privacy and speed using a hybrid "local-first" architecture. Sensitive user assets remain on-device, while progression metadata is securely synced via Google Cloud Platform. We use modern, static-first technologies (like Astro) for a fast, AI-readable web presence.

## Contact & Socials
- Website: https://milesoft.io
- Email: support@milesoft.io
- LinkedIn: https://www.linkedin.com/company/milesoft/?viewAsMember=true
- YouTube: https://www.youtube.com/channel/UCWBQFMO4yW4_k-8pbDd2UVw?sub_confirmation=1
- Focus: Software Engineering & Game Design

---
[Full Documentation](https://milesoft.io/llms-full.txt)