# kylejanossmith/solostack-portal architecture

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

- Interactive diagram: https://gitdiagram.com/kylejanossmith/solostack-portal
- Repository: https://github.com/kylejanossmith/solostack-portal

## Overview

SoloStack is a customer account and product portal, not a customer-workload platform. Visitors discover the Job Search OS on the landing page, can create an account or sign in through Clerk, and access product links from a protected dashboard. The runtime also includes shared navigation, account controls, and compliance messaging. The README documents Gumroad delivery and future integrations; the dashboard confirms the latter are placeholders. Edges reflect shown links, Clerk usage, layout composition, and route protection; no integration behavior beyond those sources is inferred.

Main entry points: [`src/components/Header.tsx`](https://github.com/kylejanossmith/solostack-portal/blob/main/src/components/Header.tsx) (Header navigation), [`src/app/dashboard/page.tsx`](https://github.com/kylejanossmith/solostack-portal/blob/main/src/app/dashboard/page.tsx) (Customer dashboard), [`src/app/page.tsx`](https://github.com/kylejanossmith/solostack-portal/blob/main/src/app/page.tsx) (Marketing landing), [`src/app/layout.tsx`](https://github.com/kylejanossmith/solostack-portal/blob/main/src/app/layout.tsx) (Root layout)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_customer_ui["Customer UI"]
  node_landing["Marketing landing<br/>[page.tsx]"]
  node_dashboard["Customer dashboard<br/>[page.tsx]"]
end

subgraph group_account["Account access"]
  node_signin["Sign-in page<br/>[page.tsx]"]
  node_signup["Sign-up page<br/>[page.tsx]"]
  node_route_guard["Route protection<br/>[middleware.ts]"]
end

subgraph group_shared["Shared application"]
  node_root_layout["Root layout<br/>[layout.tsx]"]
  node_header["Header navigation<br/>[Header.tsx]"]
  node_footer["Compliance footer<br/>[Footer.tsx]"]
end

subgraph group_services["External services"]
  node_clerk["Clerk identity"]
  node_gumroad["Gumroad delivery"]
end

node_visitor(("Visitor"))

node_visitor -->|"visits"| node_landing
node_landing -->|"links to"| node_signup
node_landing -->|"links to"| node_dashboard
node_landing -->|"links to product"| node_gumroad
node_header -->|"links to"| node_signin
node_header -->|"links to"| node_signup
node_header -->|"links to"| node_dashboard
node_header -->|"uses account controls"| node_clerk
node_signin -->|"renders sign-in"| node_clerk
node_signup -->|"renders sign-up"| node_clerk
node_route_guard -->|"protects route"| node_dashboard
node_dashboard -->|"reads current user"| node_clerk
node_dashboard -->|"links to products"| node_gumroad
node_root_layout -->|"provides identity context"| node_clerk
node_root_layout -->|"renders"| node_header
node_root_layout -->|"renders"| node_footer

click node_landing "https://github.com/kylejanossmith/solostack-portal/blob/main/src/app/page.tsx"
click node_dashboard "https://github.com/kylejanossmith/solostack-portal/blob/main/src/app/dashboard/page.tsx"
click node_signin "https://github.com/kylejanossmith/solostack-portal/blob/main/src/app/sign-in/%5B%5B...sign-in%5D%5D/page.tsx"
click node_signup "https://github.com/kylejanossmith/solostack-portal/blob/main/src/app/sign-up/%5B%5B...sign-up%5D%5D/page.tsx"
click node_route_guard "https://github.com/kylejanossmith/solostack-portal/blob/main/src/middleware.ts"
click node_root_layout "https://github.com/kylejanossmith/solostack-portal/blob/main/src/app/layout.tsx"
click node_header "https://github.com/kylejanossmith/solostack-portal/blob/main/src/components/Header.tsx"
click node_footer "https://github.com/kylejanossmith/solostack-portal/blob/main/src/components/Footer.tsx"

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_landing,node_dashboard toneBlue
class node_signin,node_signup,node_route_guard toneAmber
class node_root_layout,node_header,node_footer toneMint
class node_clerk,node_gumroad toneRose
class node_visitor toneIndigo
```

## Components

### Customer UI

- [Marketing landing](https://github.com/kylejanossmith/solostack-portal/blob/main/src/app/page.tsx): `src/app/page.tsx`
- [Customer dashboard](https://github.com/kylejanossmith/solostack-portal/blob/main/src/app/dashboard/page.tsx): `src/app/dashboard/page.tsx`

### Account access

- [Sign-in page](https://github.com/kylejanossmith/solostack-portal/blob/main/src/app/sign-in/%5B%5B...sign-in%5D%5D/page.tsx): `src/app/sign-in/[[...sign-in]]/page.tsx`
- [Sign-up page](https://github.com/kylejanossmith/solostack-portal/blob/main/src/app/sign-up/%5B%5B...sign-up%5D%5D/page.tsx): `src/app/sign-up/[[...sign-up]]/page.tsx`
- [Route protection](https://github.com/kylejanossmith/solostack-portal/blob/main/src/middleware.ts): `src/middleware.ts`

### Shared application

- [Root layout](https://github.com/kylejanossmith/solostack-portal/blob/main/src/app/layout.tsx): `src/app/layout.tsx`
- [Header navigation](https://github.com/kylejanossmith/solostack-portal/blob/main/src/components/Header.tsx): `src/components/Header.tsx`
- [Compliance footer](https://github.com/kylejanossmith/solostack-portal/blob/main/src/components/Footer.tsx): `src/components/Footer.tsx`

### External services

- **Clerk identity**
- **Gumroad delivery**

### Other components

- **Visitor**

## Connections

- Visitor → Marketing landing: visits (evidence: `README.md`)
- Marketing landing → Sign-up page: links to (evidence: `src/app/page.tsx`)
- Marketing landing → Customer dashboard: links to (evidence: `src/app/page.tsx`)
- Marketing landing → Gumroad delivery: links to product (evidence: `src/app/page.tsx`)
- Header navigation → Sign-in page: links to (evidence: `src/components/Header.tsx`)
- Header navigation → Sign-up page: links to (evidence: `src/components/Header.tsx`)
- Header navigation → Customer dashboard: links to (evidence: `src/components/Header.tsx`)
- Header navigation → Clerk identity: uses account controls (evidence: `src/components/Header.tsx`)
- Sign-in page → Clerk identity: renders sign-in (evidence: `src/app/sign-in/[[...sign-in]]/page.tsx`)
- Sign-up page → Clerk identity: renders sign-up (evidence: `src/app/sign-up/[[...sign-up]]/page.tsx`)
- Route protection → Customer dashboard: protects route (evidence: `src/middleware.ts`)
- Customer dashboard → Clerk identity: reads current user (evidence: `src/app/dashboard/page.tsx`)
- Customer dashboard → Gumroad delivery: links to products (evidence: `src/app/dashboard/page.tsx`)
- Root layout → Clerk identity: provides identity context (evidence: `src/app/layout.tsx`)
- Root layout → Header navigation: renders (evidence: `src/app/layout.tsx`)
- Root layout → Compliance footer: renders (evidence: `src/app/layout.tsx`)
