# growthhackercz/amazing-simple-fun architecture

> Architecture diagram of the GitHub repository growthhackercz/amazing-simple-fun, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-25). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/growthhackercz/amazing-simple-fun
- Repository: https://github.com/growthhackercz/amazing-simple-fun

## Overview

Growili is a marketing analytics and growth platform for e-commerce teams, centered on measuring profit on ad spend (POAS). The main workflow is to connect advertising, analytics, and shop data; fetch and preview or transform it; import it into Supabase; then calculate metrics and inspect dashboards. The README also describes optimization, SEO/content, integrations, and shop-management capabilities, represented as product branches. Sampled import hooks support the fetch/import and storage details shown; several broader branches are documented in the README but their implementation and wiring were not sampled.

Main entry points: [`src/app/router/routes/ModulesRoutes.tsx`](https://github.com/growthhackercz/amazing-simple-fun/blob/main/src/app/router/routes/ModulesRoutes.tsx) (Product modules), [`src/app/router/AppRouter.tsx`](https://github.com/growthhackercz/amazing-simple-fun/blob/main/src/app/router/AppRouter.tsx) (App routing), [`src/features/google-ads-import/hooks/useGoogleAdsImportPipeline.ts`](https://github.com/growthhackercz/amazing-simple-fun/blob/main/src/features/google-ads-import/hooks/useGoogleAdsImportPipeline.ts) (Google Ads import), [`src/features/shoptet-import/hooks/useShoptetImportPipeline.ts`](https://github.com/growthhackercz/amazing-simple-fun/blob/main/src/features/shoptet-import/hooks/useShoptetImportPipeline.ts) (Shoptet import)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Application"]
  node_router["App routing<br/>[AppRouter.tsx]"]
  node_auth["Auth providers"]
  node_modules["Product modules<br/>[ModulesRoutes.tsx]"]
end

subgraph group_ingestion["Data ingestion"]
  node_google_import["Google Ads import"]
  node_shoptet_import["Shoptet import"]
  node_fapi_import["FAPI import"]
  node_sklik_import["Sklik import"]
  node_gsc_import["GSC import"]
  node_fb_storage["Facebook storage"]
  node_google_storage["Google Ads storage"]
end

subgraph group_analytics["Analytics"]
  node_metrics["Metrics engine"]
  node_dashboards["Analytics dashboards"]
  node_marketing_analytics["Marketing analytics"]
  node_product_analytics["Product analytics<br/>[index.ts]"]
end

subgraph group_growth["Growth tools"]
  node_optimization["Optimization tools"]
  node_seo_content["SEO and content"]
end

subgraph group_management["Platform management"]
  node_connections["Service connections"]
  node_shop_management["Shop management"]
end

node_user(("Shop team"))
node_ads_sources(("Ad platforms"))
node_shop_sources(("Shop platforms"))
node_supabase[("Supabase services")]

node_user -->|"uses"| node_router
node_router -->|"initializes"| node_auth
node_router -->|"dispatches"| node_modules
node_modules -->|"routes to"| node_google_import
node_modules -->|"routes to"| node_shoptet_import
node_modules -->|"routes to"| node_fapi_import
node_modules -->|"routes to"| node_sklik_import
node_modules -->|"routes to"| node_gsc_import
node_ads_sources -->|"provides data"| node_google_import
node_shop_sources -->|"provides data"| node_shoptet_import
node_shop_sources -->|"provides data"| node_fapi_import
node_ads_sources -->|"provides data"| node_sklik_import
node_ads_sources -->|"provides data"| node_gsc_import
node_google_import -->|"invokes import"| node_supabase
node_shoptet_import -->|"imports data"| node_supabase
node_fapi_import -->|"imports data"| node_supabase
node_sklik_import -->|"imports data"| node_supabase
node_gsc_import -->|"imports data"| node_supabase
node_fb_storage -->|"writes campaigns"| node_supabase
node_google_storage -->|"writes campaigns"| node_supabase
node_user -->|"reviews results"| node_dashboards
node_user -->|"reviews results"| node_marketing_analytics
node_user -->|"reviews results"| node_product_analytics
node_dashboards -->|"calculates metrics"| node_metrics
node_marketing_analytics -->|"calculates metrics"| node_metrics
node_product_analytics -->|"calculates metrics"| node_metrics
node_user -->|"uses"| node_optimization
node_user -->|"uses"| node_seo_content
node_user -->|"configures"| node_connections
node_user -->|"manages shops"| node_shop_management

click node_router "https://github.com/growthhackercz/amazing-simple-fun/blob/main/src/app/router/AppRouter.tsx"
click node_auth "https://github.com/growthhackercz/amazing-simple-fun/blob/main/src/app/providers/AuthInitializer.tsx"
click node_modules "https://github.com/growthhackercz/amazing-simple-fun/blob/main/src/app/router/routes/ModulesRoutes.tsx"
click node_google_import "https://github.com/growthhackercz/amazing-simple-fun/blob/main/src/features/google-ads-import/hooks/useGoogleAdsImportPipeline.ts"
click node_shoptet_import "https://github.com/growthhackercz/amazing-simple-fun/blob/main/src/features/shoptet-import/hooks/useShoptetImportPipeline.ts"
click node_fapi_import "https://github.com/growthhackercz/amazing-simple-fun/blob/main/src/features/fapi-import/hooks/useFapiImportPipeline.ts"
click node_sklik_import "https://github.com/growthhackercz/amazing-simple-fun/blob/main/src/features/sklik-import/hooks/useSklikImportPipeline.ts"
click node_gsc_import "https://github.com/growthhackercz/amazing-simple-fun/blob/main/src/features/gsc-import/hooks/useGSCImportPipeline.ts"
click node_fb_storage "https://github.com/growthhackercz/amazing-simple-fun/blob/main/src/features/facebook/hooks/useFacebookStorage.ts"
click node_google_storage "https://github.com/growthhackercz/amazing-simple-fun/blob/main/src/features/google-ads/hooks/useGoogleAdsStorage.ts"
click node_metrics "https://github.com/growthhackercz/amazing-simple-fun/blob/main/src/hooks/data/useMetricsEngine.ts"
click node_dashboards "https://github.com/growthhackercz/amazing-simple-fun/tree/main/src/components/dashboard"
click node_marketing_analytics "https://github.com/growthhackercz/amazing-simple-fun/blob/main/src/components/MarketingAnalytics/MarketingAnalytics.tsx"
click node_product_analytics "https://github.com/growthhackercz/amazing-simple-fun/blob/main/src/components/ProductAnalytics/index.ts"
click node_optimization "https://github.com/growthhackercz/amazing-simple-fun/tree/main/src/features"
click node_seo_content "https://github.com/growthhackercz/amazing-simple-fun/tree/main/src/features"
click node_connections "https://github.com/growthhackercz/amazing-simple-fun/tree/main/src/features"
click node_shop_management "https://github.com/growthhackercz/amazing-simple-fun/tree/main/src/features"

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_router,node_auth,node_modules toneBlue
class node_google_import,node_shoptet_import,node_fapi_import,node_sklik_import,node_gsc_import,node_fb_storage,node_google_storage,node_supabase toneAmber
class node_metrics,node_dashboards,node_marketing_analytics,node_product_analytics toneMint
class node_optimization,node_seo_content toneRose
class node_connections,node_shop_management,node_user,node_ads_sources,node_shop_sources toneIndigo
```

## Components

### Application

- [App routing](https://github.com/growthhackercz/amazing-simple-fun/blob/main/src/app/router/AppRouter.tsx): `src/app/router/AppRouter.tsx`
- [Auth providers](https://github.com/growthhackercz/amazing-simple-fun/blob/main/src/app/providers/AuthInitializer.tsx): `src/app/providers/AuthInitializer.tsx`
- [Product modules](https://github.com/growthhackercz/amazing-simple-fun/blob/main/src/app/router/routes/ModulesRoutes.tsx): `src/app/router/routes/ModulesRoutes.tsx`

### Data ingestion

- [Google Ads import](https://github.com/growthhackercz/amazing-simple-fun/blob/main/src/features/google-ads-import/hooks/useGoogleAdsImportPipeline.ts): `src/features/google-ads-import/hooks/useGoogleAdsImportPipeline.ts`
- [Shoptet import](https://github.com/growthhackercz/amazing-simple-fun/blob/main/src/features/shoptet-import/hooks/useShoptetImportPipeline.ts): `src/features/shoptet-import/hooks/useShoptetImportPipeline.ts`
- [FAPI import](https://github.com/growthhackercz/amazing-simple-fun/blob/main/src/features/fapi-import/hooks/useFapiImportPipeline.ts): `src/features/fapi-import/hooks/useFapiImportPipeline.ts`
- [Sklik import](https://github.com/growthhackercz/amazing-simple-fun/blob/main/src/features/sklik-import/hooks/useSklikImportPipeline.ts): `src/features/sklik-import/hooks/useSklikImportPipeline.ts`
- [GSC import](https://github.com/growthhackercz/amazing-simple-fun/blob/main/src/features/gsc-import/hooks/useGSCImportPipeline.ts): `src/features/gsc-import/hooks/useGSCImportPipeline.ts`
- [Facebook storage](https://github.com/growthhackercz/amazing-simple-fun/blob/main/src/features/facebook/hooks/useFacebookStorage.ts): `src/features/facebook/hooks/useFacebookStorage.ts`
- [Google Ads storage](https://github.com/growthhackercz/amazing-simple-fun/blob/main/src/features/google-ads/hooks/useGoogleAdsStorage.ts): `src/features/google-ads/hooks/useGoogleAdsStorage.ts`

### Analytics

- [Metrics engine](https://github.com/growthhackercz/amazing-simple-fun/blob/main/src/hooks/data/useMetricsEngine.ts): `src/hooks/data/useMetricsEngine.ts`
- [Analytics dashboards](https://github.com/growthhackercz/amazing-simple-fun/tree/main/src/components/dashboard): `src/components/dashboard`
- [Marketing analytics](https://github.com/growthhackercz/amazing-simple-fun/blob/main/src/components/MarketingAnalytics/MarketingAnalytics.tsx): `src/components/MarketingAnalytics/MarketingAnalytics.tsx`
- [Product analytics](https://github.com/growthhackercz/amazing-simple-fun/blob/main/src/components/ProductAnalytics/index.ts): `src/components/ProductAnalytics/index.ts`

### Growth tools

- [Optimization tools](https://github.com/growthhackercz/amazing-simple-fun/tree/main/src/features): `src/features`
- [SEO and content](https://github.com/growthhackercz/amazing-simple-fun/tree/main/src/features): `src/features`

### Platform management

- [Service connections](https://github.com/growthhackercz/amazing-simple-fun/tree/main/src/features): `src/features`
- [Shop management](https://github.com/growthhackercz/amazing-simple-fun/tree/main/src/features): `src/features`

### Other components

- **Shop team**
- **Ad platforms**
- **Shop platforms**
- **Supabase services**

## Connections

- Shop team → App routing: uses
- App routing → Auth providers: initializes
- App routing → Product modules: dispatches
- Product modules → Google Ads import: routes to
- Product modules → Shoptet import: routes to
- Product modules → FAPI import: routes to
- Product modules → Sklik import: routes to
- Product modules → GSC import: routes to
- Ad platforms → Google Ads import: provides data
- Shop platforms → Shoptet import: provides data
- Shop platforms → FAPI import: provides data
- Ad platforms → Sklik import: provides data
- Ad platforms → GSC import: provides data
- Google Ads import → Supabase services: invokes import
- Shoptet import → Supabase services: imports data
- FAPI import → Supabase services: imports data
- Sklik import → Supabase services: imports data
- GSC import → Supabase services: imports data
- Facebook storage → Supabase services: writes campaigns
- Google Ads storage → Supabase services: writes campaigns
- Shop team → Analytics dashboards: reviews results
- Shop team → Marketing analytics: reviews results
- Shop team → Product analytics: reviews results
- Analytics dashboards → Metrics engine: calculates metrics
- Marketing analytics → Metrics engine: calculates metrics
- Product analytics → Metrics engine: calculates metrics
- Shop team → Optimization tools: uses
- Shop team → SEO and content: uses
- Shop team → Service connections: configures
- Shop team → Shop management: manages shops