# 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