{"id":48031445,"url":"https://github.com/magicappdev/templates","last_synced_at":"2026-04-04T13:55:36.390Z","repository":{"id":334451176,"uuid":"1141380288","full_name":"magicappdev/templates","owner":"magicappdev","description":null,"archived":false,"fork":false,"pushed_at":"2026-01-24T20:40:06.000Z","size":6695,"stargazers_count":0,"open_issues_count":10,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-01-25T08:58:32.678Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/magicappdev.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"github":["involvex"],"custom":["https://buymeacoffee.com/involvex","https://paypal.me/involvex","https://rewards.bing.com/welcome?rh=14525F68\u0026ref=rafsrchae\u0026form=ML2XE3\u0026OCID=ML2XE3\u0026PUBL=RewardsDO\u0026CREA=ML2XE3"]}},"created_at":"2026-01-24T18:50:04.000Z","updated_at":"2026-01-24T20:40:09.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/magicappdev/templates","commit_stats":null,"previous_names":["magicappdev/templates"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/magicappdev/templates","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/magicappdev%2Ftemplates","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/magicappdev%2Ftemplates/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/magicappdev%2Ftemplates/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/magicappdev%2Ftemplates/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/magicappdev","download_url":"https://codeload.github.com/magicappdev/templates/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/magicappdev%2Ftemplates/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31402276,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-04T10:20:44.708Z","status":"ssl_error","status_checked_at":"2026-04-04T10:20:06.846Z","response_time":60,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":"2026-04-04T13:55:36.286Z","updated_at":"2026-04-04T13:55:36.382Z","avatar_url":"https://github.com/magicappdev.png","language":"TypeScript","funding_links":["https://github.com/sponsors/involvex","https://buymeacoffee.com/involvex","https://paypal.me/involvex","https://rewards.bing.com/welcome?rh=14525F68\u0026ref=rafsrchae\u0026form=ML2XE3\u0026OCID=ML2XE3\u0026PUBL=RewardsDO\u0026CREA=ML2XE3"],"categories":[],"sub_categories":[],"readme":"# MagicAppDev Monorepo\n\n![License](https://img.shields.io/badge/license-MIT-blue.svg)\n![Version](https://img.shields.io/badge/version-0.0.0-orange.svg)\n\nA comprehensive monorepo-based fullstack app building platform inspired by Expo, utilizing Turborepo for efficient monorepo management. MagicAppDev enables rapid development, customization, and deployment of apps across web and mobile platforms.\n\n## Table of Contents\n\n- [Project Title \u0026 Brief Description](#project-title--brief-description)\n- [Key Features](#key-features)\n- [Installation \u0026 Setup](#installation--setup)\n- [Usage \u0026 Examples](#usage--examples)\n- [Configuration \u0026 Customization](#configuration--customization)\n- [Project Structure](#project-structure)\n- [API Documentation](#api-documentation)\n- [Contributing Guidelines](#contributing-guidelines)\n- [Testing](#testing)\n- [Deployment](#deployment)\n- [Troubleshooting \u0026 FAQ](#troubleshooting--faq)\n- [License \u0026 Attribution](#license--attribution)\n- [Roadmap \u0026 Future Plans](#roadmap--future-plans)\n- [Contact \u0026 Support](#contact--support)\n\n## Project Title \u0026 Brief Description\n\n**MagicAppDev** is a monorepo-based fullstack app building platform designed to streamline the development, customization, and deployment of web and mobile applications. It leverages Turborepo for efficient monorepo management and provides a suite of tools, including a CLI, web interface, mobile app, API, and database services.\n\n### Target Audience\n\n- Developers looking to rapidly build and deploy fullstack applications.\n- Teams requiring a scalable and customizable platform for app development.\n- Organizations needing seamless integration with AI-powered tools for code generation and error fixing.\n\n## Key Features\n\n- **Monorepo Structure**: Utilizes Turborepo with pnpm for package management, including local/remote caching, TypeScript, and Node.js/JS as preferred languages.\n- **CLI Tool**: Generate and manage app code, components, and packages with ease.\n- **Web Interface**: Interactive AI chat for app creation, hot reload preview, and prompt suggestions.\n- **Mobile App**: React Native-based app with interactive AI chat (SSE streaming), deep link authentication, and cross-platform component sharing.\n- **API \u0026 Database**: High-performance backend on Cloudflare Workers/D1 with integrated AI model routing and provider support.\n- **AI Integration**: Real-time streaming AI chat using Cloudflare Workers AI (Llama 3.1).\n- **Extensibility**: Highly customizable with plugins and good debugging utilities.\n\n## Installation \u0026 Setup\n\n### Prerequisites\n\n- Node.js (v18 or higher)\n- pnpm (v8 or higher)\n- Git\n\n### Step-by-Step Installation\n\n1. **Clone the Repository**:\n\n   ```bash\n   git clone https://github.com/magicappdev/magicappdev.git\n   cd magicappdev\n   ```\n\n2. **Install Dependencies**:\n\n   ```bash\n   pnpm install\n   ```\n\n3. **Set Up Environment Variables**:\n\n   Create a `.env` file in the root directory and add the necessary environment variables. Refer to the [Configuration \u0026 Customization](#configuration--customization) section for details.\n\n4. **Build the Project**:\n\n   ```bash\n   pnpm run build\n   ```\n\n### OS-Specific Notes\n\n- **Windows**: Ensure that you have the latest version of Node.js and pnpm installed. Use PowerShell or Git Bash for running commands.\n- **macOS/Linux**: Ensure that your system has the necessary permissions for installing global packages and running scripts.\n\n## Usage \u0026 Examples\n\n### CLI Tool\n\nThe CLI tool, `npx create-magicappdev-app`, allows you to generate and manage app code, components, and packages. Here are some examples:\n\n- **Generate a New App**:\n\n  ```bash\n  npx create-magicappdev-app my-app\n  ```\n\n- **Generate a Component**:\n\n  ```bash\n  npx create-magicappdev-app generate component my-component\n  ```\n\n- **Run Doctor Command for Diagnostics**:\n\n  ```bash\n  npx create-magicappdev-app doctor\n  ```\n\n### Web Interface\n\nThe web interface is hosted at `*.magicappdev.workers.dev` (Cloudflare Workers). It provides an interactive AI chat for app creation, hot reload preview, and prompt suggestions.\n\n### Mobile App\n\nThe mobile app is built using React Native and mirrors the features of the web interface. It includes optional packages like DevTools, Reanimated, Expo, Metro, and test setups.\n\n## Configuration \u0026 Customization\n\n### Environment Variables\n\nCreate a `.env` file in the root directory and add the following environment variables:\n\n```env\nNODE_ENV=development\nAPI_KEY=your_api_key_here\nDATABASE_URL=your_database_url_here\n```\n\n### Settings\n\n- **CLI Settings**: Configure the CLI tool by modifying the `packages/cli/src/config.ts` file.\n- **Web Interface Settings**: Configure the web interface by modifying the `apps/web/src/config.ts` file.\n- **Mobile App Settings**: Configure the mobile app by modifying the `apps/mobile/src/config.ts` file.\n\n## Project Structure\n\n```plaintext\nmagicappdev/\n├── .github/\n├── .vscode/\n├── apps/\n│   ├── web/\n│   └── mobile/\n├── packages/\n│   ├── cli/\n│   ├── api/\n│   ├── database/\n│   ├── shared/\n│   └── templates/\n├── docs/\n├── scripts/\n├── package.json\n├── pnpm-workspace.yaml\n└── README.md\n```\n\n### Key Directories and Files\n\n- **`apps/web`**: Next.js-based web interface.\n- **`apps/mobile`**: React Native-based mobile app.\n- **`packages/cli`**: CLI tool for generating and managing app code.\n- **`packages/api`**: API for backend services.\n- **`packages/database`**: Database integration.\n- **`packages/shared`**: Shared utilities and types.\n- **`packages/templates`**: Templates for generating components and apps.\n\n## API Documentation\n\n### Endpoints\n\n- **`GET /api/projects`**: Retrieve a list of projects.\n- **`POST /api/projects`**: Create a new project.\n- **`GET /api/projects/:id`**: Retrieve a specific project.\n- **`PUT /api/projects/:id`**: Update a specific project.\n- **`DELETE /api/projects/:id`**: Delete a specific project.\n\n### Request/Response Examples\n\n- **Create a Project**:\n\n  ```bash\n  curl -X POST https://api.magicappdev.workers.dev/projects \\\n    -H \"Content-Type: application/json\" \\\n    -d '{\"name\": \"my-project\", \"description\": \"A new project\"}'\n  ```\n\n  **Response**:\n\n  ```json\n  {\n    \"id\": \"123\",\n    \"name\": \"my-project\",\n    \"description\": \"A new project\"\n  }\n  ```\n\n### Authentication\n\nAuthentication is handled via GitHub OAuth.\n\n1. **Web/Mobile**: Use the \"Continue with GitHub\" button to authenticate.\n2. **CLI**: Run `magicappdev auth login` to authenticate your local environment.\n\nThe system uses JWT for session management and stores profiles in Cloudflare D1.\n\n## Contributing Guidelines\n\n### Submitting Issues\n\n1. **Search Existing Issues**: Before submitting a new issue, search the [issue tracker](https://github.com/magicappdev/magicappdev/issues) to ensure it hasn't been reported already.\n2. **Create a New Issue**: If the issue doesn't exist, create a new one with a clear title and description.\n\n### Submitting Pull Requests\n\n1. **Fork the Repository**: Fork the repository and create a new branch for your changes.\n2. **Make Changes**: Implement your changes and ensure they adhere to the coding standards.\n3. **Test Your Changes**: Run the test suite to ensure your changes don't break existing functionality.\n4. **Submit a Pull Request**: Submit a pull request with a clear title and description of your changes.\n\n### Coding Standards\n\n- Follow the existing code style and conventions.\n- Use TypeScript for type safety.\n- Write clear and concise commit messages.\n\n### Testing Protocols\n\n- Ensure all tests pass before submitting a pull request.\n- Write new tests for any new functionality.\n- Update existing tests if necessary.\n\n## Testing\n\n### Running Tests\n\n1. **Unit Tests**:\n\n   ```bash\n   pnpm run test:unit\n   ```\n\n2. **Integration Tests**:\n\n   ```bash\n   pnpm run test:integration\n   ```\n\n3. **End-to-End Tests**:\n\n   ```bash\n   pnpm run test:e2e\n   ```\n\n### Expected Outcomes\n\n- All tests should pass without errors.\n- Code coverage should meet the minimum threshold.\n\n## Deployment\n\nMagicAppDev is designed for Cloudflare.\n\n### API \u0026 Database\n\n```bash\ncd packages/api\npnpm run deploy\n```\n\n### Web Application\n\n```bash\ncd apps/web\npnpm run deploy\n```\n\n### Docker Deployment\n\n1. **Build the Docker Image**:\n\n   ```bash\n   docker build -t magicappdev .\n   ```\n\n2. **Run the Docker Container**:\n\n   ```bash\n   docker run -p 3000:3000 magicappdev\n   ```\n\n### Nx Workspace Sync\n\nIf you encounter \"workspace out of sync\" errors, run:\n\n```bash\npnpm nx sync\n```\n\n## Troubleshooting \u0026 FAQ\n\n### Common Pitfalls\n\n- **Dependency Issues**: Ensure all dependencies are installed correctly. Run `pnpm install` if you encounter dependency-related errors.\n- **Environment Variables**: Double-check your `.env` file for missing or incorrect environment variables.\n- **Build Errors**: Ensure your code adheres to the project's coding standards and TypeScript types.\n\n### Error Messages and Solutions\n\n- **`Error: Missing API Key`**: Ensure your `.env` file includes a valid `API_KEY`.\n- **`Error: Database Connection Failed`**: Verify your `DATABASE_URL` in the `.env` file.\n- **`Error: Build Failed`**: Check the console output for specific errors and address them accordingly.\n\n### FAQ\n\n**Q: How do I update the CLI tool?**\n\nA: Run `pnpm update` to update all dependencies, including the CLI tool.\n\n**Q: Can I use MagicAppDev with other package managers?**\n\nA: MagicAppDev is optimized for pnpm, but you can use other package managers like npm or yarn with some adjustments.\n\n**Q: How do I contribute to the project?**\n\nA: Follow the [Contributing Guidelines](#contributing-guidelines) section for detailed instructions.\n\n## License \u0026 Attribution\n\n### License\n\nMagicAppDev is licensed under the [MIT License](LICENSE).\n\n### Attribution\n\n- **Turborepo**: For efficient monorepo management.\n- **pnpm**: For fast and disk-space-efficient package management.\n- **Next.js**: For the web interface.\n- **React Native**: For the mobile app.\n- **Cloudflare**: For API and database hosting.\n\n## Roadmap \u0026 Future Plans\n\n### Upcoming Features\n\n- **Plugin System**: Enhance extensibility with a plugin system.\n- **Additional Templates**: Add more templates for generating components and apps.\n- **Improved AI Integration**: Enhance AI-powered code generation and error fixing.\n\n### Milestones\n\n- **v1.0.0**: Initial release with core features.\n- **v2.0.0**: Enhanced plugin system and additional templates.\n- **v3.0.0**: Improved AI integration and performance optimizations.\n\n### Known Limitations\n\n- **Windows Support**: Some features may not work as expected on Windows due to path and permission issues.\n- **Mobile App**: The mobile app is currently in beta and may have some bugs.\n\n## Contact \u0026 Support\n\n### Issue Tracker\n\nFor bug reports and feature requests, please use the [issue tracker](https://github.com/magicappdev/magicappdev/issues).\n\n### Community Channels\n\n- **Discord**: Join our [Discord server](https://discord.gg/magicappdev) for community support and discussions.\n- **Slack**: Join our [Slack workspace](https://slack.magicappdev.com) for team collaboration.\n\n### Maintainer Contact\n\nFor direct inquiries, you can contact the maintainer at [involvex](https://github.com/involvex).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmagicappdev%2Ftemplates","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmagicappdev%2Ftemplates","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmagicappdev%2Ftemplates/lists"}