How phuuthanh-dev/meta-marketing-dashboard works
Meta Marketing Dashboard combines Facebook organic, Ads, Instagram reporting, CSV export, live updates, and content planning. Users view reporting through the dashboard; the server exposes authenticated API routes backed by SQLite, while fetchers collect platform data. Content planning adds Google Sheets/Drive synchronization and publishing workflows. Scheduled collection is optional. The README documents the product capabilities; some route wiring and frontend behavior are unsampled, so those relationships are shown only where supported or marked unverified.
Main entry points: server.js HTTP Server · api.js API Client · database.js SQLite Store · index.js Content Plan API
Components 32
Dashboard UI
- Dashboard Shell
public/js/app.js - API Client
public/js/api.js - Analytics Charts
public/js/charts.js - Extended Charts
public/js/additional-charts.js - Ads Dashboard
public/js/ads.js - Instagram Dashboard
public/js/instagram.js - Page Insights
public/js/phase1.js - Engagement Views
public/js/phase2.js - Management Views
public/js/phase3.js - Management Charts
public/js/phase3-charts.js - Content Plan UI
public/js/content-plan.js
Application API
- HTTP Server
src/server.js - SQLite Store
src/database.js - Runtime Config
src/config.js
Data Collection
- Facebook API
src/facebook/api.js - Facebook Metrics
src/facebook/metrics.js - Meta Ads API
src/meta-ads/api.js - Ads Collector
src/meta-ads/fetcher.js - Instagram API
src/instagram/api.js - Instagram Collector
src/instagram/fetcher.js - Scheduler
src/scheduler.js
Content Planning
- Content Plan API
src/content-plan/index.js - Sheets Sync
src/content-plan/sheets-sync.js - Sheet Updater
src/content-plan/sheet-updater.js - Drive Media
src/content-plan/drive-download.js - Media Hosting
src/cloudinary.js
Other components
- Marketer
- Browser
- Meta Graph API
- Google Sheets
- Google Drive
- Cloudinary
Connections 42
- Marketer → Browser: uses
README.md - Browser → Dashboard Shell: loads dashboard
- Dashboard Shell → API Client: uses
- API Client → HTTP Server: requests API
- HTTP Server → SQLite Store: reads and writes
src/server.js - HTTP Server → Facebook API: routes platform actions
src/server.js - HTTP Server → Meta Ads API: routes platform actions
src/server.js - HTTP Server → Instagram API: routes platform actions
src/server.js - HTTP Server → Content Plan API: mounts routes
src/server.js - HTTP Server → Runtime Config: uses settings
src/server.js - Facebook Metrics → Facebook API: fetches metrics
src/facebook/metrics.js - Facebook Metrics → SQLite Store: saves metrics
src/facebook/metrics.js - Ads Collector → Meta Ads API: fetches insights
src/meta-ads/fetcher.js - Ads Collector → SQLite Store: saves insights
src/meta-ads/fetcher.js - Instagram Collector → Instagram API: fetches insights
src/instagram/fetcher.js - Instagram Collector → SQLite Store: saves insights
src/instagram/fetcher.js - Facebook API → Meta Graph API: calls Graph API
src/facebook/api.js - Meta Ads API → Meta Graph API: calls Graph API
src/meta-ads/api.js - Instagram API → Meta Graph API: calls Graph API
src/instagram/api.js - Scheduler → Facebook Metrics: runs collection
src/scheduler.js - Scheduler → Ads Collector: runs collection
src/scheduler.js - Scheduler → Instagram Collector: runs collection
src/scheduler.js - Scheduler → Sheets Sync: runs sync
src/scheduler.js - Scheduler → SQLite Store: processes publish jobs
src/scheduler.js - Content Plan API → SQLite Store: reads and writes plans
src/content-plan/index.js - Content Plan API → Sheets Sync: triggers sync
src/content-plan/index.js - Content Plan API → Drive Media: streams media
src/content-plan/index.js - Content Plan API → Sheet Updater: updates sheet
src/content-plan/index.js - Sheets Sync → Google Sheets: reads sheet
src/content-plan/sheets-sync.js - Sheets Sync → SQLite Store: stores plan
src/content-plan/sheets-sync.js - Drive Media → Google Drive: downloads media
src/content-plan/drive-download.js - Drive Media → Media Hosting: uploads media
src/content-plan/drive-download.js - Media Hosting → Cloudinary: hosts media
- Content Plan UI → Content Plan API: uses plan API
- Ads Dashboard → API Client: requests reporting
- Instagram Dashboard → API Client: requests reporting
- Page Insights → API Client: requests reporting
- Engagement Views → API Client: requests reporting
- Management Views → API Client: requests management
- Analytics Charts → Dashboard Shell: renders charts
- Extended Charts → Dashboard Shell: renders charts
- Management Charts → Management Views: renders charts