WeeklyGoals - Goal Tracking Application

A professional full-stack web application for tracking weekly goals across six life categories. Built for college presentation with production-ready architecture.

🚀 Quick Start

Development

npm install
npm run dev

Visit: http://localhost:5000

Demo Account

Email: demo@example.com
Password: demo1234

📦 Deployment

For College Presentation ⭐ RECOMMENDED

Railway.app (Free Trial) - See RAILWAY_DEPLOYMENT.md

• ✅ $5 free trial credit (15-30 days usage)
• ✅ Always-on (no sleeping, instant response)
• ✅ Professional platform for demos
• ✅ Easy to delete after presentation

Quick Start Guide →

For Long-Term Free Hosting

Render.com - See RENDER_DEPLOYMENT.md

• $0/month forever (with sleeping)
• Free PostgreSQL included
• Great for portfolios

📚 Documentation

• RAILWAY_DEPLOYMENT.md - Complete Railway setup (recommended for presentation)
• RAILWAY_QUICK_START.md - 10-minute quick start
• DEPLOYMENT_GUIDE.md - Full architecture explanation
• RENDER_DEPLOYMENT.md - Free long-term hosting option
• replit.md - Development guidelines

🛠️ Tech Stack

• Frontend: React 18 + TypeScript + Vite + TailwindCSS
• Backend: Node.js + Express + TypeScript
• Database: PostgreSQL + Drizzle ORM
• Auth: JWT + bcrypt
• Deployment: Render.com (free) or Railway (paid)

✨ Features

• 🎯 6 life categories (Personal, Inner Peace, Health, Family, Career, Fun)
• 📊 Weekly goal tracking (12 goals per week)
• 🏆 Achievement system (track, rock, slayed)
• 📈 Analytics dashboard with charts
• 👥 Social features (friends, activity feed)
• 🔐 Secure JWT authentication
• 📱 Responsive design

📖 Project Structure

├── client/              # React frontend
│   ├── src/
│   │   ├── pages/      # Page components
│   │   ├── components/ # Reusable UI components
│   │   └── lib/        # Utilities
├── server/              # Express backend
│   ├── index.ts        # Server entry
│   ├── routes.ts       # API routes
│   ├── auth.ts         # Authentication
│   └── storage.ts      # Database layer
├── shared/              # Shared code
│   └── schema.ts       # Database schema
└── docs/               # Documentation

🎓 For Your Presentation

URLs to Share

Live App: https://your-app.up.railway.app
GitHub: https://github.com/your-username/weekly-goals

Key Features to Demo

1. Sign up / Login
2. Select 12 weekly goals
3. Track progress in real-time
4. View analytics dashboard
5. Earn achievements
6. Add friends and share progress

Talking Points

• "Full-stack TypeScript application"
• "PostgreSQL for data persistence"
• "Deployed on Railway's cloud infrastructure"
• "Production-ready architecture with automatic CI/CD"
• "Secure authentication with JWT and bcrypt"
• "Always-on deployment with instant response times"

🔧 Development

# Install dependencies
npm install

# Start development server
npm run dev

# Build for production
npm run build

# Start production server
npm start

# Type check
npm run check

# Push database schema
npm run db:push

📊 Database Schema

11 tables supporting:

• User management
• Goal categorization
• Progress tracking
• Achievement system
• Social features
• Notifications

See DEPLOYMENT_GUIDE.md for complete schema details.

🌐 Live Demo

Visit your deployed app at: https://your-app.up.railway.app

⚠️ After Presentation

Remember to delete your Railway project after your presentation to avoid charges:

1. Railway Dashboard → Settings → Delete Project
2. Or see RAILWAY_DEPLOYMENT.md for details

📝 License

MIT

---

Built for college presentation - Ready for production deployment! 🎓