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.
✅ 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
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
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.
Name: zynu-express · Set to Private · Click "Create repository".
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".
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.
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)
🤖 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.
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.
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)
| Name | What it is | Where to find it |
|---|---|---|
| NEXT_PUBLIC_SUPABASE_URL | Your Supabase project address | Supabase → Settings → API → Project URL |
| NEXT_PUBLIC_SUPABASE_ANON_KEY | Public access key (starts with eyJ…) | Supabase → Settings → API → anon/public |
| DATABASE_URL | Direct database connection string | Supabase → Settings → Database → URI (with your password inserted) |
🛒 AliExpress Affiliate
| Name | What it is | Where to find it |
|---|---|---|
| ALIEXPRESS_APP_KEY | Your affiliate App Key (numbers) | AliExpress Affiliate Portal → API Settings |
| ALIEXPRESS_APP_SECRET | Your affiliate App Secret (long string) | AliExpress Affiliate Portal → API Settings |
| ALIEXPRESS_TRACKING_ID | Your tracking/partner ID | AliExpress Affiliate Portal → Account Info |
🌐 Site Identity
| Name | What to put | Example |
|---|---|---|
| NEXT_PUBLIC_SITE_URL | Your store's full URL (with https://) | https://zynu-express.vercel.app |
| NEXT_PUBLIC_SITE_NAME | Your store's display name | DealHub |
| NEXT_PUBLIC_SITE_NAME_PREFIX | First part of your store name (plain) | DEAL |
| NEXT_PUBLIC_SITE_NAME_SUFFIX | Second part (shown in accent color) | HUB |
| NEXT_PUBLIC_SITE_DESCRIPTION | One-sentence store description for Google | Discover epic AliExpress deals with honest reviews |
| NEXT_PUBLIC_CONTACT_EMAIL | Support contact email | hello@yourdomain.com |
🚀 Deploy
Your store is live!
Now install the Poster app to start filling your store with products and writing your first blog articles.
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
⚠️ Critical: On the first screen, check "Add Python to PATH" before clicking Install Now. Easy to miss — this step is required.
If double-clicking doesn't work: right-click → Open with → Python.
🍎 Mac
🐧 Linux
Linux has an automated installer script. Open Terminal in the folder containing the Poster files and run:
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.
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
| Field | What to enter | Where to find it |
|---|---|---|
| Supabase DB URL | Your full PostgreSQL connection string | Supabase → Settings → Database → Connection string → URI |
| DB Password | The password you set when creating your Supabase project | You saved this in Step 3 |
| AliExpress App Key | Your AliExpress affiliate App Key | AliExpress Affiliate Portal → API Settings |
| AliExpress App Secret | Your AliExpress affiliate App Secret | AliExpress Affiliate Portal → API Settings |
| AliExpress Tracking ID | Your partner/tracking ID | AliExpress Affiliate Portal |
| Groq API Key(s) | One or more Groq keys (gsk_...) | console.groq.com → API Keys |
| Site URL | Your live store URL | Your Vercel deployment URL (https://...) |
| AI Provider | Groq (default) or Ollama (local, advanced) | Leave as Groq unless you know what Ollama is |
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
bluetooth speaker · gaming mouse under $30 · car phone holder · wireless earbuds
| Filter | What it does | Recommended |
|---|---|---|
| Min Rating | Minimum star rating (out of 5) | 4.5+ |
| Min Orders | Minimum number of past orders | 500+ |
| Min Price | Lowest price to include (USD) | 5 |
| Max Price | Highest price to include (USD) | 200 |
| Products per keyword | How many products to fetch per keyword | 10–20 |
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
| Setting | What it does | Recommended |
|---|---|---|
| Batch size | Products to write per run | 20–50 |
| Loop mode | Keep running until all products have descriptions | ✓ On |
| Delay (seconds) | Wait time between each product (respects Groq rate limits) | 2 |
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
best wireless earbuds under $50
gaming chair review 2026
cheap bluetooth speaker comparison
| Setting | What it does | Recommended |
|---|---|---|
| Min words | Minimum article length | 800 |
| Min score | Quality threshold (0–100). Articles below this are skipped | 70 |
| Products per article | How many store products to link in each article | 4–6 |
| Delay (min/max) | Seconds between articles (for rate limiting) | 5–15 |
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)
🐦 Posting a thread
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)
✈️ 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.
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
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.
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.
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.
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.
Finds pages with very similar titles or descriptions — which can confuse Google and split your rankings. Common with automatically generated product pages.
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.
💾 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
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.
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.
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.
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:
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.
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;
Social Posting Issues
Playwright (the browser automation tool for Twitter) needs to be installed separately.
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).
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 →