Skip to content

kushagra486/Smart-Budget-Assistant

Repository files navigation

███████╗███████╗██████╗ ██████╗ ██████╗ ██╔════╝██╔════╝██╔══██╗██╔═══██╗██╔═══██╗ █████╗ ███████╗██████╔╝██║ ██║██║ ██║ ██╔══╝ ╚════██║██╔═══╝ ██║ ██║██║ ██║ ███████╗███████║██║ ╚██████╔╝╚██████╔╝ ╚══════╝╚══════╝╚═╝ ╚═════╝ ╚═════╝

Medo Full Stack Project — Next.js + Tailwind + API + Android WebView

This repository is a complete, ready-to-upload GitHub project that lets anyone:

  • Run a modern Next.js + Tailwind frontend
  • Use built-in API routes (Next.js) to accept contact forms
  • Optionally run an Express backend (included)
  • Use NextAuth placeholders for authentication
  • View API documentation (OpenAPI)
  • Build a simple Android WebView app that wraps the website (Android Studio)

Contents

  • /nextjs/ → Next.js + Tailwind app (frontend + API)
  • /backend/ → Optional Express backend (for microservice)
  • /android-webview/ → Android Studio WebView app skeleton
  • /docs/ → openapi.yaml and architecture notes
  • README.md → this file (what you're reading)
  • .env.example → environment variable template

Quick Start (development)

  1. Unzip the archive.

  2. Frontend (Next.js)

    • cd nextjs
    • npm install
    • cp .env.example .env.local # edit MONGODB_URI, NEXTAUTH_SECRET, etc.
    • npm run dev
    • Open http://localhost:3000
  3. Optional Backend (Express)

  4. Android WebView

    • Open /android-webview in Android Studio
    • Replace WEB_URL in MainActivity.java with your deployed URL or localhost via ngrok
    • Build → Generate Signed Bundle / APK

Repository Structure

(nextjs) ├─ package.json ├─ next.config.js ├─ tailwind.config.js ├─ src/pages │ ├─ index.tsx │ ├─ _app.tsx │ └─ api/forms.ts └─ src/lib/mongodb.ts

(android-webview) ├─ app/ │ ├─ src/main/AndroidManifest.xml │ ├─ src/main/java/com/medo/webview/MainActivity.java │ └─ src/main/res/layout/activity_main.xml └─ build.gradle

(backend) ├─ server.js └─ backend controllers / models

Docs

  • docs/openapi.yaml — minimal OpenAPI spec for the forms API
  • docs/DEPLOY.md — deployment guides for Vercel, Render, Railway

Notes

  • This repo is scaffolded so anyone can upload to GitHub and deploy.
  • Replace placeholder secrets and API keys in .env.local before deploying.
  • For production, use MongoDB Atlas and a proper email provider for NextAuth.

If you'd like, I can:

  • Push this directly to a GitHub repo I create (I cannot access your GitHub account).
  • Generate detailed screenshots and sample admin user accounts.
  • Provide a script to auto-deploy to Vercel.

Enjoy! — If you want the repo zipped for download, it's ready below.

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors