https://github.com/hummbl-dev/hummbl-mobile
HUMMBL Mobile - Mental Models for Better Thinking (Expo/React Native)
https://github.com/hummbl-dev/hummbl-mobile
Last synced: 4 months ago
JSON representation
HUMMBL Mobile - Mental Models for Better Thinking (Expo/React Native)
- Host: GitHub
- URL: https://github.com/hummbl-dev/hummbl-mobile
- Owner: hummbl-dev
- Created: 2025-10-15T23:34:02.000Z (9 months ago)
- Default Branch: main
- Last Pushed: 2026-02-13T17:24:52.000Z (5 months ago)
- Last Synced: 2026-02-14T01:20:20.449Z (5 months ago)
- Language: TypeScript
- Homepage: https://hummbl.io
- Size: 2.18 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Governance: governance/CAES_CANONICAL.sha256
Awesome Lists containing this project
README
# HUMMBL Mobile
Mobile application for HUMMBL - Mental Models for Better Thinking.
Built with Expo SDK 50 and React Native, leveraging Base120 mental model transformations for structured thinking frameworks.
## Structure
```
hummbl-mobile/
├── mobile/ # Expo mobile app
│ ├── app/ # Expo Router screens
│ │ ├── (tabs)/ # Tab navigation
│ │ ├── mental-models/ # Model detail screens
│ │ └── narratives/ # Narrative detail screens
│ └── theme/ # Design system
├── shared/ # Platform-agnostic code
│ ├── src/types/ # TypeScript interfaces
│ ├── src/stores/ # Zustand state management
│ ├── src/hooks/ # React hooks
│ └── src/utils/ # Utilities (fuzzy search, etc.)
└── package.json # Monorepo root
```
## Quick Start
```bash
# Install dependencies
pnpm install
# Start development
pnpm dev
# Build shared types
pnpm build:shared
# Run linting
pnpm lint
# Type checking
pnpm typecheck
```
## Features
- **Mental Models** - Browse 120 mental models organized by transformation type
- **Narratives** - Evidence-based thinking frameworks with citations
- **Search** - Fuzzy search across all content
- **Bookmarks** - Save and organize favorites
- **Offline Support** - Zustand persistence with AsyncStorage
## Base120 Transformations
Six transformation domains, 20 models each:
| Code | Domain | Focus |
|------|--------|-------|
| P | Perspective | Reframing viewpoints |
| IN | Inversion | Thinking backwards |
| CO | Composition | Building up from parts |
| DE | Decomposition | Breaking down complexity |
| RE | Recursion | Patterns at multiple levels |
| SY | Systems | Interconnections and feedback |
## Tech Stack
- **Expo SDK 50** - Cross-platform mobile development
- **React Native 0.73** - Native mobile UI
- **Expo Router** - File-based navigation
- **Zustand** - Lightweight state management
- **TypeScript** - Type safety throughout
## Development
### Prerequisites
- Node.js 20+
- pnpm 9+
- Expo Go app (for device testing)
### Workspace Commands
```bash
# Mobile app
pnpm --filter @hummbl/mobile
# Shared package
pnpm --filter @hummbl/shared
# All packages
pnpm -r
```
## License
Proprietary - HUMMBL