Skip to content

🀝 Are you interested in helping contribute? Get started here.

Notifications You must be signed in to change notification settings

stacksjs/contributing

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

7 Commits
Β 
Β 

Repository files navigation

Contributing

Note

First off, thank you for taking the time to contribute to the Stacks ecosystem πŸ’™

πŸ’­ Knowledge

All projects are written using at least one (or all) of the following techologies: TypeScript, Bun, Vite, Vue, and Tauri.

Early on, it's important to note that while some of the technologies may be new to you, don't get discouraged. With basic JavaScript, HTML and CSS skills, you will get by learning on-the-fly, as you review some of the examples within the codebases. Every project is very approachable (and readable).

Get Started

Head over to the repository on GitHub and click the Fork button in the top right corner.

After the project has been forked, run the following commands in your terminal:

gh repo clone stacksjs/stacks

Every project has the same steps to get started:

# Check if you have the `./pkgx.yaml` deps installed locally
# otherwise, given `pkgx` is installed, run
dev

# next, install `./node_modules`
bun install


# now, that you are set up you may run any of the following
bun dev
bun build
bun test

Check out each project's ./package.json and you will find a few more handy scripts.

Testing

All of the tests are stored within the ./tests project folder.

When adding or updating functionality, please ensure it is covered through the test suite. Ensure so by running bun test, or buddy test within Stacks contexts.

Commit

We use semantic commit messages to automate package releases. No worries, you may not be aware what this is or how it works justβ€”the CLI will guide you. The commit process was automated to some degree, simply run bun run commit in your terminal and follow the instructions.

For example,

# Add all changes to staging to be committed.
git add .

# Commit changes
bun run commit
buddy commit # inside Stacks context

# Push changes up to GitHub
git push

By following these minor steps, Stacks is able to automatically release new versions & generate relating local & remote changelogs.

Pull Request

When you're all done, head over to the repository, and click the big green Compare & Pull Request button that should appear after you've pushed changes to your fork.

Don't expect your PR to be accepted immediately, or even accepted at all. Give the community time to vet it and see if it should be merged. Please don't be disheartened if it's not accepted. Your contribution is appreciated more than you can imagine, and even an unmerged PR can teach us a lot! Please nudge us in Discord, if you think it slipped our attention!

Working on your first Pull Request? You can learn how from this free series How to Contribute to an Open Source Project on GitHub.

Community

For help, discussion about best practices, or any other conversation that would benefit from being searchable:

Discussions on GitHub

For casual chit-chat with others using this package:

Join the Stacks Discord Server

Postcardware

Two things are true: Stacks OSS will always stay open-source, and we do/would love to receive postcards from wherever Stacks is used! 🌍 _And we also publish them on our website.

Our address: Stacks.js, 5710 Crescent Park #107, Playa Vista 90094, CA, USA

Made with πŸ’™

About

🀝 Are you interested in helping contribute? Get started here.

Resources

Code of conduct

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published