ZynU Express/Getting Started/Overview

Welcome to ZynU Express 👋

This guide covers everything — setting up your affiliate store, installing the Poster desktop app, and using all 10 tools. No coding required. Average total setup time: ~45 minutes.

🗺️ Your setup roadmap

The bundle has two products. Set up the Store first (Steps 1–5), then install the Poster app separately. You can do both in the same session.

① ZynU Express — The Store
1
Download files & upload to GitHubSave your store files and put them online
~5 min
2
Apply to AliExpress Affiliate ProgramFree signup — get your App Key & Tracking ID
FREE
3
Create Supabase + Groq accountsFree database and free AI quota
FREE
4
Create Vercel hosting & deployYour store goes live at a real URL
~10 min
5
Add your API keys to VercelConnect all accounts — store is fully live
~5 min
② Express Poster — Desktop App
6
Install the Poster appPython setup — Windows, Mac, or Linux
~10 min
7
Configure Global SettingsEnter your keys once — all panels use them
~3 min
8
Fill your store with productsType keywords, click Start, watch catalog grow
Optional
💡
Do all of it in one sittingSteps 1–5 take about 45 minutes total. AliExpress affiliate approval takes up to 24 hours, but you can complete everything else while you wait — and start using the Poster app immediately.

What you'll need

  • A computer with Chrome or FirefoxAny modern laptop or desktop works.
  • Your ZynU Express bundle download linkCheck the email from Gumroad after purchase.
  • An email address for creating free accountsYou can use the same email for all accounts.
  • About 45 minutes of uninterrupted time for the store setup
Getting Started/Step 1

Step 1 — Download & GitHub

You'll download your store files and upload them to GitHub — a free site that stores your project so Vercel (your hosting) can read it later. Think of it like saving files to Google Drive.

📥 Download your store files

1
Open your purchase email
Check the email you used to buy. You'll have an email from Gumroad with download links. You'll see two files — download the one labelled ZynU Express (the store). Save it to your Desktop.
2
Extract the ZIP file
Windows: Right-click the ZIP → "Extract All" → Extract.
Mac: Double-click the ZIP — it extracts automatically.

You'll get a folder called zynu-express (or similar). Keep it — you'll use it shortly.

🐙 Upload to GitHub

GitHub is where your store files live online. Vercel reads from GitHub to build and host your store. You only do this once.

💡
Already have GitHub?Skip to Step 3.
1
Create a free GitHub account
Go to github.com → Sign up. Use any email. It's completely free.
2
Create a new repository
Click the "+" icon (top-right) → "New repository".
Name: zynu-express · Set to Private · Click "Create repository".
3
Upload your store files
On the empty repo page, click the link "uploading an existing file".

Open your extracted folder, select all files inside it (not the folder itself), and drag them into the upload area.

Scroll down → click "Commit changes".
⚠️
Upload the contents, not the folderWhen uploading, make sure you're seeing files like package.json and a folder called app in the root of your GitHub repo — not a single folder containing all those files.
Step 1 complete!Files are on GitHub. Leave this tab open — you'll reconnect it to Vercel in Step 4.
Getting Started/Step 2

Step 2 — AliExpress Affiliate Program

This is how you earn money. When someone buys a product from your store, AliExpress pays you a commission (3–9% per sale). To get started, you need a free AliExpress Affiliate account and three credentials from it.

Approval takes up to 24 hoursApply now, then continue with Steps 3–5 while you wait. You can add your AliExpress credentials to Vercel later once approved.
1
Go to the AliExpress Affiliate Portal
Visit portals.aliexpress.com and click "Sign In". Use any AliExpress account (or create one free).
2
Apply for the affiliate program
After logging in, click "Apply Now" or "Join the Affiliate Program". Fill out the short application form — website URL can be your future Vercel URL (e.g., zynu-express.vercel.app) or any website. Submit and wait for approval.
3
Find your App Key, App Secret, and Tracking ID
Once approved, go to Account → API Settings (or similar — the exact location varies). You need three values:
What to copy from AliExpress Affiliate
ALIEXPRESS_APP_KEY = 12345678 ALIEXPRESS_APP_SECRET = abc123xyz456def789... ALIEXPRESS_TRACKING_ID = yourtrackingid
Paste all three into a notes app — you'll need them in Step 5.
⚠️
Can't find the API settings?AliExpress sometimes updates their portal layout. If you can't find the API credentials page, search for "AliExpress Affiliate API key" inside their help docs, or contact AliExpress affiliate support. The credentials always exist — they're just sometimes in different menu locations.
Step 2 started!Application submitted. Move on to Step 3 while waiting for approval.
Getting Started/Step 3

Step 3 — Supabase & Groq

Two more free accounts to create. Supabase stores your product catalog and articles. Groq writes all your AI content — product descriptions, blog articles, and social posts.

🗄️ Create Supabase (your database)

1
Sign up at supabase.com
Go to supabase.com"Start your project". Sign up with GitHub for the easiest experience. No credit card needed.
2
Create a new project
Click "New project". Give it any name (e.g., zynu-express). Set a database password and save it in your notes. Choose the region closest to you. Wait ~60 seconds for it to set up.
3
Copy your Supabase credentials
Go to Project Settings → API. Copy these two values and save them:
Supabase → Settings → API
NEXT_PUBLIC_SUPABASE_URL = https://xxxxxxxx.supabase.co NEXT_PUBLIC_SUPABASE_ANON_KEY = eyJhbGciOi... (very long)
4
Copy your database connection string
Still in Supabase, go to Project Settings → Database. Find the Connection string section and copy the "URI" format. It looks like:
Supabase → Settings → Database → Connection string → URI
DATABASE_URL = postgresql://postgres:[YOUR-PASSWORD]@db.xxxxxxxx.supabase.co:5432/postgres
Replace [YOUR-PASSWORD] with the password you set when creating the project.

🤖 Create Groq (your free AI)

Groq powers all AI writing — product descriptions, blog posts, Twitter threads, and Telegram promos. Free tier is more than enough for personal use.

1
Sign up at console.groq.com
Go to console.groq.com → Sign Up with Google or email. Free, no credit card.
2
Create an API key
In the left sidebar, click "API Keys""Create API Key". Name it anything. Copy the key immediately — it starts with gsk_ and Groq only shows it once.
💡
Want multiple Groq keys?The Poster app supports multiple Groq keys and rotates through them automatically when one hits a rate limit. Create 2–3 keys for uninterrupted writing on large runs.
Step 3 complete!You now have Supabase URL, Anon Key, Database URL, and Groq key(s) saved. One more account to go.
Getting Started/Step 4

Step 4 — Vercel & Deploy

Vercel is the free platform that puts your store online and gives it a URL. It reads your files from GitHub, builds your store, and keeps it running 24/7 — at no cost.

1
Create a free Vercel account
Go to vercel.com"Sign Up""Continue with GitHub". Approve the permissions — Vercel needs to read your GitHub repos.
2
Import your project
In your Vercel dashboard, click "Add New… → Project". Find your zynu-express repo in the list and click "Import".
3
Stop — don't click Deploy yet
You'll land on a configuration page. Don't click Deploy yet — you need to add your API keys first. That's what Step 5 covers. Keep this tab open.
Almost there!You're on the Vercel config page. Go straight to Step 5 to add your credentials.
Getting Started/Step 5

Step 5 — All Settings Explained

On the Vercel configuration page, expand the "Environment Variables" section. You'll add each credential one by one — a name and a value. Here's every single one explained in plain English.

🗄️ Supabase (Database)

NameWhat it isWhere to find it
NEXT_PUBLIC_SUPABASE_URLYour Supabase project addressSupabase → Settings → API → Project URL
NEXT_PUBLIC_SUPABASE_ANON_KEYPublic access key (starts with eyJ…)Supabase → Settings → API → anon/public
DATABASE_URLDirect database connection stringSupabase → Settings → Database → URI (with your password inserted)

🛒 AliExpress Affiliate

NameWhat it isWhere to find it
ALIEXPRESS_APP_KEYYour affiliate App Key (numbers)AliExpress Affiliate Portal → API Settings
ALIEXPRESS_APP_SECRETYour affiliate App Secret (long string)AliExpress Affiliate Portal → API Settings
ALIEXPRESS_TRACKING_IDYour tracking/partner IDAliExpress Affiliate Portal → Account Info

🌐 Site Identity

NameWhat to putExample
NEXT_PUBLIC_SITE_URLYour store's full URL (with https://)https://zynu-express.vercel.app
NEXT_PUBLIC_SITE_NAMEYour store's display nameDealHub
NEXT_PUBLIC_SITE_NAME_PREFIXFirst part of your store name (plain)DEAL
NEXT_PUBLIC_SITE_NAME_SUFFIXSecond part (shown in accent color)HUB
NEXT_PUBLIC_SITE_DESCRIPTIONOne-sentence store description for GoogleDiscover epic AliExpress deals with honest reviews
NEXT_PUBLIC_CONTACT_EMAILSupport contact emailhello@yourdomain.com
💡
NEXT_PUBLIC_SITE_URL is criticalThis must match your actual Vercel URL exactly, including https://. After your first deploy, Vercel assigns you a URL — update this variable with the real URL and redeploy.

🚀 Deploy

1
Add all your variables
After adding each credential (Name + Value), click "Add" to confirm it before moving to the next.
2
Click Deploy
Scroll to the bottom and click the big Deploy button. Vercel will build your store — takes 1–3 minutes.
3
Set up the database schema
After your store is live, you need to create the database tables. Go back to Supabase → SQL Editor → paste the contents of database/schema.sql (from your downloaded files) → click Run.
4
Update NEXT_PUBLIC_SITE_URL
Vercel gives your store a URL like zynu-express-xxx.vercel.app. Go to Vercel → Settings → Environment Variables → update NEXT_PUBLIC_SITE_URL to this real URL → click Redeploy.
🎉

Your store is live!

Now install the Poster app to start filling your store with products and writing your first blog articles.

Express Poster/Installation

Poster App — Installation

The Poster app runs on Python — a free program you install once. Then install a few add-ons and the app is ready. Total time: about 10 minutes. Works on Windows, Mac, and Linux.

🪟 Windows

1
Download & install Python
Go to python.org/downloads → click the big yellow "Download Python" button → open the file.

⚠️ Critical: On the first screen, check "Add Python to PATH" before clicking Install Now. Easy to miss — this step is required.
2
Open Command Prompt
Press Windows + R → type cmd → press Enter. A black window opens.
3
Install the required packages
Copy and paste this command into the black window, then press Enter:
Command Prompt — Windows
pip install PyQt5 requests psycopg2-binary
Wait 1–3 minutes for it to finish. You'll see text scrolling — that's normal.
4
Run the app
Find the main.py file from the ZynU Express Poster download. Double-click it. The app opens.

If double-clicking doesn't work: right-click → Open with → Python.

🍎 Mac

1
Check if Python is installed
Open Terminal (Cmd+Space → type Terminal → Enter). Type this and press Enter:
Terminal
python3 --version
If you see Python 3.x.x → skip to Step 3. If error → go to Step 2.
2
Install Python (if needed)
Go to python.org/downloads → download the .pkg file → install it.
3
Install packages in Terminal
Terminal — Mac
pip3 install PyQt5 requests psycopg2-binary
4
Run the app
Terminal — adjust path to where you saved the folder
cd ~/Downloads/ZynU-Express-Poster python3 main.py

🐧 Linux

Linux has an automated installer script. Open Terminal in the folder containing the Poster files and run:

Terminal — Linux
bash install.sh

The script installs all dependencies, creates a desktop shortcut, and asks if you want to add it to your app launcher. Run it once and you're done.

App is open?You should see the ZynU Express Poster window with a sidebar and tabs. Go to Step 2: Global Settings.
Express Poster/Global Settings

Global Settings — Setup Once

The Global Settings panel is the first thing to fill out. You enter all your credentials here once — and every other panel in the app reads from them automatically. You never need to enter your keys again.

🔧 What to fill in

FieldWhat to enterWhere to find it
Supabase DB URLYour full PostgreSQL connection stringSupabase → Settings → Database → Connection string → URI
DB PasswordThe password you set when creating your Supabase projectYou saved this in Step 3
AliExpress App KeyYour AliExpress affiliate App KeyAliExpress Affiliate Portal → API Settings
AliExpress App SecretYour AliExpress affiliate App SecretAliExpress Affiliate Portal → API Settings
AliExpress Tracking IDYour partner/tracking IDAliExpress Affiliate Portal
Groq API Key(s)One or more Groq keys (gsk_...)console.groq.com → API Keys
Site URLYour live store URLYour Vercel deployment URL (https://...)
AI ProviderGroq (default) or Ollama (local, advanced)Leave as Groq unless you know what Ollama is
💡
Multiple Groq keysYou can add more than one Groq API key, separated by commas. The app rotates through them automatically if one hits a rate limit — useful for long batch runs.
⚠️
Save after every changeAlways click Save Settings after filling in the Global Settings. If you close the app without saving, you'll need to re-enter everything.
Express Poster/Batch Product Fetcher

Batch Product Fetcher

This panel fills your store with real AliExpress products. You type keywords, set quality filters, and click Start — the app fetches products and adds them to your store catalog automatically.

🛒 How to use it

1
Open the Batch Products panel
Click Batch Products in the sidebar.
2
Add your keywords
Enter keywords for the products you want in your store. One keyword per line, or load from a file. Examples:

bluetooth speaker · gaming mouse under $30 · car phone holder · wireless earbuds
3
Set your quality filters
These filters ensure only quality products get added:
FilterWhat it doesRecommended
Min RatingMinimum star rating (out of 5)4.5+
Min OrdersMinimum number of past orders500+
Min PriceLowest price to include (USD)5
Max PriceHighest price to include (USD)200
Products per keywordHow many products to fetch per keyword10–20
4
Click Start
Click ▶ Start. Watch the live log — you'll see products being fetched and added in real-time. The counter shows how many were inserted vs failed.
💡
The more keywords, the bigger your catalogCreate a text file with 50–100 keywords and load it via the "Load from file" button. Run this once a week to keep your catalog fresh with new products.
ℹ️
No duplicatesThe app uses upsert logic — if a product already exists in your store, it updates it rather than creating a duplicate. Run it as many times as you like safely.
Express Poster/AI Description Writer

AI Description Writer

Every product in your store needs a unique description. This panel reads products that don't have a description yet and writes one for each using Groq AI — automatically, in the background, while you do other things.

🤖 How to use it

1
Open the AI Worker panel
Click AI Worker (or AI Descriptions) in the sidebar.
2
Set your preferences
SettingWhat it doesRecommended
Batch sizeProducts to write per run20–50
Loop modeKeep running until all products have descriptions✓ On
Delay (seconds)Wait time between each product (respects Groq rate limits)2
3
Click Start and let it run
Click ▶ Start. The app works through all your products without descriptions. The Done/Pending/Total counter updates in real-time. You can close other programs — this runs in the background.
💡
Run after every batch importEvery time you add new products with the Batch Fetcher, run the AI Writer afterward to write descriptions for the new ones. Takes about 2 seconds per product with Groq's free tier.
Express Poster/Blog Generator

Blog Article Generator

Blog articles are how people find your store through Google. This panel generates full 800–1,100 word SEO articles — with a table of contents, FAQ section, product comparisons, and affiliate links — for any keyword you give it.

✍️ How to use it

1
Prepare your keyword list
Create a text file with one keyword per line — buyer-intent keywords work best. Examples:
best wireless earbuds under $50
gaming chair review 2026
cheap bluetooth speaker comparison
2
Load keywords in the Blog Generator
In the Blog Generator panel, click "Load keywords from file" and select your text file.
3
Configure quality settings
SettingWhat it doesRecommended
Min wordsMinimum article length800
Min scoreQuality threshold (0–100). Articles below this are skipped70
Products per articleHow many store products to link in each article4–6
Delay (min/max)Seconds between articles (for rate limiting)5–15
4
Click Start
Click ▶ Start. Each keyword becomes a full article. Articles that score below your minimum are added to the retry queue automatically — the app will try them again later.
🎯
Best keyword strategyFocus on buyer-intent keywords — people ready to buy. "Best [product] under $[price]", "[product] review", "[product] vs [product]" all convert much better than generic terms.
📊
Article scoringEach article gets a quality score (0–100) based on word count, structure, and keyword coverage. Articles scoring below your minimum are skipped and queued for retry. Aim for 70+ for articles that rank on Google.
Express Poster/X / Twitter

X / Twitter Auto-Poster

This panel picks a random product from your store, generates a 5–7 tweet viral thread about it using Groq AI, and posts it to your Twitter/X account automatically. More posts = more traffic = more affiliate commissions.

🔐 First-time login (one time only)

1
Click 'Login to X'
In the X Poster panel, click the Login to X button. A Chrome browser window will open automatically.
2
Log in to your Twitter/X account
In the browser window that opens, log into your Twitter/X account normally. After logging in successfully, close that browser window.
3
Session is saved — you're done
The app saves your login session to disk. Every future post uses this saved session — you only log in once. If the session expires (usually after weeks), the app will prompt you to log in again.

🐦 Posting a thread

1
Choose your tone
Select from 4 tone options: Viral (curiosity-driven), Review (honest recommendation), Storytelling (before/after narrative), or Deals (value-focused). Each creates a different style of thread.
2
Click Post Thread
Click Post Thread. The AI writes a 5–7 tweet thread and posts it automatically. You'll see the tweet IDs in the log when it's done.
📅
Post consistently for best resultsTwitter/X rewards consistent posting. Use the built-in schedule feature to post one thread per day automatically — this grows your following and drives steady traffic to your store.
⚠️
Playwright is required for Twitter postingTwitter posting uses Playwright (a browser automation tool). If you get an error about Playwright on first use, open Command Prompt (Windows) or Terminal (Mac) and run: pip install playwright then playwright install chromium.
Express Poster/Telegram

Telegram Channel Poster

This panel picks a product from your store, writes an AI-generated promotional caption, and sends it to your Telegram channel — with the product photo and a "Buy Now" button that links to your affiliate store.

⚙️ Setup (one time)

1
Create a Telegram Bot
Open Telegram and search for @BotFather. Start a chat and type /newbot. Follow the prompts to name your bot. BotFather will give you a Bot Token — copy it. It looks like: 1234567890:ABCDefGHI...
2
Add your bot to your channel
Open your Telegram channel → Edit → Administrators → Add Administrator. Search for your bot by its username and add it with permission to Post Messages.
3
Find your Channel ID
Forward any message from your channel to @userinfobot on Telegram. It will reply with the channel's ID — a number starting with -100.... Copy it.
4
Enter credentials in the app
In the Telegram Poster panel, enter your Bot Token and Channel ID. Click Save.

✈️ Sending a post

Choose a tone (Viral, Review, Storytelling, Deals, Urgency) and click Send Post. The app picks a random product from your store, writes the caption, and sends it to your channel with a photo and inline "Buy Now" button.

💡
Build an audience firstInvite friends or promote your Telegram channel on social media first. Even 100 real followers will generate meaningful clicks. Telegram audiences tend to have high click-through rates on deal content.
Express Poster/SEO Toolkit

SEO Toolkit

The SEO Toolkit has 5 auditing tools that check your store for issues hurting your Google rankings. Run these after your store is live and monthly to stay on top of your SEO health.

🔍 The 5 tools

IndexNow Submitter

Tells search engines (Google, Bing) about new pages on your store immediately — instead of waiting for them to discover them on their own. Run this every time you add new products or articles.

How to use: Enter your store URL → click Submit. Done.
🔗Broken Link Checker

Scans all pages on your store and finds links that return 404 errors (page not found). Broken links hurt your SEO score and frustrate visitors.

How to use: Enter your store URL → click Check. View the report, fix or remove any broken links.
🏷️Meta Tag Auditor

Checks every page for missing, duplicate, or too-long title tags and meta descriptions. These directly affect how your pages appear in Google search results.

How to use: Enter your sitemap URL → click Audit. Review the list of pages with SEO issues.
⏱️Page Speed Tester

Tests how fast your store pages load. Slow pages rank lower on Google and have higher bounce rates. Flags the slowest pages for you to investigate.

How to use: Enter your store URL → click Test. Slow pages (>3s) are highlighted in red.
🔁Duplicate Content Detector

Finds pages with very similar titles or descriptions — which can confuse Google and split your rankings. Common with automatically generated product pages.

How to use: Enter your sitemap URL → click Scan. Review flagged duplicates and update the ones that are too similar.
📅
Run the SEO Toolkit monthlyNew products and articles can introduce new issues. A monthly audit takes 5 minutes and keeps your store in peak SEO health.
Express Poster/DB Exporter & Setup

DB Exporter & Setup

Two database tools in one panel: Setup Database creates all required tables in Supabase with one click, and DB Exporter backs up your entire catalog to a file.

🛠️ Setup Database (do this once)

If you haven't run the Supabase schema yet (from Step 5), you can do it here instead. Click Setup Database and the app creates all required tables: categories, products, articles, posting_logs, and twitter_sessions.

⚠️
Only run Setup Database onceRunning it a second time is safe — it won't delete existing data — but it's not necessary. If your tables already exist (you ran the SQL in Supabase), skip this.

💾 DB Exporter

Export your entire Supabase database to a single SQL file. Useful for:

  • Making a backup before doing major changes
  • Moving your catalog to a different Supabase project
  • Sharing your product database with someone else
1
Choose what to export
Select: Schema only (table structure), Data only (all records), or Schema + Data (full backup — recommended).
2
Choose output folder
Click Browse to select where to save the SQL file.
3
Click Export
The app exports in 500-row batches. A file like supabase_dump_20260314.sql is saved to your chosen folder. Done.
💾
Export monthly as a backupIf you've built up a large product catalog, a monthly export protects your work. Save it to Google Drive or Dropbox for safe off-site backup.
Troubleshooting/Store

Store Deploy Issues

Most store setup issues come from one of three things: wrong file location in GitHub, missing environment variables, or a missing database schema. Find your issue below.

Most likely cause: Files were uploaded incorrectly to GitHub.

  • In your GitHub repo, the root level should show files like package.json, next.config.js, and a folder called app.
  • If you see a single folder containing all these files, you uploaded the folder instead of its contents. Delete everything and re-upload the contents of the extracted ZIP — not the folder itself.

Fix: One or more environment variables are missing or have a typo.

  • Go to Vercel → Settings → Environment Variables.
  • Check that NEXT_PUBLIC_SUPABASE_URL, NEXT_PUBLIC_SUPABASE_ANON_KEY, and NEXT_PUBLIC_SITE_URL are all present.
  • Make sure there are no spaces at the start or end of any value.
  • After fixing: Vercel → Deployments → latest → Redeploy.

The database schema hasn't been set up yet, or AliExpress credentials are missing.

  • Go to Supabase → SQL Editor → paste the contents of database/schema.sql → Run.
  • Check that ALIEXPRESS_APP_KEY, ALIEXPRESS_APP_SECRET, and ALIEXPRESS_TRACKING_ID are set in Vercel.
  • Then run the Poster's Batch Product Fetcher to populate products.

This variable is required. Go to Vercel → Settings → Environment Variables → add NEXT_PUBLIC_SITE_URL with your full store URL (e.g., https://zynu-express.vercel.app) → Redeploy.

In Vercel → Settings → Domains → Add Domain. Enter your domain (e.g., mydeals.com). Vercel gives you DNS records to add at your domain registrar. After updating DNS (can take up to 24 hours to propagate), your store will be live at your custom domain. Also update NEXT_PUBLIC_SITE_URL to the new domain and redeploy.

Troubleshooting/Products

Products Not Syncing

If the Batch Fetcher isn't adding products, the issue is usually AliExpress credentials or filter settings being too strict.

  • Check your AliExpress App Key, Secret, and Tracking ID in Global Settings. Even one character wrong will cause all requests to fail silently.
  • Check that your AliExpress Affiliate account has been approved. If the application is still pending, the API won't return products.
  • Try relaxing your filters: lower Min Rating to 4.0, lower Min Orders to 100, widen the price range.

Very niche or spelled-incorrectly keywords return zero results from AliExpress. Try slightly broader versions of the keyword — for example, "wired gaming headset" instead of "pro esports gaming headset".

Products may have is_active = false or in_stock = false flags. Go to Supabase → Table Editor → products → filter where is_active = false and manually set them to true, or adjust the product fetcher settings to only add in-stock items.

Troubleshooting/Poster App

Poster App Won't Open

If the Poster desktop app won't start, here are the most common causes.

The required packages weren't installed, or were installed for a different Python version.

Windows — Command Prompt
pip install PyQt5 requests psycopg2-binary
Mac / Linux — Terminal
pip3 install PyQt5 requests psycopg2-binary

Python isn't set as the default program for .py files.

  • Right-click main.py → Open with → Choose another app → find Python in the list.
  • OR: Open Command Prompt → navigate to the folder → type python main.py

This is usually a PyQt5 compatibility issue. Try updating PyQt5:

Command Prompt / Terminal
pip install --upgrade PyQt5

Log files are saved at:

  • Windows: C:\Users\[YourName]\.local\share\zynu-express-poster\logs\
  • Mac/Linux: ~/.local/share/zynu-express-poster/logs/

If the app crashes, a crash_report_[timestamp].log file is created here with full details. Share this file with support if you need help diagnosing an issue.

Troubleshooting/AI & Groq

AI / Groq Errors

AI writing issues are almost always caused by an invalid Groq key or hitting the free-tier rate limit.

  • Go to Global Settings and check your Groq key. It should start with gsk_ — if it doesn't, you copied the wrong thing.
  • Go to console.groq.com → API Keys → create a new key and update it in Global Settings.

Groq's free tier has rate limits. The fix is to slow down or add more API keys.

  • Increase the delay between articles (5–15 seconds for free tier).
  • Add 2–3 Groq API keys in Global Settings (separated by commas). The app rotates through them automatically.
  • Try running at off-peak hours (nights/weekends) when Groq is less busy.

Articles might have is_published = false in Supabase. Go to Supabase → Table Editor → articles → set is_published = true for the articles you want to show. You can also do a bulk update via SQL: UPDATE articles SET is_published = true;

Troubleshooting/Social Posting

Social Posting Issues

Playwright (the browser automation tool for Twitter) needs to be installed separately.

Command Prompt / Terminal
pip install playwright playwright install chromium

After this, try the Twitter login again.

Twitter sessions expire after a few weeks of inactivity. When this happens:

  • Click Login to X in the X Poster panel.
  • Log in again in the browser window that opens.
  • The new session is saved and you're good for another few weeks.
  • Double-check your Bot Token in the Telegram panel — it should look like 1234567890:ABCDefGHIjklmno
  • Check that your bot is an Administrator of the channel with permission to Post Messages.
  • Channel ID must start with -100 for channels (not just @channelname).
Troubleshooting/General

General Questions

  • Download the new ZIP from your Gumroad purchase link (check your email).
  • Extract and upload the new files to your GitHub repo, overwriting the existing ones.
  • Vercel automatically detects the changes and redeploys — no action needed.

Basic branding (store name, description) is done through environment variables in Vercel — change NEXT_PUBLIC_SITE_NAME, NEXT_PUBLIC_SITE_NAME_PREFIX, and NEXT_PUBLIC_SITE_NAME_SUFFIX, then redeploy.

For colors and logo, edit app/globals.css (CSS variables) and the header component in components/layout/Header.tsx.

Commission rates vary by category — typically 3–9% per sale. Electronics tends to be 3–5%, fashion and accessories can be 7–9%. You can view the exact rates for each category in your AliExpress Affiliate portal under Commission Rates.

The license covers one personal store deployment. If you want to run multiple stores, each would need a separate purchase. For volume or agency licensing, contact support.

New sites typically take 2–8 weeks to appear in Google. Speed this up by: (1) submitting your sitemap to Google Search Console, (2) using the IndexNow tool in the SEO Toolkit after adding products, and (3) publishing regular blog articles targeting specific buyer keywords.

💬

Problem not listed? We'll help directly.

Send a screenshot of the error and we'll diagnose and fix it with you. Support is included with your purchase.

Chat with Support on Telegram →