Skip to content

Gaby-L33/Amigo-Secreto-JS-Logic

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

4 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Secret Friend Draw - JS Logic Challenge 🎉

Completion Badge License Badge

[Project Page] App Screenshot

📋 Index

  1. Description
  2. Project Status
  3. Key Features
  4. Technologies Used
  5. User Guide
  6. Testing & Logic

📝 Description

Secret Friend is an interactive application designed to organize "secret santa" or "secret friend" draws easily. Users can input participant names and perform a random draw, displaying the result directly on the interface.

This tool is ideal for gatherings, parties, or any event where you want to add a touch of fun to gift exchanges.


✅ Project Status

Status: Completed

The application is fully functional and optimized for a seamless user experience.


✨ Key Features

  • Dynamic Entry: Users can add participants via a text field and an "Add" button.
  • Input Validation: Implements logic to prevent empty strings or invalid entries, ensuring data integrity.
  • Real-time Rendering: The list of names updates automatically on the UI as names are added.
  • Randomized Logic: Uses a JavaScript-based random selection algorithm for the "Draw Friend" button.
  • Instant Results: Clear display of the winner to facilitate the event flow.

🛠️ Technologies Used

  • HTML5: Content structure.
  • CSS3: Visual styling and responsive design.
  • JavaScript (ES6): Application logic, array management, and DOM manipulation.

🚀 User Guide

Step 1: Inputting Names

  1. Type a name in the "Escribe un nombre" field.
  2. Click "Añadir".
    • If empty: An alert appears saying "Por favor, escribe un nombre válido."

Step 2: List Management

The list updates dynamically. For example, adding Juan, Ana, and Carlos will render a visible list in real-time.

Step 3: Random Draw

  1. Once the list is ready, click "Sortear Amigo".
  2. The app selects one name randomly.
    • If the list is empty: An alert warns the user to add names first.

🔍 Testing & Logic

From a QA perspective, this project focuses on:

  • Edge Case Handling: Managing empty inputs and preventing draws with insufficient participants.
  • UI/UX Validation: Ensuring the list and results are clear and responsive for the end-user.

🎓 Credits

This project was developed as part of the Oracle Next Education (ONE) program with Alura Latam.

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors