|
| 1 | +# GitHub Template Setup |
| 2 | + |
| 3 | +This repository is configured as a GitHub template. |
| 4 | + |
| 5 | +## How to Use |
| 6 | + |
| 7 | +### Option 1: Using `bun create` (Recommended) |
| 8 | +```bash |
| 9 | +bun create somus/create-tauri-react-app my-app |
| 10 | +cd my-app |
| 11 | +bun tauri dev |
| 12 | +``` |
| 13 | + |
| 14 | +### Option 2: GitHub "Use this template" button |
| 15 | +1. Click the green "Use this template" button on the repository page |
| 16 | +2. Select "Create a new repository" |
| 17 | +3. Choose your account/organization and repository name |
| 18 | +4. Clone your new repository |
| 19 | +5. Run `bun install` (the setup script will run automatically) |
| 20 | + |
| 21 | +### Option 3: Using degit |
| 22 | +```bash |
| 23 | +# Using bun |
| 24 | +bunx degit somus/create-tauri-react-app my-app |
| 25 | +cd my-app |
| 26 | +bun install |
| 27 | + |
| 28 | +# Using npm |
| 29 | +npx degit somus/create-tauri-react-app my-app |
| 30 | +cd my-app |
| 31 | +npm install |
| 32 | + |
| 33 | +# Using pnpm |
| 34 | +pnpm dlx degit somus/create-tauri-react-app my-app |
| 35 | +cd my-app |
| 36 | +pnpm install |
| 37 | +``` |
| 38 | + |
| 39 | +## What happens after cloning |
| 40 | + |
| 41 | +The `postinstall` script automatically runs an interactive setup (`scripts/setup.ts`) which: |
| 42 | + |
| 43 | +1. **Prompts for project information**: |
| 44 | + - Project name |
| 45 | + - Product name (display name) |
| 46 | + - GitHub username or organization |
| 47 | + - Bundle identifier (e.g., `com.username.appname`) |
| 48 | + - Author name |
| 49 | + - Description |
| 50 | + |
| 51 | +2. **Prompts for AI agent configuration**: |
| 52 | + - Multi-select from 27+ supported agents (claude, cursor, copilot, opencode, etc.) |
| 53 | + - Agents are ordered by popularity for easy selection |
| 54 | + - No agents are pre-selected by default |
| 55 | + |
| 56 | +3. **Prompts for build configuration**: |
| 57 | + - Select target platforms for releases (macOS ARM64/Intel, Windows, Linux) |
| 58 | + - Enable code signing options (macOS notarization, Windows signing) |
| 59 | + - Customizes `.github/workflows/publish.yml` based on selections |
| 60 | + |
| 61 | +4. **Automatically sets up development environment**: |
| 62 | + - Initializes a git repository (if not already in one) |
| 63 | + - Updates `.ruler/ruler.toml` with selected agents |
| 64 | + - Runs `ruler apply` to configure AI agent instructions |
| 65 | + - Installs Lefthook git hooks for pre-commit checks |
| 66 | + |
| 67 | +5. **Skips silently on subsequent installs** (detects if already configured) |
| 68 | + |
| 69 | +## Supported AI Agents |
| 70 | + |
| 71 | +The setup script supports configuration for these AI coding agents (ordered by popularity): |
| 72 | + |
| 73 | +**Popular**: claude, cursor, copilot, opencode, windsurf, cline, zed |
| 74 | + |
| 75 | +**Mid-tier**: aider, amp, codex, gemini-cli, goose, kiro, roo |
| 76 | + |
| 77 | +**Others**: agentsmd, amazonqcli, antigravity, augmentcode, crush, firebase, firebender, jules, junie, kilocode, openhands, qwen, trae, warp |
| 78 | + |
| 79 | +## Release Automation |
| 80 | + |
| 81 | +This template includes GitHub Actions workflows for automated releases: |
| 82 | + |
| 83 | +### Workflows |
| 84 | + |
| 85 | +- **release-please.yml** - Automatically creates Release PRs with version bumps and changelog updates when you push conventional commits to `main` |
| 86 | +- **publish.yml** - Builds the app for all selected platforms and creates a draft GitHub Release when a Release PR is merged |
| 87 | + |
| 88 | +### Release Process |
| 89 | + |
| 90 | +1. Push conventional commits to `main` (`feat:`, `fix:`, etc.) |
| 91 | +2. Review and merge the auto-generated Release PR |
| 92 | +3. Review and publish the draft GitHub Release |
| 93 | + |
| 94 | +### Setup Required Before First Release |
| 95 | + |
| 96 | +1. Generate an updater keypair: `bun tauri signer generate -w ~/.tauri/myapp.key` |
| 97 | +2. Update `src-tauri/tauri.conf.json` with your public key and GitHub repo URL |
| 98 | +3. Add secrets to GitHub repository settings: |
| 99 | + - `TAURI_SIGNING_PRIVATE_KEY` |
| 100 | + - `TAURI_SIGNING_PRIVATE_KEY_PASSWORD` |
| 101 | + - (Optional) macOS code signing secrets for notarization |
| 102 | + |
| 103 | +See [.ruler/RELEASING.md](../.ruler/RELEASING.md) for detailed documentation. |
| 104 | + |
| 105 | +## Repository Settings |
| 106 | + |
| 107 | +To mark this as a template repository on GitHub: |
| 108 | +1. Go to repository Settings |
| 109 | +2. Under "General", check "Template repository" |
0 commit comments