# schakravorti21/cubeassist architecture

> Architecture diagram of the GitHub repository schakravorti21/cubeassist, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-17). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/schakravorti21/cubeassist
- Repository: https://github.com/schakravorti21/cubeassist

## Overview

CubeAssist is an Android Rubik’s Cube teaching and solving app. Users choose text scramble, manual color entry, or camera-assisted capture; cube state is then solved and presented as an animated, controllable 2D solution. The graph preserves the documented input modes and solution controls. Camera capture forwards color data into the manual-input flow. Source excerpts show the main routing and core model/view links; undocumented internal solver phases and camera callback details are not expanded.

Main entry points: [`app/src/main/java/comschakravorti21/github/cubeassist/MainActivity.java`](https://github.com/schakravorti21/cubeassist/blob/master/app/src/main/java/comschakravorti21/github/cubeassist/MainActivity.java) (Navigation host), [`app/src/main/java/comschakravorti21/github/cubeassist/TextSolutionFragment.java`](https://github.com/schakravorti21/cubeassist/blob/master/app/src/main/java/comschakravorti21/github/cubeassist/TextSolutionFragment.java) (Solution controls), [`app/src/main/java/comschakravorti21/github/cubeassist/CaptureCubeActivity.java`](https://github.com/schakravorti21/cubeassist/blob/master/app/src/main/java/comschakravorti21/github/cubeassist/CaptureCubeActivity.java) (Camera capture), [`app/src/main/java/comschakravorti21/github/cubeassist/ColorInputFragment.java`](https://github.com/schakravorti21/cubeassist/blob/master/app/src/main/java/comschakravorti21/github/cubeassist/ColorInputFragment.java) (Manual color entry)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_navigation["App navigation"]
  node_main["Navigation host<br/>[MainActivity.java]"]
end

subgraph group_inputs["Cube input"]
  node_camera_capture["Camera capture"]
  node_camera_preview["Camera color analysis<br/>[CameraPreview.java]"]
  node_manual_input["Manual color entry"]
  node_scramble_dialog["Scramble editor"]
end

subgraph group_solver["Cube solving"]
  node_cube_model["Cube and solving<br/>[Cube.java]"]
  node_cubie["Cubie state<br/>[Cubie.java]"]
  node_cubie_color["Directional colors<br/>[CubieColor.java]"]
end

subgraph group_presentation["Solution presentation"]
  node_solution_fragment["Solution controls"]
  node_cube_view["Animated cube view<br/>[CubeView.java]"]
end

node_user(("User"))

node_user -->|"selects mode"| node_main
node_main -->|"launches camera"| node_camera_capture
node_main -->|"routes to input"| node_manual_input
node_main -->|"shows solution"| node_solution_fragment
node_camera_capture -->|"creates preview"| node_camera_preview
node_camera_capture -->|"forwards colors"| node_main
node_manual_input -->|"validates colors"| node_cube_model
node_manual_input -->|"opens solution"| node_solution_fragment
node_solution_fragment -->|"edits scramble"| node_scramble_dialog
node_solution_fragment -->|"controls animation"| node_cube_view
node_cube_view -->|"computes solution"| node_cube_model
node_cube_model -->|"updates cubies"| node_cubie
node_cubie -->|"stores colors"| node_cubie_color

click node_main "https://github.com/schakravorti21/cubeassist/blob/master/app/src/main/java/comschakravorti21/github/cubeassist/MainActivity.java"
click node_camera_capture "https://github.com/schakravorti21/cubeassist/blob/master/app/src/main/java/comschakravorti21/github/cubeassist/CaptureCubeActivity.java"
click node_camera_preview "https://github.com/schakravorti21/cubeassist/blob/master/app/src/main/java/comschakravorti21/github/cubeassist/CameraPreview.java"
click node_manual_input "https://github.com/schakravorti21/cubeassist/blob/master/app/src/main/java/comschakravorti21/github/cubeassist/ColorInputFragment.java"
click node_scramble_dialog "https://github.com/schakravorti21/cubeassist/blob/master/app/src/main/java/comschakravorti21/github/cubeassist/EditScrambleDialog.java"
click node_solution_fragment "https://github.com/schakravorti21/cubeassist/blob/master/app/src/main/java/comschakravorti21/github/cubeassist/TextSolutionFragment.java"
click node_cube_view "https://github.com/schakravorti21/cubeassist/blob/master/app/src/main/java/comschakravorti21/github/cubeassist/CubeView.java"
click node_cube_model "https://github.com/schakravorti21/cubeassist/blob/master/app/src/main/java/comschakravorti21/github/cubeassist/Cube.java"
click node_cubie "https://github.com/schakravorti21/cubeassist/blob/master/app/src/main/java/comschakravorti21/github/cubeassist/Cubie.java"
click node_cubie_color "https://github.com/schakravorti21/cubeassist/blob/master/app/src/main/java/comschakravorti21/github/cubeassist/CubieColor.java"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_main,node_user toneBlue
class node_camera_capture,node_camera_preview,node_manual_input,node_scramble_dialog toneAmber
class node_cube_model,node_cubie,node_cubie_color toneMint
class node_solution_fragment,node_cube_view toneRose
```

## Components

### App navigation

- [Navigation host](https://github.com/schakravorti21/cubeassist/blob/master/app/src/main/java/comschakravorti21/github/cubeassist/MainActivity.java): `app/src/main/java/comschakravorti21/github/cubeassist/MainActivity.java`

### Cube input

- [Camera capture](https://github.com/schakravorti21/cubeassist/blob/master/app/src/main/java/comschakravorti21/github/cubeassist/CaptureCubeActivity.java): `app/src/main/java/comschakravorti21/github/cubeassist/CaptureCubeActivity.java`
- [Camera color analysis](https://github.com/schakravorti21/cubeassist/blob/master/app/src/main/java/comschakravorti21/github/cubeassist/CameraPreview.java): `app/src/main/java/comschakravorti21/github/cubeassist/CameraPreview.java`
- [Manual color entry](https://github.com/schakravorti21/cubeassist/blob/master/app/src/main/java/comschakravorti21/github/cubeassist/ColorInputFragment.java): `app/src/main/java/comschakravorti21/github/cubeassist/ColorInputFragment.java`
- [Scramble editor](https://github.com/schakravorti21/cubeassist/blob/master/app/src/main/java/comschakravorti21/github/cubeassist/EditScrambleDialog.java): `app/src/main/java/comschakravorti21/github/cubeassist/EditScrambleDialog.java`

### Cube solving

- [Cube and solving](https://github.com/schakravorti21/cubeassist/blob/master/app/src/main/java/comschakravorti21/github/cubeassist/Cube.java): `app/src/main/java/comschakravorti21/github/cubeassist/Cube.java`
- [Cubie state](https://github.com/schakravorti21/cubeassist/blob/master/app/src/main/java/comschakravorti21/github/cubeassist/Cubie.java): `app/src/main/java/comschakravorti21/github/cubeassist/Cubie.java`
- [Directional colors](https://github.com/schakravorti21/cubeassist/blob/master/app/src/main/java/comschakravorti21/github/cubeassist/CubieColor.java): `app/src/main/java/comschakravorti21/github/cubeassist/CubieColor.java`

### Solution presentation

- [Solution controls](https://github.com/schakravorti21/cubeassist/blob/master/app/src/main/java/comschakravorti21/github/cubeassist/TextSolutionFragment.java): `app/src/main/java/comschakravorti21/github/cubeassist/TextSolutionFragment.java`
- [Animated cube view](https://github.com/schakravorti21/cubeassist/blob/master/app/src/main/java/comschakravorti21/github/cubeassist/CubeView.java): `app/src/main/java/comschakravorti21/github/cubeassist/CubeView.java`

### Other components

- **User**

## Connections

- User → Navigation host: selects mode (evidence: `README.md`)
- Navigation host → Camera capture: launches camera (evidence: `app/src/main/java/comschakravorti21/github/cubeassist/MainActivity.java`)
- Navigation host → Manual color entry: routes to input (evidence: `app/src/main/java/comschakravorti21/github/cubeassist/MainActivity.java`)
- Navigation host → Solution controls: shows solution (evidence: `app/src/main/java/comschakravorti21/github/cubeassist/MainActivity.java`)
- Camera capture → Camera color analysis: creates preview (evidence: `app/src/main/java/comschakravorti21/github/cubeassist/CaptureCubeActivity.java`)
- Camera capture → Navigation host: forwards colors (evidence: `app/src/main/java/comschakravorti21/github/cubeassist/CaptureCubeActivity.java`)
- Manual color entry → Cube and solving: validates colors (evidence: `app/src/main/java/comschakravorti21/github/cubeassist/ColorInputFragment.java`)
- Manual color entry → Solution controls: opens solution (evidence: `app/src/main/java/comschakravorti21/github/cubeassist/ColorInputFragment.java`)
- Solution controls → Scramble editor: edits scramble (evidence: `app/src/main/java/comschakravorti21/github/cubeassist/TextSolutionFragment.java`)
- Solution controls → Animated cube view: controls animation (evidence: `app/src/main/java/comschakravorti21/github/cubeassist/TextSolutionFragment.java`)
- Animated cube view → Cube and solving: computes solution (evidence: `app/src/main/java/comschakravorti21/github/cubeassist/CubeView.java`)
- Cube and solving → Cubie state: updates cubies (evidence: `app/src/main/java/comschakravorti21/github/cubeassist/Cube.java`)
- Cubie state → Directional colors: stores colors (evidence: `app/src/main/java/comschakravorti21/github/cubeassist/Cubie.java`)
