{"id":30118616,"url":"https://github.com/codesign-cloud/cdc-browser-plugin-starterkit","last_synced_at":"2026-04-20T13:04:58.722Z","repository":{"id":308171759,"uuid":"1031880517","full_name":"codesign-cloud/cdc-browser-plugin-starterkit","owner":"codesign-cloud","description":"Starterkit with Preact and Tailwind for Chrome/Firefox/Edge/Tor and compatible Browser Plugins/Add-Ons","archived":false,"fork":false,"pushed_at":"2025-08-04T15:23:16.000Z","size":88,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2025-08-04T17:37:36.044Z","etag":null,"topics":["browser-addon","browser-extension","chrome","chrome-extension","edge","edge-extension","firefox","firefox-addon","plugin","tor","tor-browser"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","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/codesign-cloud.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-04T13:21:19.000Z","updated_at":"2025-08-04T15:23:20.000Z","dependencies_parsed_at":"2025-08-04T17:49:58.923Z","dependency_job_id":null,"html_url":"https://github.com/codesign-cloud/cdc-browser-plugin-starterkit","commit_stats":null,"previous_names":["codesign-cloud/cdc-browser-plugin-starterkit"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/codesign-cloud/cdc-browser-plugin-starterkit","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codesign-cloud%2Fcdc-browser-plugin-starterkit","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codesign-cloud%2Fcdc-browser-plugin-starterkit/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codesign-cloud%2Fcdc-browser-plugin-starterkit/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codesign-cloud%2Fcdc-browser-plugin-starterkit/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/codesign-cloud","download_url":"https://codeload.github.com/codesign-cloud/cdc-browser-plugin-starterkit/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codesign-cloud%2Fcdc-browser-plugin-starterkit/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32048446,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-20T11:35:06.609Z","status":"ssl_error","status_checked_at":"2026-04-20T11:34:48.899Z","response_time":94,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: 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":["browser-addon","browser-extension","chrome","chrome-extension","edge","edge-extension","firefox","firefox-addon","plugin","tor","tor-browser"],"created_at":"2025-08-10T12:01:12.869Z","updated_at":"2026-04-20T13:04:58.707Z","avatar_url":"https://github.com/codesign-cloud.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Preact + Tailwind CSS Starter Kit (TypeScript)\n\nA lightweight starter kit for building web applications and browser extensions with Preact and Tailwind CSS in TypeScript, optimized for Firefox, Chrome, Edge, and Tor Browser.\n\n![Screenshot](assets/screenshot.png)\n\n## Features\n\n- ⚡️ [Preact](https://preactjs.com/) - Fast 3kB alternative to React with the same modern API\n- 🎨 [Tailwind CSS](https://tailwindcss.com/) - Utility-first CSS framework\n- 🚀 [Vite](https://vitejs.dev/) - Lightning fast build tool\n- 🔄 Hot Module Replacement (HMR)\n- 📦 Optimized builds for production\n- 🌐 Cross-browser support (Firefox, Chrome, Edge, Tor Browser)\n- 🔌 Browser extension support with automated packaging\n- 📘 TypeScript support\n- 🔒 Privacy-focused (Tor Browser compatible)\n\n## Getting Started\n\n### Prerequisites\n\n- Node.js (version 14 or higher)\n- npm or yarn\n\n### Installation\n\n1. Clone this repository:\n\n   ```bash\n   git clone \u003crepository-url\u003e\n   ```\n\n2. Navigate to the project directory:\n\n   ```bash\n   cd preact-tailwind-starterkit\n   ```\n\n3. Install dependencies:\n\n   ```bash\n   npm install\n   # or\n   yarn install\n   ```\n\n### Development\n\n#### Web Application Development\n\nStart the development server:\n\n```bash\nnpm run dev\n# or\nyarn dev\n```\n\nThe application will be available at `http://localhost:5173` (or the next available port).\n\n#### Browser Extension Development\n\nFor browser extension development, use browser-specific commands:\n\n```bash\n# Firefox\nnpm run dev:firefox\n\n# Chrome (also works for Opera, Brave, Vivaldi, etc.)\nnpm run dev:chrome\n\n# Edge\nnpm run dev:edge\n\n# Tor Browser\nnpm run dev:tor\n```\n\nSee [README_BROWSER.md](README_BROWSER.md) for detailed browser extension setup instructions.\n\n### Building for Production\n\n#### Web Application Build\n\nCreate a production build:\n\n```bash\nnpm run build\n# or\nyarn build\n```\n\nPreview the production build:\n\n```bash\nnpm run preview\n# or\nyarn preview\n```\n\n#### Browser Extension Build\n\nCreate browser extension packages:\n\n```bash\n# Single browser\nnpm run release:firefox\nnpm run release:chrome\nnpm run release:edge\nnpm run release:tor\n\n# All browsers at once\nnpm run release:all\n```\n\nExtension packages will be created in the `release/` directory.\n\n## Project Structure\n\n```text\n├── assets/              # Project assets (screenshots, etc.)\n├── config/              # Browser extension configurations\n│   ├── common.json      # Shared extension settings\n│   ├── firefox.json     # Firefox-specific settings\n│   ├── chrome.json      # Chrome-specific settings\n│   ├── edge.json        # Edge-specific settings\n│   └── tor.json         # Tor Browser-specific settings\n├── scripts/             # Build and development scripts\n│   ├── dev-setup.js     # Development environment setup\n│   ├── merge-config.js  # Configuration merging utility\n│   └── release-browser.js # Browser extension packaging\n├── src/                 # Source code\n│   ├── App.tsx          # Main application component\n│   ├── index.css        # Global CSS styles (Tailwind imports)\n│   └── main.ts          # Application entry point\n├── dist/                # Built application (generated)\n├── release/             # Browser extension packages (generated)\n├── index.html           # HTML template\n├── package.json         # Project dependencies and scripts\n├── postcss.config.js    # PostCSS configuration\n├── tailwind.config.js   # Tailwind CSS configuration\n├── tsconfig.json        # TypeScript configuration\n├── vite.config.js       # Vite configuration\n├── README.md            # This file\n└── README_BROWSER.md    # Browser extension setup guide\n```\n\n## Browser Support\n\n### Primary Supported Browsers\n\nThis starter kit supports both web applications and browser extensions for:\n\n- **Firefox** (version 60 and above) - Manifest V2\n- **Chrome** (version 60 and above) - Manifest V3\n- **Edge** (Chromium-based) - Manifest V3\n- **Tor Browser** - Manifest V2 with enhanced security\n\n### Additional Compatible Browsers\n\nThe Chrome extension build also works with:\n\n- Opera, Brave Browser, Vivaldi, Arc Browser, Kiwi Browser (Android), Yandex Browser\n\nThe Firefox extension build also works with:\n\n- Firefox Developer Edition, Firefox Nightly, Firefox ESR\n\n### Browser Extension Features\n\n- Automated manifest generation for each browser\n- Browser-specific security policies\n- Cross-browser compatibility testing\n- Privacy-focused configurations (Tor Browser)\n\nThe build configuration targets ES2015+ syntax for modern browsers while maintaining compatibility with the specified minimum versions.\n\n## Customization\n\n### Tailwind CSS\n\nTo customize Tailwind CSS, modify the `tailwind.config.js` file. You can extend the theme, add plugins, or configure other options according to your project needs.\n\n### Preact\n\nPreact is configured through the Vite plugin in `vite.config.js`. You can modify the configuration there if needed.\n\n### TypeScript\n\nTypeScript is configured through the `tsconfig.json` file. The configuration is set up to work with Preact and Vite, with JSX transforms enabled.\n\n## Deployment\n\n### Web Application Deployment\n\nThe production build outputs to the `dist/` directory. You can deploy this folder to any static hosting service:\n\n- [Vercel](https://vercel.com/)\n- [Netlify](https://www.netlify.com/)\n- [GitHub Pages](https://pages.github.com/)\n- Any traditional web server\n\n### Browser Extension Distribution\n\nBrowser extension packages are created in the `release/` directory and can be submitted to:\n\n- **Firefox**: [Mozilla Add-ons](https://addons.mozilla.org/developers/)\n- **Chrome**: [Chrome Web Store](https://chrome.google.com/webstore/devconsole/)\n- **Edge**: [Microsoft Edge Add-ons](https://partner.microsoft.com/dashboard/microsoftedge/)\n- **Opera**: [Opera Add-ons](https://addons.opera.com/developer/)\n- **Tor Browser**: Manual distribution for privacy-focused users\n\nFor detailed browser extension setup and testing instructions, see [README_BROWSER.md](README_BROWSER.md).\n\n## License\n\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcodesign-cloud%2Fcdc-browser-plugin-starterkit","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcodesign-cloud%2Fcdc-browser-plugin-starterkit","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcodesign-cloud%2Fcdc-browser-plugin-starterkit/lists"}