Publish a safety-first Arduino learning course

.github/ISSUE_TEMPLATE/bug.yml

@@ -0,0 +1,32 @@
+name: Sketch bug
+description: Report a reproducible sketch or documentation error.
+title: "[Bug]: "
+labels: ["bug"]
+body:
+  - type: input
+    id: lesson
+    attributes:
+      label: Lesson and sketch
+      placeholder: Exercise B / exercise-b-multi-led-pattern.ino
+    validations:
+      required: true
+  - type: input
+    id: environment
+    attributes:
+      label: Board and core version
+      placeholder: Arduino Uno / Arduino AVR Boards 1.8.6
+    validations:
+      required: true
+  - type: textarea
+    id: circuit
+    attributes:
+      label: Circuit and power details
+      description: For motor exercises, include the driver and supply ratings.
+    validations:
+      required: true
+  - type: textarea
+    id: reproduction
+    attributes:
+      label: Reproduction and observed behavior
+    validations:
+      required: true

.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,5 @@
+blank_issues_enabled: false
+contact_links:
+  - name: Private security report
+    url: https://github.com/devkyato/Arduino-Programs-Guide/security/advisories/new
+    about: Report software vulnerabilities privately.

.github/ISSUE_TEMPLATE/lesson.yml

@@ -0,0 +1,23 @@
+name: Lesson improvement
+description: Propose a clearer explanation, test, diagram, or challenge.
+title: "[Lesson]: "
+labels: ["documentation"]
+body:
+  - type: input
+    id: lesson
+    attributes:
+      label: Lesson
+    validations:
+      required: true
+  - type: textarea
+    id: confusion
+    attributes:
+      label: What is unclear or missing?
+    validations:
+      required: true
+  - type: textarea
+    id: proposal
+    attributes:
+      label: Proposed improvement
+    validations:
+      required: true

.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,14 @@
+## Learning outcome
+
+<!-- What becomes safer, clearer, or more useful for a student? -->
+
+## Verification
+
+- [ ] Changed sketches compile for Arduino Uno
+- [ ] Matching lesson documentation is updated
+- [ ] No blocking delay was added to interactive behavior
+- [ ] Hardware/power details are included when applicable
+
+## Hardware tested
+
+<!-- Board, core, driver, supply, wiring, or "Not hardware-tested". -->

.github/dependabot.yml

@@ -0,0 +1,9 @@
+version: 2
+updates:
+  - package-ecosystem: github-actions
+    directory: /
+    schedule:
+      interval: monthly
+    groups:
+      actions:
+        patterns: ["*"]

.github/workflows/compile.yml

@@ -0,0 +1,37 @@
+name: Sketch compilation
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+jobs:
+  compile-uno:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v7
+      - uses: arduino/compile-sketches@v1
+        with:
+          fqbn: arduino:avr:uno
+          libraries: "[]"
+          sketch-paths: |
+            - exercises
+            - extras
+          enable-warnings-report: true
+
+  offline-package:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v7
+      - uses: actions/setup-python@v7
+        with:
+          python-version: "3.14"
+      - run: python tools/build_release.py
+      - uses: actions/upload-artifact@v6
+        with:
+          name: Arduino-Programs-Guide
+          path: dist/*.zip

.github/workflows/release.yml

@@ -0,0 +1,25 @@
+name: Release
+
+on:
+  push:
+    tags: ["v*"]
+
+permissions:
+  contents: write
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v7
+      - uses: actions/setup-python@v7
+        with:
+          python-version: "3.14"
+      - name: Verify tag
+        shell: bash
+        run: test "$GITHUB_REF_NAME" = "v$(cat VERSION)"
+      - run: python tools/build_release.py
+      - name: Publish release
+        env:
+          GH_TOKEN: ${{ github.token }}
+        run: gh release create "$GITHUB_REF_NAME" dist/*.zip --generate-notes --verify-tag

.gitignore

@@ -0,0 +1,7 @@
+.vscode/
+build/
+dist/
+*.hex
+*.elf
+*.bin
+*.map

CHANGELOG.md

@@ -0,0 +1,10 @@
+# Changelog
+
+## [1.0.0] - 2026-07-29
+
+- Turn the sketch collection into a six-lesson learning path.
+- Add wiring, safety, serial-control, troubleshooting, and lesson documentation.
+- Refactor every sketch to remain responsive without blocking pattern delays.
+- Add official Arduino Uno compilation checks and contributor templates.
+
+[1.0.0]: https://github.com/devkyato/Arduino-Programs-Guide/releases/tag/v1.0.0

CODE_OF_CONDUCT.md

@@ -0,0 +1,13 @@
+# Code of Conduct
+
+This project is a learning space. Be patient, specific, and constructive. Welcome
+beginner questions, explain corrections without ridicule, and respect different
+backgrounds and experience levels.
+
+Harassment, discriminatory language, personal attacks, and publishing private
+information are not acceptable. Report problems privately through the
+maintainer's GitHub profile. Maintainers may remove content or restrict
+participation to protect the community.
+
+This policy is adapted from the
+[Contributor Covenant 2.1](https://www.contributor-covenant.org/version/2/1/code_of_conduct/).

CONTRIBUTING.md

@@ -0,0 +1,30 @@
+# Contributing
+
+## Choose a contribution
+
+Look for issues labeled `good first issue`, `documentation`, or `hardware`. If a
+change alters a pin map, command, or learning objective, open an issue first.
+
+## Verify your work
+
+- Compile every changed sketch for Arduino Uno.
+- Test hardware changes with the exact circuit described in the pull request.
+- Keep `loop()` responsive; do not add long `delay()` calls.
+- Update the matching lesson when behavior or wiring changes.
+- Never recommend powering a motor directly from GPIO or the USB 5 V rail.
+
+Install Arduino CLI and run:
+
+```sh
+arduino-cli core update-index
+arduino-cli core install arduino:avr
+arduino-cli compile --fqbn arduino:avr:uno exercises/exercise-a-arrow-controller
+```
+
+CI recursively compiles all exercise and extra sketches.
+
+## Pull requests
+
+Keep the change focused, explain what a student learns from it, and list the
+board, core version, power source, and driver used for any hardware test.
+Participation is governed by the [Code of Conduct](CODE_OF_CONDUCT.md).

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 devkyato
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.