{"id":15480971,"url":"https://github.com/pyronaur/css4jsdev-character-creator","last_synced_at":"2025-04-09T05:44:01.256Z","repository":{"id":144768714,"uuid":"516357878","full_name":"pyronaur/css4jsdev-character-creator","owner":"pyronaur","description":null,"archived":false,"fork":false,"pushed_at":"2022-07-21T12:15:01.000Z","size":4730,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-02-15T00:20:02.419Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/pyronaur.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-07-21T12:14:57.000Z","updated_at":"2022-07-21T12:15:39.000Z","dependencies_parsed_at":null,"dependency_job_id":"c51441f3-3c64-40bc-b4ff-92258b1e429d","html_url":"https://github.com/pyronaur/css4jsdev-character-creator","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pyronaur%2Fcss4jsdev-character-creator","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pyronaur%2Fcss4jsdev-character-creator/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pyronaur%2Fcss4jsdev-character-creator/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pyronaur%2Fcss4jsdev-character-creator/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/pyronaur","download_url":"https://codeload.github.com/pyronaur/css4jsdev-character-creator/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247987108,"owners_count":21028891,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-10-02T05:00:57.623Z","updated_at":"2025-04-09T05:44:01.235Z","avatar_url":"https://github.com/pyronaur.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Character Creation Workshop\n\nIn this workshop, you'll build a Sims-style character creation screen.\n\n## Mockups\n\nDesktop:\n\n\u003cimg alt=\"Desktop-sized screenshot of the character creation screen\" src=\"./docs/mockup.png\" style=\"width: 100%;\" /\u003e\n\nFor this workshop, we're only targeting desktops (although if you're so inclined, creating a mobile variant would make a great stretch goal!).\n\n\u003e Protip: If you're reading this in VS Code, open the Command Palette (Cmd + Shift + P) and select “Markdown: Open Preview to the Side”. That way, you can see all the images in this document!\n\n## Setup Instructions\n\nThis project uses create-react-app.\n\nStart by installing dependencies:\n\n```\nnpm install\n```\n\nBoot up a dev server:\n\n```\nnpm run start\n```\n\nYou should be able to access the application at `http://localhost:3000`.\n\n## Troubleshooting\n\nIf you run into problems running a local development server, check out our [Troubleshooting Guide](https://courses.joshwcomeau.com/troubleshooting) on the course platform.\n\nThis guide addresses the common `Digital Envelope Routine` error you may have seen.\n\n## Project structure and context\n\nThis project is built with React.\n\n**All of the functionality has already been built.** Your job is to add the CSS. You're also allowed to tweak the JSX (HTML) as-needed. But you shouldn't need to fuss with any advanced React stuff.\n\nThis project uses **CSS Modules**. CSS modules are ultimately very similar to vanilla CSS, but the classes are applied in JS. Here's an example:\n\n```css\n/* Something.module.css */\n.wrapper {\n  width: 500px;\n}\n```\n\n```js\n/* Something.js */\nimport styles from './Something.module.css';\n\nfunction Something() {\n  return \u003cdiv className={styles.wrapper}\u003eI'll be 500px wide!\u003c/div\u003e;\n}\n```\n\nAdditionally, a few global styles can be found in `src/index.css`.\n\n## Exercises\n\n### Exercise 1: Fix footer links\n\nLet's start with a small detail: The footer links are unreadable:\n\n\u003cimg alt=\"Side-by-side comparison of the current footer vs. the ideal one\" src=\"./docs/footer-fix.png\" style=\"max-width: 500px\" /\u003e\n\n### Exercise 2: Layout adjustments\n\nNext, let's tackle the biggest visual issue: the layout.\n\nWe have a `MaxWidthWrapper` constraining the max width, but everything is super wide within it.\n\nOur header should be 65% of the available width, and our control-panel column should be 50%.\n\n\u003cimg alt=\"Annotated mockup showing the overall width at 1024px, the header occupying 65%, and the control panels occupying 50%\" src=\"./docs/sizes.png\" style=\"width: 100%;\" /\u003e\n\nThe character (the big illustration) should use fixed positioning, and it should occupy the space cleared by the above width tweaks.\n\nGive the character a minimum height of 500px. On smaller windows, this means the character won't fit in the viewport:\n\n\u003cimg alt=\"Screenshot of a shorter Chrome window, with the character truncated at the knees\" src=\"./docs/short-window.png\" style=\"width: 100%;\" /\u003e\n\n### Exercise 3: Overflow\n\nEach control panel features a number of customizations. For control panels with too many options, a horizontal scrollbar should be introduced:\n\n\u003cimg alt=\"Close-up screen recording of the overflow area in the control-panel\" src=\"./docs/overflow.gif\" style=\"width: 100%;\" /\u003e\n\n### Exercise 4: Perspective decoration\n\nTo help add a bit of perspective, a light gray bar should extend across the bottom 40% of the screen:\n\n\u003cimg alt=\"Screenshot of the mockup, showing the light gray bar\" src=\"./docs/mockup.png\" style=\"width: 100%;\" /\u003e\n\nIt should sit behind the avatar (and both the perspective bar and the character should sit below the footer):\n\n\u003cimg alt=\"Screen recording, showing how the character and stripe don't move as the page is scrolled\" src=\"./docs/scroll.gif\" style=\"width: 640px; max-width: 100%\" /\u003e\n\nYou can use the background color `hsl(195deg, 20%, 86%)`.\n\nFor bonus points, solve this challenge without setting any z-indexes.\n\n### Exercise 5 (Stretch): Implement a mobile variant\n\nOn mobile devices, the cards should stack horizontally, and sit near the bottom of the screen, underneath the character:\n\n\u003cimg alt=\"Screen recording, showing a mobile variant of the application\" src=\"./docs/mobile-variant.gif\" style=\"max-width: 100%\" /\u003e\n\n**NOTE:** This is a challenging stretch goal! It may require some CSS features we haven't covered yet. This is meant as an extra challenge for advanced students. Feel free to skip it!\n\n## Submissions\n\n**Workshops are submitted through the course platform.** Commit your changes, push them to your fork, and submit the link by clicking the \"Complete lesson\" button on the workshop page.\n\nIf you're not comfortable with Git, you can upload a `.zip` file using Dropbox or Google Drive, and paste a link to the public file instead.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpyronaur%2Fcss4jsdev-character-creator","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpyronaur%2Fcss4jsdev-character-creator","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpyronaur%2Fcss4jsdev-character-creator/lists"}