{"id":20672085,"url":"https://github.com/workarea-commerce/workarea-one-theme","last_synced_at":"2026-03-17T03:52:17.204Z","repository":{"id":36468238,"uuid":"221313991","full_name":"workarea-commerce/workarea-one-theme","owner":"workarea-commerce","description":null,"archived":false,"fork":false,"pushed_at":"2023-01-05T00:47:31.000Z","size":1495,"stargazers_count":0,"open_issues_count":8,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-12-06T17:46:04.761Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Haml","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/workarea-commerce.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE.md","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2019-11-12T21:18:58.000Z","updated_at":"2020-12-14T14:52:36.000Z","dependencies_parsed_at":"2023-01-17T01:46:11.402Z","dependency_job_id":null,"html_url":"https://github.com/workarea-commerce/workarea-one-theme","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/workarea-commerce/workarea-one-theme","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/workarea-commerce%2Fworkarea-one-theme","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/workarea-commerce%2Fworkarea-one-theme/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/workarea-commerce%2Fworkarea-one-theme/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/workarea-commerce%2Fworkarea-one-theme/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/workarea-commerce","download_url":"https://codeload.github.com/workarea-commerce/workarea-one-theme/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/workarea-commerce%2Fworkarea-one-theme/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28017822,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-12-25T02:00:05.988Z","response_time":58,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-16T20:31:52.202Z","updated_at":"2025-12-25T03:12:08.112Z","avatar_url":"https://github.com/workarea-commerce.png","language":"Haml","funding_links":[],"categories":[],"sub_categories":[],"readme":"Workarea One Theme\n================================================================================\n\nOne Theme plugin for the Workarea platform. [Visit the One Theme demo site](https://one-theme.demo.workarea.com)\n\n\nBrowser Support\n--------------------------------------------------------------------------------\n\nDue to the occasional use of flexbox; OneTheme only supports IE 10+\nIf you need to support older versions of IE you will need to provide alternative styles\nwhere flexbox is used.\n\nNotable features\n--------------------------------------------------------------------------------\n\n* 2 additional Taxonomy content blocks which include products\n* Retina support for PDP images using responsive images via dragonfly\n* Hero Slider content block type with full bleed option\n* Color scheme and font configuration\n* Credit card formatting and validation in checkout.\n\nOptimal Image Sizes\n--------------------------------------------------------------------------------\n\n| Image Type| Optimum size | Note |\n|----------|--------|-------|\n| Logo | 140 x 37px ||\n| Product Images | 720px x 960px | This size does not account for use of image-zoom, it is recommended to *at least* double this size if your client is likely to want zoom functionality. |\n| Blog thumbnails | 914px x 417px\n| Category summary | 464 x 742px | Some cropping will occur depending on device size, Image height depends on product height at a diven device width. |\n| Hero Slider | 1044 x 511px | An aspect ratio of 16:9 is recommended. Any height image could be used here, admin user should preview at different device sizes to ensure it scales well. |\n| Hero Slider full bleed | 1682 x 823px ||\n\nOut of the box plugin support\n--------------------------------------------------------------------------------\n\nThe following workarea plugins are supported by OneTheme, and are dependencies of the plugin.\n\n* Product Quickview\n* Package Products\n* Slick Slider\n* Blog\n* Content Search\n* Gift Cards\n* Share\n* OMS\n* Reviews\n* Super Hero\n* Wish Lists\n\nTheme Configuration\n--------------------------------------------------------------------------------\n\n### Recommended initializer configuration\n\nWhile you are able to configure the Workarea OneTheme from any initializer it is recommended\nthat you create a new initializer called theme.rb using the following code\n\n    Workarea.configure do |config|\n      config.theme = config.theme.merge(\n        color_scheme: \"one\",\n        font_stacks: {\n            roboto: '\"Roboto\", \"HelveticaNeue\", \"Helvetica Neue\", sans-serif',\n            lora: '\"Lora\", \"Times New Roman\", \"Georgia\", serif',\n            hind: '\"Hind\", Helvetica, Arial, sans-serif',\n            source_serif_pro: '\"Source Serif Pro\", \"Times New Roman\", Georgia, serif',\n            muli: '\"Muli\", Helvetica, Arial, sans-serif',\n            playfair_display: '\"Playfair Display\", \"Times New Roman\", Georgia, serif'\n        },\n        primary_font_family: \"roboto\",\n        secondary_font_family: \"lora\"\n      )\n    end\n\nThis will set your application up with the default configuration options, but allow you to\nchange them easily.\n\n---\n\n### Color Schemes\n\nOneTheme comes with 3 color schemes pre-defined for demo and learning purposes.\n\nTo change the color scheme in your application, set the color_scheme configuration\nin your theme initializer to one of the following configurations:\n\n Default:\n\n    Workarea.config.theme[:color_scheme] = \"one\"\n\nLight:\n\n    Workarea.config.theme[:color_scheme] = \"workarea\"\n\nDark:\n\n    Workarea.config.theme[:color_scheme] = \"midnight\"\n\n#### Creating a new color scheme\n\nWe will be creating a gem for theme infastructure in the near future that will make this process\nmore developer friendly. In the meantime you can create a new color scheme by:\n\n1. Copying one of the existing color scheme files into your application re-nameing the file,\n2. Update the color_scheme config to match the name of your new color scheme file.\n\n__Example__\nThis will create a sass file called _custom_color_scheme.scss in your host application, please change [your-app-name]\nFrom your ~/src directory, ensure you have workarea-one-theme pulled down\n\n    cp -i workarea-one-theme/app/assets/stylesheets/workarea/storefront/theme_config/_one_color_scheme.scss [your-app-name]/app/assets/stylesheets/workarea/storefront/theme_config/_custom_color_scheme.scss\n\n---\n\n### Font Stacks\n\nOneTheme includes configurable font-stack functionality!\n\nA developer is able to configure the primary and secondary font stacks using the theme\nconfiguration initializer. To change the font stacks in your application set the\nprimary_font_family and secondary_font_family initializer values to one of the font_stacks\ndefined in workarea-one-theme/config/initializers/theme.rb\n\nNote: If you are using the starter_store generator to install the theme your initializer\nmust specify the font_stacks hash. The names defined in your primary and secondary\nfont variables must match one of the keys in the font_stacks hash.\n\nExample:\n\n    config.theme = config.theme.merge(\n      primary_font_family: \"hind\",\n      secondary_font_family: \"source_serif_pro\"\n    )\n\nThe primary_font_family is used for most text throughout the site, including body text, links,\nbuttons, prices, content blocks etc.\nThe secondary_font_family is used for headings, specifically H1, H2, and elements with the heading--fancy class.\n\n#### Suggested font combinations\n\n1. Primary: roboto, Secondary: lora\n2. Primary: hind, Secondary: source_serif_pro\n3. Primary: muli, Secondary: playfair_display\n\n#### Adding a new font\n\nI recommend using google fonts where possible, the [googlefonts webfont helper](https://google-webfonts-helper.herokuapp.com) is a useful tool for downloading webfonts and easily generating @font-face CSS - give it a try!\n\n1. Create a new directory in app/assets/fonts/workarea/storefront/\u003cyour_font_name_here\u003e\n2. Download woff and woff2 files for the font you want to use.\n3. Place your font files in the directory we created in step 1.\n4. Create a sass file for you @font-face declarations in /app/assets/stylesheets/workarea/storefront/theme_config/fonts/_\u003cyour_font_name_here\u003e.scss\n5. Update your theme initializer, adding a new font_stack and setting either the primary_font_family or secondary_font_family\n\nExample configuration for Calibri font stack used as secondary font family:\n\n    config.theme[:font_stacks] = config.theme.font_stacks.merge (\n      calibri: 'Calibri, Candara, Segoe, \"Segoe UI\", Optima, Arial, sans-serif',\n    )\n\n    config.theme = config.theme.merge(\n      secondary_font_family: \"calibri\"\n    )\n\nWorkarea Platform Documentation\n--------------------------------------------------------------------------------\n\nSee [https://developer.workarea.com](https://developer.workarea.com) for Workarea platform documentation.\n\nCopyright \u0026 Licensing\n--------------------------------------------------------------------------------\nWorkarea Commerce Platform is released under the [Business Software License](https://github.com/workarea-commerce/workarea/blob/master/LICENSE)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fworkarea-commerce%2Fworkarea-one-theme","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fworkarea-commerce%2Fworkarea-one-theme","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fworkarea-commerce%2Fworkarea-one-theme/lists"}