Skip to content

Interactive exercises for honing advanced language skills

Notifications You must be signed in to change notification settings

A-L-P-s/alps-ui

Repository files navigation


Logo

Advanced Language Practices (ALPs)

Improve your language skills with inspiring images & immediate feedback!



Now that you've "climbed the mountain" of learning another language, keep your skills fresh with regular practice! Language output (speaking & writing) is key but can get dull with routine drills, plus you may never know if it's entirely correct.
🔸
With ALPs, every writing challenge comes with an inspiring image to ignite your imagination, a random verb & grammar points to help focus your language, and immediate feedback with the help of AI!


Visit the ALPs website!


Video Presentation

Table of Contents

  1. About The Project
  2. Getting Started
  3. WireFrames
  4. Future Iterations
  5. Contributors

About the Project

🔸 Deployed Site
🔸 Backend Service
🔸 Back End Repository


ALPs was created by a cross-functional development team of students from the Turing School of Software and Design as their capstone project.

The mission of ALPs is to provide users with writing promts that ignite their imagination and provide immediate feedback on their language output.

Users simply choose their target language via an avatar to start a new challenge. When they begin, they'll see a random verb, inspiring image, and multiple grammar points to create fresh, unique sentences. Once they submit the challenge -- with the help of AI -- immediate feedback and correct sentences are provided so they can review and learn even faster! Users also have the option to email a copy of their work to themselves since tracking personal progress not only expediates growth but also cultivates confidence!


Agile Methodology

This method is a flexible and iterative approach to project management that focuses on collaboration, adaptability, and continuous improvement.

ALPs Agile Workflow:

  • Planning and outling an MVP.
  • Continuous integration and continuous deployment using GitHub actions (CI) and GitHub pages (CD).
  • Daily Standups with FE and BE teams.
  • Weekly retros to reflect & improve

Built With

Collaboration Tools

Postman GitHub Git

Frontend Technologies

TypeScript ESLint React Cypress

Packages Used

  • React Spinners
    • NPM package used for loading animation viewed while challenge submission is being processed
  • React Modal
    • NPM package used for instructions pop up on prompt page
  • @types/react-modal
    • NPM package used for type definitions for implementing the react modal in TypeScript

(back to top)

Getting Started

If you'd like to demo this application on your local machine:

  1. Fork and clone this repo: git clone git@github.com:A-L-P-s/alps_ui.git
  2. Visit the Backend Repo and follow the steps to demo the ALPs API locally
  3. Navigate to the root folder: cd alps_ui
  4. Run: npm install to install necessary dependencies
  5. Run: npm start to open the local host on your machine

Testing

To run the test specs in Cypress, run npm run cypress in your terminal within your Apls UI repo!

WireFrames

HomePage
User Dashboard
New Challenge Page
Individual Challenge Page

(back to top)

Future Iterations

See Refactoring Suggestions
🔸 Delete Past Challenge
- Allow users to delete challenges that they do not want to see on their dashboard! This would require adding a button on the past challenge feedback component that would hit the existing BE delete endpoint.
🔸Login Page
- Add input fields to authenticate user and save their data.
🔸More Languages
- We currently have data and functionality for practicing Spanish, Turkish, and Vietnamese. In the future, we would love to update our application to support more languages!
🔸More Practice
- Currently, a singular challenge prompts the completion of 2 sentences. In the future, we would love to add more sentences/different activities to exercise language knowledge!

(back to top)

Contributors


Kirk Hauck Bea Ordonez Katherine Blaine Tyalor Pridgen Brian Zanti
Kirk Hauck Bea Ordonez Katherine Blaine Tyalor Pridgen Brian Zanti
Frontend Developer Frontend Developer Frontend Developer Project Mentor Project Manager
GitHub GitHub GitHub GitHub GitHub
LinkedIn LinkedIn LinkedIn LinkedIn LinkedIn

Caleb Thomas James Taylor Huy Phan David Marino Melony Erin Franchini
Caleb Thomas James Taylor Huy Phan David Marino Melony Erin Franchini
Backend Developer Backend Developer Backend Developer Backend Developer Backend Developer
GitHub GitHub GitHub GitHub GitHub
LinkedIn LinkedIn LinkedIn LinkedIn LinkedIn

(back to top)

About

Interactive exercises for honing advanced language skills

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 3

  •  
  •  
  •