shipwords کے ساتھ مطلوبہ کلیدی الفاظ پر مرکوز AI سائٹس کا نیٹ ورک بنائیں اور لانچ کریں

shipwords کیا کرتا ہے

shipwords ایک اوپن سورس، MIT لائسنس یافتہ فریم ورک ہے جو Cloudflare پر AI تصاویر اور ویڈیوز کی سائٹس کے مجموعے کو چلانے کے لیے بنایا گیا ہے، جہاں ہر کلیدی لفظ کے لیے ایک الگ سائٹ مخصوص ہوتی ہے۔ اکاؤنٹس، ادائیگیاں، کریڈٹس اور AI جنریشن جیسی مشترکہ سہولیات فریم ورک میں ایک بار نافذ کی جاتی ہیں، جبکہ ہر سائٹ کے اپنے صفحات، بصری شناخت، ڈومین، ڈیٹابیس، اسٹوریج اور ادائیگی اکاؤنٹ ہو سکتے ہیں۔

ہر سائٹ TanStack Start اور React 19 کی ایپلی کیشن ہوتی ہے جو اپنے Cloudflare Worker پر D1، R2 اور Workflows کے ساتھ چلتی ہے۔ یہ علیحدگی آپ کو سائٹس کو آزادانہ طور پر لانچ، اپ ڈیٹ یا ریٹائر کرنے دیتی ہے، جبکہ آئندہ تعیناتیوں میں مشترکہ کور کی بہتریاں بھی حاصل ہوتی رہتی ہیں۔

اہم خصوصیات

• اکاؤنٹ صفحات کے ساتھ Google اور ای میل سائن اِن۔
• Stripe اور PayPal کی معاونت، جس میں کریڈٹ پیکس، سبسکرپشنز، آرڈرز، ریفنڈز اور تنازعات شامل ہیں۔
• ای میل اطلاعات اور reCAPTCHA v3 کے غلط استعمال کی حدود کے ساتھ مہمانوں کے لیے مفت آزمائشیں۔
• رازداری، شرائط، ریفنڈ اور DMCA صفحات۔
• SEO اور GEO مددگار، جن میں sitemap.xml، robots.txt اور llms.txt شامل ہیں۔
• ورک فلو پر مبنی جنریشن رن ٹائم، جس میں یک طرفہ جاب اسٹیٹس اور ناکام جابز کے لیے خودکار ریفنڈز شامل ہیں۔
• GPT Image، Nano Banana، Seedream، FLUX، Seedance، Veo، Kling اور Wan جیسے ماڈلز کے لیے Yir API انضمام۔
• ماڈل API کلید کے بغیر مقامی ڈیولپمنٹ کے لیے فرضی upstream۔
• ffmpeg کنٹینر کے ساتھ اختیاری ویڈیو کمپوزیشن۔

پیشگی تقاضے

شروع کرنے سے پہلے Node 24 انسٹال کریں، جیسا کہ repository کی .nvmrc میں درج ہے، اور Corepack فعال کریں تاکہ مطلوبہ pnpm ورژن دستیاب ہو:

corepack enable

Windows پر Git Bash یا WSL استعمال کریں۔ جب آپ تعیناتی اور ادائیگیاں قبول کرنے کے لیے تیار ہوں گے تو Cloudflare اکاؤنٹ اور Stripe یا PayPal اکاؤنٹ درکار ہوگا۔ بنیادی مقامی سیٹ اپ کے لیے ان کی ضرورت نہیں ہے۔

repository انسٹال کریں

repository کو fork یا clone کریں، پھر اس کی dependencies انسٹال کریں:

pnpm install

نئی سائٹ بنائیں

مکمل AI سائٹ ٹیمپلیٹ سے سائٹ بنانے کے لیے سائٹ جنریٹر استعمال کریں۔ پہلی دلیل sites/ کے اندر ڈائریکٹری بن جاتی ہے، جبکہ ڈومین سائٹ کی ترتیب میں درج کیا جاتا ہے:

pnpm new-site my-tool --domain my-tool.com
pnpm install

بنائی گئی سائٹ میں ہوم پیج، قیمتوں کا صفحہ، اکاؤنٹ اور لاگ اِن فلو، پالیسی صفحات، اور معیاری sitemap.xml، robots.txt اور llms.txt فائلیں شامل ہوتی ہیں۔ نئی سائٹ کی dependencies انسٹال کرنے کے لیے دوبارہ pnpm install چلائیں۔

مقامی secrets ترتیب دیں

مقامی secrets کو repository سے باہر رکھیں۔ ایک configuration ڈائریکٹری بنائیں، بنائی گئی سائٹ کی مثال والی variables فائل کاپی کریں، اور worktree configuration منسلک کریں:

mkdir -p ~/.config/shipwords
cp sites/my-tool/.dev.vars.example ~/.config/shipwords/my-tool.dev.vars
pnpm setup:worktree

مثالی configuration مقامی ڈیولپمنٹ کے لیے فوراً کام کرنے کے لیے بنائی گئی ہے۔ ای میل سائن اِن کوڈز ڈیولپمنٹ سرور کے ٹرمینل میں دکھائے جاتے ہیں، نئے اکاؤنٹس کو سائن اپ کریڈٹس ملتے ہیں، اور جب UPSTREAM_MOCK=1 ہو تو جنریشن فرضی upstream استعمال کرتی ہے۔ اس طرح آپ ماڈل API کلید کے بغیر ایپلی کیشن کی جانچ کر سکتے ہیں۔

حقیقی جنریشن شامل کریں

حقیقی ماڈل درخواستوں کے لیے Yir API کلید شامل کریں اور UPSTREAM_MOCK تبدیل کر کے فرضی upstream بند کریں۔

ادائیگیوں کی جانچ کریں

کریڈٹ خریداریوں کی جانچ کے لیے sk_test_ سے شروع ہونے والی Stripe test key شامل کریں۔ سائٹ کی ڈائریکٹری سے repository کی webhook forwarding utility چلائیں تاکہ مقامی ڈیولپمنٹ Stripe events وصول کر سکے:

node ../../tools/stripe-listen.mjs

مشترکہ payment code بار بار آنے والے یا ترتیب سے ہٹ کر ادائیگی کے events، دوہری کٹوتیوں اور ناکام جابز کے ریفنڈز کو سنبھالنے کے لیے بنایا گیا ہے۔

اختیاری سائن اِن اور مہمان رسائی ترتیب دیں

مہمانوں کی مفت آزمائشوں کے لیے reCAPTCHA keys درکار ہیں۔ ان کے بغیر، زائرین کو پہلی جنریشن سے پہلے سائن اِن کرنا ہوگا۔ Google سائن اِن اختیاری ہے؛ اسے فعال کرنے کی صورت میں Google OAuth client بنائیں اور http://localhost:<port> کو allowed origin کے طور پر استعمال کریں۔ ای میل سائن اِن Google OAuth کے بغیر کام کرتا ہے۔

سائٹ مقامی طور پر چلائیں

بنائی گئی سائٹ میں جائیں، مقامی ڈیٹابیس artifacts بنائیں، مقامی migrations لاگو کریں، اور ڈیولپمنٹ سرور شروع کریں:

cd sites/my-tool
pnpm db:generate && pnpm db:migrate:local
pnpm dev

ڈیولپمنٹ سرور کی طرف سے دکھائے گئے مقامی URL کو کھولیں۔ مثال والی configuration استعمال کرتے ہوئے آپ ای میل authentication، اکاؤنٹ بنانا، کریڈٹس اور فرضی جنریشن آزما سکتے ہیں۔

repository کے commands استعمال کریں

زیادہ تر commands کسی سائٹ تک محدود کیے جا سکتے ہیں یا پوری repository کی جانچ کے لیے استعمال کیے جا سکتے ہیں:

pnpm new-site <dir> --domain <domain>
pnpm list-sites
pnpm setup:worktree
pnpm --filter "./sites/<site>" dev
pnpm --filter "./sites/<site>" check
pnpm check:packages
pnpm check:template
pnpm lint && pnpm test:tools

list-sites command ہر سائٹ کے code اور README سے سائٹس کی فہرست بناتا ہے۔ سائٹ کا check command type checking، build اور launch checks چلاتا ہے۔ Package checks مشترکہ core اور jobs packages کا احاطہ کرتے ہیں، جبکہ template اور tools checks لانچ سے پہلے مسائل پکڑنے میں مدد دیتے ہیں۔

AI coding agent کے ساتھ سائٹ بنائیں

اگر آپ پہلے ہی جانتے ہیں کہ کس کلیدی لفظ کو ہدف بنانا ہے تو repository agent-driven workflow فراہم کرتی ہے۔ Claude Code، Codex یا Cursor میں repository کی agent instructions دیں اور اس سے سائٹ بنانے کو کہیں:

Read shipwords.dev/llms.txt and build a site for "<your keyword>"

ایجنٹ ریپوزٹری کو کلون کر سکتا ہے، سائٹ بنا سکتا ہے، اور اسے مقامی طور پر چلا سکتا ہے۔ AI کوڈنگ ایجنٹس کے قواعد AGENTS.md میں درج ہیں۔ اگر آپ کو ابھرتے ہوئے کلیدی الفاظ کے لیے آئیڈیاز درکار ہوں تو الگ new-term-radar پروجیکٹ X، Hugging Face، GitHub اور سائٹ میپس پر نئے AI اصطلاحات کی نگرانی کرتا ہے۔

سائٹ کے جدید رویے کو حسب ضرورت بنائیں

مشترکہ جنریشن رن ٹائم استعمال کریں

packages/jobs پیکیج ورک فلو پر مبنی رن ٹائم، اپ اسٹریم اڈاپٹر انٹرفیس، Yir اڈاپٹر، مقامی موک اپ اسٹریم، اور اختیاری ffmpeg کمپوزیشن فراہم کرتا ہے۔ سائٹ سے متعلق جنریشن رویہ سائٹ کی کنفیگریشن میں رکھیں اور جاب پروسیسنگ اور رقم کی واپسی کے انتظام کے لیے مشترکہ رن ٹائم استعمال کریں۔

جنریشن کی لاگت کی حدیں مقرر کریں

Yir کے ذریعے ماڈل کالز کی بلنگ فی درخواست ہوتی ہے۔ ہر جاب کی زیادہ سے زیادہ لاگت site.models.ts میں مقرر کی جاتی ہے۔ حقیقی جنریشن فعال کرنے سے پہلے ان حدود کا جائزہ لیں تاکہ سائٹ کی قیمتوں اور کریڈٹ کا رویہ زیادہ سے زیادہ اپ اسٹریم لاگت سے مطابقت رکھے۔

ویڈیو کی مثال کا مطالعہ کریں

ویڈیو پر مرکوز سائٹ کے لیے sites/tinydeskai-example کا جائزہ لیں۔ یہ Tiny Desk AI کا مکمل سورس ہے اور فوٹو سلاٹس، ایک مرحلے کی ویڈیو ایڈیٹنگ، آؤٹ پٹ چیکنگ، ffmpeg کمپوزیشن، اور مواد کے صفحات کی مثال پیش کرتا ہے۔ اس کا ورک فلو ایک وائرل کلپ کو ایسے ٹیمپلیٹ میں تبدیل کرتا ہے جسے وزیٹرز اپ لوڈ کردہ تصاویر کے ساتھ استعمال کر سکتے ہیں۔

سائٹس کو خودمختار رکھیں

ہر سائٹ اپنے ڈیٹا بیس، اسٹوریج اور ادائیگی اکاؤنٹ کے ساتھ الگ سے تعینات کی جاتی ہے۔ یہ طرزِ تعمیر آپ کو مشترکہ بنیادی حصے کو ایک بار بہتر بنانے اور منتخب سائٹس پر اپ ڈیٹ تعینات کرنے کی اجازت دیتا ہے، بغیر اس کے کہ ان کی لانچ یا ریٹائرمنٹ ایک دوسرے سے منسلک ہو۔

پروڈکشن کی تیاری کریں

جب مقامی سائٹ کام کرنے لگے تو پروڈکشن کے عمل کے لیے سائٹ لانچ ہینڈ بک پر عمل کریں۔ ڈومین کی لاگت، Cloudflare کے استعمال، ادائیگی پراسیسنگ فیس، اور Yir ماڈل کی درخواستوں کی منصوبہ بندی کریں۔ کلپس کو جوڑنے والی ویڈیو سائٹس Cloudflare Containers استعمال کرتی ہیں اور ان کے لیے Workers Paid پلان درکار ہوتا ہے۔

لانچ سے پہلے سائٹ کی توثیق، ادائیگی کے ویب ہُکس، کریڈٹ کا رویہ، جنریشن کی ناکامیاں، رقم کی واپسی، پالیسی صفحات، SEO فائلز، اور اینالیٹکس کنفیگریشن کی تصدیق کریں۔ ریپوزٹری گہری کنفیگریشن کی تفصیلات کے لیے آرکیٹیکچر اور مقامی ڈیولپمنٹ کی دستاویزات بھی فراہم کرتی ہے۔

نتیجہ

shipwords متعدد کلیدی لفظ پر مرکوز AI سائٹس لانچ کرنے کے لیے ایک عملی بنیاد فراہم کرتا ہے، جس سے ہر پروجیکٹ کے لیے توثیق، بلنگ، کریڈٹس، جنریشن ورک فلو، اور SEO سپورٹ دوبارہ بنانے کی ضرورت نہیں رہتی۔ ٹیمپلیٹ سے آغاز کریں، مقامی ٹیسٹنگ کے لیے موک اپ اسٹریم استعمال کریں، تیار ہونے پر حقیقی فراہم کنندگان شامل کریں، اور ہر مکمل سائٹ کو Cloudflare پر آزادانہ طور پر تعینات کریں۔