Note: Prior to reaching v0.1.0, this is a work in progress. The API is incomplete, and breaking changes can occur frequently across versions.

Safe binding for the Playdate SDK C-API that:

1. Is easy to use and well documented.
2. Designed with memory safety in mind.

Only works on Linux/macOS with the playdate simulator for now.

1. Ensure that the environment variable PLAYDATE_SDK_PATH is correctly set.
   • Skip this step on macOS, as the crate will automatically find the SDK by checking the default installation location.
2. Install the CLI tool: cargo install playdate-cli
3. Create a new project: cargo playdate new hello-world
4. Run the project: cd hello-world && cargo playdate run

Please refer to Playdate CLI docs for all the available CLI commands.

The cargo playdate build command will automatically create a target/<profile>/<package_name>.pdx folder that can run on the simulator. For the device build, it will be located at target/thumbv7em-none-eabihf/<profile>/<package_name>.pdx.

Please put all assets files under the assets folder in the project's root directory (the folder containing Cargo.toml). The CLI will automatically copy all contents to the .pdx folder. All supported resources will be transformed by the pdc compiler.

For more details, please refer to the examples/hello-world project.