MertCapkin-GraphCraft 0.1.1

Mobile game/app design layer on GraphStack — design graph, style packs, aesthetic engine

GraphCraft 🎨📱

Mobile game & app design layer on GraphStack.
Design graph · style packs · aesthetic engine · Stitch import · wide mobile stack support.

GraphCraft is the product you install and use. GraphStack is a dependency that provides orchestration (cycle, gate, roles, code graph). GraphCraft adds the design layer without forking or patching GraphStack.

Graphify     → code graph        (graphify-out/)
GraphStack   → orchestration     (cycle, gate, roles)     ← dependency
GraphCraft   → design layer      (graphcraft-out/, design-system/)

Important: GraphCraft never modifies GraphStack source. Integration is overlay-only: extra rules, skills, orchestrator/GRAPHCRAFT.md, and graphcraft CLI. GraphStack files come from the MertCapkin_GraphStack package unchanged.

---

Quick Start

Requirements: Python 3.8+, Git, Cursor

Install (PyPI — after v0.1.1 release)

pip install "MertCapkin_GraphCraft[graphstack]"

Install (GitHub — works now)

pip install "MertCapkin_GraphCraft[graphstack] @ git+https://github.com/MertCapkin/GraphCraft.git@v0.1.1"

GraphStack + Graphify install automatically via the [graphstack] extra from PyPI.

2. Initialize your project

Open your app/game repo in Cursor, then in terminal:

graphcraft init . -y --install-deps

This runs graphstack init first (GraphStack overlay), then graphcraft install (GraphCraft overlay). Both rule sets load in Cursor automatically.

3. Build graphs

graphcraft design update .          # design graph
# In Cursor chat: /graphify .       # code graph (or: graphstack graph update .)
graphcraft doctor .

4. Start working

Describe your mobile app or game in Cursor chat. GraphCraft orchestrator activates first; GraphStack handles cycle/gate mechanics.

---

Install from source (this repo — contributors)

git clone https://github.com/MertCapkin/GraphCraft.git
cd GraphCraft
pip install -e ".[full]"

Initialize a consumer project (not this framework repo):

cd C:\path\to\your-mobile-app
graphcraft init . -y --install-deps

See docs/GRAPHSTACK.md for dependency details.

---

What runs when you open a task?

GraphCraft uses an overlay orchestrator — GraphStack is not edited, but GraphCraft is not skipped.

Step	What loads	Purpose
1	.cursor/rules/graphcraft.mdc	Primary greeting, design routing
2	.cursor/rules/graphstack.mdc	Cycle, gate, token discipline (unchanged)
3	orchestrator/GRAPHCRAFT.md	Design lifecycle extension
4	orchestrator/ORCHESTRATOR.md	GraphStack cycle mechanics
5	graphcraft-out/DESIGN_REPORT.md	Design graph summary
6	graphify-out/GRAPH_REPORT.md	Code graph summary

User request flow (UI/mobile task)

User goal in chat
    → [GRAPHCRAFT] greet + read design context
    → ARCHITECT (GraphStack cycle start + BRIEF.md)
    → DESIGN STRATEGIST (AESTHETIC_BRIEF.md)     ← GraphCraft adds
    → DESIGNER (design graph, screens, tokens)   ← GraphCraft adds
    → DESIGN AUDIT (validate + harmony)          ← GraphCraft adds
    → BUILDER (GraphStack — requires brief + design ready)
    → VISUAL REVIEW                              ← GraphCraft adds
    → REVIEWER → QA → SHIP (GraphStack unchanged)

Pure backend tasks (no UI): GraphStack flow only — design phases skipped.

Full detail: docs/FLOW.md · orchestrator/GRAPHCRAFT.md

---

Commands

Command	Layer	Purpose
graphcraft init .	GraphCraft	GraphStack init + GraphCraft overlay
graphcraft doctor .	GraphCraft	Health check (both layers)
graphcraft design update .	GraphCraft	Build design graph
graphcraft design query "screens"	GraphCraft	Query design graph
graphcraft design validate	GraphCraft	Validate design graph
graphcraft design harmony	GraphCraft	Component harmony check
graphcraft stitch import .	GraphCraft	Import Stitch prototype
python -m graphstack cycle start …	GraphStack	Start dev cycle
python -m graphstack graph query "…"	GraphStack	Query code graph

---

Configuration

Edit graphcraft.config.yaml:

profile: mobile-app          # mobile-app | mobile-game
design_source: native        # native | stitch | hybrid
active_stack: react-native   # see packs/mobile-app/STACKS.md

---

Mobile stacks

Profile	Targets
mobile-app	React Native, Expo, Flutter, SwiftUI, Jetpack Compose, KMP, Ionic, Capacitor
mobile-game	Unity UGUI, Unity UI Toolkit, Godot, Unreal UMG, Defold, Cocos

Pack docs: packs/mobile-app/STACKS.md · packs/mobile-game/STACKS.md

---

Project layout (after init)

your-project/
├── graphcraft.config.yaml
├── design-system/           # tokens, components
├── design/screens/          # screen specs
├── graphcraft-out/          # design-graph.json
├── graphify-out/            # code graph (Graphify)
├── handoff/                 # BRIEF, DESIGN_BRIEF, AESTHETIC_BRIEF
├── orchestrator/
│   ├── GRAPHCRAFT.md        # GraphCraft extension
│   └── ORCHESTRATOR.md      # GraphStack (from dependency)
├── .cursor/rules/
│   ├── graphcraft.mdc       # GraphCraft overlay (primary)
│   └── graphstack.mdc       # GraphStack (from dependency)
└── scripts/
    ├── graphcraft/          # GraphCraft CLI copy
    └── graphstack/          # GraphStack CLI copy

---

Design sources

Mode	Use when
native	YAML design-system + screens from scratch
stitch	Google Stitch prototype import
hybrid	Stitch visual reference + native refinement

---

Documentation

Doc	Content
docs/GRAPHSTACK.md	GraphStack dependency — install, what it provides
docs/FLOW.md	Orchestrator overlay — who runs first
docs/ARCHITECTURE.md	Layer model — why GraphStack is untouched
CHANGELOG_GRAPHCRAFT.md	GraphCraft releases
docs/PYPI.md	PyPI publish + install

---

License

MIT — see LICENSE.

GraphStack is © its contributors, installed as a separate dependency under MIT.