1 GitHub star = 1 new component.

Full templates

Developer Portfolio

A monochrome, keyboard-inspired portfolio with 3D projects, a typing keyboard and a contribution matrix of flying cubes.

Keycap is a six-page personal site for developers, designed for konstantink.dev and rebuilt as reusable sections. The home page pairs a retyping hero over a breathing dot matrix with a 3D projects showcase whose cards animate code, terminals, equalizers or a paint canvas from your data, a mechanical keyboard that types your stack under your repositories, and a GitHub-style contribution matrix whose cubes fly in and ripple like water. Projects get filterable keycap cards and case studies with a 3D monitor and a spec sheet; the blog has a featured index and a reading-progress article layout; the contact page validates a project brief. Pure white and black by default, with a dark mode the 3D scenes follow.

6 pages 0 components 15 sections three (optional peer)

Live preview

Pages

Every page is a real, interactive preview: links, forms and state work across pages.

Home

Retyping hero with skill tape, 3D projects showcase, typing 3D keyboard with repositories, 3D contribution matrix and contact.

src/pages/index.astro

Projects

Keycap-style project cards with category filter keys, stack, status and stars.

src/pages/projects/index.astro

Project case study

Hero with a 3D monitor typing the project terminal, overview, challenge, solution, highlights and a sticky spec sheet.

src/pages/projects/[slug].astro

Blog

Featured latest article and a filterable list with date, category and reading time.

src/pages/blog/index.astro

Article

Meta line, lead, tags, reading-progress bar, monochrome prose with code blocks and previous / next keys.

src/pages/blog/[slug].astro

Contact

Hero with a 3D monitor, project brief with type keys, budget and message, inline validation and direct contacts.

src/pages/contact.astro

What is included

  • 6 pages: home, projects, project case study, blog, article and contact
  • 3D projects showcase with 7 data-driven card visuals
  • Typing 3D keyboard and a 3D monitor
  • 3D contribution matrix: flying cubes and water ripples, real or demo data
  • Light and dark mode — the 3D scenes redraw with the theme
  • Accessible: real buttons and dialogs beside every 3D block, reduced motion respected
  • 15 reusable sections in Sections → Developer Portfolio

Install & use

  1. Install the package

    bash
    npm install astro-component-kit
    npm install astro-component-kit
  2. Create one Astro page per template page

    src/pages/index.astro

    astro
    ---
    // npm install three
    import { PortfolioHomePage } from 'astro-component-kit/templates/portfolio';
    ---
    
    <!-- contributionsSrc: a URL returning { weeks: [{ days: [{ date, count }] }] } -->
    <PortfolioHomePage theme="light" />
    --- // npm install three import { PortfolioHomePage } from 'astro-component-kit/templates/portfolio'; --- <!-- contributionsSrc: a URL returning { weeks: [{ days: [{ date, count }] }] } --> <PortfolioHomePage theme="light" />

    src/pages/projects/index.astro

    astro
    ---
    import { PortfolioProjectsPage } from 'astro-component-kit/templates/portfolio';
    ---
    
    <PortfolioProjectsPage />
    --- import { PortfolioProjectsPage } from 'astro-component-kit/templates/portfolio'; --- <PortfolioProjectsPage />

    src/pages/projects/[slug].astro

    astro
    ---
    import { PortfolioProjectPage, keycapPortfolio } from 'astro-component-kit/templates/portfolio';
    
    export function getStaticPaths() {
      return keycapPortfolio.projects.map((p) => ({ params: { slug: p.slug } }));
    }
    ---
    
    <PortfolioProjectPage slug={Astro.params.slug} />
    --- import { PortfolioProjectPage, keycapPortfolio } from 'astro-component-kit/templates/portfolio'; export function getStaticPaths() { return keycapPortfolio.projects.map((p) => ({ params: { slug: p.slug } })); } --- <PortfolioProjectPage slug={Astro.params.slug} />

    src/pages/blog/index.astro

    astro
    ---
    import { PortfolioBlogPage } from 'astro-component-kit/templates/portfolio';
    ---
    
    <PortfolioBlogPage />
    --- import { PortfolioBlogPage } from 'astro-component-kit/templates/portfolio'; --- <PortfolioBlogPage />

    src/pages/blog/[slug].astro

    astro
    ---
    import { PortfolioPostPage, keycapPortfolio } from 'astro-component-kit/templates/portfolio';
    
    export function getStaticPaths() {
      return keycapPortfolio.posts.map((p) => ({ params: { slug: p.slug } }));
    }
    ---
    
    <PortfolioPostPage slug={Astro.params.slug} />
    --- import { PortfolioPostPage, keycapPortfolio } from 'astro-component-kit/templates/portfolio'; export function getStaticPaths() { return keycapPortfolio.posts.map((p) => ({ params: { slug: p.slug } })); } --- <PortfolioPostPage slug={Astro.params.slug} />

    src/pages/contact.astro

    astro
    ---
    import { PortfolioContactPage } from 'astro-component-kit/templates/portfolio';
    ---
    
    <!-- Pass action="https://your-backend/contact" to post the form -->
    <PortfolioContactPage />
    --- import { PortfolioContactPage } from 'astro-component-kit/templates/portfolio'; --- <!-- Pass action="https://your-backend/contact" to post the form --> <PortfolioContactPage />
  3. Use your own catalogue, currency and routes

    Spread the demo store and replace what you need. Products accept a real image or one of 16 built-in illustrations.

    astro
    ---
    // src/pages/index.astro — pass the same site + routes to every page
    import { PortfolioHomePage, keycapPortfolio, type PortfolioSite } from 'astro-component-kit/templates/portfolio';
    
    const site: PortfolioSite = {
      ...keycapPortfolio,
      name: 'Ada Example',
      logo: { initial: 'A', middle: 'DAEXAMPLE', suffix: '.DEV' },
      phrases: ['ASTRO', 'SVELTE', 'GO'],
      // projects (with visual: { kind: 'code' | 'terminal' | 'equalizer' | 'monitor' | 'endpoints' | 'paint' | 'atom' }),
      // repos, posts, skills, contacts… — edit or replace any list
    };
    ---
    
    <PortfolioHomePage
      site={site}
      theme="auto"
      contributionsSrc="/api/contributions.json"
      routes={{ home: '/', projects: '/projects/', project: '/projects/', blog: '/blog/', post: '/blog/', contact: '/contact/' }}
    />
    --- // src/pages/index.astro — pass the same site + routes to every page import { PortfolioHomePage, keycapPortfolio, type PortfolioSite } from 'astro-component-kit/templates/portfolio'; const site: PortfolioSite = { ...keycapPortfolio, name: 'Ada Example', logo: { initial: 'A', middle: 'DAEXAMPLE', suffix: '.DEV' }, phrases: ['ASTRO', 'SVELTE', 'GO'], // projects (with visual: { kind: 'code' | 'terminal' | 'equalizer' | 'monitor' | 'endpoints' | 'paint' | 'atom' }), // repos, posts, skills, contacts… — edit or replace any list }; --- <PortfolioHomePage site={site} theme="auto" contributionsSrc="/api/contributions.json" routes={{ home: '/', projects: '/projects/', project: '/projects/', blog: '/blog/', post: '/blog/', contact: '/contact/' }} />

New sections 15

Full-width blocks of this template, available in Sections. Open any of them to see it on its own page with code.

Section

Dev Header

Floating navigation with a split logo that collapses on scroll (N·OALINDQVIST·.DEV → N.DEV), pill links, light/dark toggle and a full-screen mobile menu.

Section

Dev Hero

Developer hero: an oversized title that retypes itself, the name dropping in with floating blocks, a status pill and an endless tape of skill cards with tooltips, over a 3D dot matrix that parts around the cursor.

Section

Dev Projects Showcase 3D

3D projects slider: paper cards with ink outlines fanned out in perspective, each with an animated visual chosen by data (code, terminal, equalizer, monitor, endpoints, paint, atom). Drag, keys or arrows to move; click to open a project sheet.

Section

Dev Keyboard 3D

Full-width 3D mechanical keyboard that types your stack by itself and echoes each word as a huge backdrop; slot content (e.g. a repo list) floats over the lower rows.

Section

Dev Repo List

Frosted list of open-source repositories with language dot, stars, description, source link and a live-site eye; reveals the rest with “Show all”.

Section

Dev Contributions 3D

GitHub-style contribution matrix in 3D: barely-rounded cubes fly in from the sky and assemble, keep rebuilding, and ripple like water around the cursor; tooltips with date and count. Pass weeks, a URL or use demo data.

Section

Dev Monitor 3D

3D CRT monitor with ink outlines that drops into place, sways with the cursor and types terminal lines on an inverted screen.

Section

Dev Footer

Minimal footer with a row of mono links, copyright and a small “built with” note.

Section

Dev Page Hero

Inner-page hero with breadcrumb, HUD label, two-line sliding title, intro and an optional slot on the right (e.g. a 3D monitor).

Section

Dev Project Grid

Keycap-style project cards (ink outline, hard shadow that presses on hover) with number, category, stack, status and stars, plus category filter keys.

Section

Dev Project Detail

Project case study: overview, challenge, solution and highlights next to a sticky spec sheet (role, year, status, stack, metrics, links), with previous / next keys.

Section

Dev Post List

Blog index with a featured latest post and a hairline list (date, category, reading time, excerpt) filtered by category.

Section

Dev Article

Blog post layout: meta line, title, lead, tags, reading-progress bar, monochrome prose with code blocks and previous / next keys.

Section

Dev Contact Form

Project inquiry form with project-type keys, budget and message, inline validation, success state and an aside with availability and direct contacts.

Reused library components

Existing components the template is assembled from.