Nuspace.kz

The superapp for NU students, offering campus services, announcements, and student essentials in one trusted, convenient platform.

Table of Contents

• Nuspace.kz
  • Tech Stack
  • Prerequisites
  • Quick Start
  • Documentation
  • Contributing
  • License
  • Contact

Tech Stack

Backend

Frontend

DevOps & Infrastructure

Prerequisites

Before setting up the project, ensure you have the following installed:

• Docker
• Git

Quick Start

1. Clone the Repository

git clone https://github.com/ulanpy/nuspace.git
cd nuspace/infra

2. Configure Environment Variables

Create a .env file using the provided example:

cp .env.example .env

Important: Add your TELEGRAM_BOT_TOKEN (create a bot through @BotFather if needed).

3. Build and Run

Start the application using Docker Compose:

# syntax from Compose v2.0 and above
docker compose up --build

# If older version try
docker-compose up --build

4. Verify Setup

Access the application at localhost to confirm everything is running correctly.

Documentation

• Workload Identity Federation - GitHub Actions authentication with GCP for CI/CD pipeline
• Monitoring Guide - What monitoring service stack is used and their connection details
• Terraform Setup - Provision cloud services for stage/production environments by IoC
• WireGuard VPN - Secure VPN access to monitoring tools and internal services
• SSH Access - Production/Staging server SSH is available only via VPN and OS Login

Contributing

We welcome contributions! Please read the CONTRIBUTING.md file for detailed guidelines.

License

This project is licensed under the MIT License. See the LICENSE file for details.

Contact

For questions or support, reach out to:

• Email: ulan.sharipov@nu.edu.kz
• Nuspace dev chat: https://t.me/nuspacedevcommunity