Atlas Assistant

Stop doomscrolling. Start reading signal.

Atlas Assistant is a calm, high‑signal news portal that turns chaos into clarity.

Live app: https://atlasassistant.rakibhq.xyz

---

Features

8 focused tabs (huge international news, in one place)

• Global
• Tech
• Innovators
• Early Signals
• Great Creators
• Universe
• History

Filters that actually help

Pick a Country + Topic + time window (1d / 7d) and Atlas curates the feed using scoring + caps (so you don’t get a junk flood).

AI experience

• 1‑click AI Digest (daily/weekly context in one summary):
  • Overview → Themes → Highlights → Why it matters → Watchlist
  • Optional text‑to‑speech if you’re short on time
• Per‑item AI summaries + key points
• Listen mode (text‑to‑speech)
• Multi‑language UI (broad language support)

Freshness

• Updates hourly

Saved posts

• Bookmark any post and find it in Settings → Saved.
• Free accounts can keep 10 posts; Pro accounts can keep 50.
• Removing a bookmark or deleting its original post frees a slot immediately.
• Saves are private account references, not permanent copies. Existing saves survive a plan downgrade, but new saves require room under the current limit.
• Feed and saved cards include a speaker button. Saving updates the interface immediately, with rollback if the server rejects the change.

Saved interaction checks:

• npm run test:saved-ui-state checks optimistic updates and rollback.
• npm run test:saved-interactions uses Playwright and a running production build at http://127.0.0.1:3000 (override with UI_TEST_BASE). It intercepts all API calls with isolated fixtures to test slow responses, failed saves and speech controls without account or database changes. Provide a Playwright installation as the playwright package or set PLAYWRIGHT_MODULE to its module URL. Chrome must be available.

Automatic payment activation

• Each NOWPayments checkout supplies /api/webhooks/nowpayments as its callback URL. Set the matching NOWPAYMENTS_IPN_SECRET in production and in the merchant account.
• A verified, fully paid finished notification activates Pro and adds one calendar month automatically, even when the browser is closed. Repeated notifications cannot grant the same month twice.
• Processing fees deducted from merchant proceeds do not count as buyer underpayment. Partial payments remain pending and do not grant Pro.
• An open checkout checks status every 8 seconds and refreshes account and saved-post limits after activation. Returning to an existing checkout can recover a missed webhook through the provider status API.
• Pro includes 50 saves, 20 item summaries per day, 10 digests per day and 2 translation languages per paid period. Access returns to Free when the paid period ends; there is no automatic charge.
• npm run test:checkout uses an isolated PostgreSQL database to verify signed webhook fulfillment, paid limits, expiry and duplicate callbacks without a browser session. npm run test:checkout-ui verifies the success screen appears without clicking the status button.

Database deployment

The existing database is managed with npm run db:migrate (Prisma db push). Vercel runs npm run db:migrate:saved before the application build to apply the additive, repeatable SQL in prisma/changes/20260909_saved_items.sql through DIRECT_URL. This only adds the saved-items table, indexes and cascading foreign keys. Local databases can use the normal schema push. It does not delete existing records.

Run npm run test:saved against an isolated PostgreSQL database by setting SAVED_TEST_DATABASE_URL to a localhost database whose name ends in _test. The suite uses its own temporary users and source, and removes those fixtures afterward.

---

License

This project is licensed under the MIT License.