1 GitHub star = 1 new component.

Star the repo
Developer Portfolio

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.

contactformvalidationportfolio
Live Preview

What are we building?

Usage

Copy and paste this code into your React component:

tsx
import { DevContactForm } from 'react-component-kit-ui/sections';

<DevContactForm action="https://your-backend/contact" contacts={[{ label: 'Email', value: 'hi@you.dev', href: 'mailto:hi@you.dev' }]} />

Manual Installation

If you are not using the npm package, create a new file and paste the following code: src/components/sections/DevContactForm.tsx + DevContactForm.css:

DevContactForm.tsx
'use client';

import { useEffect, useRef, useId } from 'react';
import './DevContactForm.css';

/** class:list โ†’ className */
function cx(...args: unknown[]): string {
  const out: string[] = [];
  const walk = (v: unknown) => {
    if (!v) return;
    if (typeof v === 'string' || typeof v === 'number') out.push(String(v));
    else if (Array.isArray(v)) v.forEach(walk);
    else if (typeof v === 'object') for (const [k, on] of Object.entries(v as Record<string, unknown>)) if (on) out.push(k);
  };
  args.forEach(walk);
  return out.join(' ');
}

/**
 * DevContactForm โ€” Project inquiry form for developer portfolios ("Keycap" design): name, email,
 * project-type keys, budget, timeline and message, with inline validation and a success state;
 * an aside lists availability, response time and direct contacts.
 *
 * @param {string} action - Form endpoint. Without it the form validates and shows the success state (demo).
 * @param {string} method - HTTP method. Default 'post'.
 * @param {string[]} topics - Project types. Default Website / Web app / 3D & creative / Consulting.
 * @param {string[]} budgets - Budget options.
 * @param {string} availability - Availability line. Default 'Available for new projects'.
 * @param {string} response - Response-time line. Default 'Replies within 24 hours'.
 * @param {Array<{label: string, value: string, href: string}>} contacts - Direct contacts in the aside.
 * @param {object} labels - Field labels and messages: { name, email, topic, budget, message, submit, sending, success, required, invalidEmail }.
 * @param {string} className - Extra class.
 *
 * Accessibility: native labels, required fields marked and validated with aria-invalid and
 * aria-describedby error text; topic keys are a radio group (fieldset/legend); the status message
 * is announced in a live region and receives focus on success.
 */
export interface DevContactFormProps {
  action?: string;
  method?: 'post' | 'get';
  topics?: string[];
  budgets?: string[];
  availability?: string;
  response?: string;
  contacts?: Array<{ label: string; value: string; href: string }>;
  labels?: Partial<Record<'name' | 'email' | 'topic' | 'budget' | 'message' | 'submit' | 'sending' | 'success' | 'required' | 'invalidEmail', string>>;
  className?: string;
}

export function DevContactForm({
  action,
  method = 'post',
  topics = ['Website', 'Web app', '3D & creative', 'Consulting'],
  budgets = ['< โ‚ฌ5k', 'โ‚ฌ5k โ€“ โ‚ฌ15k', 'โ‚ฌ15k โ€“ โ‚ฌ40k', 'โ‚ฌ40k +'],
  availability = 'Available for new projects',
  response = 'Replies within 24 hours',
  contacts = [],
  labels = {},
  className = '',
}: DevContactFormProps) {
  const L = {
    name: 'Your name', email: 'Email', topic: 'What are we building?', budget: 'Budget', message: 'Tell me about the project',
    submit: 'Send message', sending: 'Sendingโ€ฆ', success: "Thanks! Your message is on its way โ€” I'll reply soon.",
    required: 'This field is required.', invalidEmail: 'Enter a valid email address.',
    ...labels,
  };
  const id = `dvcf-${useId().replace(/[^a-zA-Z0-9]/g, '')}`;

  // Client-side behaviour: runs once after mount.
  const mounted = useRef(false);
  useEffect(() => {
    if (mounted.current) return;
    mounted.current = true;
    document.querySelectorAll<HTMLFormElement>('[data-dev-form]:not([data-bound])').forEach((form) => {
        form.dataset.bound = '';
        const status = form.querySelector<HTMLElement>('[data-status]')!;
        const submit = form.querySelector<HTMLButtonElement>('[data-submit]')!;
        const fields = Array.from(form.querySelectorAll<HTMLInputElement | HTMLTextAreaElement>('input[required], textarea[required]'));
    
        const check = (f: HTMLInputElement | HTMLTextAreaElement) => {
          const err = f.closest('.dvcf__field')?.querySelector<HTMLElement>('[data-err]');
          let msg = '';
          if (!f.value.trim()) msg = status.dataset.required ?? '';
          else if (f.type === 'email' && !/^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(f.value.trim())) msg = status.dataset.invalidEmail ?? '';
          f.setAttribute('aria-invalid', String(!!msg));
          if (err) err.textContent = msg;
          return !msg;
        };
        fields.forEach((f) => f.addEventListener('blur', () => f.getAttribute('aria-invalid') !== null && check(f)));
    
        form.addEventListener('submit', async (e) => {
          const invalid = fields.filter((f) => !check(f));
          if (invalid.length) {
            e.preventDefault();
            invalid[0].focus();
            return;
          }
          if (!form.hasAttribute('data-demo')) return; // real endpoint: let the browser submit
          e.preventDefault();
          submit.disabled = true;
          submit.textContent = submit.dataset.sending ?? '';
          await new Promise((r) => setTimeout(r, 700));
          form.reset();
          fields.forEach((f) => f.removeAttribute('aria-invalid'));
          form.querySelectorAll<HTMLElement>('[data-err]').forEach((el) => (el.textContent = ''));
          submit.disabled = false;
          submit.innerHTML = `${submit.dataset.label} <span aria-hidden="true">โ†’</span>`;
          status.textContent = status.dataset.success ?? '';
          status.classList.add('is-success');
          status.focus();
        });
      });
    // eslint-disable-next-line react-hooks/exhaustive-deps
  }, []);

  return (
    <>
      <section className={cx(['dvcf', className])} data-rk-036bce="">
        <div className="dvcf__wrap" data-rk-036bce="">
          <form className="dvcf__form" data-dev-form action={action} method={method} noValidate data-demo={action ? undefined : ''} data-rk-036bce="">
            <div className="dvcf__row" data-rk-036bce="">
              <div className="dvcf__field" data-rk-036bce="">
                <label htmlFor={`${id}-name`} data-rk-036bce="">{L.name} <span aria-hidden="true" data-rk-036bce="">*</span></label>
                <input id={`${id}-name`} name="name" type="text" autoComplete="name" required aria-describedby={`${id}-name-err`} data-rk-036bce="" />
                <p className="dvcf__err" id={`${id}-name-err`} data-err data-rk-036bce=""></p>
              </div>
              <div className="dvcf__field" data-rk-036bce="">
                <label htmlFor={`${id}-email`} data-rk-036bce="">{L.email} <span aria-hidden="true" data-rk-036bce="">*</span></label>
                <input id={`${id}-email`} name="email" type="email" autoComplete="email" required aria-describedby={`${id}-email-err`} data-rk-036bce="" />
                <p className="dvcf__err" id={`${id}-email-err`} data-err data-rk-036bce=""></p>
              </div>
            </div>
      
            <fieldset className="dvcf__topics" data-rk-036bce="">
              <legend data-rk-036bce="">{L.topic}</legend>
              <div className="dvcf__keys" data-rk-036bce="">
                {topics.map((t, i) => (
                  <label key={i} className="dvcf__key" data-rk-036bce="">
                    <input type="radio" name="topic" defaultValue={t} defaultChecked={i === 0} data-rk-036bce="" />
                    <span data-rk-036bce="">{t}</span>
                  </label>
                ))}
              </div>
            </fieldset>
      
            <div className="dvcf__field" data-rk-036bce="">
              <label htmlFor={`${id}-budget`} data-rk-036bce="">{L.budget}</label>
              <select id={`${id}-budget`} name="budget" data-rk-036bce="">
                {budgets.map((b, __i: number) => <option key={__i} value={b} data-rk-036bce="">{b}</option>)}
              </select>
            </div>
      
            <div className="dvcf__field" data-rk-036bce="">
              <label htmlFor={`${id}-msg`} data-rk-036bce="">{L.message} <span aria-hidden="true" data-rk-036bce="">*</span></label>
              <textarea id={`${id}-msg`} name="message" rows={6} required aria-describedby={`${id}-msg-err`} data-rk-036bce=""></textarea>
              <p className="dvcf__err" id={`${id}-msg-err`} data-err data-rk-036bce=""></p>
            </div>
      
            <button className="dvcf__submit" type="submit" data-submit data-label={L.submit} data-sending={L.sending} data-rk-036bce="">{L.submit} <span aria-hidden="true" data-rk-036bce="">โ†’</span></button>
            <p className="dvcf__status" role="status" tabIndex={-1} data-status data-success={L.success} data-required={L.required} data-invalid-email={L.invalidEmail} data-rk-036bce=""></p>
          </form>
      
          <aside className="dvcf__aside" data-rk-036bce="">
            <p className="dvcf__avail" data-rk-036bce=""><span aria-hidden="true" data-rk-036bce=""></span>{availability}</p>
            <p className="dvcf__resp" data-rk-036bce="">{response}</p>
            {contacts.length > 0 && (
              <ul className="dvcf__contacts" data-rk-036bce="">
                {contacts.map((c, __i: number) => (
                  <li key={__i} data-rk-036bce=""><span data-rk-036bce="">{c.label}</span><a href={c.href} data-rk-036bce="">{c.value}</a></li>
                ))}
              </ul>
            )}
          </aside>
        </div>
      </section>
    </>
  );
}

export default DevContactForm;
DevContactForm.css
.dvcf:where([data-rk-036bce]) { padding: 0 0 clamp(3rem, 7vw, 5rem); color: var(--c-text-1); }
.dvcf__wrap:where([data-rk-036bce]) { max-width: 1040px; margin: 0 auto; padding: 0 clamp(1rem, 3vw, 1.5rem); display: grid; grid-template-columns: minmax(0, 1fr) 300px; gap: clamp(2rem, 5vw, 4rem); align-items: start; }
.dvcf__form:where([data-rk-036bce]) { display: grid; gap: 1.25rem; padding: clamp(1.25rem, 3vw, 2rem); border: 2px solid var(--c-text-1); border-radius: 4px; box-shadow: 6px 6px 0 var(--c-text-1); background: var(--c-bg); }
.dvcf__row:where([data-rk-036bce]) { display: grid; grid-template-columns: 1fr 1fr; gap: 1rem; }
.dvcf__field:where([data-rk-036bce]) { display: grid; gap: 0.4rem; }
.dvcf:where([data-rk-036bce]) label:where([data-rk-036bce]), .dvcf:where([data-rk-036bce]) legend:where([data-rk-036bce]) { font-family: var(--font-mono); font-size: 0.72rem; font-weight: 600; letter-spacing: 0.04em; text-transform: uppercase; color: var(--c-text-2); }
.dvcf:where([data-rk-036bce]) label:where([data-rk-036bce]) span:where([data-rk-036bce]) { color: var(--c-text-1); }
.dvcf:where([data-rk-036bce]) input[type='text']:where([data-rk-036bce]), .dvcf:where([data-rk-036bce]) input[type='email']:where([data-rk-036bce]), .dvcf:where([data-rk-036bce]) select:where([data-rk-036bce]), .dvcf:where([data-rk-036bce]) textarea:where([data-rk-036bce]) {
  width: 100%;
  min-height: 46px;
  padding: 0.7rem 0.85rem;
  border: 1.5px solid rgb(var(--ink-rgb, 0 0 0) / 0.25);
  border-radius: 2px;
  background: var(--c-bg);
  color: var(--c-text-1);
  font: inherit;
  font-size: 1rem;
  transition: border-color 0.15s ease, box-shadow 0.15s ease;
}
.dvcf:where([data-rk-036bce]) textarea:where([data-rk-036bce]) { resize: vertical; min-height: 140px; }
.dvcf:where([data-rk-036bce]) input:focus:where([data-rk-036bce]), .dvcf:where([data-rk-036bce]) select:focus:where([data-rk-036bce]), .dvcf:where([data-rk-036bce]) textarea:focus:where([data-rk-036bce]) { outline: none; border-color: var(--c-text-1); box-shadow: 2px 2px 0 var(--c-text-1); }
.dvcf:where([data-rk-036bce]) [aria-invalid='true']:where([data-rk-036bce]) { border-color: var(--c-danger, #dc2626); }
.dvcf__err:where([data-rk-036bce]) { min-height: 1em; margin: 0; font-size: 0.78rem; color: var(--c-danger, #dc2626); }
.dvcf__topics:where([data-rk-036bce]) { margin: 0; padding: 0; border: 0; }
.dvcf__topics:where([data-rk-036bce]) legend:where([data-rk-036bce]) { margin-bottom: 0.6rem; }
.dvcf__keys:where([data-rk-036bce]) { display: flex; flex-wrap: wrap; gap: 0.5rem; }
.dvcf__key:where([data-rk-036bce]) { position: relative; }
.dvcf__key:where([data-rk-036bce]) input:where([data-rk-036bce]) { position: absolute; opacity: 0; inset: 0; margin: 0; cursor: pointer; }
.dvcf__key:where([data-rk-036bce]) span:where([data-rk-036bce]) {
  display: inline-flex;
  align-items: center;
  min-height: 40px;
  padding: 0 0.9rem;
  border: 1.5px solid var(--c-text-1);
  border-radius: 3px;
  background: var(--c-bg);
  color: var(--c-text-1);
  font-family: var(--font-mono);
  font-size: 0.78rem;
  font-weight: 600;
  text-transform: none;
  letter-spacing: 0;
  box-shadow: 0 3px 0 var(--c-text-1);
  transition: transform 0.15s ease, box-shadow 0.15s ease, background 0.15s ease, color 0.15s ease;
}
.dvcf__key:where([data-rk-036bce]) input:checked:where([data-rk-036bce]) + span:where([data-rk-036bce]) { background: var(--c-text-1); color: var(--c-bg); transform: translateY(3px); box-shadow: none; }
.dvcf__key:where([data-rk-036bce]) input:focus-visible:where([data-rk-036bce]) + span:where([data-rk-036bce]) { outline: 2px solid var(--c-text-1); outline-offset: 3px; }
.dvcf__submit:where([data-rk-036bce]) {
  justify-self: start;
  display: inline-flex;
  align-items: center;
  gap: 0.6rem;
  min-height: 48px;
  padding: 0 1.5rem;
  border: 1.5px solid var(--c-text-1);
  border-radius: 2px;
  background: var(--c-text-1);
  color: var(--c-bg);
  font-family: var(--font-mono);
  font-size: 0.9rem;
  font-weight: 700;
  box-shadow: 3px 3px 0 var(--c-text-3);
  cursor: pointer;
  transition: transform 0.15s ease, box-shadow 0.15s ease;
}
.dvcf__submit:hover:where([data-rk-036bce]) { transform: translateY(-1px); box-shadow: 4px 4px 0 var(--c-text-3); }
.dvcf__submit:disabled:where([data-rk-036bce]) { opacity: 0.6; cursor: progress; }
.dvcf__submit:focus-visible:where([data-rk-036bce]) { outline: 2px solid var(--c-text-1); outline-offset: 3px; }
.dvcf__status:where([data-rk-036bce]) { margin: 0; font-size: 0.92rem; font-weight: 600; }
.dvcf__status:empty:where([data-rk-036bce]) { display: none; }
.dvcf__status.is-success:where([data-rk-036bce]) { padding: 0.85rem 1rem; border: 1.5px dashed var(--c-text-1); border-radius: 4px; }
.dvcf__status:focus:where([data-rk-036bce]) { outline: 2px solid var(--c-text-1); outline-offset: 3px; }

.dvcf__aside:where([data-rk-036bce]) { display: grid; gap: 0.75rem; position: sticky; top: 6rem; }
.dvcf__avail:where([data-rk-036bce]) { display: inline-flex; align-items: center; gap: 0.5rem; margin: 0; font-family: var(--font-mono); font-size: 0.8rem; font-weight: 600; }
.dvcf__avail:where([data-rk-036bce]) span:where([data-rk-036bce]) { width: 8px; height: 8px; border-radius: 50%; background: var(--c-success, #10b981); box-shadow: 0 0 8px var(--c-success, #10b981); }
.dvcf__resp:where([data-rk-036bce]) { margin: 0 0 0.75rem; font-size: 0.9rem; color: var(--c-text-2); }
.dvcf__contacts:where([data-rk-036bce]) { display: grid; gap: 0.6rem; margin: 0; padding: 0; list-style: none; }
.dvcf__contacts:where([data-rk-036bce]) li:where([data-rk-036bce]) { display: grid; gap: 0.15rem; padding: 0.85rem 1rem; border: 1px solid var(--c-border); border-radius: 4px; }
.dvcf__contacts:where([data-rk-036bce]) span:where([data-rk-036bce]) { font-family: var(--font-mono); font-size: 0.66rem; letter-spacing: 0.08em; text-transform: uppercase; color: var(--c-text-3); }
.dvcf__contacts:where([data-rk-036bce]) a:where([data-rk-036bce]) { overflow-wrap: anywhere; color: var(--c-text-1); font-weight: 500; text-decoration: none; }
.dvcf__contacts:where([data-rk-036bce]) a:hover:where([data-rk-036bce]) { text-decoration: underline; }
@media (max-width: 860px) { .dvcf__wrap:where([data-rk-036bce]) { grid-template-columns: 1fr; } .dvcf__aside:where([data-rk-036bce]) { position: static; } }
@media (max-width: 560px) { .dvcf__row:where([data-rk-036bce]) { grid-template-columns: 1fr; } }