Headless Bitrix and modernization

How to move an e-commerce storefront to Next.js while the catalog, cart and 1C exchange stay on Bitrix. Notes on rewrite versus staged migration, redirects, auth, stock sync and deploying two independent parts.

31 articles

TypeScript API contract for Bitrix REST: generate types, stop guessing shapes

We spent two weeks asking "what does this method actually return?" when we moved a 28,000-product catalog to a headless architecture. Open the Bitrix REST docs — they're three months behind the actual version. Open the debugger, call the method, look at the real response, infer the shape, write an interface. Next day, a teammate does the same with another method. Slightly different assumptions.

Redirects Died on Deploy Day. Bitrix Didn't Warn Us.

We went headless in February. In April, our SEO consultant sent a spreadsheet: 340 broken links. Three years of redirect rules, gone the day we deployed Next.js. No errors in the logs. Next.js had no idea these rules were supposed to exist in the first place.

Have you actually hit the Bitrix ceiling, or are you just tired of it?

A client messaged me last year. 30,000 SKU store on Bitrix, "everything's slow," ready to migrate to headless. I asked three questions: what percentage of requests take more than two seconds? Is composite mode enabled? When did you last check slow_query_log?

Local Dev for Headless Bitrix: Three Setups, One That Actually Works

The first question I get about headless Bitrix is about architecture. The second is about deployment. The third nobody asks out loud — but everyone runs into it in the first week: how do you actually develop when you don't have Bitrix on your machine?

PHP Earns the Money. Next.js Shows It.

In a headless Bitrix + Next.js architecture, the split is straightforward in theory: Bitrix owns the data and business logic, Next.js owns the rendering. In practice, most teams get this wrong within the first year.

Five questions I ask before proposing headless to a client

In the past two years I've turned down headless three times. Not because I don't believe in it — I've built it, I know what it delivers. But each time, five questions made the answer obvious before we touched a wireframe. The fourth client got the full Next.js + Bitrix split. It's one of the best ecommerce projects I've worked on.

When headless is the wrong answer

I build headless sites on Next.js + Bitrix. I've migrated a catalog of 28,000 SKUs. I turned down a $40K contract because rewriting a working monolith made no sense. And when a client walks in asking for headless, my first question is always: "Why headless, exactly?"

Modernizing a 1C-Bitrix Monolith Without a Risky Rewrite

How do you modernize a 28,000-product 1C-Bitrix store without a risky rewrite? In this case study, I break down a Headless migration using Next.js + Elasticsearch that improved performance, preserved SEO, and kept the business running.