Skip to content

AntoineGuglielmi/polariisXnextjs

Repository files navigation

Polariis X Next.js

Polariis embodies a vision of digital accessibility that is both enhanced for people with disabilities and streamlined for web developers.

Built on top of a Next.js project, Polariis leverages AI to transcribe and interpret user needs expressed through speech, provide more or less detailed descriptions of the page currently being viewed, or trigger a series of actions (click, scroll, focus).

The project follows the standard structure of a Next.js application. At the root of the project, a polariis/ folder contains the core development and main features. The rest of the Next.js application serves as the demo site, acting as a testing ground for these features.

Polariis development

The Polariis part contains the core of the project and the main features, all developed within the polariis/ folder.

Configuration

Polariis relies on several AI services:

  • Mistral AI: for audio transcription, chat completion, and vision.
  • ElevenLabs: for voice generation.

To test and use Polariis, you need to:

  1. Create an account on MistralAI and ElevenLabs (a free account is sufficient).
  2. Generate API keys for each service.
  3. Add the keys to a .env file at the root of the project, based on the .env.example file:
MISTRAL_API_KEY=your_api_key
ELEVENLABS_API_KEY=your_api_key

This setup allows the application to access the AI services required for Polariis to function.

Running Polariis

After configuring the API keys, start the development server with:

npm run dev

Then open http://localhost:3000 in your browser to access the homepage listing all demo sites. Click on a site to go to its homepage.

To activate Polariis, press Tab (or Shift + Tab) to focus the trigger button, currently located in the top-left corner of the screen:

Polariis Trigger Button

Then press Enter. You can then speak your request aloud, and Polariis will process it and trigger the corresponding feature.

During development, logs are displayed in the console, allowing you to follow Polariis’ execution flow and monitor its behavior.

Demo site development

The site part is structured to host multiple demo websites. Each website corresponds to a dedicated folder (route) located at the root of the app/ directory.

For example:
The app/cowork/ folder contains the Cowork site, with its layout, main page, and related routes.
If a new site is added, it will be created in a app/new-site/ folder following the same structure.

This setup makes it possible to develop and test multiple independent demo sites while sharing Polariis features.

Each demo site is based on a mockup, which serves as a reference for designing the pages.

Site Folder in app/ Mockup link
Cowork app/cowork/ Figma

Git flow

About

Polariis is a prototype designed to simplify and enhance digital accessibility. It enables experimenting with voice interaction on websites using AI, and provides developers with an environment to test and develop advanced accessibility features.

Topics

Resources

Stars

Watchers

Forks

Contributors

Languages