Prompt-Craft-Ai: Sonic Blueprint ๐ต
Dynamic Prompt Ecosystem for AI-powered Music Creation
The "Sonic Blueprint" project is a Dashboard system designed to elevate prompt engineering for AI Music generation (e.g., Suno, Udio). It transitions the workflow from using directionless, unpredictable commands (Volatile Static Prompts) to a "Self-Evolving Prompt Ecosystem" through a locked structural framework and a smart database system.
โจ Key Features
๐๏ธ The 4-Pillar Engine:
A structured form system that requires users to input data based on a strict framework: Core Genre, Vocal Profile, Instruments, and Logic/Progression. This ensures the AI understands and processes the instructions with maximum accuracy.
๐ Interactive Keyword Cheat Sheet:
A clearly categorized technical glossary. Users can simply "click" to instantly insert pro-level terminology and audio engineering terms into their Master Prompt.
๐ช Auto-Enhance System:
An automated enhancement button that injects advanced technical keywords (e.g., Dolby Atmos, pristine mastering, Masterpiece) into the structure to instantly elevate the Ground Truth quality.
๐ก๏ธ Guardrail & Content Moderation:
A real-time scanning system for prohibited words (e.g., violence, explicit content, copyrighted terms). If a violation is detected, the system triggers a Lockdown, disabling both clipboard copying and database saving to protect users from being banned on external AI platforms.
๐ฅ Workspace & Profiles:
Supports seamless profile switching (e.g., Main Studio, Experimental Lab) within a single session to neatly organize your prompt Knowledge Base.
๐พ Live Ground Truth Database:
Integrated with Firebase Cloud Firestore to permanently save successful prompt formulas, complete with visibility permission settings (Private / Public).
๐ External Platform Shortcuts:
Built-in shortcut buttons to immediately test your generated prompts in Suno and Udio.
๐ ๏ธ System Architecture
The application is built as a Single-File Web Application for rapid deployment, high portability, and ease of use:
Frontend: HTML5
Styling: Tailwind CSS (via CDN) for a modern, responsive UI
Icons: Lucide Icons
Backend / Database: Firebase v11 (Auth & Firestore) via ES Modules
State Management: Vanilla JavaScript (ES6)
๐ Installation & Setup
Because the system is designed as a standalone file, deploying it is incredibly simple:
Clone Repository / Copy File:
Place the promptcraft_sonic_blueprint.html file into your desired project folder.
Firebase Configuration (For your own live database):
Locate the following block inside the <script type="module"> tag and insert your credentials:
const Firebase Config = {
API Key: "YOUR_API_KEY",
Auth Domain: "YOUR_PROJECT_ID.firebaseapp.com",
Project ID: "YOUR_PROJECT_ID",
// ...
};
Note: In the collaborative Canvas test environment, the system automatically uses predefined config via __firebase_config.
Running the Application:
Simply open the HTML file with any modern Web Browser (Chrome, Edge, Safari) or run it using an extension like Live Server in VSCode.
๐บ๏ธ Roadmap & Future Development
The following features are planned for Phase 2 and Phase 3 of the Promptcraft-Ai ecosystem:
[ ] Phase 2 (Data Tagging): Implement a 1-5 star Rating system within the Database table to score and evaluate the audio output of each saved Prompt.
[ ] Phase 2.5 (Automated AI Sync): Enable an AI (LLM) to read values from the Public Database, extract highly effective keywords (High-performance tags), and automatically generate new default Presets.
[ ] Phase 3 (Self-Evolving UI): Implement feedback analysis. If a specific keyword is frequently used and yields high ratings, the system will automatically push it to the top of the Cheat Sheet.
Developed for Promptcraft-Ai - Elevating AI interaction through structured engineering.
What's Changed
- main.yml by @BGovertime in #1
- BGovertime-patch-2 by @BGovertime in #2
New Contributors
- @BGovertime made their first contribution in #1
Full Changelog: https://github.com/BGovertime/PromptCraftAI/commits/Prompt_Craft_Ai