- Performance: Pre-aggregated analytics and intelligent caching.
- Content: Manage Blog, Projects, and Downloads with ease.
- Career: Built-in Resume Vault and Bio-Link (Linktree) directory.
- Branding: Dynamic theme control and auto-branding wizard.
- Portability: Full export/restore of your entire database state.
- Push Notifications: Receive instant, real-time system alerts.
- Analytics: Built-in user behavior tracking and traffic insights.
- Monitoring: Integrated health checks for deployments and domains.
- Security: Multi-Factor Authentication (TOTP) and one-click maintenance.
- Multi-Account: Secure multiple admin accounts with role-based access across devices.
The Portfolio Manager provides a robust set of JSON endpoints for external frontends.
| Endpoint | Method | Description |
|---|---|---|
/api/settings |
GET |
Website branding, social URLs, and features |
/api/seo |
GET |
SEO metadata and auto-generated JSON-LD |
/api/blog |
GET |
List all published blog posts |
/api/blog/<permalink> |
GET |
Fetch a single blog post by slug |
/api/projects |
GET |
List all projects and case studies |
/api/projects/<permalink> |
GET |
Fetch a single project by slug |
/api/experience |
GET |
Career professional experience history |
/api/education |
GET |
Career education and academic history |
/api/certificates |
GET |
Career certifications and awards |
/api/downloads |
GET |
Software/App download links across platforms |
/api/sitemap |
GET |
Dynamic sitemap structure for search engines |
| Endpoint | Method | Description |
|---|---|---|
/api/contact |
POST |
Submit contact form messages |
/api/analytics |
POST |
Log page views and visitor data |
/api/blog/<permalink>/update_view |
POST |
Increment read count for a blog post |
/api/projects/<permalink>/update_view |
POST |
Increment view count for a project |
/api/downloads/<id>/hit |
POST |
Track a file download click |
| Endpoint | Method | Description |
|---|---|---|
/api/push/public-key |
GET |
Retrieve the VAPID public key |
/api/push/subscribe |
POST |
Register a service worker subscription |
/api/health |
GET |
Basic system health check |
| Endpoint | Method | Description |
|---|---|---|
/api/notifications/new |
GET |
Poll for new unread messages |
/api/notifications/dismiss/<id> |
DELETE |
Permanently delete a message |
/api/upload-image |
POST |
Upload media to ImgBB and get URL |
/api/push/send |
POST |
Trigger a push notification to all subscribers |
/api/export |
GET |
Export a full encrypted JSON backup |
/api/restore |
POST |
Restore database from a backup file |
- Backend: Python / Flask
- Database: Google Firestore (NoSQL)
- Deployment: Vercel / Railway / Google Cloud Run
- Styling: Vanilla CSS / Tailwind (Frontend optimized)
- Integrations: ImgBB (Media), VAPID (Push Notifications)
To use this engine, you need a Google Firebase project. Follow these steps exactly:
- Create Project: Visit the Firebase Console and click "Add Project".
- Enable Firestore: In your new project, navigate to Build → Firestore Database and click "Create Database". Choose your region and start in Test Mode.
- Generate Private Key: Click the Project Settings (Gear Icon) → Service Accounts → "Generate New Private Key".
- Save Credentials: Download the
.jsonfile. You will need to paste its contents during the setup wizard. - Media Storage: Get a free API Key from ImgBB for image uploads.
# Clone the repository
git clone https://github.com/TharukRenuja/Portfolio-Manager-Engine.git
cd Portfolio-Manager-Engine
# Install dependencies
pip install -r requirements.txt
# Run the application
python main.pyVisit http://localhost:5000 to start the setup wizard.
- Enter your Firebase Service Account Config.
- Enter your ImgBB API Key.
- Follow the wizard to initialize your brand.
The system supports full data portability. You can export your entire database from the Danger Zone and restore it during setup or via the API to move between projects instantly.
Built with ❤️ by Tharuk Renuja