/groundwork

An opinionated set of packages for starting projects

Primary LanguageHTML

Groundwork

Version
Packages to get your next project up and running.

TailwindCSS Version Laravel Mix Version Laravel Mix PurgeCSS Version
Include Media Version Sassdoc Version Sassdoc Version

Based on the commit styleguide by SlashBin, with some additions / refinements SlashsBin Styleguide

Planned Features

  • (P) Add other stubs - webpack,
  • (P) Extract family.scss mixins to indv files
  • (M) Upgrade to Laravel Mix 4.0
  • (M) Add script for starting projects

Styleguide

Follow the guidelines listed at Sass Guidelines and CSS Guidelines.

Commit Message Format

All Git Commit Messages MUST meet with this Text Format:

:emoji1: :emoji2: Subject
(Only One NewLine)
Message Body
(Only One NewLine)
Ref <###>

Rules

  1. Capitalize the Subject.
  2. Do not end the Subject line with a period.
  3. Message Subject SHOULD Begin with at-least One Emoji(see below for list of Suggested Emojis).
  4. Message Body SHOULD End with at-least One Issue Tracking ID Reference(GitHub Issues/JIRA Ticket Number), Ex. Issue #27, JIRA-## or Ref T27, JIRA-## or Fixes T8. It's also recommanded to use Full URL to Issues, instead of just Issue ID Number; Doing so will ease browsing issues from terminal.
  5. Total Characters of the Subject Line MUST be Less than or Equal to 50 Chars Long.
  6. Wrap the Message body at 72 characters.
  7. Use Valid MarkDown format in Message Body.
  8. Use the Present Tense ("Add feature" not "Added feature").
  9. Use the Imperative Mood ("Move cursor to..." not "Moves cursor to...").
  10. Use the Message body to explain what and why vs. how.
  11. All WIP(Work In Progress) Commits MUST have the WIP Emoji(see below).

Notes

  • Refrencing Issues by using special keywords like Fixes or Resolves will mark them as closed automatically! For more information about automatic issue closing using ketwords see: GitHub
  • There is a Space Character between Multiple Emojis!.
  • There is NO New-Line After the Task ID Reference Line.
  • Every Raw Emoji Text(:emoji:) is Counted as One Char!.

Suggested Emojis

Emoji Raw Emoji Code Description
🎉 :tada: Initial Commit
💎 :gem: New Release
🔖 :bookmark: Version Tags
📦 :package: when adding new packages
🎀 :ribbon: when dealing with Yarn / NPM pkgs
🎼 :musical_score: when dealing with Composer pkgs
⬆️ :arrow_up: when upgrading dependencies / packages
⬇️ :arrow_down: when downgrading dependencies / packages
📄 :page_facing_up: when creating a new file
📖 :book: when writing docs
🏷️ :label: when writing comments
🎨 :art: when improving the format/structure of the code
🚜 🚚 :tractor: :truck: when change file structure. Usually together with 🎨
🚄 :bullettrain_side: when adding / modifying the api
🔨 :hammer: when refactoring code
🗑️ :wastebasket: when removing code or files, maybe with @CHANGED Comment Tag
💻 :computer: when improving UI/Cosmetic
📝 :memo: when performing minor changes/fixing the code or language
🐎 :racehorse: when improving performance
🪲 :beetle: when fixing a bug
🐧 :penguin: when fixing something on Linux
🍎 :apple: when fixing something on Mac OS
🏁 :checkered_flag: when fixing something on Windows
⚙️ :gear: changing Configuration, Usually together with 🐧 or 🎀 or 🚀
🔧 :wrench: Customer requested application Customization, with @HACK Comment Tag
🐳 :whale: Docker Configuration
🚀 :rocket: Anything related to Deployments/DevOps
🐘 :elephant: PostgreSQL Database specific (Migrations, Scripts, Extensions, ...)
🐬 :dolphin: MySQL Database specific (Migrations, Scripts, Extensions, ...)
🍃 :leaves: MongoDB Database specific (Migrations, Scripts, Extensions, ...)
🏦 :bank: Generic Database specific (Migrations, Scripts, Extensions, ...)
🤝 :handshake: when Merging files
🔬 :microscope: when adding tests
:umbrella: when adding code coverage
💚 :green_heart: when fixing the CI build
🔒 :lock: when dealing with security
:fast_forward: when forward-porting features from an older version/branch
:rewind: when backporting features from a newer version/branch
👕 :shirt: when removing linter/strict/deprecation warnings
:wheelchair: when improving accessibility (a11y)
🌐 :globe_with_meridians: when dealing with globalization/internationalization (i18n/g11n)
🚧 :construction: WIP(Work In Progress) Commits, maybe with @REVIEW Comment Tag
🔈 :speaker: when Adding Logging
🔇 :mute: when Reducing Logging
:sparkles: when introducing New Features
:zap: when introducing Backward-InCompatible Features, maybe with @CHANGED Comment Tag
💡 :bulb: New Idea, with @IDEA Comment Tag

License

The Code is licensed under the MIT License.