Transform GitHub Repositories into SEO-Optimized Technical Articles

Italiano • English

DevFlow AI è una piattaforma che trasforma repository GitHub in articoli tecnici di alta qualità, ottimizzati per SEO. Costruito per sviluppatori che vogliono scalare il content marketing senza sacrificare tempo di coding.

DevFlow supporta OpenRouter per accedere a 18+ modelli con una sola API key.

• Node.js 18+
• Account OpenRouter o Google AI Studio

# Clone repository
git clone https://github.com/fracabu/devflow-ai.git
cd devflow-ai

# Installa dipendenze
npm install

# Copia e configura environment
cp .env.example .env.local
# Modifica .env.local con le tue API keys

# Avvia development server
npm run dev

Puoi configurare le chiavi in due modi:

1. Via UI: Vai in Config e inserisci le chiavi nei campi dedicati
2. Via .env.local: Modifica il file con le tue chiavi

OPENROUTER_API_KEY=sk-or-v1-...
GEMINI_API_KEY=AIzaSy...

devflow-ai/
├── App.tsx              # Main component con tutte le view
├── index.tsx            # Entry point React
├── types.ts             # TypeScript interfaces
├── services/
│   ├── ai-providers.ts  # Sistema multi-provider AI
│   └── geminiService.ts # Generazione articoli
├── api/
│   └── devto.ts         # Vercel serverless function per Dev.to
├── public/
│   └── DevFlow_AI.mp4   # Video demo NotebookLM
├── vite.config.ts       # Vite configuration
└── index.html           # HTML template con Tailwind CDN

┌─────────────┐    ┌─────────────┐    ┌─────────────┐    ┌─────────────┐
│  1. GitHub  │───▶│  2. AI Gen  │───▶│  3. Review  │───▶│  4. Publish │
│  Sync Repo  │    │  18+ Models │    │  Edit/Save  │    │  to Dev.to  │
└─────────────┘    └─────────────┘    └─────────────┘    └─────────────┘

1. Connect GitHub → Inserisci username, seleziona repo (supporta token per repo private)
2. Generate Article → L'AI analizza README e genera articolo SEO-optimized
3. Review & Edit → Visualizza preview, modifica, salva nel planner
4. Publish to Dev.to → Pubblica direttamente come bozza con un click

La pubblicazione su Dev.to avviene tramite Vercel Serverless Function (/api/devto.ts) che bypassa le restrizioni CORS del browser.

Setup:

1. Ottieni la tua API Key da dev.to/settings/extensions
2. Inseriscila in Config → Dev.to API Key
3. Clicca "Invia come Bozza" nell'editor

L'articolo viene creato come bozza privata su Dev.to, pronta per la revisione finale.

DevFlow AI is a platform that transforms GitHub repositories into high-quality, SEO-optimized technical articles. Built for developers who want to scale content marketing without sacrificing coding time.

DevFlow supports OpenRouter to access 18+ models with a single API key.

• Node.js 18+
• OpenRouter or Google AI Studio account

# Clone repository
git clone https://github.com/fracabu/devflow-ai.git
cd devflow-ai

# Install dependencies
npm install

# Copy and configure environment
cp .env.example .env.local
# Edit .env.local with your API keys

# Start development server
npm run dev

You can configure keys in two ways:

1. Via UI: Go to Config and enter keys in the dedicated fields
2. Via .env.local: Edit the file with your keys

OPENROUTER_API_KEY=sk-or-v1-...
GEMINI_API_KEY=AIzaSy...

┌─────────────┐    ┌─────────────┐    ┌─────────────┐    ┌─────────────┐
│  1. GitHub  │───▶│  2. AI Gen  │───▶│  3. Review  │───▶│  4. Publish │
│  Sync Repo  │    │  18+ Models │    │  Edit/Save  │    │  to Dev.to  │
└─────────────┘    └─────────────┘    └─────────────┘    └─────────────┘

1. Connect GitHub → Enter username, select repo (supports token for private repos)
2. Generate Article → AI analyzes README and generates SEO-optimized article
3. Review & Edit → Preview, edit, save to planner
4. Publish to Dev.to → Publish directly as draft with one click

Publishing to Dev.to works via Vercel Serverless Function (/api/devto.ts) that bypasses browser CORS restrictions.

Setup:

1. Get your API Key from dev.to/settings/extensions
2. Enter it in Config → Dev.to API Key
3. Click "Push as Draft" in the editor

The article is created as a private draft on Dev.to, ready for final review.

• Multi-provider AI system (OpenRouter + Gemini)
• Free models support
• API key management via UI
• Bilingual interface (IT/EN)
• Dev.to frontmatter export
• Editorial planner with localStorage
• GitHub token support (private repos + higher rate limit)
• Dev.to direct publishing via API
• Storytelling article structure
• First comment auto-generation
• Landing page with video demo
• Scheduled publishing
• Analytics integration
• Custom author persona configuration

• API keys stored in localStorage (browser only)
• .env.local excluded via .gitignore
• No keys committed to repository
• Keys configurable at runtime via UI

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the project
2. Create your feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

This project is licensed under the MIT License - see the LICENSE file for details.

• GitHub: @fracabu

Made with ❤️ and 🤖 Claude Code AI