Contributing

Welcome Contributors

Contributions to Slick Carousel are welcome! Whether you’re fixing bugs, adding features, or improving documentation, your help is appreciated.

Please review these guidelines before submitting pull requests or filing issues.

Submitting Issues

Bug Reports

All bug reports and problem issues require a jsFiddle test case.

Before submitting a bug report:

Create a test case

Fork this JSFiddle as a baseline: https://jsfiddle.net/o1yehw0g/1/Your test case must:

Clearly demonstrate the bug or issue
Contain the bare minimum HTML, CSS, and JavaScript required
Use non-minified assets (we cannot debug .min.js files)
Be a reduced test case, not a link to your production site

Provide clear reproduction steps

In your issue, include:

## Steps to reproduce
1. Initialize slider with specific options
2. Click the next arrow
3. Observe incorrect behavior

## Expected behavior
Slider should advance to next slide

## Observed behavior  
Slider jumps to wrong slide

## Environment
- Browser: Chrome 120
- jQuery version: 3.6.0
- Slick version: 1.8.1

Submit with test case link

Include your jsFiddle link prominently in the issue.

Issues without a test case may be closed without response.

Issue Template

When creating an issue, use this format:

> Short description of the bug/issue

====================================================================

###### [paste your jsfiddle link here]

Use this jsfiddle to reproduce your bug:
http://jsfiddle.net/simeydotme/fmo50w7n/
We will likely close your issue without it.

====================================================================

#### Steps to reproduce the problem

1. ...
2. ...

====================================================================

#### What is the expected behaviour?

...

====================================================================

#### What is observed behaviour?

...

====================================================================

#### More Details

- Which browsers/versions does it happen on?
- Which jQuery/Slick version are you using?
- Did this work before?

Getting Support

GitHub Issues is not for support questions. Use these resources instead:

Where to Ask Questions

If you’re having problems getting Slick to work or can’t figure something out:

Stack Overflow: stackoverflow.com/questions/tagged/slick
- Search existing questions
- Ask new questions with the slick tag
Gitter Chat: gitter.im/kenwheeler/slick
- Real-time community discussion
- Share code and get quick feedback
Troubleshooting Guide: View common issues
- Check solutions to frequent problems

Support questions posted to GitHub Issues will be redirected to these forums.

Feature Requests

If you would like to request or propose a feature:

Discuss features on r/slickcarousel

Gitter

Chat with the community

Feature requests are welcome, but please discuss them in the community forums before opening a GitHub issue.

Pull Requests

Contributions are welcome! Please be prepared to edit your pull request based on feedback.

Before Submitting a Pull Request

Discuss major changes

For significant features or changes:

Open an issue first to discuss your proposal
Get feedback from maintainers
Ensure the feature aligns with project goals

Create a working test case

Provide a jsFiddle demonstrating your change working with:

Every mode that Slick supports
Varying numbers of slides
Different slidesToShow and slidesToScroll values
Responsive breakpoints

Pull requests without comprehensive test cases will be closed.

Follow code style

Match existing code style and formatting
Use meaningful variable and function names
Add comments for complex logic
Keep changes focused and minimal

Test thoroughly

Verify your changes work across:

All major browsers (Chrome, Firefox, Safari, Edge)
IE8+ if applicable
Mobile browsers (iOS Safari, Chrome for Android)
Various screen sizes

Pull Request Requirements

Code Requirements

Your pull request must:

Include a clear description of what it changes
Reference related issues (e.g., “Fixes #123”)
Include a jsFiddle demonstrating the fix/feature
Work with all Slick modes and configurations
Not break existing functionality
Follow existing code style
Include comments for complex changes

Testing Requirements

You must test your changes with:

// Test with different configurations
$('.slider').slick({
  infinite: true,
  infinite: false,
  centerMode: true,
  variableWidth: true,
  vertical: true,
  fade: true,
  // etc.
});

// Test with responsive breakpoints
$('.slider').slick({
  responsive: [
    {
      breakpoint: 1024,
      settings: { /* ... */ }
    }
  ]
});

// Test with varying slide counts
// - 1 slide
// - 3 slides
// - 10+ slides

Documentation Requirements

If your PR adds new features:

Update README.markdown with new options
Document new methods or events
Provide usage examples
Update relevant documentation pages

Pull Request Process

Fork the repository

git clone https://github.com/your-username/slick.git
cd slick

Create a feature branch

git checkout -b feature/my-improvement

Make your changes

Edit source files in /slick/
Test your changes thoroughly
Create a jsFiddle demo

Commit your changes

git add .
git commit -m "Fix: Description of what this fixes"

Use clear commit messages:

Fix: Corrects edge case with infinite scroll
Feature: Add new pauseOnDotsHover option
Docs: Update browser support information

Push and create PR

git push origin feature/my-improvement

Then open a pull request on GitHub with:

Clear title and description
Link to your jsFiddle demo
Reference to related issues
Browser testing results

Respond to feedback

Be prepared to:

Answer questions about your implementation
Make requested changes
Update your test case
Rebase if needed

Development Setup

Building from Source

# Clone the repository
git clone https://github.com/kenwheeler/slick.git
cd slick

# Install dependencies
npm install

# Build (if applicable)
npm run build

Project Structure

slick/
├── slick/
│   ├── slick.js          # Main source file
│   ├── slick.min.js      # Minified version
│   ├── slick.css         # Core styles
│   ├── slick-theme.css   # Theme styles
│   └── fonts/            # Icon fonts
├── README.markdown       # Documentation
├── CONTRIBUTING.markdown # This file
└── ISSUE_TEMPLATE.md    # Issue template

Coding Standards

JavaScript Style

Use semicolons
4-space indentation
Single quotes for strings
Meaningful variable names
Comment complex logic

// Good
var slideCount = _.slideCount;

// Bad
var sc = _.slideCount;

CSS Style

Use existing class naming conventions
Prefix all Slick classes with .slick-
Keep specificity low
Comment unusual CSS

/* Good */
.slick-slide {
    display: none;
}

/* Bad */
div.slider .slide {
    display: none;
}

Code of Conduct

Our Standards

Be respectful and professional
Welcome newcomers and help them learn
Accept constructive criticism gracefully
Focus on what’s best for the project
Show empathy towards other community members

Unacceptable Behavior

Harassment or discriminatory comments
Trolling or insulting remarks
Personal or political attacks
Publishing others’ private information
Any conduct inappropriate in a professional setting

Ownership and Rights

By submitting a pull request, you authorize the project maintainer to edit or modify it in any way.

You will be listed in GitHub as a contributor, but the project maintainer retains final decision-making authority on the project’s direction.

From the project creator:

While Slick is open source, this is still my baby, and by submitting a pull request you are authorizing me to edit or modify it in any way shape or form. You will be listed in GitHub as a contributor, but I have and will continue to steer the direction of this project.

Recognition

Contributors are recognized through:

GitHub’s contributor list
Mention in release notes (for significant contributions)
Community acknowledgment

License

Slick Carousel is licensed under the MIT License.

Copyright (c) 2017 Ken Wheeler

Licensed under the MIT license.

Free as in Bacon.

By contributing, you agree that your contributions will be licensed under the same MIT License.

Questions?

If you have questions about contributing:

Gitter Chat

Ask the community

Stack Overflow

Search or ask questions

Additional Resources

Troubleshooting

Common issues and solutions

Browser Support

Compatibility information

Migration Guide

Upgrading between versions

GitHub Repository

View source code

Thank you for contributing to Slick Carousel! Your efforts help make it better for everyone.

Get Started

Core Concepts

Guides

Resources

Welcome Contributors

Submitting Issues

Bug Reports

Issue Template

Getting Support

Feature Requests

Reddit

Gitter

Pull Requests

Before Submitting a Pull Request

Pull Request Requirements

Pull Request Process

Development Setup

Building from Source

Project Structure

Coding Standards

Code of Conduct

Our Standards

Unacceptable Behavior

Ownership and Rights

Recognition

License

Questions?

Gitter Chat

Stack Overflow

Additional Resources

Troubleshooting

Browser Support

Migration Guide

GitHub Repository

Build docs developers (and LLMs) love

Get Started

Core Concepts

Guides

Resources

​Welcome Contributors

​Submitting Issues

​Bug Reports

​Issue Template

​Getting Support

​Feature Requests

Reddit

Gitter

​Pull Requests

​Before Submitting a Pull Request

​Pull Request Requirements

​Pull Request Process

​Development Setup

​Building from Source

​Project Structure

​Coding Standards

​Code of Conduct

​Our Standards

​Unacceptable Behavior

​Ownership and Rights

​Recognition

​License

​Questions?

Gitter Chat

Stack Overflow

​Additional Resources

Troubleshooting

Browser Support

Migration Guide

GitHub Repository

Build docs developers (and LLMs) love

Welcome Contributors

Submitting Issues

Bug Reports

Issue Template

Getting Support

Feature Requests

Pull Requests

Before Submitting a Pull Request

Pull Request Requirements

Pull Request Process

Development Setup

Building from Source

Project Structure

Coding Standards

Code of Conduct

Our Standards

Unacceptable Behavior

Ownership and Rights

Recognition

License

Questions?

Additional Resources