Contributing

Contributing

MacPad welcomes small, focused contributions that preserve the app's Notepad-like scope.

Contribution Channels

• Bugs: open an Issue.
• Questions and ideas: start a Discussion.
• Code or documentation changes: open a pull request.

Review Policy

Changes should be controlled and reviewed before they become part of the project:

• Keep pull requests focused on one behavior or documentation topic.
• Explain why the change belongs in the lightweight MacPad app.
• Run the local build before submitting code changes.
• Avoid private notes, local machine paths, screenshots with personal data, credentials, or generated build output.
• Wiki updates should be proposed through an Issue, Discussion, or pull request first.

What Usually Fits

• bug fixes
• small editing improvements
• accessibility fixes
• macOS behavior polish
• documentation corrections
• packaging/release improvements

What Usually Does Not Fit

• extension/plugin systems
• themes
• language-aware code editing
• Markdown preview workflows
• project folders or workspaces
• cloud sync
• account systems

Those ideas are better suited to MacPad Pro.

Local Build

./scripts/build-app.sh

The app bundle is created at:

build/MacPad.app