# yukionishi1129/dailydevapps architecture

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

- Interactive diagram: https://gitdiagram.com/yukionishi1129/dailydevapps
- Repository: https://github.com/yukionishi1129/dailydevapps

## Overview

##### Project type and high-level purpose
- This is a pnpm-managed monorepo (“apps”) that houses:
- A Next.js web application (“webapp”)
- A browser extension (“extension”)
- A shared React/TS component + hook library (“shared”)
- Supporting config packages (eslint-config, prettier-config) and a Storybook site
- Both the webapp and extension consume shared UI components, custom hooks, and GraphQL queries/mutations defined under packages/shared.

##### File structure for architectural cues
- Top-level files and folders (Dockerfile, docker-compose.yml, Tiltfile) set up local dev containers and services.
- /packages/webapp is a Next.js SSR/CSR client that builds via Vercel (next.config.js, pages/).
- /packages/extension is a WebExtension project built with webpack and runs in Chrome/Firefox as background + content + popup scripts.
- /packages/shared exports common UI, hooks, GraphQL clients, and styling (Tailwind, CSS).
- /packages/storybook hosts a component playground and mock providers.

##### README for stack and architecture notes
- Monorepo managed by pnpm workspaces
- Node 20.12.0, React + TypeScript
- Next.js for the webapp, Webpack for the extension
- Shared design system + GraphQL client code reused by both clients
- CI/CD via CircleCI and GitHub Actions, deployments to Vercel (webapp) and browser extension stores

##### Main components and how they interact
A. Clients
- Webapp (Next.js) – SSR pages, dynamic routing, CSR for interactive feeds
- Extension – background script, content script, popup/newtab UI
B. Shared Library (packages/shared)
- React components, hooks, GraphQL queries, styling, utilities
C. External GraphQL API
- daily.dev’s backend GraphQL endpoint (authentication, feed, posts, user data)
D. Third-party Services
- Identity provider (e.g., Ory Kratos) for sign-in/up
- OneSignal (push notifications)
- Analytics/tracking (e.g., gtag.js)
- CDN (serving static assets, SW)
E. Dev & CI/CD Pipeline
- Docker/Docker Compose for local dev (webapp + mock services)
- Tiltfile enables local Kubernetes dev if used
- CircleCI workflows run lint/test/build, deploy preview domains, remove previews on PR close
- Vercel hosts the webapp; extension builds get loaded manually or published to stores

##### Architectural patterns and design principles
- Monorepo / workspace pattern for cross-project code reuse
- Component library + design system in shared package
- Clear separation of concerns: presentation (React components), data layer (GraphQL hooks), routing (Next.js pages or WebExtension routing)
- SSR + CSR hybrid for the webapp; background + content scripts for the extension
- CI/CD as code (circleci/config.yml, GitHub workflows, vercel.json)

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Top Layer: Developers & CI/CD
    subgraph "Developers & CI/CD" 
        direction TB
        Dev["Developers"]:::tool
        CI["CI/CD Pipeline"]:::tool
        Dev --> CI
        Docker["Docker & Docker Compose"]:::tool
        Tilt["Tilt (local Kubernetes)"]:::tool
        CircleCI["CircleCI Workflows"]:::tool
        GHActions["GitHub Actions"]:::tool
        CI --> Docker
        CI --> Tilt
        CI --> CircleCI
        CI --> GHActions
        DeployWebapp["Vercel Deployment"]:::tool
        DeployExt["Extension Store Deployment"]:::tool
        CircleCI --> DeployWebapp
        GHActions --> DeployWebapp
        CircleCI --> DeployExt
        GHActions --> DeployExt
    end

    %% Middle Layer: Clients & Shared Library
    subgraph "Clients & Shared Library"
        direction TB

        subgraph "Webapp (Next.js)" 
            direction TB
            WServer["Next.js Server (SSR)"]:::client
            WPages["Pages (packages/webapp/pages)"]:::client
            WGraphQL["GraphQL Queries (packages/webapp/graphql)"]:::client
            WPublic["Public Assets (packages/webapp/public)"]:::client
            WSW["Service Worker (packages/webapp/sw.ts)"]:::client
            WServer --> WPages
            WServer --> WGraphQL
            WServer --> WPublic
            WPublic --> WSW
        end

        subgraph "Extension (Browser Extension)"
            direction TB
            ExtManifest["Manifest & Scripts\n(packages/extension/src/manifest.json)"]:::client
            ExtBg["Background Script\n(packages/extension/src/background)"]:::client
            ExtContent["Content Script\n(packages/extension/src/content)"]:::client
            ExtNewtab["Popup/Newtab UI\n(packages/extension/src/newtab)"]:::client
            ExtWebpack["Webpack Config\n(packages/extension/webpack.config.js)"]:::client
            ExtTailwind["Tailwind Config\n(packages/extension/tailwind.config.ts)"]:::client
            ExtManifest --> ExtBg
            ExtBg --> ExtContent
            ExtContent --> ExtNewtab
        end

        subgraph "Shared Library (packages/shared)" 
            direction TB
            SharedComponents["Components\n(packages/shared/src/components)"]:::shared
            SharedHooks["Hooks\n(packages/shared/src/hooks)"]:::shared
            SharedGraphQL["GraphQL Definitions\n(packages/shared/src/graphql)"]:::shared
            SharedLib["Utilities & Lib\n(packages/shared/src/lib)"]:::shared
            SharedStyles["Styles\n(packages/shared/src/styles)"]:::shared
            SharedTailwind["Tailwind Config\n(packages/shared/tailwind.config.ts)"]:::shared
        end

        %% Dependencies
        WPages -->|imports| SharedComponents
        WPages -->|uses hooks| SharedHooks
        WGraphQL -->|uses| SharedGraphQL
        ExtManifest -->|imports UI| SharedComponents
        ExtManifest -->|uses hooks| SharedHooks
        ExtBg -->|calls| SharedGraphQL
    end

    %% Bottom Layer: External Services
    subgraph "External Services"
        direction TB
        GraphAPI["External GraphQL API"]:::ext
        Identity["Identity Provider\n(e.g., Ory Kratos)"]:::ext
        OneSignal["OneSignal Push Service"]:::ext
        Analytics["Analytics/Tracking"]:::ext
        CDN["CDN & Static Assets"]:::ext
    end

    %% Data Flows
    WServer -->|SSR/CSR requests| CDN
    WServer -->|GraphQL requests| GraphAPI
    ExtBg -->|GraphQL requests| GraphAPI
    ExtContent -->|GraphQL requests| GraphAPI
    WServer -->|auth| Identity
    ExtBg -->|auth| Identity
    WServer -->|notifications| OneSignal
    ExtBg -->|notifications| OneSignal
    WPublic -->|static assets| CDN
    WServer -->|analytics| Analytics
    ExtBg -->|analytics| Analytics

    %% Click Events
    click WPages "https://github.com/yukionishi1129/dailydevapps/tree/main/packages/webapp/pages"
    click WGraphQL "https://github.com/yukionishi1129/dailydevapps/tree/main/packages/webapp/graphql"
    click WPublic "https://github.com/yukionishi1129/dailydevapps/tree/main/packages/webapp/public"
    click WSW "https://github.com/yukionishi1129/dailydevapps/blob/main/packages/webapp/sw.ts"
    click ExtManifest "https://github.com/yukionishi1129/dailydevapps/blob/main/packages/extension/src/manifest.json"
    click ExtBg "https://github.com/yukionishi1129/dailydevapps/tree/main/packages/extension/src/background"
    click ExtContent "https://github.com/yukionishi1129/dailydevapps/tree/main/packages/extension/src/content"
    click ExtNewtab "https://github.com/yukionishi1129/dailydevapps/tree/main/packages/extension/src/newtab"
    click ExtWebpack "https://github.com/yukionishi1129/dailydevapps/blob/main/packages/extension/webpack.config.js"
    click ExtTailwind "https://github.com/yukionishi1129/dailydevapps/blob/main/packages/extension/tailwind.config.ts"
    click SharedComponents "https://github.com/yukionishi1129/dailydevapps/tree/main/packages/shared/src/components"
    click SharedHooks "https://github.com/yukionishi1129/dailydevapps/tree/main/packages/shared/src/hooks"
    click SharedGraphQL "https://github.com/yukionishi1129/dailydevapps/tree/main/packages/shared/src/graphql"
    click SharedLib "https://github.com/yukionishi1129/dailydevapps/tree/main/packages/shared/src/lib"
    click SharedStyles "https://github.com/yukionishi1129/dailydevapps/tree/main/packages/shared/src/styles"
    click SharedTailwind "https://github.com/yukionishi1129/dailydevapps/blob/main/packages/shared/tailwind.config.ts"
    click Docker "https://github.com/yukionishi1129/dailydevapps/tree/main/Dockerfile"
    click Docker "https://github.com/yukionishi1129/dailydevapps/blob/main/docker-compose.yml"
    click Tilt "https://github.com/yukionishi1129/dailydevapps/tree/main/Tiltfile"
    click CircleCI "https://github.com/yukionishi1129/dailydevapps/blob/main/.circleci/config.yml"
    click GHActions "https://github.com/yukionishi1129/dailydevapps/blob/main/.github/workflows/add-preview-domain.yml"
    click GHActions "https://github.com/yukionishi1129/dailydevapps/blob/main/.github/workflows/remove-preview-domain.yml"
    click DeployWebapp "https://github.com/yukionishi1129/dailydevapps/blob/main/vercel.json"

    %% Styles
    classDef client fill:#D6EAF8,stroke:#3498DB,color:#154360
    classDef shared fill:#D5F5E3,stroke:#27AE60,color:#145A32
    classDef ext fill:#FCF3CF,stroke:#F1C40F,color:#7D6608
    classDef tool fill:#F2F3F4,stroke:#7B7D7D,color:#1B2631
```
