Tyche documentation
How to install Tyche, import a starter site, change the look, and what to do when something does not behave. If your question is not here, the support forum is the place to ask.
What you need
Tyche is a block theme, so everything in it is edited in the Site Editor rather than the Customizer.
| WordPress | 7.0 or newer |
|---|---|
| PHP | 7.4 or newer |
| WooCommerce | Required for the shop. Without it the theme still works as a blog and a set of pages. |
| Tyche Companion | Optional, and needed for starter sites, the free-delivery bar, the sticky add-to-cart bar and the product badges. |
The features in the plugin are in a plugin on purpose: a theme on
WordPress.org is not allowed to add shop functionality, and anything it did add would disappear the day you
changed themes. Yours stays.
Installing
The WordPress.org directory still lists Tyche 1.x while 2.0 is in review, so
install 2.0 from the zip for now. Searching for Tyche in your dashboard gets you the older classic theme.
- Download the theme zip, then go to
Appearance › Themes › Add New › Upload Theme, choose the file, install it
and activate it. - Install WooCommerce from Plugins › Add New and run its setup, or skip
the setup if you are going to import a starter. - Install Tyche Companion the same way, from
its own zip, under
Plugins › Add New › Upload Plugin.
Nothing about your existing content is changed by activating the theme. If you already sell something, read
importing only the look before you import anything.
Starter sites
A starter site is a complete shop: products with real options, categories, pages, journal posts and
photographs. Importing one takes about thirty seconds.
- Go to Appearance › Starter sites.
- Pick one and choose Import. The screen shows each step as it runs.
- When it finishes, visit your site.
The import brings the starter’s look with it, so the colours, fonts, header and footer change too. Every
piece of it is ordinary WordPress content afterwards: edit the pages in the Site Editor, the products in
WooCommerce, and the photographs in the media library.
An import never touches orders, customers, or your payment, tax and account
settings. On a store that is already selling it also leaves the coming-soon setting alone.
Importing only the look
If you already have a catalogue, choose Look only instead of Import. It brings the design,
the header, the footer and the homepage layout, and leaves your products and pages where they are. The
starter’s own pages arrive as drafts, named after the starter, so you can look at them and publish the ones
you want.
Removing a starter
Use Remove starter content on the same screen. The importer records everything it creates,
so removal takes out exactly that and nothing else:
- Anything you have since used stays. A category you have put your own products in is kept, not deleted.
- Your site title, home page, posts page and permalink setting go back to what they were before the import.
- WordPress’s own first post, which the importer moves to the trash so it does not sit in the journal without
a photograph, is put back.
Colours and type
Open Appearance › Editor › Styles to swap the whole look in one click. Tyche
ships ten palettes and seven type pairings, plus one named style for each starter site that combines the two.
| Palettes | Linen (the default), Noir, Sage, Blush, Cobalt, Market, Midnight, Espresso, Stride, Oak |
|---|---|
| Type | Editorial (the default), System fonts, Roaster, Poster, Garden, Apothecary, Workshop |
| Starter looks | Roastery, Stride, Verdant, Oakhouse, Dew |
Every palette was measured rather than eyeballed: the text, buttons and badges in each one meet WCAG AA
contrast against the surfaces they sit on. The fonts are bundled with the theme, so nothing is fetched from
Google when a page loads.
Header layouts
Tyche has five headers: a centred logo, a logo on the left, a minimal one with the menu behind a button, a
stacked one with the menu under the brand, and a version of each without the announcement bar.
To change it, open Appearance › Editor › Patterns › Header, select the
header, and use Replace in the toolbar. The search, account and cart icons come with each one.
The store features
These come from Tyche Companion and are configured under WooCommerce › Tyche Companion.
| Free delivery bar | “Spend $21.00 more for free delivery”, above the cart and inside the cart drawer, updating as the cart changes. The figure is read from your own free-shipping method, so it always matches what checkout charges. |
|---|---|
| Sticky add to cart | On a product page, once the real button scrolls away, a bar with the product, price and button follows the shopper. It submits the page’s own form, so quantities and other plugins keep working. |
| Badges | Sale badges as a percentage rather than the word “Sale”, plus New and Sold out. How many days count as new is a setting. |
| Second photo on hover | Product cards show the first gallery image when a pointer is over them. |
| Countdown block | Counts down to a drop or the end of an offer and says so when the moment passes. Screen readers are given the date rather than the ticking numbers. |
The photographs
Every photograph in every starter site is CC0, and each one is credited to its photographer inside the
package. You can keep them, but they are meant to be replaced: swap them in the media library and the pages
follow, because the layouts do not depend on any particular picture.
If something looks wrong
The design did not change after an import
Go to Appearance › Editor › Styles and check the starter’s own style is
selected. If a previous theme left custom styles behind, choosing the style again applies them cleanly.
The shop says “Great things are on the horizon”
That is WooCommerce’s coming-soon screen, not the theme. Turn it off under WooCommerce ›
Settings › Site visibility. An import turns it off for a store that has never sold anything,
and deliberately leaves it alone on one that has.
The menu does not open on a phone
Make sure the header pattern still contains its navigation block. If you have replaced the header by hand,
re-insert one of the theme’s own header patterns from Patterns › Header.
Prices or variations look empty
That is usually WooCommerce still building its lookup tables after a large import. Go to
WooCommerce › Status › Tools and run Regenerate product lookup
tables.
Elsewhere
- About the Tyche theme — what it is, what it looks
like and what it needs. - The six starter sites — with live
demos, and a link that opens each one in your browser without installing anything. - Support forum — for anything this page does not
answer. - GitHub — the theme is developed in the open.
