Skip to content

hrtshpdbx1/social-script-v1-vanilla

Repository files navigation

🤝 SocialScript : Simulateur d'Entraînement Social

JS A11y Status

A vanilla JS app to practice social interactions, without pressure and without judgment.

SocialScript was built to help neurodivergent individuals (autism, ADHD) and anyone who wants to build assertiveness skills practice everyday social situations in a safe space, with immediate educational feedback on each choice made.

This is the original prototype. The project has since been rebuilt as a fullstack application. Check out SocialScript v2 for the current version.


✨ What it does

  • Interactive scenarios: 3 difficulty levels (Easy, Medium, Hard), each with an immediate educational breakdown of every choice
  • Inclusive avatars: random avatar generation via the DiceBear API for a more personal experience
  • Accessible by design: semantic HTML structure optimized for screen readers
  • Educational feedback: every response option is explained to help decode the unspoken rules of social interactions

🛠️ Tech stack

Layer Technology
Frontend HTML5 / CSS3 / JavaScript ES6+
Data Static db.json file
API simulation json-server + Axios
Avatars DiceBear API

📁 Project structure

SocialScript/
├── data/
│   └── db.json        # Scenario database
├── scripts/
│   └── app.js         # JS logic (scenarios, avatars, Axios calls)
├── index.html         # Accessible user interface
└── README.md

⚙️ Run the project locally

Requirements

  • Node.js (for the data server)
  • Live Server extension (VS Code)

Setup

# 1. Clone the repository
git clone <project-url>
cd SocialScript

# 2. Start the data server
json-server --watch data/db.json --port 3000

# 3. Start the frontend
# Open index.html with Live Server in VS Code

Live Server is required so that Axios requests work correctly in the browser.


📜 License and credits

  • License: free educational project
  • Avatar credits: DiceBear API (MIT and CC BY 4.0 licenses)

👤 Author

Louise Moraldy LinkedIn · Portfolio

This project was built with the belief that code can be a tool for social inclusion.

About

Initial prototype of the Social Script interactive simulator. Built with Vanilla JavaScript, HTML5, and CSS3 to focus on accessibility and core UI/UX logic.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors