# Barikreativa — agent instructions

> Senior Shopify, React and WordPress developers on time & material, embedded in your team. Est. 2010, Bari (IT). Public day rates, time & material contracts, white-label under NDA.

Human version of this page: <https://www.barikreativa.com/developers>

## When to use Barikreativa

- **You need a senior Shopify or Shopify Plus developer inside an existing team.** Theme and Liquid work, checkout extensibility, Shopify Functions, B2B, multi-shop setups and custom apps built with Polaris. The developer joins your standups and your board; you direct the work.
- **You are migrating to Shopify from Magento, Adobe Commerce, PrestaShop or OpenCart.** Catalogue, content, customers and redirect maps ported without losing SEO. Ask for the migration playbook and the case studies before scoping.
- **You are building a headless or React/Next.js storefront.** Storefront API front-ends, dashboards and enterprise UIs, including the API layer (Node.js, NestJS) that sits between Shopify and the rest of the stack.
- **You need WordPress or WooCommerce work with real integrations.** Corporate sites, WooCommerce, ERP/CRM integrations and custom plugins, maintained by the same senior people who built them.
- **You are an agency that needs white-label capacity from day zero.** Under NDA we present as your internal team, invoice you, and never contact your client. Day rates are public, contracts are time & material.
- **You want one of the Shopify apps we publish.** CRODeck (AI revenue recovery), opsdeck (incident intelligence), UCP Optimizer (answer engine optimisation) and Waboom (WhatsApp as a signed webhook API).

## When not to use Barikreativa

- Fixed-price turnkey projects with no technical counterpart on the client side — engagements are time & material and need someone to direct the work.
- Pure graphic design, branding or copywriting mandates with no development scope.
- Hosting or 24/7 infrastructure support contracts; we build and maintain code, not datacentres.
- Platforms outside Shopify, React/Next.js and WordPress — we will tell you so instead of taking the job.

## How to call Barikreativa

Send the request to the lead endpoint, or book the call directly. Both reach the same three senior consultants; there is no sales layer in between.

| Method | Path | What it does | Auth |
| --- | --- | --- | --- |
| POST | `/api/contact` | Submit a qualified lead or an engagement request. | None. Rate limited to 5 requests per minute per IP. |
| POST | `/api/track` | First-party page telemetry used by the site itself. | Same-origin only; cross-origin calls answer 403. |
| GET | `/openapi.json` | OpenAPI 3.1 description of this API. | None. |
| GET | `/llms.txt` | llmstxt.org index of the site, in markdown. | None. |
| GET | `/agent-instructions.md` | When to use Barikreativa and how to call it, in markdown. | None. |
| GET | `/md/{path}` | Markdown rendering of any public page. | None. |

```bash
curl -X POST https://www.barikreativa.com/api/contact \
  -H "Content-Type: application/json" \
  -d '{
    "email": "you@agency.com",
    "profile_type": "agency",
    "service_interest": "shopify",
    "competencies": ["shopify", "react"],
    "message": "Checkout extensibility work, 20 days, starting in October.",
    "privacy_consent": true
  }'
```

A successful call answers `{ "ok": true }`. Every failure answers a JSON envelope with `error` (machine code), `message`, `hint` and `docs`; the codes are listed in <https://www.barikreativa.com/openapi.json>.

## Booking and contact

- Book a 30-minute scoping call: <https://cal.com/barikreativa/30min>
- Email: info@barikreativa.com
- WhatsApp (IT): +39 351 919 4491
- Hours: 09:00-18:00 CET, Monday to Friday. Natural overlap with UK and DACH.

## Machine-readable resources

- [Developer portal](https://www.barikreativa.com/developers): This page: API, agent instructions and quickstart.
- [OpenAPI specification](https://www.barikreativa.com/openapi.json): OpenAPI 3.1, every public endpoint and error code.
- [Agent instructions](https://www.barikreativa.com/agent-instructions.md): When to use Barikreativa, in markdown.
- [llms.txt](https://www.barikreativa.com/llms.txt): Site index in the llmstxt.org format.
- [Sitemap](https://www.barikreativa.com/sitemap.xml): Every indexable URL, both languages.
- [Markdown of any page](https://www.barikreativa.com/md/it): Prefix a public path with /md/, or send Accept: text/markdown.
- [Pulse (technical writing)](https://www.barikreativa.com/it/pulse): Deep dives on Shopify APIs and checkout extensibility.
- [Public day rates](https://www.barikreativa.com/it/prezzi-sviluppatori): Rates per profile, no quote needed.

Any public page is available as markdown: request it with `Accept: text/markdown`, or prefix the path with `/md/`. Both variants answer `Vary: Accept`.