# Become a contributor

Welcome and thank you so much for thinking of contributing to StorefrontUI ❤️👍.

We want you to have fun contributing with us, so let's go over a few important guidelines before getting started.

# Important resources

# Repository's structure

StorefrontUI is an open-source UI library which is written initially for Vue.js developers. Like any other Vue.js project, you should be familiar with the basic of Vue.js before starting to contribute. This is to help you understand the code faster and thus make it easier for you in contributing.

Our repo structure follows monorepo development strategy. It consists of two main projects: shared and vue, both located under packages folder.

storefrontUI
|__/packages
  |__/shared
  |__/vue
  • shared - Contains all CSS stylings of components and icons used within StorefrontUI. This is to ensure design consistency between our future projects.

  • vue - This is the main project that contains main Storefront UI Vue components code in src, storybook config in config, customized scripts in scripts and main documentation written in vuepress will be found in docs.

./vue
|__/config
|__/docs
|__/scripts
|__/src

We selected this strategy to enable the reusability of resources between future extension to other frameworks such as React.js.

# Ways of contribution

WORK WITH GITHUB

StorefrontUI is a Github repository. If you are new to Github, please check our Github guidelines for instructions.

Anything for a better StorefrontUI and bulding the community is considered contributions 😉, which include:

# Contribute Code

We have a lot of features that need good helping hand, as always. However, there are coding rules you need to follow, for maintaining readability and for us to process your pull request as quickly as possible. Please read our code contributing guide.

Then you'll be ready to pick your first issue and contribute to StorefrontUI core respository.

DON'T KNOW WHICH ISSUE TO SELECT?

We have our issues labelled to make it easier in selecting an issue to work with. You can also check about our labels system for more information.

# Report bug or request a feature

Our goal is to make StorefrontUI customisable as much as possible. Hence issue reporting, either a bug or a feature request, is extremely valuable to us.

In order to maintain an effective workflow and make sure all issues reported will be solved, we'd like you to follow some simple guidelines.

If you are sure your issue is a bug, or a valid feature request, file a new issue in our Github issue tracker following the template and guidelines.

# Work on Documentation

Good and friendly documentation is extremply significant for our community, for every reason. Currently we have lots of work needed to be done on this matter. Would you like to help us a hand to build the best documentation? 😉

StorefrontUI aims to be an international community, with the core team coming from different timezones across the globe. Thus, we are actively looking for contributors on the following:

  • Translating docs into different languages. We do want you to be able to read this section in your preferred language. And that surely needs some help!

  • Review our documentation Pull Requests.

  • Fix current documentation (on dictation error, word usage, etc)

  • Write documentation for our components, or select an docs issue to start.

WORK WITH DOCUMENTATION

Certainly, make sure you read and follow our documentation guidelines.

# Speard the words

There is a lot more you can help StorefrontUI community grow besides the above:

  • Write and publish blog posts about StorefrontUI best practices, use cases. If you like StorefrontUI, why not share it to the world?

  • Talk about how awesome StorefrontUI is to you in a conference, meetup or simple at your work 😉.

  • Integrate StorefrontUI with other awesome frameworks, such as Nuxt.js, Gridsome.js. Write a StorefrontUI plugin for any of the frameworks you work with, and we will love to add it in our ecosystem.

If you have any question on how you can be more involved in contributing other than these, reach out to us @StorefrontUI or in our Discord Server