# story-apps/starc architecture

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

- Interactive diagram: https://gitdiagram.com/story-apps/starc
- Repository: https://github.com/story-apps/starc

## Overview

Story Architect is a Qt desktop writing environment that takes authors from project and document setup through planning, drafting, analysis, and formatted exchange. The README documents support for many writing formats, templates, research, story assets, multiple drafts, planning tools, and analytical views. The sampled application code shows startup entering the application manager, which owns the principal management services; the format manager explicitly selects readers. Many feature implementations were not sampled, so their paths identify existing feature directories and their internal links are left unasserted.

Main entry points: [`src/core/management_layer/application_manager.cpp`](https://github.com/story-apps/starc/blob/master/src/core/management_layer/application_manager.cpp) (Application manager), [`src/3rd_party/fileformats/format_manager.cpp`](https://github.com/story-apps/starc/blob/master/src/3rd_party/fileformats/format_manager.cpp) (Format reader selection), [`src/core/management_layer/content/import/import_manager.cpp`](https://github.com/story-apps/starc/blob/master/src/core/management_layer/content/import/import_manager.cpp) (Document import), [`src/app/application.cpp`](https://github.com/story-apps/starc/blob/master/src/app/application.cpp) (Desktop application)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_startup["Application startup"]
  node_app["Desktop application<br/>[application.cpp]"]
  node_manager["Application manager"]
end

subgraph group_projects["Project management"]
  node_projects["Projects and drafts"]
  node_project["Project workspace"]
  node_account["Account services"]
  node_settings["Preferences and templates"]
  node_database[("Application data<br/>[database.cpp]")]
end

subgraph group_writing["Writing and planning"]
  node_writing["Format-specific editors"]
  node_planning["Planning tools"]
  node_analysis["Story analysis"]
end

subgraph group_exchange["Document exchange"]
  node_import["Document import<br/>[import_manager.cpp]"]
  node_formats["Format reader selection<br/>[format_manager.cpp]"]
  node_odt["ODT reader<br/>[odt_reader.cpp]"]
  node_docx["DOCX reader<br/>[docx_reader.cpp]"]
  node_rtf["RTF reader<br/>[rtf_reader.cpp]"]
  node_text["Text reader<br/>[txt_reader.cpp]"]
  node_export["Document export<br/>[export_manager.cpp]"]
end

node_author(("Author"))

node_author -->|"uses"| node_app
node_app -->|"starts via"| node_manager
node_manager -->|"creates"| node_account
node_manager -->|"creates"| node_projects
node_manager -->|"creates"| node_project
node_manager -->|"creates"| node_settings
node_manager -->|"creates"| node_import
node_manager -->|"creates"| node_export
node_author -->|"organizes work"| node_projects
node_author -->|"drafts in"| node_writing
node_author -->|"plans with"| node_planning
node_author -->|"reviews"| node_analysis
node_author -->|"imports work"| node_import
node_author -->|"exports work"| node_export
node_import -.->|"selects reader"| node_formats
node_formats -->|"selects"| node_odt
node_formats -->|"selects"| node_docx
node_formats -->|"selects"| node_rtf
node_formats -->|"falls back"| node_text
node_project -.->|"persists data"| node_database

click node_app "https://github.com/story-apps/starc/blob/master/src/app/application.cpp"
click node_manager "https://github.com/story-apps/starc/blob/master/src/core/management_layer/application_manager.cpp"
click node_projects "https://github.com/story-apps/starc/blob/master/src/core/management_layer/content/projects/projects_manager.cpp"
click node_project "https://github.com/story-apps/starc/blob/master/src/core/management_layer/content/project/project_manager.cpp"
click node_account "https://github.com/story-apps/starc/blob/master/src/core/management_layer/content/account/account_manager.cpp"
click node_settings "https://github.com/story-apps/starc/blob/master/src/core/management_layer/content/settings/settings_manager.cpp"
click node_database "https://github.com/story-apps/starc/blob/master/src/corelib/data_layer/database.cpp"
click node_writing "https://github.com/story-apps/starc/tree/master/src/core/management_layer/plugins"
click node_planning "https://github.com/story-apps/starc/tree/master/src/core/management_layer/plugins"
click node_analysis "https://github.com/story-apps/starc/tree/master/src/core/management_layer/plugins"
click node_import "https://github.com/story-apps/starc/blob/master/src/core/management_layer/content/import/import_manager.cpp"
click node_formats "https://github.com/story-apps/starc/blob/master/src/3rd_party/fileformats/format_manager.cpp"
click node_odt "https://github.com/story-apps/starc/blob/master/src/3rd_party/fileformats/odt_reader.cpp"
click node_docx "https://github.com/story-apps/starc/blob/master/src/3rd_party/fileformats/docx_reader.cpp"
click node_rtf "https://github.com/story-apps/starc/blob/master/src/3rd_party/fileformats/rtf_reader.cpp"
click node_text "https://github.com/story-apps/starc/blob/master/src/3rd_party/fileformats/txt_reader.cpp"
click node_export "https://github.com/story-apps/starc/blob/master/src/core/management_layer/content/export/export_manager.cpp"

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_app,node_manager toneBlue
class node_projects,node_project,node_account,node_settings,node_database toneAmber
class node_writing,node_planning,node_analysis toneMint
class node_import,node_formats,node_odt,node_docx,node_rtf,node_text,node_export toneRose
class node_author toneIndigo
```

## Components

### Application startup

- [Desktop application](https://github.com/story-apps/starc/blob/master/src/app/application.cpp): `src/app/application.cpp`
- [Application manager](https://github.com/story-apps/starc/blob/master/src/core/management_layer/application_manager.cpp): `src/core/management_layer/application_manager.cpp`

### Project management

- [Projects and drafts](https://github.com/story-apps/starc/blob/master/src/core/management_layer/content/projects/projects_manager.cpp): `src/core/management_layer/content/projects/projects_manager.cpp`
- [Project workspace](https://github.com/story-apps/starc/blob/master/src/core/management_layer/content/project/project_manager.cpp): `src/core/management_layer/content/project/project_manager.cpp`
- [Account services](https://github.com/story-apps/starc/blob/master/src/core/management_layer/content/account/account_manager.cpp): `src/core/management_layer/content/account/account_manager.cpp`
- [Preferences and templates](https://github.com/story-apps/starc/blob/master/src/core/management_layer/content/settings/settings_manager.cpp): `src/core/management_layer/content/settings/settings_manager.cpp`
- [Application data](https://github.com/story-apps/starc/blob/master/src/corelib/data_layer/database.cpp): `src/corelib/data_layer/database.cpp`

### Writing and planning

- [Format-specific editors](https://github.com/story-apps/starc/tree/master/src/core/management_layer/plugins): `src/core/management_layer/plugins`
- [Planning tools](https://github.com/story-apps/starc/tree/master/src/core/management_layer/plugins): `src/core/management_layer/plugins`
- [Story analysis](https://github.com/story-apps/starc/tree/master/src/core/management_layer/plugins): `src/core/management_layer/plugins`

### Document exchange

- [Document import](https://github.com/story-apps/starc/blob/master/src/core/management_layer/content/import/import_manager.cpp): `src/core/management_layer/content/import/import_manager.cpp`
- [Format reader selection](https://github.com/story-apps/starc/blob/master/src/3rd_party/fileformats/format_manager.cpp): `src/3rd_party/fileformats/format_manager.cpp`
- [ODT reader](https://github.com/story-apps/starc/blob/master/src/3rd_party/fileformats/odt_reader.cpp): `src/3rd_party/fileformats/odt_reader.cpp`
- [DOCX reader](https://github.com/story-apps/starc/blob/master/src/3rd_party/fileformats/docx_reader.cpp): `src/3rd_party/fileformats/docx_reader.cpp`
- [RTF reader](https://github.com/story-apps/starc/blob/master/src/3rd_party/fileformats/rtf_reader.cpp): `src/3rd_party/fileformats/rtf_reader.cpp`
- [Text reader](https://github.com/story-apps/starc/blob/master/src/3rd_party/fileformats/txt_reader.cpp): `src/3rd_party/fileformats/txt_reader.cpp`
- [Document export](https://github.com/story-apps/starc/blob/master/src/core/management_layer/content/export/export_manager.cpp): `src/core/management_layer/content/export/export_manager.cpp`

### Other components

- **Author**

## Connections

- Author → Desktop application: uses
- Desktop application → Application manager: starts via (evidence: `src/app/application.cpp`)
- Application manager → Account services: creates (evidence: `src/core/management_layer/application_manager.cpp`)
- Application manager → Projects and drafts: creates (evidence: `src/core/management_layer/application_manager.cpp`)
- Application manager → Project workspace: creates (evidence: `src/core/management_layer/application_manager.cpp`)
- Application manager → Preferences and templates: creates (evidence: `src/core/management_layer/application_manager.cpp`)
- Application manager → Document import: creates (evidence: `src/core/management_layer/application_manager.cpp`)
- Application manager → Document export: creates (evidence: `src/core/management_layer/application_manager.cpp`)
- Author → Projects and drafts: organizes work
- Author → Format-specific editors: drafts in
- Author → Planning tools: plans with
- Author → Story analysis: reviews
- Author → Document import: imports work
- Author → Document export: exports work
- Document import → Format reader selection: selects reader
- Format reader selection → ODT reader: selects (evidence: `src/3rd_party/fileformats/format_manager.cpp`)
- Format reader selection → DOCX reader: selects (evidence: `src/3rd_party/fileformats/format_manager.cpp`)
- Format reader selection → RTF reader: selects (evidence: `src/3rd_party/fileformats/format_manager.cpp`)
- Format reader selection → Text reader: falls back (evidence: `src/3rd_party/fileformats/format_manager.cpp`)
- Project workspace → Application data: persists data
