Project PA

Project PA CLI — AI-Powered Presentation Generator for Web Projects

💡 Inspiration

When developers build web applications, they often struggle to present their work clearly to recruiters, clients, or hackathon judges. Creating documentation, demo tours, and polished feature highlights takes more time than building the actual project. Project PA CLI was created to solve that problem — a tool that automatically generates a guided presentation of any web app using AI.

🧠 What It Does

Project PA CLI (@abhi21121211/project-pa-cli) is a command-line tool that:

• Analyzes your web project with AI
• Creates a professional presentation (step-by-step guided tour)
• Lets you preview it locally
• Deploys the presentation to the cloud
• Supports protected/authenticated routes
• Supports multiple AI providers (Gemini & OpenRouter)

You can then embed the presentation directly in your website using a single script tag. ✨

🔧 How We Built It

• Node.js for building the CLI
• AI Providers supported: Gemini, OpenRouter
• Auto detection of API keys to reduce configuration friction
• Custom analyzer engine to inspect code, routes & UI structure
• Cloud deployment service storing 3 latest versions with persistent project IDs
• Interactive terminal UI to configure protected routes, authentication, and user roles

🏆 Key Features

• 🚀 Init & Generate: Instantly create a guided presentation using AI
• 🔐 Auth Support: Works with user-protected and role-based pages
• 🌐 Preview Server: Test with runtime widget injection
• ☁️ Cloud Deployment: Persistent Project ID with version history
• 🧩 Customizable Presentation File (presentation.json)
• 📦 Drop-in Runtime to embed tours in any website

😅 Challenges We Faced

• Extracting useful UI context without reading too many files
• Handling login-based dashboards and authenticated pages
• Providing intelligent AI prompts without leaking code
• Keeping deployments consistent using the same Project ID
• Ensuring smooth UX in a terminal-based interface

📚 What We Learned

• Designing developer tools is not just code — it’s developer experience (DX)
• Authentication handling in automation requires careful security checks
• AI-generated content must be validated and editable after generation
• Version history + persistent IDs dramatically improves reliability

🌍 Future Improvements

• More LLM provider support (Claude, GPT)
• VS Code plugin to edit & preview tours visually
• Custom themes for presentation widgets
• Multi-language tour support

🔗 NPM Package: @abhi21121211/project-pa-cli 📜 License: MIT ✨ Built to help developers showcase their work with style!

Built With

• axios
• backend
• cloud
• commander.js
• custom
• gemini-api
• inquirer.js
• javascript
• node.js
• npm
• openrouter