salla-app-challenge v0.0.1

Salla Web Component Challenge

Overview

This is an assignment project for talented Senior Front-End developers who are willing to join Salla development team.

You will be responsible for creating a reusable web component that showcases your skills in front-end development. Each component should be well-structured, efficient, adhere to best practices, and include state management. You will create a mini checkout (Check the UI here) using this simple MockAPI with the following steps: 1. Cart Items web Component. 2. Shipping Companies web component.

The checkout will be in 2 versions React and Vue to ensure web component re-usability in any different framework. use the following API for the project:

Key Requirements:

1. Technology Stack:
   1. You must use StencilJS, a powerful toolchain for building web components.
   2. Your Code must be written using TypeScript.
   3. Use Tailwind CSS as your styling utility.
2. Component Functionality: The web component should serve its purpose, From the UI provided, each checkout step should be in a separate web component and implement state management within the component to handle and update internal data.
3. Re-Usability: Develop the component to be reusable in different web applications. It should follow the principles of encapsulation and provide a clear API for interaction, use the web components in 2 versions of the checkout (Vue and React)
4. Unit Tests: Write comprehensive unit tests for your web component to verify its functionality, including state management. Use a testing framework of your choice (e.g., Jest, Jasmine).
5. Performance: Optimize the component for performance. Consider lazy loading and asynchronous loading if applicable. Aim for minimal impact on page load times.
6. Documentation: Provide clear and concise documentation on how to use your web component. Include usage examples and explanations of available props, methods, events, and how the state management works.

Submission Guidelines:

• Make sure your code is well-organized and follows best practices for TypeScript, Stencil JS, and unit testing.
• Include a README.md file with instructions on how to run the unit tests locally.
• Create a demo or example HTML file that showcases the usage of your web component, including interactions that demonstrate the state management.
• When you're ready, submit a production ready link to your repository along with any additional notes you'd like to share about your implementation.

Evaluation Criteria:

Your solution will be evaluated based on the following criteria:

• Functionality: Does the web component serve its purpose, and is it implemented correctly, including state management?
• Code Quality: Is the code well-structured, maintainable, and efficient?
• Re-Usability: Can the component be easily reused in different projects?
• Unit Tests: Are there comprehensive unit tests that verify the component's functionality, including state management?
• Documentation: Is the usage of the component and its state management well-documented?

• Performance: Does the component perform efficiently?

• Provide your solution within 7 calendar days.

  If you need any clarification you can send an email with your questions.

Stencil App Starter

Stencil is a compiler for building fast web apps using Web Components.

Stencil combines the best concepts of the most popular frontend frameworks into a compile-time rather than run-time tool. Stencil takes TypeScript, JSX, a tiny virtual DOM layer, efficient one-way data binding, an asynchronous rendering pipeline (similar to React Fiber), and lazy-loading out of the box, and generates 100% standards-based Web Components that run in any browser supporting the Custom Elements v1 spec.

Stencil components are just Web Components, so they work in any major framework or with no framework at all. In many cases, Stencil can be used as a drop in replacement for traditional frontend frameworks given the capabilities now available in the browser, though using it as such is certainly not required.

Stencil also enables a number of key capabilities on top of Web Components, in particular Server Side Rendering (SSR) without the need to run a headless browser, pre-rendering, and objects-as-properties (instead of just strings).

Getting Started

to run the app :

pnpm start

To build the app for production, run:

pnpm run build

To run the unit tests once, run:

pnpm test

To run the unit tests and watch for file changes during development, run:

pnpm run test.watch