Docs
How Project Plug works
✦Create your list
Sign up, claim a handle, and add your projects in the dashboard. Each project has a name, a description, and a link. The handle becomes your public address at /u/your-handle.
◐Drop one line on any site
Paste this anywhere on a page. Replace your-username with your handle.
<div data-project-plug="your-username" data-limit="5"></div>
<script src="https://project-plug.vercel.app/project-plug.js" defer></script>That is the whole snippet. The script renders a plain unordered list inside the div AND auto-loads your saved stylesheet so your designed look applies automatically. It also auto-hides the project that lives on the current site, so an embed on aurora.com won't link back to itself.
Multiple looks per user. Save as many named styles as you want in Customize the look (e.g. warm-bento, monochrome). Pick one per embed:
<div
data-project-plug="your-username"
data-project-plug-style="warm-bento"
></div>
<script src="https://project-plug.vercel.app/project-plug.js" defer></script>If you want full control of the styling on the host site, add data-project-plug-style="off" to the div. The list still renders, but nothing is injected into <head> — your own CSS wins.
◇Style it (three ways, pick one)
Easiest. Open Customize the look in the dashboard. Pick a preset, tweak it, save. Your public profile updates and a hosted stylesheet is served at /u/your-handle/styles.css. Link to it from any site:
<link rel="stylesheet" href="https://project-plug.vercel.app/u/your-handle/styles.css">Manual copy. The customizer also exposes the generated CSS so you can paste it directly into your own stylesheet and edit it further.
From scratch. If you prefer, ignore the customizer entirely and target the class names yourself.
.project-plug-list { list-style: none; padding: 0; margin: 0; }
.project-plug-item { margin: 0 0 0.75rem; }
.project-plug-link { display: block; padding: 1rem; border: 1px solid #e5e5e5; border-radius: 8px; text-decoration: none; color: inherit; }
.project-plug-title { display: block; font-weight: 600; }
.project-plug-description { display: block; color: #666; font-size: 0.875rem; margin-top: 0.25rem; }
.project-plug-view-all { display: inline-block; margin-top: 0.75rem; }◑Attributes you can set on the div
| data-project-plug | required. Your username. |
| data-project-plug-style | Pick which saved style to load. '<slug>' loads /u/<your-handle>/styles/<slug>.css. Absent → the user's default style (/u/<your-handle>/styles.css). 'inherit' → no stylesheet, the list adopts the host page's own fonts and colors. 'off' → no stylesheet injected; style the list yourself. |
| data-project-plug-styles | Legacy alias. 'off' (or 'false', 'none', 'manual') opts out of stylesheet injection. Use data-project-plug-style instead for new embeds. |
| data-project-plug-skip-self | true (default) — hide any project whose URL is on the current host page (same hostname and matching path prefix). Set to false to always include every project, even the one the embed is sitting on. |
| data-limit | 1 to 100. Default 5. |
| data-view-all | true (default) or false. Append a 'View all' link when total exceeds the limit. |
| data-view-all-text | Default 'View all {count}'. The literal {count} is replaced. |
| data-fields | Comma list of fields to render. Default 'title,description'. Use 'title' for a names-only list. |
| data-target | _blank (default) or _self for the project links. |
| data-class-prefix | Default 'project-plug'. Change to 'myproj' to get .myproj-list, .myproj-item, etc. Note: auto-load of the saved stylesheet is skipped when a custom prefix is used (your CSS targets different class names). |
| data-loading-text | Loading state. Default 'Loading projects...'. |
| data-empty-text | Empty state. Default 'No projects yet.'. |
✕Class names emitted (with default prefix)
| .project-plug-list | Outer <ul> |
| .project-plug-item | Each <li> |
| .project-plug-link | The <a> wrapping each item |
| .project-plug-title | Project name <span> |
| .project-plug-description | Project description <span> |
| .project-plug-view-all | The View all <a> |
| .project-plug-loading | Shown while fetching |
| .project-plug-empty | Shown when there are zero projects |
| .project-plug-error | Shown if the fetch fails |
◎JSON API (if you do not want the loader)
For static site generators, server-rendered apps, or anything where you want the data directly. CORS is open and the response is cached for one minute.
GET https://project-plug.vercel.app/api/u/your-username/products?limit=5{
"user": { "username": "your-username", "display_name": null },
"total": 12,
"limit": 5,
"products": [
{ "id": "...", "slug": "my-app", "title": "My App", "description": "...", "url": "https://...", "page_url": null, "link": "https://...", "position": 0 }
],
"profile_url": "https://project-plug.vercel.app/u/your-username"
}✶Public profile
Every user gets a public profile at /u/your-handle. This is where the View all link points by default. The profile uses your saved style automatically.
✶Write API
Let another app add and update your projects and their pages. Create a key under API keys in your dashboard and send it as a bearer token. Keys act as you, so use them from a server. Browsers are not allowed to call these endpoints.
| GET /api/v1/projects | List your projects, archived ones included |
| POST /api/v1/projects | Create a project, or update it if the slug already exists |
| GET /api/v1/projects/{slug} | Read one project |
| PATCH /api/v1/projects/{slug} | Change only the fields you send |
curl -X POST https://project-plug.vercel.app/api/v1/projects \
-H "Authorization: Bearer ppk_..." \
-H "Content-Type: application/json" \
-d '{
"title": "My App",
"description": "One sentence about it.",
"url": "https://example.com",
"page_enabled": true,
"page_body": "Longer text for the project page.\n\nSeparate paragraphs with a blank line.",
"page_image_url": "https://example.com/cover.png"
}'| title | Name. Required to create. Up to 120 characters |
| slug | The project's address. Optional; defaults to the title. Cannot change after creation |
| description | One sentence. Up to 500 characters |
| url | Where the project lives. Required unless page_enabled is true |
| page_enabled | true hosts a page at /u/your-username/slug and your list links to it |
| page_body | Page text. Up to 5000 characters. Blank line between paragraphs |
| page_image_url | https link to an image shown on the page |
| status | "active" or "archived" |
Sending the same POST twice updates the same project, so retries are safe. Successful responses return the project with its page_url. Errors return { "error": "..." } with status 400, 401, 404 or 413.
Ready to try it? Create your list.