How kirastreet/generative-crochet works
This repository is a small, static front-end site for an MFA thesis project about generative crochet. There is no evidence of a backend, database, or build pipeline; the architecture appears to be browser-only HTML/CSS/JavaScript.
1. Entry points
The site has at least two HTML entry pages: index.html and crochetGenerator.html. These likely split the public-facing thesis/project presentation from the interactive generator experience.
2. Presentation layer
crochetProject.css and crochetProject.js appear to support the main thesis/project page. This layer likely handles layout, copy, visuals, and any page-specific interactions for the project narrative.
3. Generator layer
crochetGenerator.css and crochet.js appear to support the crochet pattern generator. This is the most likely “dynamic” part of the site, responsible for creating or updating the generative crochet output in the browser.
4. Shared client-side runtime
All behavior is likely executed directly in the browser using plain JavaScript, with no framework or compiled assets visible in the repository. That means the site is probably assembled from static files and DOM-based interactions.
5. Visual assets
There are two image directories: crochetPics and patternPics. These likely separate documentation imagery or finished crochet photos from pattern/generative reference graphics. The split suggests distinct visual roles in the site’s content model.
6. Content / media flow
A typical flow is: HTML loads CSS and JS, JS manipulates the DOM or canvas/SVG elements, and imagery from the two asset folders is displayed as supporting content. The generator page likely produces or previews crochet-like patterns while the project page presents examples and thesis context.
7. Functional boundary between pages
The repository appears organized around two concerns: a static informational thesis site and an interactive generator. That separation is reflected in the duplicated naming of paired JS/CSS files for the project and generator views.
8. Deployment model
Given the file set, this is likely deployed as a static website, probably on a standard web host. The README’s link to generativecrochet.com reinforces that this is a standalone published site rather than an app backed by services.
9. What to show in an architecture diagram
A clear diagram would show the browser as the runtime, the two HTML entry points as top-level entry nodes, the corresponding CSS/JS files attached per page, and the image folders as static asset dependencies. No server-side components are indicated by the repository contents.
10. Key boundary to preserve
The main architectural boundary is between static presentation assets and client-side generative logic. If you diagram this repo accurately, it should look like a self-contained front-end experience with page-specific scripts and styles, not a multi-tier application.
Main entry points: index.html Home · crochetGenerator.html Generator · crochetProject.js Project JS · README.md README
Components 10
Browser runtime
Client-side execution in the browser with no visible backend.
- Browser · Executes the static site and all client-side interactions.
Project page
Static thesis/project presentation and its page-specific assets.
- Home · Main thesis/project presentation page.
index.html - Project CSS · Layout and visual styling for the project page.
crochetProject.css - Project JS · Page behavior for the thesis/project presentation.
crochetProject.js - README · Repository overview and published-site reference.
README.md
Generator page
Interactive crochet pattern generation experience and its page-specific assets.
- Generator · Interactive crochet generator page.
crochetGenerator.html - Generator CSS · Layout and visual styling for the generator page.
crochetGenerator.css - Generator JS · Browser-side logic that produces or updates crochet-like output.
crochet.js
Media assets
Image folders used as supporting visual content.
- Crochet pics · Supporting photos or visual documentation for the project.
crochetPics - Pattern pics · Reference or output imagery for patterns and generation.
patternPics
Connections 11
- Browser → Home: loads · The browser opens the main presentation page.
- Browser → Generator: loads · The browser opens the interactive generator page.
- Home → Project CSS: uses · Presentation page styling.
- Home → Project JS: runs · Presentation page behavior.
- Generator → Generator CSS: uses · Generator page styling.
- Generator → Generator JS: runs · Generator page behavior.
- Project JS → Crochet pics: shows · Project page can display supporting crochet imagery.
- Project JS → Pattern pics: shows · Project page can display pattern-related imagery.
- Generator JS → Pattern pics: references · Generator logic may use pattern imagery as visual reference or output support.
- README → Home: points to · Repository notes describe the published site entry point.
- README → Generator: points to · Repository notes describe the interactive generator page.