docs: improve README with possible issues and animated demo

[littleninja]

Alaska Airlines Pull Request

Summary:

Improve documentation (README):

• Add short section to mention possible issues and offer troubleshooting hints and workarounds
• Add animated demo!
• Fix build badge

Type of change:

• [/] Revision of an existing capability

Checklist:

• [/] My update follows the CONTRIBUTING guidelines of this project
• [/] I have performed a self-review of my own update

By submitting this Pull Request, I confirm that my contribution is made under the terms of the Apache 2.0 license.

Pull Requests will be evaluated by their quality of update and whether it is consistent with the goals and values of this project. Any submission is to be considered a conversation between the submitter and the maintainers of this project and may require changes to your submission.

Thank you for your submission!
-- Auro Design System Team

[blackfalcon]

:tada: This PR is included in version 1.1.0 :tada:

The release is available on:

• npm package (@latest dist-tag)
• GitHub release

Your semantic-release bot :package::rocket: