Salla Docs
Merchant API
  • Merchant API
  • Salla OAuth 2.0
Partner APIs
  • App API
  • Shipment API
Storefront
  • Twilight Engine
  • Twilight SDK
  • Web Components
  • Change Log
Salla CLI
Merchant API
  • Merchant API
  • Salla OAuth 2.0
Partner APIs
  • App API
  • Shipment API
Storefront
  • Twilight Engine
  • Twilight SDK
  • Web Components
  • Change Log
Salla CLI
Salla - Opensource
Salla - Developers Community
  1. Getting Started
  • Getting Started
    • Create a theme
    • Develop a theme
    • Setup a theme
    • Publish a theme
  • Requirements & Review
    • Overview
    • Main Requirements
    • Review Process
      • UI / UX Review
      • Technical Review
      • Metadata Review
      • Pre-Launch Review
  • Files and Folders Structure
    • Directory structure
    • Twilight.json
  • Twig Template Engine
    • Basic syntax
    • Twilight flavoured twig
  • Theme Architecture
    • Layouts
      • Overview
      • Master Layout
      • Global Variables
      • CSS Variables
      • Salla Icons
      • Custom Fonts
      • Hooks
      • Localizations
    • Pages
      • Overview
      • Home Page
      • Product Pages
        • Products listing
        • Single product
      • Customer Pages
        • Profile
        • Orders list
        • Order details
        • Wishlist
        • Notifications
      • Blog Pages
        • Blog listing
        • Single blog
      • Brand Pages
        • Brands listing
        • Single brand
      • Common Pages
        • Cart
        • Loyalty
        • Thank you
        • Single page
        • Landing Page
    • Componenets
      • Overview
      • Home Components
        • Youtube
        • Fixed banner
        • Testimonials
        • Parallax background
        • Photos slider
        • Store features
        • Square photos
        • Fixed products
        • Products slider
        • Featured products - Style 1
        • Featured Products - Style 2
        • Featured Products - Style 3
        • Brands
        • Enhanced Square Banners
        • Main Links
        • Enhanced Slider
        • Slider Products with Headers
        • Latest Products
        • Vertical Menu with Slider
      • Product Components
        • Essentials
        • Options
      • Common Components
        • Header Components
        • Footer Components
        • Comments component
  • Change Log
  1. Getting Started

Create a theme

Now that you have the necessary skills to begin creating fantastic Twilight themes for Salla's Store, you can move on to the next phase and construct your theme.
A thing to know!
Salla Partners Portal and Salla CLI are two alternatives tools provided by Salla for creating and setting up Twilight Themes for the developers.
Salla CLI documentation provides a full guide for Salla CLI commands.

📙 What you'll learn#

By the end of this article, you will have successfully created a theme using Salla Partners Portal.
Creating a Theme via Salla Partners Portal, includes:
Prerequisites
Initiating a theme
Connecting with GitHub
Create a new theme
Import an existing theme

Creating Theme via Salla Partners Portal#

Developers can use the Salla Partners Portal to integrate their themes with Salla's eCommerce Platform. It gives them the ability to create custom themes for Salla Merchants by giving them a set of tools to help them explore their creativity.
By using this tool, developers will be able to build big projects on the platform in a simple, organized, and monitored way. Learn more about Salla Partners Portal by visiting this blog.

Prerequisites#

Salla partner account account.
Github account, to sync the theme's files that are being developed with the Salla partner account.

Initiating a theme#

On Salla Partners Portal dashboard, click on My Themes on the main navigation menu. The page will be redirected to the theme management page. From there, click on Create your first theme. If you have already created your first theme, click on the Create theme button.
Salla Partners Portal
A thing to know!
Salla CLI, is a command-line tool developed by Salla team, can be used to create Salla themes.

Connecting with GitHub#

This step is crucial in order for Twilight to access a GitHub account and start crafting the theme's files there, it needs to verify the developer's GitHub identity. This requires going through the authorization process in order to authorize interactions with the data on GitHub on the developer's behalf. 
GitHub
After setting the GitHub authorization, the page will give two options:
Create a New Theme
Import a Theme
Both methods will be explained respectively.

Create a new theme#

By clicking on Create theme button, the theme setting file will be created. More about theme's files here.
Create theme options
Next, fill in the new theme basic information:

Theme information
Then, click on Create theme. The table below explains the new theme details required in the above photo.
1- Theme icon for the new themeIcon is an image that describes your theme.
2- NameThe name of the theme
3- Theme Category (optional)This option allows the theme to be categorized in the available categories for ease of access by merchants.
4- Theme website (optional)This option provides the theme website for the merchant to display the theme.
5- Support emailEmail address to support the theme.
🎉 Well done! You have successfully created a theme using create theme on Salla Partners Portal.
Next, we'll create a theme by importing it.

Import an existing theme#

The other method for creating a theme from the Salla Partners Portal is to import an existing theme that already exists in the developer's GitHub account. This method will detect the theme setting file twilight.json and craft the new theme based on it. Here is a complete article about the twilight.json file.
On the theme management page click on import theme button.
Import theme

Next, fill in these details:
Import information
Then, click on import theme. The following table explains the information required from the developer to create the theme using import theme option.
1- Icon for the imported themeIcon is an image that describes your theme.
2- The Github accountThe GitHub account linked to the partners account.
3- The theme repositoryImported theme repository, from the developer's remote GitHub account.
4- Theme CategoriesThe Theme category
5- Theme screenshots (optional)Images of the theme, up to three images.
🎉Congratulations! You have successfully created a theme using import theme on Salla Partners Portal.

Modified at 2025-03-04 12:54:02
Previous
Getting Started
Next
Develop a theme