Download the PHP package iamsabbiralam/ghost-notes without Composer
On this page you can find all versions of the php package iamsabbiralam/ghost-notes. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download iamsabbiralam/ghost-notes
More information about iamsabbiralam/ghost-notes
Files in iamsabbiralam/ghost-notes
Package ghost-notes
Short Description A Laravel package to generate a dev-diary from @ghost tags in your code.
License MIT
Informations about the package ghost-notes
๐ป GhostNotes - Transform Code Comments into a Dev Diary
GhostNotes is a powerful Laravel utility that scans your codebase for hidden tags like @ghost, @todo, or @fixme and compiles them into a beautiful, organized developer diary, multi-format reports, and a modern Web Dashboard.
โจ Features
- ๐ Advanced Tag Scanning: Automatically finds
@ghost,@todo,@fixme, and@notewith optional Priority Levels (high|medium|low). - ๐จ Modern Dashboard: A sleek, Tailwind-powered dashboard with Search, Priority Badges, and Source Code Snippets.
- ๐ Multi-Format Export: Export your dev-diary into Markdown, JSON, or CSV (Excel compatible).
- ๐ Resolved Graveyard: Track resolved notes in the "Resolved Ghosts" history after clearing them from your code.
- ๐ VS Code & GitHub Integration: Open files directly in VS Code from the dashboard or view them on GitHub with line-specific links.
- ๐ค Git Context: Automatically identifies the author using
git blame. - ๐งน Code Cleanup: Use the
--clearflag to safely remove tags from source code once they are logged. - ๐ Safe for Devs: Dashboard and routes are automatically disabled in production.
๐ Installation
Install the package via composer:
Set up everything with a single command:
This command publishes the config file and prepares the internal storage.
๐ Usage
-
Adding Tags in Code You can now add priority levels to your tags:
-
Generating the Diary Run the command to scan files and update the dashboard cache:
-
Exporting Reports Generate reports in your preferred format:
- Clearing and Archiving Log the notes to the Resolved History and remove them from your code:
๐ฅ Web Dashboard
Visit the interactive dashboard at: http://your-app.test/ghost-notes
In the Dashboard you can:
- ๐ Search through notes by author, message, or file name.
- ๐ฑ๏ธ One-click Open files directly in VS Code.
- ๐ฆ Download reports as CSV, JSON, or Markdown.
- ๐จ๏ธ Print a clean PDF report of your technical debt.
- ๐ View History of all resolved/cleared notes.
โ๏ธ Configuration
The configuration file allows you to customize:
๐ค Contributing
Contributions are welcome! If you have any ideas, feel free to open an issue or submit a pull request.
๐ License
The MIT License (MIT). Please see License File for more information.
Developed by Sabbir Alam