Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/rtajio/ESEN/llms.txt

Use this file to discover all available pages before exploring further.

ESEN is a fully static application built with plain HTML, CSS, and JavaScript — no framework, no build tool, no package manager. Deploying it means copying the project folder to a static hosting provider and receiving a public URL. The entire process takes under two minutes. All features work identically whether you open the app locally from your file system or visit it at a deployed URL.

​
Opening locally (no deployment needed)

If you only need to run ESEN on your own machine, you do not need to deploy it at all.
1

Open index.html in your browser

Double-click index.html in the project folder, or drag it into an open browser window. There is no npm install, no build step, and no local server to start. The app runs entirely in the browser.
ESEN stores all data in browser memory for the current session only — there is no localStorage, no database, and no API. A page refresh resets all data to the built-in demo values. A deployment makes the app accessible from any device via a shared URL, but data is not shared between sessions.

​
Deploy to Vercel

Vercel is the recommended hosting platform for ESEN. The included vercel.json file configures the static build and applies security headers automatically.
Deploy directly from the Vercel dashboard without installing anything.
1

Create a Vercel account

Go to vercel.com and create a free account if you do not already have one.
2

Start a new project

In your dashboard, click Add New → Project.
3

Upload the project folder

Select Upload and drag the entire esen/ folder into the upload area.
4

Deploy

Click Deploy. Vercel builds and serves the project in under 30 seconds and gives you a public URL such as https://esen.vercel.app.

​
Deploy to Netlify

Netlify supports deploying static sites with a single drag-and-drop action.
1

Open the Netlify dashboard

Go to netlify.com and log in or create a free account.
2

Drag and drop the project folder

On the dashboard, locate the drag-and-drop deployment area and drag the entire esen/ folder into it.
3

Receive your public URL

Netlify processes the upload and immediately provides a public URL for your site. No additional configuration is required.

​
The vercel.json configuration

The project includes a vercel.json file that tells Vercel how to serve the site and what security headers to attach to every response. You do not need to edit this file.
vercel.json
{
  "version": 2,
  "builds": [
    {
      "src": "**/*",
      "use": "@vercel/static"
    }
  ],
  "routes": [
    {
      "src": "/(.*)",
      "dest": "/$1"
    }
  ],
  "headers": [
    {
      "source": "/(.*)",
      "headers": [
        { "key": "X-Content-Type-Options", "value": "nosniff" },
        { "key": "X-Frame-Options",        "value": "DENY"    },
        { "key": "X-XSS-Protection",       "value": "1; mode=block" }
      ]
    }
  ]
}
FieldValuePurpose
version2Vercel platform version
builds[].use@vercel/staticServes all files as a static site with no build step
X-Content-Type-OptionsnosniffPrevents MIME-type sniffing attacks
X-Frame-OptionsDENYBlocks the site from being embedded in iframes
X-XSS-Protection1; mode=blockEnables the browser’s built-in XSS filter

​
After deployment

Once the deployment finishes, you receive a public HTTPS URL. Visit it in any browser and you will see the ESEN login screen. Every feature — logging in, registering activities, viewing the student history, exporting CSV reports — works identically to running the app locally. No backend, no database, and no additional configuration is needed.
ESEN stores all data in the browser’s memory for the duration of the session. Data does not persist between page reloads unless you extend app.js to use localStorage. This is expected behavior for the current version.

Build docs developers (and LLMs) love

Get started for freeTalk to us