Code Rain Theme Documentation

Version 1.0.0 · Online Store 2.0 theme for Shopify · by byte-force.de

Menu names in this guide follow the Shopify admin. The admin and the theme editor appear in the language of your Shopify account; section and setting names in the editor follow that language too (English and German are included).

1. Overview

Code Rain is a dark techwear theme for fashion and streetwear stores. A canvas animation of falling characters (the “character stream”) runs behind all pages. The home page opens with a “stream stage”: product columns that run like the code rain, with a menu column on the left.

2. Installation

  1. Open your Shopify admin and go to Online Store → Themes.
  2. Add the theme from the Theme Store.
  3. Click Customize (button “Edit theme” in some admin versions) to open the theme editor. Click Publish when you are ready to go live.

The theme ships with one preset, “Code Rain”, with the home page, collection, product, cart, blog, FAQ and contact templates already filled with example content.

3. First-time setup

Do these steps once. They make the demo content of the theme show your own content.

3.1 Collections

Create your collections under Products → Collections and add products. You choose which collection each section shows in the theme editor. The demo content refers to the collection handles bestseller, new, hoodies, t-shirts, pants, accessories and drop; if yours have other handles, select your collections in the editor.

3.2 Menus

Go to Content → Menus. Create or edit:

MenuUsed for
Main menuMenu column of the home page stage and the menu panel (hamburger button); both default to the menu with the handle main-menu
Footer menuLink column in the footer (for example collections)
Footer InfoSecond footer link column (About, FAQ, Contact, Shipping)
Footer Rechtliches (legal)Imprint, privacy policy, terms, withdrawal. Select it under Theme settings → Legal.
Popular searchesChips in the search overlay and on the search page
Customer account main menuMenu of the account button in the header (default menu of Shopify)

The demo content uses the menu handles main-menu, footer, footer-info, footer-rechtliches and beliebte-suchen. Menus with other handles work too: select them in the section settings (stage Menu column, Menu panel, Footer link columns, Predictive search, Search page, Theme settings → Legal).

3.3 Pages

Go to Online Store → Pages and create your pages (About, FAQ, Contact, Shipping and so on). Choose the matching Theme template in the page editor:

TemplateUse for
page (default)Standard text page with a call-to-action row
faqFAQ page with grouped questions and answers
contactContact page with form and info card (uses the Shopify contact form)

3.4 Blog

Add posts under Content → Blog posts. The blog template is called “Logbook” in the editor.

3.5 Optional product details (metafields)

The product page can show accordion items that read from product metafields. The example template uses the keys custom.material_pflege (materials and care) and custom.masse (measurements). Create matching definitions under Settings → Custom data → Products (namespace custom, a text or rich-text type), then fill them in each product. Where a metafield is empty, the accordion shows the text you entered in the editor instead. You can use any key: type the key without custom. into the block setting “Metafield key”.

3.6 Store settings that affect the theme

4. Using the theme editor

Open Online Store → Themes → Customize. In the editor:

5. Theme settings

Open them with the gear icon in the editor. Groups:

Colors

Sixteen colours in three groups: base and text (background, surface, raised surface, text, muted text, bright text), stream and borders (stream bright/mid/dim, glow, border, border dim) and status (success, warning, error, sale).

Character stream

SettingOptions
Performance levelFull, Reduced, Off (static). “Reduced” halves columns and density (30 fps).
Mobile defaults to “Reduced”On/off
SpeedSlow, Normal, Fast
Density20–100 %
Glow strength0–40 px
Stream opacity (global)20–100 %
Show wet floorReflective floor at the bottom
Pause buttonShows a pause button bottom left
Colour switcherLets visitors change the accent colour (next to the pause button)
Motion blur on focusOn/off
“Flow-in” page transitionOn/off
Pixel cursor with code trailOn/off (only for devices with a mouse; off with “reduce motion”)

If a visitor has “reduce motion” enabled in the operating system, the stream is always static.

Typography

Font (any font of the Shopify font library; the default is Roboto Mono, monospace fonts suit the theme best), heading letter spacing (0–30 %), brand letter spacing (10–50 %), uppercase headings.

Layout

Content width (1000–1800 px, default 1280), section spacing (Compact, Normal, Airy), text direction (left to right or right to left).

Buttons

Height (44, 48 or 52 px; on mobile always 52 px) and glow on hover.

Product tiles

Quick add in the focus zoom, badges (New, Sale, Sold out), glow around products (“In the image” or “By theme” with animated cut-out images; size 4–24 px), tag for the “New” badge (products with this tag get the badge), show vendor on the product page, hint “Tap again to open” on mobile.

Cart

Cart type (Drawer or Page), open drawer after adding, free-shipping progress and threshold (0–500, in store currency), order note, discount code field, express checkout buttons, payment icons.

Legal

Price note “incl. VAT, plus shipping”, links to the shipping page, privacy policy and terms, the legal menu (imprint, privacy, terms, withdrawal), and the cookie notice (on/off, title, text).

Support and shipping

Support email: shown on the contact page. The contact page section can override it with its own “Support email” setting.

Social media

Instagram, TikTok, YouTube, X and Discord. Enter your profile links. The links appear in the footer (when “Show social links” is enabled) and on the contact page.

Favicon

Upload an image.

Custom CSS

The “Custom CSS” group is added by Shopify to every theme. Use it for small style adjustments.

6. Home page

The home page template contains, from top to bottom: stream stage, hero, “New in” stream row, banner, benefits and newsletter. Change, remove or reorder them like any other section.

Stream stage

Settings: height, products per column, run speed, wet floor at the stage bottom. The stage is built from blocks:

BlockPurpose
Menu column (max. 1)The navigation on the left and the DROP box. Settings: menu, Drop image, countdown on/off, end date, time.
Collection columnA column of products from one collection. Settings: collection, column head (empty = collection title), products per column, column flow, “Highlight as active column”.
Search column (max. 1)Search field in the stage. Setting: heading.
Legal column (max. 1)Links from the legal menu. Setting: legal menu.
Decor columnA decorative column that only shows the character stream.

The product columns can be stepped through with the arrows below the column heads.

DROP box and countdown

In the editor open Home page → Stream stage → Menu column:

Hero and banner

Both sections take a desktop image, an optional mobile image, an overlay strength, alignment, eyebrow, heading, text and links. Recommended sizes: hero 2880 × 1600 px (mobile 1080 × 1350 px); banner 2880 × 960 px (mobile 1080 × 1080 px). Hero height: Medium (640 px), Large (800 px) or Viewport height.

7. Collection pages

The collection template has a collection header (breadcrumb, description, image), the product wall with filters and a banner. Setting overview:

The filters shown are the storefront filters of your collection. You define which filters exist with Shopify’s free Search & Discovery app; the theme only displays them.

The collection list page (“Collection list”) shows your collections as columns with arrows. Settings: heading, text ([count] is replaced by the number), selection (“Only the blocks below” or “All collections”), preview tiles per column, show count. Add up to 12 Collection blocks to pick specific collections; with no blocks, all collections are shown.

8. Product page

Settings of “Product (main)”: breadcrumb, sticky buy bar on mobile, loop videos. Blocks (drag to reorder; most can be used once):

BlockSettings
TitleShow vendor
PriceInstallments banner (Shop Pay)
Variant pickerStyle (buttons or dropdown), switch to dropdown from this many values, size guide page
Quantity–
Stock notice and SKU“Only x left” threshold, show SKU
Pickup availability–
Buy buttonsShow express checkout, shipping note
Share–
Description (accordion)Heading, open by default
Accordion itemHeading, text, metafield key, page as content, open by default
TextFree text
App blockAny app block

Below the product: Recommendations (used twice: “related” and “complementary”; settings heading, type, count, quick add), Recently viewed and an app block area. In the variant picker, colour options are shown as swatches. Common colour names in English and German (black, white, grey, silver, purple, pink, blue, green, red, beige, brown and so on) are recognised; other values are used as a CSS colour name or code.

9. Cart

10. Pages, blog, search

11. Customer accounts

Login, register, account overview, orders, addresses, account activation and password reset are included as templates (classic customer accounts). Settings: “Order without account” hint on the login page, newsletter checkbox on the register page, number of orders in the account overview. The customer account menu in the header uses the menu “customer-account-main-menu” unless you choose another one in the rail header.

12. Section reference

Sections that you can add to pages (Add section):

SectionWhat it does
Stream stageHome stage with product columns (home page)
HeroLarge image with text and up to two buttons
BannerWide image with a glass text box
Image + textImage next to text, image left or right
Stream row (collection)A row of products from a collection with arrows, optional “View all” link
BenefitsUp to 4 benefits with icon, heading and text
Rich textBlocks: eyebrow, heading (size), text, up to 2 buttons (style); width, alignment, optional panel
NewsletterEmail signup with optional consent checkbox
CTA rowHeading, text and a button
FAQGrouped questions and answers
Read more (articles)1–4 articles of a blog
Recommendations / Recently viewedProduct suggestions
Custom LiquidYour own Liquid, HTML or CSS
App block areaPlace for app blocks

Most content sections have a Color scheme setting: Rain dark, Rain bright-active (stronger glow), Reduced (stream 70 %) and Calm (stream 35 %).

Announcement bar

In the header group. Up to 5 messages (text and link). Settings: show, closable, rotate messages (desktop) every n seconds, ticker on mobile/tablet.

Rail header

Settings: logo image and width, brand as text (used when no logo is set), icon tiles on the home page too (desktop), “Document” tile (legal) and “Shield” tile (privacy), customer account menu.

Menu panel

The hamburger menu. Settings: menu, number of top-level items (the rest goes under “More”), legal menu, country/language selector.

Footer

Up to 6 blocks: Newsletter (max. 1), Brand and text (max. 1) and any number of Link column blocks (heading and menu). Settings: social links, Follow on Shop (shows only when Shop Pay and Follow on Shop are active in your store), country/language selector, payment icons, copyright name.

14. Languages

The storefront and editor texts are translated into English (default) and German. Add more store languages in your Shopify admin settings. Text you type into the editor (headings, buttons) can be translated with Shopify’s translation tools. Right-to-left reading is available under Theme settings → Layout → Text direction.

15. Accessibility and motion

16. Troubleshooting

ProblemSolution
Home page shows empty columnsSelect a collection in each Collection column block of the stream stage.
No “New” badge on productsCheck Theme settings → Product tiles → “Tag for ‘New’ badge” and tag your products accordingly.
Filters are missing on collection pagesDefine filters with Shopify’s Search & Discovery app; enable “Show filter streams” in the Stream wall section.
Countdown does not showEnter an end date (YYYY-MM-DD) and enable “Show countdown below drop”. It hides itself after the end time.
Drop box shows a product photo instead of my imageUpload a PNG in Stream stage → Menu column → Drop image.
Animation is slow on mobileSet Performance level to “Reduced” or lower the density.
Accordion on the product page shows demo textFill the metafield, or edit the block text (section 3.5).
Cart drawer does not openCheck Theme settings → Cart → Cart type and “Open drawer after adding”.

17. Support

Questions about the theme: use our support form (https://byte-force.de/themes/support). Enter the URL of your store, choose Code Rain and add screenshots if possible. You receive a confirmation by email; we reply within two business days. Alternatively write to support@themes.byte-force.de.

Documentation: https://byte-force.de/themes/code-rain/doku/ · Theme page: byte-force.de/themes/code-rain

18. Changelog

VersionNotes
1.0.0First release.

© byte-force.de · Code Rain is an independent theme and is not affiliated with Shopify Inc.