Skip to content
CloudAlt Documentation

Nx Project Count Investigation

Date: October 20, 2025 (Updated post-division-consolidation)
Previous: 87 projects (before consolidation)
Current: 88 projects (after adding ui-stay-overnight)

Executive Summary

Section titled “Executive Summary”

Finding: We have 88 Nx projects after division consolidation (October 2025).

Division Consolidation (Oct 2025):

  • Consolidated 4 divisions (Homestay, Guestroom, Greenhost, Room LGBT) → Stay Overnight
  • Moved HostGuest to internal-platform (not customer-facing)
  • Result: 10 divisions → 6 divisions + internal platform

Key Architecture Insight:

  • Each -mobile project is ONE Nx project that builds BOTH Android and iOS
  • Mobile projects have separate android, ios, run-android, run-ios targets (build commands)
  • Nx does NOT create separate Android and iOS projects—it’s one project with multiple platform targets

Current Architecture:

  • 30 brand apps × 2 Nx projects per app (-mobile + -web) = 60 app projects
  • 25 package projects (including new ui-stay-overnight, deprecated packages)
  • 1 root project (cloudalt-frontend)
  • 2 docs/tooling projects
  • Total: 88 projects ✓

Naming Variations:

  • Some apps use app_name-mobile/web format
  • Others use normalized-name-mobile/web format (e.g., greenhost_app → greenhost-mobile)
  • Both are valid—Nx handles normalization

Detailed Breakdown

Section titled “Detailed Breakdown”

1. Brand Apps Inventory

Section titled “1. Brand Apps Inventory”

Total brand apps in apps/ directory: 30

Division: altfinder (3 apps)
  - altFinder_app
  - orangeFinder
  - pinkFinder


Division: bonjour-services (3 apps)
  - bonjour_it_com
  - bonjour_locker
  - lingua_it_com


Division: stay-overnight (13 apps) 🆕 CONSOLIDATED
  📁 Former Homestay brands:
    - homestay_international
    - homestay_lgbt
    - stayovernight
  📁 Former Guestroom brands:
    - guestroom_city
    - guestroom_help
    - guestroom_host
    - guestroom_lgbt
    - guestroom_pink
    - guestroom_travel
  📁 Former Greenhost brand:
    - greenhost_app ⚠️ MISSING iOS
  📁 Former Room LGBT brands:
    - room_lgbt
    - roomlgbt_app
    - rooms_gay


Division: pride-city (1 app)
  - pride_city_app ⚠️ MISSING iOS


Division: roommate (3 apps)
  - roommate_guru
  - roommate_help
  - roommate_works


Division: stay-match (5 apps)
  - orangeguest
  - pinkguest
  - purpleguest
  - rainbowhost
  - staymatch_app


Internal Platform (2 apps) 🔧 NON-CUSTOMER-FACING
  - hostguest_click (moved from division)
  - hostguest_cloud (moved from division)

2. Nx Detected Projects (86 total)

Section titled “2. Nx Detected Projects (86 total)”

App Projects (62 total)

Section titled “App Projects (62 total)”

Mobile Projects (31):

✓ altFinder_app-mobile
✓ bonjour_it_com-mobile
✓ bonjour_locker-mobile
✓ guestroom_city-mobile
✓ guestroom_help-mobile
✓ guestroom_host-mobile
✓ guestroom_lgbt-mobile
✓ guestroom_pink-mobile
✓ guestroom_travel-mobile
✓ greenhost-mobile (normalized from greenhost_app)
✓ homestay_international-mobile
✓ homestay_lgbt-mobile
✓ hostguest_cloud-mobile
✓ hostguest-click-mobile
✓ lingua_it_com-mobile
✓ orangeFinder-mobile
✓ orangeguest-mobile
✓ pinkFinder-mobile
✓ pinkguest-mobile
✓ pride_city_app-mobile
✓ purpleguest-mobile
✓ rainbowhost-mobile
✓ room_lgbt-mobile
✓ roomlgbt_app-mobile
✓ roommate_guru-mobile
✓ roommate_help-mobile
✓ roommate_works-mobile
✓ rooms_gay-mobile
✓ staymatch_app-mobile
✓ stayovernight-mobile
⚠️ @cloudalt/pinkguest-mobile (duplicate in company/cloudalt/)

Web Projects (31):

✓ altFinder_app-web
✓ bonjour_it_com-web
✓ bonjour_locker-web
✓ guestroom_city-web
✓ guestroom_help-web
✓ guestroom_host-web
✓ guestroom_lgbt-web
✓ guestroom_pink-web
✓ guestroom_travel-web
✓ greenhost-web (normalized from greenhost_app)
✓ homestay_international-web
✓ homestay_lgbt-web
✓ hostguest_cloud-web
✓ hostguest-click-web
✓ lingua_it_com-web
✓ orangeFinder-web
✓ orangeguest-web
✓ pinkFinder-web
✓ pinkguest-web
✓ pride-city-web (normalized from pride_city_app)
✓ purpleguest-web
✓ rainbowhost-web
✓ room_lgbt-web
✓ roomlgbt_app-web
✓ roommate_guru-web
✓ roommate_help-web
✓ roommate_works-web
✓ rooms-gay-web
✓ staymatch_app-web
✓ stayovernight-web
⚠️ ui-web (package project, not brand app)

Package Projects (23 total)

Section titled “Package Projects (23 total)”
@cloudalt-frontend/hooks
@cloudalt-frontend/services
@cloudalt-frontend/testing
@cloudalt-frontend/theme
@cloudalt-frontend/types
@cloudalt/assets
@cloudalt/universal-types
brands
common
design-tokens
storybook
ui
ui-altfinder
ui-bonjour-services
ui-greenhost
ui-guestroom
ui-homestay
ui-hostguest
ui-pride-city
ui-room-lgbt
ui-roommate
ui-stay-match
ui-web

Root Project (1 total)

Section titled “Root Project (1 total)”
cloudalt-frontend

Architecture Confirmation

Section titled “Architecture Confirmation”

✅ Platform Strategy: -mobile = Android + iOS Combined

Section titled “✅ Platform Strategy: -mobile = Android + iOS Combined”

Verified: Each -mobile project is ONE Nx project that handles BOTH Android and iOS platforms.

Evidence:

  • Inspecting pinkguest-mobile project shows these targets:
    • android - Build for Android
    • ios - Build for iOS
    • run-android - Run on Android device/emulator
    • run-ios - Run on iOS simulator/device
    • Plus: start, build, export, test, etc.

Architecture:

apps/stay_match/pinkguest/
├── mobile/                    ← ONE Nx project: "pinkguest-mobile"
│   ├── android/              ← Platform-specific native code
│   ├── ios/                  ← Platform-specific native code
│   ├── src/                  ← Shared React Native code
│   └── package.json          ← Defines "android" and "ios" scripts
└── web/                      ← ONE Nx project: "pinkguest-web"
    └── src/                  ← Web-specific code

Key Insight:

  • Nx counts this as 2 projects (mobile + web), not 3
  • The mobile project has multiple platform targets (Android, iOS)
  • This is standard for React Native + Expo monorepos

Math:

  • 30 brand apps × 2 Nx projects per app = 60 app projects
  • 23 packages + 1 root + 2 anomalies = 26 other projects
  • Total: 86 projects ✓

Anomalies to Address

Section titled “Anomalies to Address”

1. Duplicate: @cloudalt/pinkguest-mobile

Section titled “1. Duplicate: @cloudalt/pinkguest-mobile”

Issue: Extra mobile project detected at company/cloudalt/cloudalt-frontend/apps/stay_match/pinkguest/mobile

Impact:

  • Causes mobile project count to be 31 instead of 30
  • Potential confusion about canonical app location

Recommendation:

  • Verify if company/cloudalt/ is legacy/archived code
  • Remove company/cloudalt/cloudalt-frontend/ folder if not needed
  • Ensure all active brand apps live in canonical apps/ directory

2. Naming: ui-web Package

Section titled “2. Naming: ui-web Package”

Issue: Package project packages/ui-web ends with -web suffix, matching brand app naming pattern

Impact:

  • Appears in counts of “web projects” when filtered by -web suffix
  • Causes web project count to be 31 instead of 30

Recommendation:

  • Consider renaming to ui-shared-web or ui-web-components to avoid confusion
  • OR: Update validation scripts to exclude package projects from app counts

3. Naming Variations

Section titled “3. Naming Variations”

Issue: Inconsistent normalization of app names to project names

  • greenhost_app → greenhost-mobile, greenhost-web
  • pride_city_app → pride_city_app-mobile, pride-city-web

Impact:

  • Makes project discovery slightly harder
  • No functional issue—Nx handles it correctly

Recommendation:

  • Document that Nx auto-normalizes some names (underscores → hyphens)
  • Consider standardizing on one format in future app generation

Validation Commands

Section titled “Validation Commands”

Check Current Project Count

Section titled “Check Current Project Count”
Terminal window
yarn nx show projects --json | jq -r '.[]' | wc -l

List All Projects by Type

Section titled “List All Projects by Type”
Terminal window
# Mobile projects (should be ~30, currently 31 due to duplicate)
yarn nx show projects --json | jq -r '.[]' | grep -E "\-mobile$"


# Web projects (should be ~30, currently 31 due to ui-web package)
yarn nx show projects --json | jq -r '.[]' | grep -E "\-web$"


# Package projects
yarn nx show projects --json | jq -r '.[]' | grep -E "^(ui-|@cloudalt|brands|common|design-tokens|storybook)"

Verify Mobile Project Has Both Android and iOS Targets

Section titled “Verify Mobile Project Has Both Android and iOS Targets”
Terminal window
# Example: Check any mobile project
yarn nx show project pinkguest-mobile --json | jq '.targets | keys | map(select(. == "android" or . == "ios"))'
# Should output: ["android", "ios"]

Find Brand Apps and Their Projects

Section titled “Find Brand Apps and Their Projects”
Terminal window
# List all brand apps in apps/ directory
find apps -type d -maxdepth 3 | grep -E "apps/[^/]+/[^/]+$" | sort


# Count them
find apps -type d -maxdepth 3 | grep -E "apps/[^/]+/[^/]+$" | wc -l
# Should be: 30

Next Steps

Section titled “Next Steps”
  1. ✅ RESOLVED: Confirmed -mobile projects handle both Android + iOS via separate targets
  2. Clean Up: Investigate and potentially remove duplicate @cloudalt/pinkguest-mobile in company/cloudalt/
  3. Clarify: Decide if packages/ui-web should be renamed to avoid naming confusion
  4. Document: Add ADR for mobile platform architecture (1 mobile project = Android + iOS targets)
  5. Proceed: Continue with redundant project.json cleanup (separate task, not blocked by this)

Impact on Current Work

Section titled “Impact on Current Work”

✅ This investigation does NOT block the redundant project.json cleanup:

  • The 11 ui-* packages cleanup is still safe to proceed
  • Plugin inference works regardless of project count
  • This is a separate architectural question about project structure

Key Takeaway:

  • 86 projects is the correct count for our architecture
  • Each mobile project handles both Android and iOS via separate build targets
  • No projects are actually missing

Appendix: Full Project List

Section titled “Appendix: Full Project List”

To see the complete list of all 86 Nx projects:

Terminal window
yarn nx show projects --json | jq -r '.[]' | sort

Report Generated: October 12, 2025
Status: ✅ RESOLVED - 86 projects is correct for 30 apps × 2 Nx projects (mobile + web)
Next Actions: Clean up duplicate pinkguest-mobile, clarify ui-web naming, proceed with project.json cleanup