The public website for Welcom'INT, the student association helping international students settle in at Télécom SudParis and IMT-BS on the Évry campus.
Built with Astro, it is a static, multilingual guide to campus life, practical services, events, and the associative foyer.
- A responsive association website with guides for arriving, housing, transport, studies, daily life, money and phone plans, administrative aid, and events.
- An interactive foyer map and association information.
- Localized pages in English, French, Spanish, Brazilian Portuguese, Simplified Chinese, Traditional Chinese, Hindi, Vietnamese, and Arabic (including right-to-left layout).
- Static-site output ready to serve from nginx or any static hosting provider.
The project uses Node.js 22.22.2 (see .nvmrc) and npm 10 or later.
nvm use
npm ci
npm run devAstro starts a local development server and prints its URL in the terminal. The default locale is English; other locales are served under paths such as /fr/ and /ar/.
| Command | Purpose |
|---|---|
npm run dev |
Start the local development server. |
npm run check |
Run Astro and TypeScript diagnostics. |
npm run lint |
Lint the source with ESLint. |
npm run build |
Create the production static site in dist/. |
npm run preview |
Preview the production build locally. |
Before opening a pull request, run:
npm run lint
npm run check
npm run buildsrc/
components/ Shared UI and page-body components
data/ Structured site data, including foyer information
i18n/ Locale registry, translations, and routing helpers
layouts/ Shared Astro layouts
pages/ Static and localized routes
styles/ Global styles and design tokens
public/
fonts/ Self-hosted web fonts
imgs/ Site images and SVG illustrations
deploy/ nginx configuration and deployment script
Translations live in src/i18n/locales/. The locale registry in src/i18n/config.ts controls the supported language list, display names, and text direction.
npm run build produces a fully static site in dist/. For the provided nginx deployment workflow, review deploy/nginx.conf, then run the deployment script on the target host:
sudo ./deploy/deploy.shThe script installs dependencies, builds the site, syncs dist/ to /var/www/welcom by default, and reloads nginx. Set WEBROOT and WEB_USER if the target uses different paths or ownership.
The CI workflow deploys a successful push to main over SSH. It fetches and fast-forwards /opt/Welcom to the exact commit that passed CI before running the existing deployment script.
Create the GitHub environment and secrets. In the repository, open Settings → Environments, create an environment named production, and add these environment secrets:
| Secret | Value |
|---|---|
DEPLOY_HOST |
Your production server hostname or IP address. |
DEPLOY_USER |
assowelcom. |
DEPLOY_SSH_KEY |
The complete contents of ~/.ssh/welcom_github_actions (the private key). |
DEPLOY_KNOWN_HOSTS |
The verified ssh-keyscan -H YOUR_SERVER_HOST output. |
This project is released under the MIT License.
