Nexpenz API Backend for Personal Finance App

🛠 Tech Stack

• Language: Python 3

• Backend Framework: Django

• API Framework: Django REST Framework

• API Auth: djangorestframework-api-key

• Database: MySQL, SQLite3

• Containerization: Docker & Docker Compose

• CI/CD: GitHub Actions

• OS Tested On: Linux (Ubuntu recommended)

---

🔥 Overview

Nexpenz API is a simple, fast, and secure backend API for a personal finance tracking mobile application. It powers the Nexpenz Android app, enabling users to track income, expenses, and view financial summaries — without signup or ads.

---

🚀 Features

• ✅ Add income & expenses instantly

• 📈 Monthly summaries & category-based analytics

• 🧾 Full transaction history

• 🌍 Multi-currency support

• 🔐 API key authentication (no login/signup)

• 🧡 100% free — no ads, no tracking

• 🐳 Docker-ready

• 🧪 CI-tested on Linux

---

🐧 OS Support

| OS | Status | |--------|--------| | Linux | ✅ Fully supported & recommended | | macOS | ✅ Supported | | Windows| ⚠️ Supported (WSL recommended) |

Tested on Linux (Ubuntu). Linux is recommended for production.

---

🔑 API Authentication

This API uses API Key authentication:

• Log in to Django Admin

• Navigate to API Keys

• Create a key

• Copy it once (shown only once)

Or go to Nexpenz API Signup to generate a key.

---

📦 Example API Usage

GET /api/transactions/ Header: X-API-KEY: your_api_key_here

---

📱 Download APK

http://localhost:8000/download_nexpenz

---

⚙️ Local Setup (Linux / Windows)

1. Clone the repo

git clone https://github.com/nexapytech/Expense-Tracker-app cd Expense-Tracker-app

---

⚙️ Make Commands

To make your repo easy to run and test, we provide a Makefile:

Run the API locally

make run

Run all tests

make test

---

2. Docker Setup (Recommended)

```bash docker build -t nexpenz . docker run -p 8000:8000 nexpenz