@soulcraft/kits 1.0.0

package/kits/freelance-portfolio/kit.json

@@ -0,0 +1,435 @@
+{
+  "$schema": "https://soulcraft.com/schemas/kit/v2.json",
+  "id": "freelance-portfolio",
+  "type": "soulcraft",
+  "role": "primary",
+  "status": "released",
+  "name": "Freelance Portfolio",
+  "description": "A personal portfolio site with project showcase, about page, and contact form",
+  "longDescription": "A clean, responsive portfolio website template built with HTML, CSS, and minimal JavaScript. Showcase projects with images and descriptions, write your bio, list services, collect testimonials, and include a contact form. Designed for designers, writers, developers, photographers, and other creatives who need a professional presence without the overhead of a full CMS. Brainy stores your projects, services, and testimonials as a knowledge graph you can query and grow over time.",
+  "version": "1.0.0",
+  "author": {
+    "name": "Soulcraft Labs",
+    "email": "kits@soulcraft.com",
+    "url": "https://soulcraft.com"
+  },
+  "icon": "🎨",
+  "tags": [
+    "portfolio",
+    "freelance",
+    "website",
+    "design",
+    "static site",
+    "creative",
+    "personal branding"
+  ],
+  "variables": [
+    {
+      "key": "yourName",
+      "label": "Your Name",
+      "description": "Your full name as it appears in your portfolio header and meta tags",
+      "type": "string",
+      "required": true,
+      "example": "Priya Nair"
+    },
+    {
+      "key": "tagline",
+      "label": "Tagline",
+      "description": "A one-line description of what you do, shown prominently on the hero",
+      "type": "string",
+      "required": false,
+      "example": "Brand designer helping startups find their visual voice"
+    },
+    {
+      "key": "profession",
+      "label": "Profession",
+      "description": "Your job title or creative role (used in meta descriptions and the about section)",
+      "type": "string",
+      "required": false,
+      "example": "Brand Designer",
+      "default": "Freelancer"
+    },
+    {
+      "key": "email",
+      "label": "Contact Email",
+      "description": "Email address used in the contact form mailto link and footer",
+      "type": "email",
+      "required": true,
+      "example": "hello@priyanair.design"
+    },
+    {
+      "key": "primaryColor",
+      "label": "Primary Colour",
+      "description": "Main brand colour for headings, buttons, and highlights (CSS colour value)",
+      "type": "string",
+      "required": false,
+      "example": "#1a1a2e",
+      "default": "#1a1a2e"
+    },
+    {
+      "key": "accentColor",
+      "label": "Accent Colour",
+      "description": "Secondary colour for hover states, links, and decorative elements",
+      "type": "string",
+      "required": false,
+      "example": "#e94560",
+      "default": "#6c63ff"
+    },
+    {
+      "key": "fontChoice",
+      "label": "Display Font",
+      "description": "Google Fonts family name for headings — any font available at fonts.google.com",
+      "type": "string",
+      "required": false,
+      "example": "Playfair Display",
+      "default": "Inter"
+    }
+  ],
+  "shared": {
+    "industry": "creative-arts",
+    "category": "creative",
+    "glossary": {
+      "above the fold": "The portion of the web page visible without scrolling — the most prime real estate for your headline, tagline, and primary call to action.",
+      "case study": "A detailed project write-up explaining the problem, your approach, and the outcome — far more persuasive than a simple before/after image.",
+      "CTA": "Call to action — a button or link prompting the visitor to take the next step, typically 'View my work' or 'Get in touch'.",
+      "testimonial": "A quote from a satisfied client endorsing your work — ideally specific about what you did and what result it produced.",
+      "social proof": "Evidence that others trust you — testimonials, client logos, press mentions, and follower counts.",
+      "conversion": "When a portfolio visitor takes the action you want — sending a contact form, booking a call, or downloading your CV."
+    },
+    "aiExpertise": [
+      "portfolio curation and project selection strategy",
+      "professional bio writing",
+      "project presentation and case study structure",
+      "visual hierarchy and information architecture",
+      "contact and conversion rate optimisation",
+      "service packaging and positioning",
+      "testimonial collection and display"
+    ],
+    "dataModelHints": [
+      "project",
+      "service",
+      "testimonial",
+      "contact_inquiry"
+    ],
+    "dataModel": {
+      "entities": [
+        {
+          "domain": "project",
+          "type": "Document",
+          "description": "A portfolio piece representing a completed or notable work. Contains title, client name, description, outcome, technologies or disciplines used, and images.",
+          "products": {
+            "workshop": {
+              "view": "gallery",
+              "icon": "🖼️"
+            },
+            "academy": {
+              "mapsTo": "learning-artifact",
+              "assessable": true
+            }
+          }
+        },
+        {
+          "domain": "service",
+          "type": "Concept",
+          "description": "A category of work offered to clients — brand identity, web design, copywriting, photography. Defines what you do and at what starting price.",
+          "products": {
+            "workshop": {
+              "view": "gallery",
+              "icon": "✨"
+            },
+            "academy": {
+              "mapsTo": "skill-unit",
+              "assessable": true
+            }
+          }
+        },
+        {
+          "domain": "testimonial",
+          "type": "Document",
+          "description": "A client endorsement quote with attribution (name, title, company). May reference a specific project it relates to.",
+          "products": {
+            "workshop": {
+              "view": "board",
+              "icon": "💬"
+            },
+            "academy": {
+              "mapsTo": "learning-artifact",
+              "assessable": false
+            }
+          }
+        },
+        {
+          "domain": "contact_inquiry",
+          "type": "Event",
+          "description": "An inbound enquiry submitted via the portfolio contact form. Records name, email, message, and timestamp.",
+          "products": {
+            "workshop": {
+              "view": "board",
+              "icon": "📨"
+            }
+          }
+        }
+      ],
+      "relationships": [
+        {
+          "from": "project",
+          "to": "service",
+          "verb": "Shows",
+          "description": "Project demonstrates competency in a particular service category."
+        },
+        {
+          "from": "testimonial",
+          "to": "project",
+          "verb": "References",
+          "description": "Testimonial is linked to the specific project it praises for context."
+        },
+        {
+          "from": "contact_inquiry",
+          "to": "service",
+          "verb": "References",
+          "description": "Inbound enquiry expresses interest in a specific service category."
+        }
+      ]
+    },
+    "suggestions": [
+      {
+        "label": "Write my bio",
+        "prompt": "Help me write a compelling professional bio that conveys my expertise, style, and personality without sounding generic."
+      },
+      {
+        "label": "Curate my projects",
+        "prompt": "Help me choose which projects to feature and in what order to maximise impact for my ideal client."
+      },
+      {
+        "label": "Write a case study",
+        "prompt": "Help me write a project case study explaining the problem, my approach, and the outcome."
+      },
+      {
+        "label": "Define my services",
+        "prompt": "Help me package and name my services in a way that makes it easy for clients to understand what to hire me for."
+      },
+      {
+        "label": "Craft a testimonial request",
+        "prompt": "Write a friendly email asking a past client for a testimonial I can feature on my portfolio."
+      },
+      {
+        "label": "Improve my CTA",
+        "prompt": "Review my portfolio's calls to action and suggest improvements to increase contact form submissions."
+      }
+    ]
+  },
+  "academy": {
+    "skillPath": "personal-branding",
+    "level": "beginner",
+    "learningObjectives": [
+      "Curate and present portfolio work in an order and format that speaks directly to an ideal client",
+      "Write a compelling professional bio that communicates expertise, personality, and unique value",
+      "Define and name service offerings in terms of client outcomes rather than deliverables",
+      "Collect and display client testimonials that build social proof and trust",
+      "Design a contact flow that converts portfolio visitors into enquiries"
+    ],
+    "assessmentTypes": [
+      "portfolio",
+      "peer-review"
+    ],
+    "certificationSlug": "portfolio-creator"
+  },
+  "workshop": {
+    "difficulty": "beginner",
+    "templateTier": 3,
+    "aiPersona": {
+      "role": "You are a portfolio design consultant helping creatives present their best work with clarity, personality, and professionalism. You balance aesthetic sensibility with conversion strategy — a beautiful portfolio that nobody hires from is just a gallery.",
+      "expertise": [
+        "portfolio curation and project selection",
+        "bio writing and personal positioning",
+        "project presentation and case study structure",
+        "service packaging and pricing communication",
+        "visual hierarchy and information architecture",
+        "testimonial collection and display strategy",
+        "contact and conversion optimisation"
+      ],
+      "tone": "collaborator",
+      "avoidances": [
+        "Don't recommend showing every project ever made — edit ruthlessly to the best 4–8 pieces",
+        "Don't write a bio that reads like a CV — it should sound like a real person talking to their ideal client",
+        "Don't over-design the contact section — friction kills conversions"
+      ]
+    },
+    "workspaceConfig": {
+      "paradigm": "creative",
+      "defaultTab": "app",
+      "defaultView": "app"
+    },
+    "graphGuidance": {
+      "conceptCreation": {
+        "triggers": [
+          "project, case study, or piece of work described",
+          "service offering or skill area defined",
+          "client testimonial or endorsement added",
+          "contact or enquiry form set up"
+        ],
+        "typeMapping": {
+          "project": "document",
+          "case study": "document",
+          "work sample": "document",
+          "service": "concept",
+          "skill": "concept",
+          "testimonial": "document",
+          "recommendation": "document",
+          "contact inquiry": "event"
+        }
+      },
+      "relationshipPatterns": [
+        {
+          "from": "project",
+          "to": "service",
+          "verb": "Shows",
+          "description": "Project demonstrates the service it falls under"
+        },
+        {
+          "from": "testimonial",
+          "to": "project",
+          "verb": "References",
+          "description": "Testimonial endorses a specific project"
+        }
+      ],
+      "rules": [
+        "Every project should be linked to at least one service category",
+        "Testimonials must reference the project they describe for context",
+        "Contact inquiries are events, not documents — record them but don't expose them publicly",
+        "Services should describe outcomes for clients, not deliverables for the freelancer"
+      ]
+    },
+    "qualityGates": {
+      "projectChecks": [
+        "Site loads and hero section displays name, tagline, and a primary CTA",
+        "At least three projects are shown with descriptions and outcomes",
+        "About section is complete with a professional bio",
+        "At least two services are defined with descriptions",
+        "Contact form is functional and submits successfully",
+        "Site is responsive on mobile viewport widths"
+      ],
+      "exportReady": [
+        "All images have alt text",
+        "Meta title and description are set",
+        "Contact form has a clear success state",
+        "All links open correctly"
+      ]
+    },
+    "templateMetadata": {
+      "identifyByStructure": true,
+      "runnable": true,
+      "runnableCommand": "npx serve ."
+    },
+    "publishConfig": {
+      "contentType": "static",
+      "publishable": true
+    },
+    "sampleData": {
+      "description": "Sample projects and services to demonstrate the portfolio template",
+      "entities": [
+        {
+          "type": "document",
+          "name": "Nova Brand Identity",
+          "properties": {
+            "client": "Nova Fintech",
+            "year": "2025",
+            "description": "Full brand identity system for a Series A fintech startup — logo, typography, colour palette, and brand guidelines.",
+            "outcome": "Brand launched to 40k email subscribers with 94% positive sentiment in post-launch survey.",
+            "services": [
+              "brand-identity"
+            ],
+            "featured": true
+          }
+        },
+        {
+          "type": "document",
+          "name": "Moss & Stone E-commerce",
+          "properties": {
+            "client": "Moss & Stone Co.",
+            "year": "2025",
+            "description": "Complete redesign of the e-commerce storefront and product photography art direction.",
+            "outcome": "32% increase in conversion rate within 60 days of launch.",
+            "services": [
+              "web-design"
+            ],
+            "featured": true
+          }
+        },
+        {
+          "type": "concept",
+          "name": "Brand Identity",
+          "properties": {
+            "description": "Logo, typography, colour, and brand guidelines for businesses finding their visual voice.",
+            "startingFrom": "from $2,500",
+            "deliverables": [
+              "Logo suite",
+              "Brand guidelines PDF",
+              "Social media kit"
+            ]
+          }
+        },
+        {
+          "type": "document",
+          "name": "Working with Priya was a game-changer for our brand.",
+          "properties": {
+            "author": "Sarah Kim",
+            "title": "CEO, Nova Fintech",
+            "quote": "Working with Priya was a game-changer for our brand. She understood exactly what we were trying to say and translated it into visuals that our customers immediately connected with.",
+            "project": "Nova Brand Identity"
+          }
+        }
+      ],
+      "relationships": [
+        {
+          "from": "Nova Brand Identity",
+          "verb": "Shows",
+          "to": "Brand Identity"
+        },
+        {
+          "from": "Working with Priya was a game-changer for our brand.",
+          "verb": "References",
+          "to": "Nova Brand Identity"
+        }
+      ]
+    },
+    "remoteWorkspace": {
+      "connectedWorkbenches": [
+        {
+          "name": "Project Gallery",
+          "view": "gallery",
+          "entityTypes": [
+            "project"
+          ],
+          "description": "Visual grid of all portfolio projects with status and featured flag"
+        },
+        {
+          "name": "Services Board",
+          "view": "board",
+          "entityTypes": [
+            "service"
+          ],
+          "description": "Manage and edit your service offerings and descriptions"
+        },
+        {
+          "name": "Testimonials",
+          "view": "board",
+          "entityTypes": [
+            "testimonial"
+          ],
+          "description": "Collect, edit, and curate client testimonials for display"
+        },
+        {
+          "name": "Portfolio Graph",
+          "view": "graph",
+          "entityTypes": [
+            "project",
+            "service",
+            "testimonial"
+          ],
+          "description": "Graph of projects, the services they demonstrate, and their testimonials"
+        }
+      ]
+    }
+  }
+}