{"id":16402696,"url":"https://github.com/m5x5/sourcesync","last_synced_at":"2025-03-21T02:33:18.289Z","repository":{"id":184609462,"uuid":"672193209","full_name":"m5x5/sourcesync","owner":"m5x5","description":"Tool to bidirectionally sync changes in CSS files between browser's DevTools and Sass/PostCSS/etc sources","archived":false,"fork":false,"pushed_at":"2023-07-31T07:59:31.000Z","size":461,"stargazers_count":22,"open_issues_count":8,"forks_count":2,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-03-17T20:11:47.071Z","etag":null,"topics":["css","devtools","lightningcss","source","sync"],"latest_commit_sha":null,"homepage":"https://sourcesync.vercel.app/","language":"JavaScript","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/m5x5.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","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":"2023-07-29T08:25:11.000Z","updated_at":"2024-06-24T18:48:26.000Z","dependencies_parsed_at":"2024-10-28T09:16:25.519Z","dependency_job_id":"76482392-bb06-408e-80a3-70bb489f49bd","html_url":"https://github.com/m5x5/sourcesync","commit_stats":null,"previous_names":["m5x5/sourcesync"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/m5x5%2Fsourcesync","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/m5x5%2Fsourcesync/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/m5x5%2Fsourcesync/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/m5x5%2Fsourcesync/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/m5x5","download_url":"https://codeload.github.com/m5x5/sourcesync/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244725834,"owners_count":20499676,"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":["css","devtools","lightningcss","source","sync"],"created_at":"2024-10-11T05:46:59.221Z","updated_at":"2025-03-21T02:33:17.962Z","avatar_url":"https://github.com/m5x5.png","language":"JavaScript","readme":"\u003cdiv align=\"center\"\u003e\n  \u003ca href=\"https://sourcesync.vercel.app\" target=\"_blank\" rel=\"noopener noreferrer\"\u003e\n    \u003cimg width=\"180\" src=\"https://sourcesync.vercel.app/logo.svg\" alt=\"SourceSync Logo\"\u003e\n  \u003c/a\u003e\n\n[![Version](https://img.shields.io/badge/Version-0.0.2-blue.svg?style=flat-square)](https://github.com/m5x5?tab=packages\u0026repo_name=sourcesync)\n[![Maintenance](https://img.shields.io/badge/Maintained%3F-yes-green.svg)](https://github.com/m5x5/sourcesync/graphs/commit-activity)\n[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat-square)](http://makeapullrequest.com)\n\n\u003c/div\u003e\n\n\u003cbr/\u003e\n\n# SourceSync 🚀\n\nSourceSync keeps your CSS source files in sync with your browser's dev tools. It works with PostCSS, LightningCSS, SASS or plain CSS. Enjoy the convenience of real-time browser-to-source CSS editing.\n\n## Table of Contents\n\n- [SourceSync 🚀](#sourcesync-)\n  - [Table of Contents](#table-of-contents)\n  - [Features](#features)\n  - [Installation](#installation)\n  - [Usage](#usage)\n    - [As a Library](#as-a-library)\n    - [Command Line Interface (CLI)](#command-line-interface-cli)\n  - [Contribute](#contribute)\n  - [License](#license)\n\n## Features\n\n- Bidirectional sync: Edit your CSS in the browser's dev tools, and see those changes in your original source files.\n- Utilizes CSS source maps: SourceSync intelligently parses the source maps to locate the correct lines in the source file.\n- Fast: Implements an efficient line diffing algorithm to locate changes quickly.\n\n![demo](https://github.com/m5x5/sourcesync/assets/30301026/34b80c7a-bc18-4c4c-b0fd-ee12de72d5cb)\n\n## Important Tasks\n- [ ] PostCSS and SASS support still needs to be added.\n- [ ] SourceSync needs to work with minified CSS files.\n- [ ] SourceSync needs to have a Vite integration and or watch the original files for changed and transpile them.\n\n## Installation\n\n```bash\nnpm install sourcesyncjs\n```\n\n## Usage\n\n### As a Library\n\nImport and use SourceSync in your Node.js application:\n\n```javascript\nimport { SourceSync } from \"sourcesyncjs\";\n\n// Initialize SourceSync with the path to your source and output files\nconst sync = new SourceSync(\"path/to/source\", \"path/to/output\");\n\n// Start the synchronization process\nsync.startSync();\n```\n\n### Command Line Interface (CLI)\n\nYou can also use SourceSync from the command line:\n\n```bash\nnpx sourcesync path/to/source path/to/output\n```\n\nOr, if you have it installed globally:\n\n```bash\nsourcesync path/to/source path/to/output\n```\n\n## Contribute\n\nSourceSync is an open source project, and contributions are welcome! Whether you're fixing bugs, improving the documentation, or proposing new features, we would love to have your help.\n\nIf you're new to the project and want to help, a great first step would be looking at our open issues with the \"good first issue\" label. These issues are especially suited for new contributors.\n\nIf you want to contribute, please:\n\n1. Fork the repository and create your branch from `main`.\n2. Make your changes and validate them.\n3. Issue that pull request!\n\nFor more details, please check the [CONTRIBUTING.md](CONTRIBUTING.md) file.\n\n## License\n\nSourceSync is [MIT licensed](LICENSE).\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fm5x5%2Fsourcesync","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fm5x5%2Fsourcesync","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fm5x5%2Fsourcesync/lists"}