Website build guide

How we built the Uncle Osaka concept site

Follow the build from two painted bakers to a stamped cheesecake, then try the scroll technique on a page of your own.

Ahmad Rasas · This is an independent bilingual concept. The order flow is a demonstration.

Download the Arabic PDF View the project case study
Painted bakers introducing the storefront
Painted bakers introducing the storefront

Try the reveal

Move the slider forward and back. The same progress value always shows the same frame. Open the example to test it with page scrolling and edit the source.

Map the page before adding motion

We mapped the route from the first painting to a real product and then to a browsable menu.

Painted bakers introducing the storefront
Painted bakers introducing the storefront
Page structure
Open with the bakers and the cheesecake reveal. Give matcha, coffee and boba separate scenes, and keep the menu and product cards easy to reach.
Separate scene and data
src/chapters.js defines the chapters and their order. src/data.js holds the catalog. src/home.js renders the page. This lets you revise presentation and product data separately.
Try it
Sketch four boxes for your opening, first product, browsing and final action. State what the visitor should understand or be able to do in each.

Before adding animation, open the menu from a direct link with your keyboard.

Split the painting and the product layer

A background, separately animated arms and hands, and a cheesecake image make up the opening.

The hands meet before the reveal
The hands meet before the reveal
An irregular opening reveals the cheesecake image
An irregular opening reveals the cheesecake image
Prepare the layers
Build the backdrop and product layer at the same aspect ratio. Separate the moving art and prepare a usable static poster for each scene.
Time the reveal
The bakers reach, the glow follows the contact point, and an irregular opening expands over the product artwork.
Find the implementation
src/scene.js assembles the Three.js scene. The hero-hand-rig.js, hero-relief.js and hero-reveal.js modules handle the arm and hand motion, the relief, and the reveal layer.

Review the start, fingertip contact and completed reveal as three still frames. The focal point should be clear in each.

Drive the scene with a value between 0 and 1

The scene reads the scroll position. Returning to a position returns to the same state.

Measure the usable distance
Subtract the sticky stage height from the chapter height. Divide the distance travelled by that result and clamp the value to zero through one.
Choose a reveal window
The exercise starts the reveal at 35% and completes it at 85%. Change those values to adjust when the product appears.
Use native page scrolling
Schedule scroll updates in one animation frame. In the production concept, scroll-controller.js also coordinates chapter navigation.
const clamp = n => Math.max(0, Math.min(1, n));
const distance = chapter.offsetHeight - stage.offsetHeight;
const travelled = -chapter.getBoundingClientRect().top;
const progress = clamp(travelled / Math.max(1, distance));
const reveal = clamp((progress - .35) / .5);
stage.style.setProperty('--radius', reveal * 115 + '%');

Scroll back to the start. The scene should reverse and pause at any point while you are still.

Lead from a scene into the menu

A scene sets the context for the category. Cards give the visitor a way to find and read about individual products.

The stamped cheesecake after the reveal
The stamped cheesecake after the reveal
Map each chapter to a category
Give the chapter links meaningful names and connect the scene to the relevant product group. Keep those links usable when motion is unavailable.
Put the details close
Place the card list after its scene and give each card a short label, an image and brief copy. Preserve the heading hierarchy.
Reuse the data
The concept links chapters and catalog data in chapters.js and demonstrates ordering in commerce.js. Test the flow with sample entries.

Try the menu in both languages. Switch languages and check the context is still easy to find.

Tune framing and loading for phones

The wide layout shows both bakers. The phone crop follows the ivory baker and keeps the point of contact on screen.

Separate vertical framing for the Arabic mobile layout
Separate vertical framing for the Arabic mobile layout
Choose the focal point
Check the beginning, fingertip contact and finished reveal at 320 and 390 pixels, including the right-to-left layout.
Keep a poster ready
Show a static image while a complex scene loads. Warm the neighbouring chapters and test fast scroll in both directions.
Respect reduced motion
Use prefers-reduced-motion to show the product, headings and menu links immediately. Provide the same access when WebGL is unavailable.

Test a slow connection, then scroll quickly in both directions. Watch for flashing, cut-off words and trapped scroll.

Build and test your own version

Start with the downloadable example. Get one chapter working before you add a catalog or more scenes.

Swap in your materials
Replace the two visual layers with artwork you can use. Adjust the reveal origin at different sizes and include a product description and a link onwards.
Check motion and access
Test fast and reverse scroll, 200% zoom, keyboard navigation and reduced motion. Disable JavaScript and confirm the content and links are available.
Review before sharing
Check phones and desktop in Arabic and English. Review contrast, text and first paint. Label a demonstration order flow near its action.

A visitor should be able to identify the product, read its details and choose their next step with motion turned off.