{"id":19404210,"url":"https://github.com/p32929/duas","last_synced_at":"2026-05-06T09:43:53.600Z","repository":{"id":105972337,"uuid":"565419084","full_name":"p32929/duas","owner":"p32929","description":"A collection of duas I try to regularly recite","archived":false,"fork":false,"pushed_at":"2022-11-18T12:48:47.000Z","size":9353,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-01-07T12:47:21.529Z","etag":null,"topics":["android","arabic","dua","duas","easy","easy-to-use","english","flutter","invocations","ios","meaning","mobile","p32929","source","supplications","web"],"latest_commit_sha":null,"homepage":"https://p32929.github.io/duas/","language":"C++","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/p32929.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}},"created_at":"2022-11-13T10:59:10.000Z","updated_at":"2022-11-13T13:30:41.000Z","dependencies_parsed_at":null,"dependency_job_id":"5d81ffd5-b26d-456c-8b8e-601c0744b907","html_url":"https://github.com/p32929/duas","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/p32929%2Fduas","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/p32929%2Fduas/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/p32929%2Fduas/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/p32929%2Fduas/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/p32929","download_url":"https://codeload.github.com/p32929/duas/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":240581402,"owners_count":19824138,"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","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":["android","arabic","dua","duas","easy","easy-to-use","english","flutter","invocations","ios","meaning","mobile","p32929","source","supplications","web"],"created_at":"2024-11-10T11:33:35.456Z","updated_at":"2026-05-06T09:43:53.594Z","avatar_url":"https://github.com/p32929.png","language":"C++","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Duas\n\nA collection of duas I try to regularly recite. This is a web application built with Flutter that displays Islamic supplications with their translations and sources.\n\n## Features\n\n- Clean, modern interface\n- Arabic text with proper font support\n- Translations and sources\n- Dark theme for better readability\n- Responsive design\n- Easy to customize and deploy\n\n## Quick Start\n\n### Prerequisites\n\n1. Install Flutter:\n   - Download Flutter SDK from [flutter.dev](https://flutter.dev/docs/get-started/install)\n   - Add Flutter to your PATH\n   - Run `flutter doctor` to verify installation\n\n2. Install Node.js and npm:\n   - Download from [nodejs.org](https://nodejs.org/)\n   - Verify installation:\n     ```bash\n     node --version\n     npm --version\n     ```\n\n3. Install Git:\n   - Download from [git-scm.com](https://git-scm.com/downloads)\n   - Verify installation:\n     ```bash\n     git --version\n     ```\n\n### Installation\n\n1. Fork this repository\n2. Clone your fork:\n   ```bash\n   git clone https://github.com/YOUR_USERNAME/duas.git\n   cd duas\n   ```\n\n3. Install dependencies:\n   ```bash\n   flutter pub get\n   npm install\n   ```\n\n### Running Locally\n\n```bash\nflutter run -d chrome\n```\n\n## Adding Your Own Duas\n\n1. Create a JSON file with your duas following this structure:\n   ```json\n   [\n     {\n       \"arabic\": \"Arabic text of the dua\",\n       \"source\": \"Source/reference of the dua\",\n       \"meaning\": \"Translation/meaning of the dua\"\n     }\n   ]\n   ```\n\n2. Host your JSON file using one of these CORS-friendly options:\n   - Option 1: npoint.io (recommended)\n     1. Go to [npoint.io](https://www.npoint.io)\n     2. Create a new JSON document\n     3. Copy the provided URL\n\n3. Update the API endpoint:\n   - Open `lib/utils/apis.dart`\n   - Replace the URL in the `getDuas()` method with your JSON URL\n\n## Customization\n\n### Changing Theme\nEdit `lib/main.dart` and modify the `ThemeData` in the `MaterialApp` widget.\n\n### Changing Fonts\nEdit `lib/widgets/dua_item.dart` and modify the `GoogleFonts` widget.\n\n### Updating App Title\nEdit `web/index.html` and change the `\u003ctitle\u003e` tag.\n\n## Deployment\n\n### GitHub Pages Deployment\n\n1. Update `package.json`:\n   - Change the repository URL to your fork\n   - Update the base href in the predeploy script if needed\n\n2. Deploy:\n   ```bash\n   npm run deploy\n   ```\n\n3. Your app will be available at: `https://[your-username].github.io/duas/`\n\n### Custom Domain Deployment\n\n1. Build the app:\n   ```bash\n   flutter build web\n   ```\n\n2. Deploy the contents of the `build/web` directory to your hosting service\n\n## Troubleshooting\n\n### Common Issues\n\n1. **CORS Issues**:\n   - Ensure your JSON hosting service allows CORS\n   - Use a CORS proxy if needed\n\n2. **Build Issues**:\n   - Clear build cache:\n     ```bash\n     flutter clean\n     flutter pub get\n     ```\n\n3. **Deployment Issues**:\n   - Check GitHub Pages settings\n   - Verify repository name matches package.json\n   - Check base href configuration\n\n## Support\n\nIf you encounter any issues:\n1. Check the [Flutter documentation](https://flutter.dev/docs)\n2. Open an issue in the repository\n3. Check the troubleshooting section above\n\n## License\n\nThis project is licensed under the MIT License - see the LICENSE file for details.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fp32929%2Fduas","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fp32929%2Fduas","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fp32929%2Fduas/lists"}