Files
vibn-frontend/README.md
2026-02-10 13:23:03 -08:00

139 lines
3.2 KiB
Markdown

# Product OS - Master AI
> A Product-Centric IDE built on Eclipse Theia, optimized for Google Cloud and powered by Gemini AI.
## Overview
Product OS is NOT a general-purpose IDE. It's a **Product Operating System** designed to unify:
- 💻 **Code** - Build and deploy Cloud Run services
- 📢 **Marketing** - Automate campaigns and content
- 📊 **Analytics** - Product intelligence and insights
- 🚀 **Growth** - Optimize onboarding and conversion
- 💬 **Support** - Customer feedback integration
- 🧪 **Experiments** - A/B testing and rollouts
- 🏗️ **Infrastructure** - Production monitoring
All powered by AI and optimized for Google Cloud.
## Vision
See [Google_Cloud_Product_OS.md](./Google_Cloud_Product_OS.md) for complete vision and requirements.
## Project Structure
```
master-ai/
├── theia/ # Customized Eclipse Theia IDE
│ ├── packages/core/ # UI shell customization
│ ├── packages/terminal/ # Terminal customization
│ ├── packages/monaco/ # Editor themes
│ └── examples/electron/ # Mac app build
├── Google_Cloud_Product_OS.md # Product vision & requirements
├── UI-DESIGN-GUIDE.md # Design customization guide
└── README.md # This file
```
## Getting Started
### Prerequisites
- Node.js 20.x (use nvm)
- Python 3
- Git
### Installation
```bash
# Clone this repo
git clone https://github.com/MawkOne/master-ai.git
cd master-ai/theia
# Use Node 20
nvm use 20
# Install dependencies
npm install
# Build Electron app
npm run build:electron
# Launch Product OS
npm run start:electron
```
## Customization
See [UI-DESIGN-GUIDE.md](./UI-DESIGN-GUIDE.md) for complete customization guide.
### Quick Design Changes
**Change colors:** Edit `theia/packages/monaco/data/monaco-themes/vscode/dark_vs.json`
**Change fonts:** Edit `theia/packages/core/src/browser/style/index.css`
**Change layout:** Edit `theia/packages/core/src/browser/shell/application-shell.ts`
## Development Workflow
```bash
cd theia
# Watch mode (auto-rebuild on changes)
npm run watch:electron
# In another terminal, run the app
npm run start:electron
```
## Building Distribution
```bash
cd theia/examples/electron
# Build Mac app (.app, .dmg)
npm run package:mac
# Output: dist/Product-OS-*.dmg
```
## Roadmap
### Phase 1: Core Simplification ✅
- [x] Clone Theia
- [x] Set up repository
- [ ] Lock dark theme
- [ ] Remove preference menus
- [ ] Simplify UI
### Phase 2: Custom Layout
- [ ] Replace Application Shell structure
- [ ] Create 7 Product OS sections
- [ ] Custom navigation/activity bar
- [ ] Section-specific views
### Phase 3: Google Cloud Integration
- [ ] Pre-configure GCP tools
- [ ] Add Gemini AI integration
- [ ] Remove non-GCP options
### Phase 4: Product OS Features
- [ ] Marketing automation UI
- [ ] Analytics dashboards
- [ ] Growth experiment tools
- [ ] Support integration
## Architecture
Built on [Eclipse Theia](https://github.com/eclipse-theia/theia) - an extensible IDE framework using TypeScript and Electron.
## License
Based on Eclipse Theia:
- Eclipse Public License 2.0
- GNU General Public License, version 2 with the GNU Classpath Exception
## Author
Built by [@MawkOne](https://github.com/MawkOne)