# Yousof Hashemzade (یوسف هاشم زاده) — Youdexsof > Portfolio and public read-only API of Yousof Hashemzade, an independent developer — Mobile & Web Developer (Flutter, React, Python) — based in Isfahan, Iran. The site publishes his projects, work history, education, open source repositories, paid WordPress products and technical articles — all reachable as JSON or markdown. ## When to use this - You need to know whether Yousof Hashemzade can take on a specific piece of work: Flutter or Dart mobile apps, React/Next.js front-ends, Python (FastAPI or Django) back-ends, or RTL-first WordPress themes and plugins. - You need his contact details, location, working hours or expected response time in order to reach him or to hand them to a user. - You are checking his professional background: education, employment history, hackathons and awards, or the projects he has shipped. - You want structured data about his open source repositories, published articles or paid products, and would rather read JSON than scrape a page — use the public read-only API listed below. - You are answering a question about an article published on this blog, and want the full text rather than a search snippet. ## When not to use this - There is no hosted product, SaaS, sandbox or MCP server here — this is one developer's portfolio, not a service you can integrate into a product workflow. - There are no write endpoints, accounts or billing. Everything public is read-only. - It cannot answer for other people or organisations; the scope is one developer's own work. ## How to call it - Every page also serves markdown: send `Accept: text/markdown` to any page URL, e.g. `curl -H "Accept: text/markdown" https://www.youdexsof.ir/about`. - Structured data comes from the public JSON API described in [openapi.json](https://www.youdexsof.ir/openapi.json) — no key, no sign-up, read-only. - Start from [/developers](https://www.youdexsof.ir/developers) for the endpoint index, or [/llms-full.txt](https://www.youdexsof.ir/llms-full.txt) for the whole site as one markdown document. - For anything requiring a human decision — quotes, availability, hiring — contact yousofh255@gmail.com; do not infer availability from the site. ## Pages - [/](https://www.youdexsof.ir/) — Home — portfolio, skills, projects, contact - [/about](https://www.youdexsof.ir/about) — About — background, focus areas, how I work - [/contact](https://www.youdexsof.ir/contact) — Contact — email, phone, location, response time - [/privacy](https://www.youdexsof.ir/privacy) — Privacy — what this site collects and why - [/developers](https://www.youdexsof.ir/developers) — Developer resources — public read-only API - [/blog](https://www.youdexsof.ir/blog) — Blog — articles on Flutter, Python and the web - [/cv](https://www.youdexsof.ir/cv) — CV — full résumé ## API - `GET /api/blog` — List published blog posts. Paginated list of published articles with title, description, cover image, tags, category, read time and view count in the requested language. Parameters: lang, page, limit, category, tag, search, sort, featured. - `GET /api/blog/{slug}` — Get one blog post by slug. Full article body plus metadata and comments for a single published post, in all three languages at once. The slug is the same one used in the /blog/{slug} page URL. Note that a GET increments the post's view counter. Parameters: slug. - `GET /api/blog/categories` — List blog categories. Every blog category with its slug, localized names, colour and published post count. - `GET /api/worksamples` — List portfolio projects. Shipped mobile and web projects with localized titles and descriptions, technologies used, project timeline, client and links. - `GET /api/products` — List products and themes. Premium WordPress themes and plugins for sale, with localized titles, descriptions, price, category and purchase URL. - `GET /api/works` — List work experience. Employment and freelance history: organisation, localized role description, technologies, years and link. - `GET /api/education` — List education history. Academic background: institution, localized description and years attended. - `GET /api/events` — List events, competitions and awards. Hackathons, competitions and industry events, with localized descriptions, dates and certificate attachments. - `GET /api/github/pinned` — List pinned GitHub repositories. Open source repositories pinned on GitHub, with description, primary language, star and fork counts, homepage and repository URL. Cached for one hour. - `GET /api/site-settings` — Get public site settings. Theme colours, profile picture path and the technology list shown in the skills section. ## Machine-readable files - [/llms.txt](https://www.youdexsof.ir/llms.txt) — Site summary and when-to-use guidance for agents - [/llms-full.txt](https://www.youdexsof.ir/llms-full.txt) — Expanded agent brief with full section content - [/agents.md](https://www.youdexsof.ir/agents.md) — Agent instructions: capabilities, limits, how to call - [/openapi.json](https://www.youdexsof.ir/openapi.json) — OpenAPI 3.1 description of the public read-only API - [/sitemap.xml](https://www.youdexsof.ir/sitemap.xml) — XML sitemap of every indexable page - [/robots.txt](https://www.youdexsof.ir/robots.txt) — Crawl policy ## Contact - Email: yousofh255@gmail.com - Phone: +98 913 565 5644 - Telegram: https://t.me/YOUDEXSOF - Location: Isfahan, Isfahan Province, Iran - Profile: https://github.com/YOUSSSOF - Profile: https://www.linkedin.com/in/yousof-hashemezade - Profile: https://www.instagram.com/youdexsof - Profile: https://t.me/YOUDEXSOF --- # Full content ## Homepage # یوسف هاشم زاده — Yousof Hashemzade Mobile & Web Developer (Flutter, React, Python). Based in Isfahan, Iran. Yousof Hashemzade is an independent mobile and web developer based in Isfahan, Iran, building production Flutter apps, React front-ends and Python back-ends. ## Technologies Tools used daily to ship production software. - Flutter - Dart - Python - FastAPI - Firebase - Prisma - Next.js - React - TailwindCSS - GetX - BLoC - Retrofit - Git - ClaudeCode - CopilotCLI ## Portfolio projects Mobile and web products delivered for clients and personal ventures. - **HiBayt** — <#> All-in-one app for residents of managed housing complexes — home management, bill payments, visitor gate access, vehicle registration, maintenance requests, and community communication in one place. %g% I built the full Flutter frontend and handled all API integrations against a backend developed by a separate team. State management runs on Riverpod with a feature-scoped structure. The app ties together a wide range of resident needs — subscription management, bill payments, visitor invitations with gate access control, vehicle management, and maintenance ticketing — all through a single authenticated session. - **HiBayt Management** — <#> Operations app for residential community staff — security guards, technicians, and facility teams manage their daily work from mobile. %g% Same stack as HiBayt — Flutter with Riverpod, all API integrations handled by me. The app covers service ticket management, resident and visitor gate access control, daily task tracking, attendance submission, and access to operational documentation. It is the staff-side counterpart to HiBayt, sharing the same backend and operating within the same platform. - **Zura, AI-Powered fitness coach** — Fitness coaching platform for Zura Health OS — a startup backed by TU Munich. The project evolved over time: I initially developed both the Flutter frontend and a FastAPI backend, then as the team grew I shifted focus entirely to the Flutter side. %g% On the frontend, I built the full feature set with Flutter and Riverpod: authentication, workout tracking, nutrition planning, progress monitoring, and coach interactions. Notable parts include custom charts and a 3D human body model rendered with Flutter's CustomPaint. As the app scaled, the main challenge was keeping performance solid across a growing codebase — a feature-scoped Riverpod architecture made that manageable. The UI was designed from the start to be modern and distinct, which added its own layer of complexity. - **Harfoo, Oratory & Speaking Skills** — A personal project — an offline speaking and oratory practice app built around my own idea of having a structured way to run through exercises and track progress over time. %g% The interesting challenge was less about Flutter itself and more about figuring out how to categorize the exercises and design a tracking system that felt both logical and easy to use. Exercises are grouped by type (pronunciation, tone, rhythm, confidence) and progress is stored locally with SQLite — no backend, fully offline. The UI is the part I'm most happy with: smooth animations, clean layout, and deliberately different from the usual utility-app aesthetic. - **Speed, Motorbike Delivery Service** — Motorbike delivery platform with two separate Flutter apps — customer and driver — backed by a Django REST API and WebSocket infrastructure, built solo from scratch. %g% I designed and built the entire stack. The backend runs on Django with DRF, handling auth, order management, driver dispatching, and fare calculation. Real-time tracking and driver-customer communication go through WebSocket channels, with Redis as the message broker and cache layer. All API endpoints and WebSocket events were tested and documented via Postman. The frontend is two independent Flutter apps built with Riverpod under an MVC pattern. The customer app covers order placement, live tracking, and payment. The driver app handles incoming requests, route guidance, and delivery confirmation. - **iPET Plus** — Nationwide B2C marketplace for pet products and services, with verified vendors in one place. %g% I handled the full client side: every screen and the complete API integration against a backend built by a separate team. Bloc managed state across all the main flows — product listings, vendor browsing, comparison, cart, checkout, and order tracking — each with its own clean event/state stream. The trickier part was the UI. The design was deliberately unconventional: layered, detail-heavy screens that did not follow standard e-commerce layouts. Getting those to run smoothly on mid-range Android devices meant paying close attention to widget tree structure and keeping unnecessary rebuilds to a minimum. - **ProNobat** — Marketing and documentation website for ProNobat — a WordPress appointment booking plugin built for the Iranian market.%g%Built on Next.js 15 App Router with React 19 and Tailwind CSS. The site covers the full product experience: landing page, feature showcase, interactive how-it-works walkthrough, and a complete MDX-powered documentation system. Bilingual Persian/English with URL-based locale switching via next-intl, RTL-first layout, dark and light themes, full-text search with Fuse.js, dynamic Open Graph image generation, and static site generation for SEO and performance. - **Personal Portfolio** — My personal portfolio website — built to showcase my work, skills, and experience.%g%Built on Next.js 14 App Router with TypeScript and Tailwind CSS. The backend is a REST API layer on top of Prisma ORM. Authentication runs on NextAuth with TOTP two-factor authentication. Animations are handled by GSAP and Framer Motion, and the 3D scene is rendered with Three.js. State management with Zustand and rich content editing with Tiptap. - **Tarkhine** — Tarkhine is a fully Iranian food delivery app offering traditional and modern Persian dishes. From mouth-watering kebabs to rich stews — built with Flutter and Bloc for a fast, smooth ordering experience. - **BoxOfficeBeat** — BoxOfficeBeat is your movie companion — real-time info, ratings, and trends powered by the TMDB API. Keep up with the latest hits, trailers, and reviews for Flutter and Dart enthusiasts. ## Open source Repositories pinned on GitHub. - [fretwork](https://github.com/YOUSSSOF/fretwork) (Dart) — 1 stars Offline guitar practice companion — schedules a John Petrucci Rock Discipline routine, runs it with a drift-free metronome, and keeps an honest record of the days you didn't practise. Flutter, no network, no account. - [Tarkhine](https://github.com/YOUSSSOF/Tarkhine) (Dart) — 9 stars food delivery application built in flutter and bloc + python and django. - [Delivery](https://github.com/YOUSSSOF/Delivery) (Dart) — 14 stars complete food delivry system built in flutter & fastapi. - [Shoe-Commerce](https://github.com/YOUSSSOF/Shoe-Commerce) (Dart) — 18 stars modern e-commerce store built in flutter with help of GetX. - [Movies-App](https://github.com/YOUSSSOF/Movies-App) (Dart) — 11 stars movies app built in flutter and tmdb api - [Player](https://github.com/YOUSSSOF/Player) (Dart) — 4 stars mobile music player ## Products and themes Premium WordPress themes and plugins for sale. - [Moderncommerce](https://www.rtl-theme.com/modern-commerce-application/) A modern RTL WordPress theme for online stores with full WooCommerce support, clean design, and right-to-left layout. - [ProNobat](https://pronobat.ir/plugin) Full-featured WordPress appointment booking and management system designed for the Iranian market. Jalali calendar, Iranian payment gateways (ZarinPal, IDPay), automated SMS notifications (Kavenegar, Melipayamak), Google Calendar sync, and a comprehensive analytics dashboard. ## Education Academic background. - **Shohada-e-Adab High School** (1398–1402) Completed high school at Shohada-e-Adab, majoring in Mathematics & Physics, graduating with a diploma. - **Islamic Azad University, Khorasgan Branch** (1402–Present) Currently pursuing a Bachelor's degree in Computer Science at this university. ## Work experience Roles where real products shipped. - **NeshatRokh Co.** (1403–1403) — Six-month freelance engagement building Flutter mobile applications, involved across the full development cycle from UI to delivery. - **ZuraCoach** (1403–1405) — Flutter frontend developer for an AI-powered fitness coaching platform backed by TU Munich. Initially built the FastAPI backend as well; shifted full focus to Flutter as the team grew. - **HiTaqnia** (1404–Present) — Built two Flutter apps for a residential community management platform — HiBayt for residents and HiBayt Management for staff. Both run on Riverpod with a feature-scoped architecture against a shared backend. ## Events, competitions and awards Competitions, hackathons and industry events attended. - **1st DanaCup Programming & Software Competition** (تیر 1403) Achieved a top ranking in the inaugural DanaCup competition, held in collaboration with Islamic Azad University, Najafabad Branch. The contest brought together top participants from across Isfahan Province to raise the bar in scientific and practical skills in technology. - **نهمین دوره مسابقات برنامه نویسی چالش های فناوری اطلاعات کشور** (شهریور 1403) شرکت در نهمین دوره مسابقات ملی ICT Challenge به میزبانی دانشگاه صنعتی شریف، فرصتی ارزشمند برای رقابت با تیم‌های نخبه کشور بود. این رویداد علاوه بر تقویت مهارت‌های فنی من، باعث آشنایی با برنامه‌نویسی بلاکچین شد که توانستم آن را به‌طور عملی پیاده‌سازی کنم. ## Latest articles Recent writing on mobile, web and back-end development. - [Getting Started with Flutter — Complete Guide 2025](https://www.youdexsof.ir/blog/getting-started-with-flutter) — 2026-06-08 Learn the fundamentals of Flutter, install the SDK, understand project structure, and build your first mobile application from scratch. ## Contact - Email: yousofh255@gmail.com - Phone: +98 913 565 5644 - Telegram: https://t.me/YOUDEXSOF - Location: Isfahan, Iran ## Pages - [/](https://www.youdexsof.ir/) — Home — portfolio, skills, projects, contact - [/about](https://www.youdexsof.ir/about) — About — background, focus areas, how I work - [/contact](https://www.youdexsof.ir/contact) — Contact — email, phone, location, response time - [/privacy](https://www.youdexsof.ir/privacy) — Privacy — what this site collects and why - [/developers](https://www.youdexsof.ir/developers) — Developer resources — public read-only API - [/blog](https://www.youdexsof.ir/blog) — Blog — articles on Flutter, Python and the web - [/cv](https://www.youdexsof.ir/cv) — CV — full résumé --- Machine-readable entry points: - [/llms.txt](https://www.youdexsof.ir/llms.txt) — Site summary and when-to-use guidance for agents - [/llms-full.txt](https://www.youdexsof.ir/llms-full.txt) — Expanded agent brief with full section content - [/agents.md](https://www.youdexsof.ir/agents.md) — Agent instructions: capabilities, limits, how to call - [/openapi.json](https://www.youdexsof.ir/openapi.json) — OpenAPI 3.1 description of the public read-only API - [/sitemap.xml](https://www.youdexsof.ir/sitemap.xml) — XML sitemap of every indexable page - [/robots.txt](https://www.youdexsof.ir/robots.txt) — Crawl policy ## About # درباره یوسف هاشم زاده — About Yousof Hashemzade — Youdexsof یوسف هاشم زاده، توسعه‌دهنده مستقل موبایل و وب، ساکن اصفهان — سازنده اپلیکیشن‌های فلاتر، رابط‌های ریکت و بک‌اندهای پایتون. Yousof Hashemzade is an independent mobile and web developer based in Isfahan, Iran, building production Flutter apps, React front-ends and Python back-ends. ## فارسی ### من کی هستم یوسف هاشم زاده هستم؛ توسعه‌دهنده مستقل موبایل و وب که در اصفهان کار می‌کند. مسیرم از کنجکاوی درباره کامپیوتر شروع شد و بعد از سال‌ها آزمون‌وخطا در زبان‌ها و فریم‌ورک‌های مختلف، به جایی رسیدم که امروز هستم: کسی که نرم‌افزار تولیدی می‌نویسد، تحویل می‌دهد و پشتیبانی می‌کند. تمرکز اصلی‌ام روی اپلیکیشن‌های موبایل با فلاتر است — از طراحی معماری تا انتشار در استور. در کنارش رابط‌های وب با ریکت و نکست و سرویس‌های بک‌اند با پایتون (FastAPI و جنگو) می‌سازم. ### چه کارهایی انجام می‌دهم پروژه‌هایی را می‌پذیرم که در آن‌ها کیفیت کد، معماری تمیز و تحویل واقعی اهمیت دارد. کار من معمولاً یکی از این شکل‌هاست: - ساخت اپلیکیشن موبایل کراس‌پلتفرم با فلاتر و دارت (معماری BLoC یا GetX) - توسعه رابط کاربری وب با ریکت، نکست‌جی‌اس و تیلویند - پیاده‌سازی API و بک‌اند با پایتون، FastAPI، جنگو و پایگاه‌داده‌های رابطه‌ای - ساخت و فروش قالب‌ها و افزونه‌های وردپرس با پشتیبانی کامل راست‌به‌چپ - بازطراحی و بهبود کارایی پروژه‌های موجود ### چطور کار می‌کنم قبل از نوشتن کد، مسئله را روشن می‌کنم؛ محدوده کار، خروجی و زمان‌بندی را شفاف می‌نویسم و در طول پروژه مرتب گزارش می‌دهم. کد را طوری می‌نویسم که شش ماه بعد هم قابل نگهداری باشد: ماژول‌های کوچک، نام‌های واضح و مدیریت خطای صریح. برای هر پروژه مخزن گیت، مستندات و مسیر انتشار مشخص تحویل می‌دهم تا تیم بعدی بتواند بدون من ادامه دهد. ### ارتباط برای شروع همکاری کافی است به yousofh255@gmail.com ایمیل بزنید یا از صفحه تماس استفاده کنید. معمولاً ظرف یک روز کاری پاسخ می‌دهم. ## English ### Who I am I am Yousof Hashemzade — an independent mobile and web developer working from Isfahan, Iran. I started out simply curious about computers, spent years trying different languages and stacks, and ended up where I am now: writing, shipping and maintaining production software. My main focus is cross-platform mobile development with Flutter, from architecture through store release. Alongside that I build web front-ends with React and Next.js and back-end services in Python. ### What I do I take on work where code quality, clean architecture and actual delivery matter. In practice that looks like: - Cross-platform mobile apps in Flutter and Dart (BLoC or GetX architecture) - Web interfaces with React, Next.js and Tailwind CSS - APIs and back-end services in Python with FastAPI or Django - Premium WordPress themes and plugins with full RTL support - Refactoring and performance work on existing codebases ### How I work I clarify the problem before writing code: scope, deliverables and timeline in writing, with regular progress updates. I write code meant to survive six months of other people maintaining it — small modules, clear names, explicit error handling. Every project ships with a Git repository, documentation and a defined release path, so the next team can carry it forward without me. ### Getting in touch Email yousofh255@gmail.com or use the contact page to start a conversation. I usually reply within one business day. --- Machine-readable entry points: - [/llms.txt](https://www.youdexsof.ir/llms.txt) — Site summary and when-to-use guidance for agents - [/llms-full.txt](https://www.youdexsof.ir/llms-full.txt) — Expanded agent brief with full section content - [/agents.md](https://www.youdexsof.ir/agents.md) — Agent instructions: capabilities, limits, how to call - [/openapi.json](https://www.youdexsof.ir/openapi.json) — OpenAPI 3.1 description of the public read-only API - [/sitemap.xml](https://www.youdexsof.ir/sitemap.xml) — XML sitemap of every indexable page - [/robots.txt](https://www.youdexsof.ir/robots.txt) — Crawl policy ## Contact # تماس با یوسف هاشم زاده — Contact Yousof Hashemzade — Youdexsof راه‌های تماس با یوسف هاشم زاده: ایمیل، تلفن و تلگرام. مستقر در اصفهان، ایران. Reach Yousof Hashemzade by email (yousofh255@gmail.com), phone (+98 913 565 5644) or Telegram. Based in Isfahan, Iran. Replies usually within one business day. ## فارسی ### راه‌های تماس برای پروژه، همکاری یا مشاوره فنی از هر کدام از راه‌های زیر می‌توانید تماس بگیرید. ایمیل مطمئن‌ترین راه است و همه پیام‌ها را خودم می‌خوانم. - ایمیل: yousofh255@gmail.com - تلفن و واتساپ: +98 913 565 5644 - تلگرام: https://t.me/YOUDEXSOF - موقعیت: اصفهان، ایران ### زمان پاسخ‌گویی ساعات کاری معمول من شنبه تا پنجشنبه، ۹ صبح تا ۶ بعدازظهر به وقت ایران (UTC+3:30) است. به ایمیل‌ها معمولاً ظرف یک روز کاری پاسخ می‌دهم؛ اگر پیام در آخر هفته ارسال شود، پاسخ در اولین روز کاری بعد ارسال می‌شود. ### برای اینکه سریع‌تر جواب بگیرید در پیام اول این موارد را بنویسید تا بتوانم دقیق‌تر و سریع‌تر جواب بدهم: - چه چیزی می‌خواهید ساخته شود و برای چه کاربری - پلتفرم هدف: موبایل، وب یا هر دو - بازه زمانی و بودجه تقریبی - لینک مستندات، طرح فیگما یا مخزن موجود در صورت وجود ## English ### How to reach me For project work, collaboration or technical consulting, use any of the channels below. Email is the most reliable one, and I read every message myself. - Email: yousofh255@gmail.com - Phone and WhatsApp: +98 913 565 5644 - Telegram: https://t.me/YOUDEXSOF - Location: Isfahan, Iran ### Response time My usual working hours are Saturday to Thursday, 9:00 to 18:00 Iran time (UTC+03:30). I answer email within one business day; messages sent over the weekend get a reply on the next working day. ### To get a faster answer Include these details in your first message so I can reply with something concrete: - What you want built, and who will use it - Target platform: mobile, web, or both - Rough timeline and budget range - Links to any existing docs, Figma files or repositories --- Machine-readable entry points: - [/llms.txt](https://www.youdexsof.ir/llms.txt) — Site summary and when-to-use guidance for agents - [/llms-full.txt](https://www.youdexsof.ir/llms-full.txt) — Expanded agent brief with full section content - [/agents.md](https://www.youdexsof.ir/agents.md) — Agent instructions: capabilities, limits, how to call - [/openapi.json](https://www.youdexsof.ir/openapi.json) — OpenAPI 3.1 description of the public read-only API - [/sitemap.xml](https://www.youdexsof.ir/sitemap.xml) — XML sitemap of every indexable page - [/robots.txt](https://www.youdexsof.ir/robots.txt) — Crawl policy ## Privacy # سیاست حریم خصوصی — Privacy Policy — Youdexsof این صفحه توضیح می‌دهد این سایت چه داده‌ای جمع می‌کند، چرا، و چطور می‌توانید حذف آن را درخواست کنید. What https://www.youdexsof.ir collects, why it collects it, which third parties are involved, and how to request deletion. ## فارسی ### چه داده‌ای جمع‌آوری می‌شود این سایت یک نمونه‌کار شخصی است و حساب کاربری عمومی ندارد. داده‌ای که ذخیره می‌شود محدود است به: - آمار بازدید صفحه: مسیر صفحه، زبان انتخابی و زمان بازدید — بدون نام، بدون ایمیل و بدون شناسه تبلیغاتی - محتوای فرم تماس: نام، ایمیل، موضوع و متن پیامی که خودتان ارسال می‌کنید - نظرات وبلاگ: نام و متنی که هنگام ثبت نظر وارد می‌کنید ### چرا جمع‌آوری می‌شود آمار بازدید فقط برای فهمیدن اینکه کدام بخش‌های سایت مفید هستند استفاده می‌شود. اطلاعات فرم تماس فقط برای پاسخ دادن به خود شما به کار می‌رود. هیچ داده‌ای فروخته نمی‌شود، به شبکه تبلیغاتی داده نمی‌شود و برای پروفایل‌سازی رفتاری استفاده نمی‌شود. ### سرویس‌های شخص ثالث این سایت روی زیرساخت ابری میزبانی می‌شود و برای بخش‌هایی از عملکردش به سرویس‌های بیرونی متکی است: میزبانی و شبکه توزیع محتوا، فایربیس برای بخش‌های بی‌درنگ، و API عمومی گیت‌هاب برای نمایش پروژه‌های متن‌باز. این سرویس‌ها ممکن است طبق سیاست خودشان لاگ فنی مانند نشانی IP نگه دارند. ### کوکی‌ها و ذخیره‌سازی محلی کوکی تبلیغاتی و ردیاب شخص ثالث روی این سایت وجود ندارد. حافظه محلی مرورگر فقط برای نگه‌داشتن تنظیمات خودتان (زبان و پوسته) استفاده می‌شود و کوکی نشست تنها در بخش مدیریت سایت و برای ورود مدیر ساخته می‌شود. ### نگه‌داری و حذف داده پیام‌های فرم تماس تا زمانی که برای پیگیری همکاری لازم باشند نگه داشته می‌شوند. برای درخواست حذف پیام، نظر یا هر داده مرتبط با خودتان کافی است به yousofh255@gmail.com ایمیل بزنید؛ درخواست حذف را ظرف ۳۰ روز انجام می‌دهم. ## English ### What this site collects This is a personal portfolio site with no public user accounts. The only data stored is: - Page view statistics: the page path, the selected language and a timestamp — no name, no email, no advertising identifier - Contact form submissions: the name, email, subject and message you choose to send - Blog comments: the name and text you enter when posting a comment ### Why it is collected Page view statistics are used only to understand which parts of the site are useful. Contact form details are used only to reply to you. No data is sold, shared with advertising networks, or used for behavioural profiling. ### Third-party services The site runs on cloud hosting and relies on a few external services: hosting and CDN delivery, Firebase for real-time features, and the public GitHub API to display open source projects. Those providers may keep technical logs such as IP addresses under their own policies. ### Cookies and local storage There are no advertising cookies and no third-party trackers. Browser local storage is used only to remember your own preferences (language and theme), and a session cookie is created solely in the admin area for the site owner's login. ### Retention and deletion Contact messages are kept for as long as they are needed to follow up on an enquiry. To have a message, a comment or any data relating to you deleted, email yousofh255@gmail.com; deletion requests are handled within 30 days. --- Machine-readable entry points: - [/llms.txt](https://www.youdexsof.ir/llms.txt) — Site summary and when-to-use guidance for agents - [/llms-full.txt](https://www.youdexsof.ir/llms-full.txt) — Expanded agent brief with full section content - [/agents.md](https://www.youdexsof.ir/agents.md) — Agent instructions: capabilities, limits, how to call - [/openapi.json](https://www.youdexsof.ir/openapi.json) — OpenAPI 3.1 description of the public read-only API - [/sitemap.xml](https://www.youdexsof.ir/sitemap.xml) — XML sitemap of every indexable page - [/robots.txt](https://www.youdexsof.ir/robots.txt) — Crawl policy ## Developer resources # Youdexsof developer resources Public, read-only HTTP API and machine-readable documents published by https://www.youdexsof.ir, the portfolio of Yousof Hashemzade (یوسف هاشم زاده). ## Endpoints All endpoints are relative to `https://www.youdexsof.ir` and respond with JSON. - `GET /api/blog` — List published blog posts. Paginated list of published articles with title, description, cover image, tags, category, read time and view count in the requested language. Parameters: lang, page, limit, category, tag, search, sort, featured. - `GET /api/blog/{slug}` — Get one blog post by slug. Full article body plus metadata and comments for a single published post, in all three languages at once. The slug is the same one used in the /blog/{slug} page URL. Note that a GET increments the post's view counter. Parameters: slug. - `GET /api/blog/categories` — List blog categories. Every blog category with its slug, localized names, colour and published post count. - `GET /api/worksamples` — List portfolio projects. Shipped mobile and web projects with localized titles and descriptions, technologies used, project timeline, client and links. - `GET /api/products` — List products and themes. Premium WordPress themes and plugins for sale, with localized titles, descriptions, price, category and purchase URL. - `GET /api/works` — List work experience. Employment and freelance history: organisation, localized role description, technologies, years and link. - `GET /api/education` — List education history. Academic background: institution, localized description and years attended. - `GET /api/events` — List events, competitions and awards. Hackathons, competitions and industry events, with localized descriptions, dates and certificate attachments. - `GET /api/github/pinned` — List pinned GitHub repositories. Open source repositories pinned on GitHub, with description, primary language, star and fork counts, homepage and repository URL. Cached for one hour. - `GET /api/site-settings` — Get public site settings. Theme colours, profile picture path and the technology list shown in the skills section. ## Access policy - Authentication: None. Every endpoint listed here is public and read-only; no API key, token or sign-up is required. - Writes: Write operations exist only behind the authenticated admin session and are not part of the public API. - Rate limits: No hard quota is enforced, but the site is a single personal deployment: keep requests under roughly 60 per minute and cache responses where you can. - CORS: The JSON endpoints are same-origin: call them server-side. The machine-readable documents (/openapi.json and the markdown representations) do send `Access-Control-Allow-Origin: *`, so a browser-side agent can read those directly. - Formats: Every endpoint returns JSON. Every HTML page also has a markdown representation: send `Accept: text/markdown` to the page URL (for example `https://www.youdexsof.ir/about`) and you get `text/markdown; charset=utf-8` back. ## Documents - [Youdexsof OpenAPI specification](https://www.youdexsof.ir/openapi.json) — OpenAPI 3.1 document describing every public read-only endpoint, its query parameters and responses. - [Youdexsof developer index](https://www.youdexsof.ir/developers) — Human-readable index of the public API, rate limits, authentication policy and support contact. - [Youdexsof llms.txt](https://www.youdexsof.ir/llms.txt) — Condensed site summary with when-to-use guidance for AI agents, per the llms.txt convention. - [Youdexsof agent instructions](https://www.youdexsof.ir/agents.md) — Agent-facing instruction file: best-fit tasks, how to call the API and what this site cannot do. - [Youdexsof sitemap](https://www.youdexsof.ir/sitemap.xml) — XML sitemap listing every indexable page. ## Support Questions, bug reports or a request for an endpoint that does not exist yet: yousofh255@gmail.com. --- Machine-readable entry points: - [/llms.txt](https://www.youdexsof.ir/llms.txt) — Site summary and when-to-use guidance for agents - [/llms-full.txt](https://www.youdexsof.ir/llms-full.txt) — Expanded agent brief with full section content - [/agents.md](https://www.youdexsof.ir/agents.md) — Agent instructions: capabilities, limits, how to call - [/openapi.json](https://www.youdexsof.ir/openapi.json) — OpenAPI 3.1 description of the public read-only API - [/sitemap.xml](https://www.youdexsof.ir/sitemap.xml) — XML sitemap of every indexable page - [/robots.txt](https://www.youdexsof.ir/robots.txt) — Crawl policy