{"id":30576785,"url":"https://github.com/superwall/supervibes","last_synced_at":"2025-09-01T05:02:16.007Z","repository":{"id":311973508,"uuid":"1044677518","full_name":"superwall/supervibes","owner":"superwall","description":"Vibecode native Swift apps without Xcode","archived":false,"fork":false,"pushed_at":"2025-08-27T21:32:57.000Z","size":322,"stargazers_count":1,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-08-28T04:27:43.903Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/superwall.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-08-26T03:51:03.000Z","updated_at":"2025-08-28T03:31:36.000Z","dependencies_parsed_at":"2025-08-28T04:31:43.133Z","dependency_job_id":"a1871409-a3b2-422e-b221-04d72ae8a5b1","html_url":"https://github.com/superwall/supervibes","commit_stats":null,"previous_names":["superwall/supervibes"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/superwall/supervibes","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/superwall%2Fsupervibes","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/superwall%2Fsupervibes/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/superwall%2Fsupervibes/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/superwall%2Fsupervibes/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/superwall","download_url":"https://codeload.github.com/superwall/supervibes/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/superwall%2Fsupervibes/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":272604078,"owners_count":24963320,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-08-28T02:00:10.768Z","response_time":74,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-08-29T01:45:35.956Z","updated_at":"2025-08-29T01:45:41.098Z","avatar_url":"https://github.com/superwall.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Supervibes ⚡️\n\nAn opinionated Claude Code workflow to build native iOS apps in Swift, mostly without (but definitely alongside) Xcode. Built by [Superwall](https://superwall.com).\n\n```\n   /$$$$$$$\n  /$$__  $$\n | $$  \\__/ /$$   /$$ /$$$$$$$   /$$$$$$  /$$$$$$\n |  $$$$$$ | $$  | $$| $$__  $$ /$$__  $$| $$__  $$\n  \\____  $$| $$  | $$| $$  \\ $$| $$$$$$$$| $$  \\__/\n  /$$  \\ $$| $$  | $$| $$  | $$| $$_____/| $$\n |  $$$$$$/|  $$$$$$/| $$$$$$$/|  $$$$$$$| $$  /$$  /$$|\n  \\______/  \\______/ | $$____/  \\_______/|__/ |__/ | $$|\n                     | $$           /$$    /$$ /$$ | $$$$$$$ | $$$$$$   /$$$$$$$\n                     | $$          |  $$  /$$/| $$ | $$__  $$| $$__  $$ /$$_____/\n                     |__/           \\  $$/$$/ | $$ | $$  \\ $$| $$$$$$$$|  $$$$$$\n                                     \\  $$$/  | $$ | $$  | $$| $$_____/ \\____  $$\n                                      \\  $/   | $$ | $$$$$$$/|  $$$$$$$ /$$$$$$$/\n                                       \\_/    |__/ |_______/  \\_______/|_______/\n\n```\n\n## Features\n\n- 🚀 **Quick Setup** - Generate a complete iOS project in seconds\n- 📱 **Build to Device** - Automatically builds to connected iOS devices\n- 🎨 **SwiftUI Templates** - Modern SwiftUI app structure out of the box\n- 🛠 **Build Scripts** - Scripts for building, running, and testing from the terminal\n- 🧪 **Test Configuration** - Separate schemes for development with unit and UI tests\n- 🎯 **XcodeGen Integration** - Create files outside of Xcode while maintaining interoperability\n- 🤖 **Claude AI Ready** - Battle tested Agents \u0026 CLAUDE.md files\n\n## Quick Install\n\n```bash\ncurl -fsSL https://raw.githubusercontent.com/superwall/supervibes/refs/heads/main/install.sh | bash\n```\n\n## Usage\n\n### Create a new project\n```bash\nsupervibes                 # Interactive mode - prompts for all details\nsupervibes --test          # Quick test mode - uses saved settings\n```\n\n### Regenerate project configuration\n```bash\nsupervibes --init          # Regenerate config from supervibes.local.json\n                          # (preserves source code and assets)\n```\n\n### Maintain Supervibes\n```bash\nsupervibes --update        # Update to latest version\nsupervibes --uninstall     # Remove Supervibes from your system\nsupervibes --help          # Show all available commands\n```\n\n### Working with generated projects\n```bash\ncd YourProject\nscripts/build              # Build the app\nscripts/run                # Build and run on device/simulator\nscripts/install            # Install and launch latest build\nscripts/xcode              # Open in Xcode\nscripts/unit-test          # Run unit tests\nscripts/ui-test            # Run UI tests\n\n# Use flags for different configurations\nscripts/run --debug        # Debug configuration with test support\nscripts/run --simulator    # Target iOS simulator\nscripts/run --debug --simulator  # Combine flags\n```\n\n## Generated Project Structure\n\n```\nprojects/YourProject/\n├── project.yml                 # XcodeGen configuration\n├── YourProject/                # Source code\n│   ├── YourProjectApp.swift   # App entry point\n│   └── ContentView.swift      # Main view\n├── YourProjectTests/           # Unit tests\n├── YourProjectUITests/         # UI tests\n├── scripts/                    # Automation scripts\n│   ├── build               # Build only\n│   ├── run                 # Build and run on device\n│   ├── install             # Install and run latest build\n│   ├── unit-test           # Run unit tests\n│   ├── ui-test             # Run UI tests\n│   └── xcode               # Open project in Xcode\n├── CLAUDE.md                   # Project documentation for Claude AI\n└── .claude/                    # Claude AI configuration\n    └── agents/                 # Specialized AI agents\n```\n\n## Build Scripts\n\nAll scripts are generated in the `scripts/` directory of your project:\n\n| Script      | Description                        | Flags                    |\n| ----------- | ---------------------------------- | ------------------------ |\n| `build`     | Builds the project                 | `--debug`, `--simulator` |\n| `run`       | Builds and runs the app            | `--debug`, `--simulator` |\n| `install`   | Installs and launches latest build | `--debug`, `--simulator` |\n| `unit-test` | Runs unit tests (debug scheme)     | -                        |\n| `ui-test`   | Runs UI tests (debug scheme)       | -                        |\n| `xcode`     | Opens project in Xcode             | -                        |\n\n**Flag descriptions:**\n\n- `--debug` - Uses debug configuration with test support\n- `--simulator` - Targets iOS simulator instead of physical device\n- Flags can be combined: `scripts/run --debug --simulator`\n\n### Prerequisites\n\nBefore using Supervibes, ensure you have all the required tools installed.\n\n**Quick check:** Run our setup checker to see what's missing:\n\n```bash\nsupervibes-check  # After installation\n# or\n~/.supervibes/check-setup.sh  # Direct path\n```\n\n#### Required Tools\n\n#### 1. **Xcode \u0026 Command Line Tools**\n\nMake sure Xcode is installed from the App Store and command line tools are set up:\n\n```bash\nxcode-select --install\n```\n\n#### 2. **Homebrew**\n\nThe package manager for macOS. If not installed:\n\n```bash\n/bin/bash -c \"$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)\"\n```\n\n#### 3. **XcodeGen**\n\nFor generating Xcode projects from YAML specifications:\n\n```bash\nbrew install xcodegen\nxcodegen --version  # Verify installation\n```\n\n#### 4. **SwiftFormat**\n\nFor consistent code formatting across generated projects:\n\n```bash\nbrew install swiftformat\nswiftformat --version  # Verify installation\n```\n\n#### 5. **GitHub CLI**\n\nFor repository operations and pull request management:\n\n```bash\nbrew install gh\ngh auth login  # Follow the prompts to authenticate\n```\n\n#### 6. **Claude Code** (Optional but Recommended)\n\nFor AI-powered development assistance:\n\n```bash\nnpm install -g @anthropic-ai/claude-code\nclaude -v  # Verify installation\n```\n\nIf you don't have npm, install Node.js first:\n\n```bash\nbrew install node\n```\n\n#### 7. **Apple Developer Setup**\n\nYou'll need your Apple Developer Team ID. To find it:\n\n1. Visit https://developer.apple.com/account\n2. Sign in with your Apple ID\n3. Scroll down to \"Membership details\" and copy your Team ID:\n\n```\n┌────────────────────────────────┐\n│       Membership details       │\n├────────────────────────────────┤\n│ Entity name:  Your Company     │\n│ Team ID:      XXXXXXXXXX       │ \u003c- copy this\n│ Entity type:  Organization     │\n└────────────────────────────────┘\n```\n\n## Getting Started\n\nOnce Supervibes is installed, you can use it from any directory:\n\n### Interactive Mode\n\nNavigate to where you want your project and run:\n\n```bash\nsupervibes\n```\n\nYou'll be asked for:\n\n- Project name (lowercase, alphanumeric)\n- Display name\n- Bundle identifier\n- Development Team ID (with visual guide to find it)\n- Device selection (optional, for deployment scripts)\n- Project description (for AI assistance)\n\n### Quick Test Mode\n\nGenerate a test project with a random name using saved settings:\n\n```bash\n./supervibes --test\n```\n\nThis requires running the interactive mode at least once to save your Team ID and device.\n\n### Init Mode\n\nRegenerate project configuration from an existing `supervibes.local.json` file:\n\n```bash\nsupervibes --init\n```\n\nThis mode allows you to:\n- Regenerate all project configuration files (project.yml, scripts, CLAUDE.md, etc.)\n- Preserve your source code files (Swift, assets, tests)\n- Update build settings or fix corrupted configuration\n- Useful when pulling a project from git or sharing projects between developers\n\n### Command Line Options\n\n```bash\nsupervibes [options]\n\nOptions:\n  --test                    # Quick test mode with random project name\n  --projects-dir=PATH       # Specify custom projects directory\n  --init                    # Regenerate project config from supervibes.local.json\n  --update                  # Update Supervibes to latest version\n  --uninstall              # Uninstall Supervibes (with confirmation)\n  --help, -h               # Show help message\n\nExamples:\n  supervibes                # Interactive mode in current directory\n  supervibes --test         # Create test project with random name\n  supervibes --init         # Regenerate project config (preserves source code)\n  supervibes --update       # Update to latest version\n  supervibes --uninstall    # Remove Supervibes from your system\n```\n\n## Configuration\n\n### Schemes\n\nTwo schemes are generated:\n\n1. **Release** (`YourProject`) - Optimized for production\n   - No test targets\n   - Release configuration\n   - Used by default in scripts\n2. **Debug** (`YourProject-debug`) - For development and testing\n   - Includes unit and UI test targets\n   - Debug configuration with symbols\n   - Used with `--debug` flag in scripts\n\n### Saved Settings\n\nYour Team ID and device selection are automatically saved in `supervibes.json` for future use.\n\n### Finding Your Team ID\n\nThe generator shows a visual guide:\n\n```\nVisit https://developer.apple.com/account\nScroll down and copy your Team ID:\n\n┌────────────────────────────────┐\n│       Membership details       │\n├────────────────────────────────┤\n│ Entity name:  Your Company     │\n│ Team ID:      XXXXXXXXXX       │ \u003c- copy this\n└────────────────────────────────┘\n```\n\n## Claude AI Integration\n\nEach project includes:\n\n- **CLAUDE.md** - Project-specific documentation with your project overview\n- **.claude/** - Configuration directory with specialized AI agents\n- Modern Swift development guidelines\n- XcodeGen documentation integration\n\n## Acknowledgments\n\nSupervibes stands on the shoulders of giants. Special thanks to:\n\n- **[XcodeGen](https://github.com/yonaskolb/XcodeGen)** by Yonas Kolb - The foundation of our project generation\n- **[SwiftFormat](https://github.com/nicklockwood/SwiftFormat)** by Nick Lockwood - Keeping our code beautifully formatted\n- **[Claude Code](https://claude.ai/code)** by Anthropic - AI-powered development assistance\n\n## Contributing\n\nThis is an internal Superwall tool (for now)! Please implement the features you think are necessary for launch.\n\n## License\n\nPrivate repository - Superwall internal use only.\n\n## Development Setup\n\nIf you want to contribute to Supervibes or run the development version:\n\n```bash\n# Clone the repository\ngit clone https://github.com/superwall/supervibes.git\ncd supervibes\n\n# Run the development setup\n./setup-dev.sh\n```\n\nThis creates `supervibes-dev` command that runs from your development directory.\n\n## Uninstall\n\nTo remove Supervibes:\n\n```bash\nrm -rf ~/.supervibes ~/.local/bin/supervibes\n```\n\nFor development version:\n\n```bash\nrm -rf ~/.supervibes-dev ~/.local/bin/supervibes-dev\n```\n\n---\n\nBuilt with 💙 by [Superwall](https://superwall.com)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsuperwall%2Fsupervibes","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsuperwall%2Fsupervibes","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsuperwall%2Fsupervibes/lists"}