You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Devora is not a star counter. It is an intelligent portfolio analyzer that goes deep into every repository to detect **what you actually built**, **how technically complex it is**, and **what it would take to score higher**.
41
40
42
-
It identifies project types, detects 10 technical depth signals, and surfaces your strongest and weakest repos — then generates AI-powered insights using Groq's `llama3-8b-8192` model to give you real, actionable feedback.
41
+
Most GitHub profile tools just count stars or show commit streaks. Devora does something fundamentally different — it reads your file tree, parses your README, inspects your directory structure, and runs 10 technical signal detectors across every repo you own. Then it aggregates all of that into a 5-dimension portfolio score, generates an AI-powered insight report, and gives you a step-by-step roadmap to improve.
43
42
44
43
Everything runs in the browser. No backend. No build step. No npm install.
45
44
@@ -53,7 +52,7 @@ Enter Username → Fetch All Repos → Analyze Each Repo → Score 5 Dimensions
53
52
54
53
**Step 1 — Repository Discovery**
55
54
56
-
All public repositories are fetched. Profile README repos (same name as username) are automatically excluded from scoring so they do not skew your results.
55
+
All public repositories are fetched via the GitHub REST API. Profile README repos (repos with the same name as your username) are automatically excluded from scoring so they do not skew your results.
57
56
58
57
**Step 2 — Per-Repo Analysis**
59
58
@@ -63,9 +62,11 @@ Each repository is scored across 4 sub-dimensions:
| Depth | Technical signal detection (see below) | 30% |
65
+
| Depth | Technical signal detection — auth, DB, API, Docker, etc. | 40% |
67
66
| Popularity | Stars, forks, original vs fork status | 20% |
68
67
68
+
> **Note:** Depth carries 40% weight at the repo level — the single most impactful sub-dimension. A repo with auth + database + real-time will score significantly higher than a static page with the same stars.
69
+
69
70
**Step 3 — Portfolio Score**
70
71
71
72
Individual repo scores are aggregated into a 5-dimension portfolio score:
@@ -75,7 +76,7 @@ Individual repo scores are aggregated into a 5-dimension portfolio score:
75
76
| Reputation | 30% | Stars, forks, and follower count across all repos |
| Technical Depth | 25% | Advanced signal detection across all repos |
78
-
| Diversity | 15% | Language variety (tiers: C/Rust/Go > TS/Python > JS) and project type range (fullstack, CLI, ML, library, etc.) — fastest boost: add a project in a second language|
79
+
| Diversity | 15% | Language variety and project type range |
79
80
| Quality | 10% | Documentation and structure health |
80
81
81
82
---
@@ -84,21 +85,23 @@ Individual repo scores are aggregated into a 5-dimension portfolio score:
84
85
85
86
### Capability Detection — 10 Signals
86
87
87
-
Devora scans file names, directory names, and README text for each repository:
88
+
Devora scans file names, directory names, and README text for each repository. Signals are detected using exact file path matching and regex patterns against README content:
88
89
89
90
| Signal | How It Is Detected | Score Boost |
90
91
|---|---|---|
91
-
|**Auth**|`auth.js`, `passport.js`, `bcrypt`, `jsonwebtoken`, `nextauth` in files or README | +15 pts |
This ensures that a score of 90+ reflects genuine impact — not just good formatting.
134
+
130
135
### Project Type Awareness
131
136
132
137
Devora detects 7 project types from file structure and directory names:
@@ -143,6 +148,98 @@ Devora detects 7 project types from file structure and directory names:
143
148
144
149
---
145
150
151
+
## 🌍 Portfolio Diversity — Deep Dive
152
+
153
+
Diversity carries **15% of your total score** and is one of the fastest dimensions to improve. It rewards breadth across two axes: the languages you use and the kinds of projects you ship.
154
+
155
+
### Language Tiers
156
+
157
+
Not all languages are weighted equally. Devora groups languages into tiers based on technical depth and market rarity:
| Build a CLI tool in any language | +8 pts (new project type) | 🟢 Easy |
193
+
| Publish an npm or pip library | +8 pts (new project type) | 🟡 Medium |
194
+
| Add a Jupyter notebook / ML experiment | +8 pts (new project type `ml-ai`) | 🟡 Medium |
195
+
| Build one project in Go or Rust | +10 pts (Tier-1/2 bonus unlocked) | 🔴 Hard |
196
+
| Reach 4 distinct languages | Full language score (60/60) | 🟡 Medium |
197
+
198
+
> **Fastest single action:** Add one Python project — even a simple CLI tool or data analysis notebook. It adds a new language (Tier 3) and a new project type (`cli` or `ml-ai`) in a single commit, giving you both the language score and the type score boost simultaneously.
199
+
200
+
---
201
+
202
+
## ⚙️ Configuration
203
+
204
+
All environment credentials and app-level settings live in `src/config/`:
205
+
206
+
```
207
+
src/
208
+
└── config/
209
+
└── env.config.js # Supabase URL, anon key, Groq API keys
210
+
```
211
+
212
+
### `src/config/env.config.js`
213
+
214
+
```js
215
+
exportconstENV= {
216
+
supabase: {
217
+
url:"YOUR_SUPABASE_URL",
218
+
anonKey:"YOUR_SUPABASE_ANON_KEY",
219
+
},
220
+
groq: {
221
+
keys: [
222
+
"YOUR_GROQ_KEY_1",
223
+
"YOUR_GROQ_KEY_2",
224
+
],
225
+
},
226
+
github: {
227
+
apiBase:"https://api.github.com",
228
+
},
229
+
};
230
+
```
231
+
232
+
Fill in your own values before running locally. Never commit real credentials — add `src/config/env.config.js` to `.gitignore` if you fork this repo privately.
│ └── detection.test.js # 18 signal detection tests
386
+
├── .github/
387
+
│ └── workflows/
388
+
│ └── ci.yml # GitHub Actions — runs tests on every push
389
+
├── supabase-setup.sql # Database schema
390
+
├── CONTRIBUTING.md # Contributor guide
391
+
├── LICENSE
392
+
└── package.json
393
+
```
394
+
395
+
---
396
+
272
397
## 🧪 Tests
273
398
274
399
```bash
@@ -292,6 +417,8 @@ open devora/index.html
292
417
293
418
No `npm install`. No webpack. No framework. Open `index.html` directly and it works.
294
419
420
+
If you want to use your own Supabase + Groq credentials, fill in `src/config/env.config.js`.
421
+
295
422
---
296
423
297
424
## 📋 Dashboard Sections
@@ -319,7 +446,7 @@ No `npm install`. No webpack. No framework. Open `index.html` directly and it wo
319
446
320
447
## 🤝 Contributing
321
448
322
-
Devora welcomes contributors of all skill levels! Read [CONTRIBUTING.md](CONTRIBUTING.md) for the full guide — project structure, good first issues, PR checklist, and commit style.
449
+
Devora welcomes contributors of all skill levels — from fixing a typo to adding a new scoring signal. Read [CONTRIBUTING.md](CONTRIBUTING.md) for the full guide.
0 commit comments