The juguetear-web from dialejo24

Juguetear es un proyecto solidario, sin fines de lucro, que tiene como objetivo adaptar juguetes para niñes con discapacidades motrices complejas y ofrecerlos en calidad de préstamo, sin costo para las familias.

En el Taller de ayudas técnicas de APRILP se adaptan juguetes a pilas que se consiguen a través de donaciones, para luego prestarlos a las familias de niñes con discapacidades motrices complejas para que puedan jugar con pulsadores o switches de distintos tipos.

La web de Juguetear surge como respuesta a la necesitad de modernizar y mejorar el sistema de préstamos de los juguetes, hacer visible la obra de quienes trabajan en el taller e incentivar la replicación del proyecto.

Cómo contribuir

Actualmente hay varias formas de contribuir al proyecto Juguetear:

Con materiales
Aportando a este repositorio
Replicando el proyecto en tu ciudad

Con materiales

Si querés donar juguetes a pilas y/o diversos materiales contactarse a través del email [email protected]

Aportando a este repositorio

Aca puedes ver el Tech Stack usado en este repositorio.

Si tenés interés en colaborar con el repositorio, consultá contributing.md para conocer las formas de comenzar a contribuir, tené en cuenta que tenemos ciertos lineamientos.

⚠️ Por favor, leer y adherir al código de conducta de este proyecto.

Replicando el proyecto en tu ciudad

La naturaleza libre y solidaria de esta idea no se refiere solo a la posibilidad de que las familias de niñes con discapacidades motrices complejas puedan acceder a los juguetes sin ningún costo sino que, además, queremos que se pueda replicar en todos los lugares donde haya instituciones y personas con voluntad para llevarlo adelante. Para saber como replicar el proyecto, por favor lee nuestra documentación.

Comunidad

Este proyecto se desarrolla con la participación y el apoyo de FrontendCafé. Es requerido unirte a nuestro server y buscar el canal #juguetear. Ahí vas a poder compartir dudas e ideas del proyecto. El código de conducta de este proyecto es extensible también a tu participación en el server de FrontendCafé en Discord.

Requerimientos

Tener instalada una versión de Node superior a v16.16.0 (incluye npm)
Tener un editor de texto (Visual Studio Code, Vim, etc)
Tener una cuenta en GitHub
Leer y seguir Código de Conducta
Unirte a FrontendCafé en Discord

Despliegues

Web: https://juguetear-web.vercel.app/
Storybook: https://storybook-juguetear-web.vercel.app/
Sanity Studio: https://juguetear-web.vercel.app/studio

Diseño de interfaz (UI/UX)

La interfaz del proyecto fue completamente desarrollada por Mariana Lessi.
Puedes acceder a este enlace para ver los diseño de la web.

💡 Cualquier duda, feedback o sugerencia podés compartirla en el canal #juguetear del server de FrontendCafé en Discord.

Accesibilidad

Quienes administramos este repositorio nos comprometemos a hacer todo lo posible por garantizar la accesibilidad digital para personas con discapacidades. Estamos continuamente mejorando la experiencia del usuario y aplicando los estándares de accesibilidad pertinentes.

Las Pautas de Accesibilidad para el Contenido Web (WCAG) definen los requisitos para que les diseñadores y desarrolladores mejoren la accesibilidad para las personas con discapacidades. Éste define tres niveles de conformidad: Nivel A, Nivel AA y Nivel AAA.

Parte importante de los requerimientos a la hora de contribuir con este proyecto es cumplir al menos con los requisitos WCAG 2.1 nivel AA.

Por favor, si encontrás barreras de accesibilidad en la web de Juguetear enviando un email a [email protected] o abrí un issue. Para hacerlo, necesitás leer la documentación sobre cómo contribuir.

Tech Stack

Nuestro tech stack consiste en las siguientes tecnologías:

💡 No hace falta tener mucho conocimiento en el tech stack para poder contribuir.

NextJS o ReactJS
TypeScript o JavaScript
Tailwind CSS
Storybook
Sanity
Jest

Has click aquí, para ver extensiones recomendadas para VSCode

Correr el Proyecto Localmente

Instalación

Ubícate en la carpeta donde deseas instalar el proyecto y clona el repositorio ejecutando:

git clone https://github.com/Juguetear/juguetear-web.git
cd juguetear-web

Posteriormente ejecutá el siguiente comando para instalar todas las dependencias listadas en el archivo package.json.

yarn install

💡 Hacé click aquí si te aparece un error que dice yarn: command not found

Quiere decir que no tenés instalado yarn. Para instalarlo, primero asegurate de tener instalada una versión Node superior a v16.16.0 y luego instalar yarn via npm (node package manager) ejecutando:

npm install --global yarn

💡 Podés leer más en este artículo.

Correr el entorno de desarrollo localmente

Una vez hechos los pasos de instalación ejecutá el siguiente comando:

yarn run dev
# o solo
yarn dev

Se iniciara el servidor de desarrollo, visitá http://localhost:3000 en tu navegador para ver la aplicación.

Dentro del mismo servidor de desarrollo se tiene acceso a Sanity Studio, visitá http://localhost:3000/studio para visualizar el dashboard.

💡 Hacé click aquí para obtener más información para el acceso al dashboard de Sanity Studio

Para tener accesso al dashboard de Sanity Studio, dejá un mensaje en el canal #juguetear de Discord avisando a quienes administran los accesos: @nykka, @TonyMckes o @LPRegen.

Correr Storybook localmente

Para iniciar Storybook en tu entorno local, desde la consola de comandos tenés que ejecutar:

yarn storybook

Se iniciará el servidor de Storybook. Visitá http://localhost:6006 en tu navegador para ver los componentes.

⚠️ Asegúrate de haber leido como contribuir, y recuerda que si tenés dudas puedes preguntarnos en el canal #juguetear en Discord.

Contribuidores

Made with contrib.rocks.

Staff

Coordinador del taller de ayudas técnicas
Sergio Ruau

Consultor / Asesor
Antonio Sacco

Diseño UX/UI
Mariana Lessi

Desarrollo y administración del repositorio
Verónica García (@nykka)

Manuel Escribano (@LPRegen)

Anthony Mackensen (@TonyMckes)

Licencias

Este repositorio se publica con licencia GNU General Public License v3.0.

El contenido de la web de Juguetear se publica con licencia Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International.

dialejo24 / juguetear-web Goto Github PK

juguetear-web's Introduction