Skip to content

Latest commit

 

History

History
226 lines (161 loc) · 7.62 KB

CONTRIBUTING.md

File metadata and controls

226 lines (161 loc) · 7.62 KB

Contributing to  NetPad

Last updated: Nov 28th, 2024 📖

Thank you for considering contributing to NetPad! We’re excited to have you join the project.

How to Contribute ⭐

Submitting Changes

  • Branching Strategy: Create a branch for your work
    • For new features or changes use the feat/ prefix, example: feat/my-new-feature
    • For bugs or fixes use the fix prefix, example: fix/my-fix
  • Commit Messages: Follow this format: Add contributing guidelines.
  • Pull Requests: Ensure your PR includes tests and follows our coding standards. A small * description* of the changes as well as the issue number (if applicable).

Pull request example ⬇️

Added contributing guidelines to make it easier for new contributors to get started.

Changes Made:

  • Added a new CONTRIBUTING.md file.
  • Updated the README.md file to include a link to the new CONTRIBUTING.md file.

Build & Run ⚒️

NetPad has a .NET backend that does all the heavy lifting and a JavaScript interface. The user interface can be hosted in a number of different environments, or shells:

  1. Web Browser: where you access the NetPad interface from any web browser.
  2. Electron Desktop App: a cross-platform desktop application that uses Electron.js to host the NetPad interface.
  3. Tauri Desktop App: a cross-platform native desktop application written in Rust that hosts the NetPad interface. It is smaller than Electron and uses less system resources.

Prerequisites

Start by cloning, or forking, the repository:

git clone https://github.com/tareqimbasher/NetPad.git && cd NetPad

Web Browser

  1. Run the JavaScript SPA
# Install dependencies
cd src/Apps/NetPad.Apps.App/App/
npm install

# Start the development web server
npm run start-web
  1. Start the development web server
cd src/Apps/NetPad.Apps.App/
dotnet watch run --environment Development

Navigate to the app from your web browser at http://localhost:57940.

Note

Creating new SQLite database connections is not supported when NetPad is used in a browser.

Electron Desktop App

  1. Run the JavaScript SPA
# Install dependencies
cd src/Apps/NetPad.Apps.App/ElectronHostHook
npm install

cd ../App
npm install

# Start the development web server
npm start
  1. Run the Electron app
cd src/Apps/NetPad.Apps.App/

# Install the `electronize` dotnet tool
dotnet tool install ElectronNET.CLI -g

# Start in watch mode (remove '/watch' to run without watch mode)
electronize start /watch /manifest electron.manifest.dev.js

# For macOS ARM, append the following to the 'electronize start' command
/target custom "osx-arm64;mac" /electron-arch arm64

Important

Running electronize requires you to have .NET 6 SDK installed.

Tip

The very first electronize start is slow. Later runs are much faster!

Tauri (Native) App

You will need to have the Rust toolchain installed to build the Tauri app.

  1. Install JavaScript SPA dependencies
cd src/Apps/NetPad.Apps.App/App
npm install
  1. Run the .NET app
cd src/Apps/NetPad.Apps.App
dotnet watch run --environment Development --tauri
  1. Run the Tauri app
cd src/Apps/NetPad.Apps.Shells.Tauri/TauriApp
npm install
npx tauri dev

Packaging 📦

The Electron app is built and packaged using electron-builder. Configuration is in the electron.manifest.js file.

Build the app for the desired platform from the root directory of the NetPad.Apps.App project:

# For x64:
electronize build /target win /manifest electron.manifest.js /PublishSingleFile false
electronize build /target osx /manifest electron.manifest.js /PublishSingleFile false
electronize build /target linux /manifest electron.manifest.js /PublishSingleFile false

# For macOS ARM:
electronize build /target custom "osx-arm64;mac" /electron-arch arm64 /manifest electron.manifest.js /PublishSingleFile false

Packaged files can be found in the bin/Desktop folder.

Important

To Build flatpak files the flatpak and flatpak-builder packages need to be installed. On Linux, the /scripts/package-electron.sh script can be used to package the Electron app, in which case packaged files can be found in the /dist/ folder.

See the Electron.NET docs for additional CLI options when packaging the app, and electron-builder for additional configuration options.

Issue Reporting

  • Bug Reports: Include steps to reproduce and environment details.
  • Feature Requests: Clearly describe the feature and why it’s needed.

Documentation Guidelines

Documentation contributions are welcome. And includes in the /docs directory as well as in the README.md and CONTRIBUTING.md files.

  • Don't add images or other media files with excessive size.
  • Use camelCase for directory names.
  • Use Title Case for file names.

Important

The naming conventions mentioned above do not apply for the .NET projects nor the Electron projects. Follow the conventions of the respective technologies.

License

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

Contact

If you have any questions, feel free to open an issue or contact us at our Discord Server

At our Discord, you can find the latest announcements, troubleshooting, ideas and feedback, and more.

Acknowledgments

Thank you for your contributions and helping make  NetPad better!