Internal SEO audit tool for ArkBoostedAds LLC - Professional AI-powered website analysis and optimization platform
This is an internal tool developed for ArkBoostedAds LLC to provide comprehensive website audits and SEO analysis for our clients. The tool delivers professional-grade reports with actionable insights across multiple performance categories.
- ✅ Fixed priority actions display in both admin and client modes
- ✅ Improved PDF generation with proper page breaks
- ✅ Enhanced backend consistency for category headers
- ✅ Added fallback parsing logic for robust data handling
- ✅ Production-ready codebase with cleanup optimizations
- Comprehensive Analysis: Security, Performance, SEO, Mobile, Content, and UI/UX evaluation
- AI-Powered Scoring: Advanced algorithms with website type-specific optimization
- Real Performance Data: Integration with Google PageSpeed Insights API
- Professional Reports: Export branded PDF reports with detailed recommendations
- Academic Grading: Standard A+ to F grading scale with transparent scoring
Backend:
- FastAPI + Uvicorn ASGI server
- SQLite database with structured storage
- BeautifulSoup for HTML parsing
- Google PageSpeed Insights integration
Frontend:
- React 18 with modern hooks
- Tailwind CSS for responsive design
- React Router for SPA navigation
- jsPDF for professional report generation
- Python 3.8+
- Node.js 16+
- Clone the repository
git clone https://github.com/ak23bar/AArkboosted-Audit-Tool.git
cd AArkboosted-Audit-Tool- Backend Setup
cd backend
python -m venv .venv
source .venv/bin/activate # Windows: .venv\Scripts\activate
pip install fastapi uvicorn requests beautifulsoup4 python-multipart
python minimal_audit_api.py- Frontend Setup (in new terminal)
cd frontend
npm install
npm start- Access the application
- Frontend: http://localhost:3001
- API: http://localhost:8001
- Enter website URL and select type (portfolio, landing-page, e-commerce, etc.)
- Get comprehensive analysis with 6-category scoring breakdown
- Review prioritized recommendations (Critical → Important → Optimization)
- Export professional PDF reports for ArkBoostedAds LLC clients
| Category | Weight | Focus |
|---|---|---|
| Security | 10-25% | HTTPS, SSL, vulnerabilities |
| Performance | 20-40% | Core Web Vitals, loading speed |
| SEO | 5-35% | Meta tags, structured data |
| Mobile | 15-25% | Responsive design, viewport |
| Content | 5-10% | Quality, readability, structure |
| UI/UX | 5-20% | Design, navigation, accessibility |
Weights adjust based on website type for accurate evaluation
POST /api/audits/ # Create new audit
GET /api/audits/ # List all audits
GET /api/audits/{id} # Get specific audit
DELETE /api/audits/{id} # Delete audit# Backend tests
cd backend && python -m pytest
# Frontend tests
cd frontend && npm test# Frontend build
cd frontend && npm run build
# Backend deployment
cd backend && uvicorn minimal_audit_api:app --host 0.0.0.0 --port 8001GitHub Pages cannot host this application because it only supports static files and our app requires a Python backend server.
| Platform | Frontend | Backend | Free Tier | Notes |
|---|---|---|---|---|
| Vercel | ✅ | ✅ | Yes | Best for full-stack apps |
| Netlify | ✅ | Functions | Yes | Good for React + serverless |
| Railway | ✅ | ✅ | Yes | Easy full-stack deployment |
| Render | ✅ | ✅ | Yes | Docker support |
| Heroku | ✅ | ✅ | No | Traditional choice (paid) |
- Frontend: Connect GitHub repo to Vercel
- Backend: Deploy as Vercel serverless function or separate service
- Database: Use hosted SQLite or PostgreSQL
- Environment: Update API URLs in production
# Frontend (.env)
REACT_APP_API_URL=https://your-backend.vercel.app
# Backend (production)
DATABASE_URL=your-database-url
CORS_ORIGINS=["https://your-frontend.vercel.app"]- Portfolio: UI/UX focused (30%), performance emphasis
- Landing Page: SEO optimized (25%), conversion focused
- E-commerce: Security priority (25%), user experience
- Blog: Content quality (10%), SEO heavy (35%)
- Fork the repository
- Create feature branch (
git checkout -b feature/amazing-feature) - Commit changes (
git commit -m 'Add amazing feature') - Push to branch (
git push origin feature/amazing-feature) - Open Pull Request
This project is licensed under the MIT License - see the LICENSE file for details.
- Google PageSpeed Insights API for performance data
- BeautifulSoup for HTML parsing capabilities
- React community for modern UI patterns
- FastAPI for high-performance API framework
Internal Tool for ArkBoosted LLC | Developed by Akbar Aman | Professional Website Analysis for Client Success