fun-project

🚀 Deployment Guide

This application requires a Node.js server to run, so it cannot be hosted on GitHub Pages (which only supports static files). Here are the best free hosting options:

Option 1: Deploy to Render (Recommended - Free)

1. Create a Render Account
   • Go to render.com
   • Sign up with your GitHub account
2. Deploy Your App
   • Click “New +” → “Web Service”
   • Connect your GitHub repository: jayantajm1/fun-project
   • Render will auto-detect the render.yaml file
   • Click “Create Web Service”
3. Your App Will Be Live!
   • Render will provide a URL like: https://fun-project.onrender.com
   • This will be your default landing page with the proposal creator

Note: Free tier may sleep after 15 minutes of inactivity. First request will wake it up (takes ~30 seconds).

---

Option 2: Deploy to Railway (Free)

1. Create Railway Account
   • Go to railway.app
   • Sign in with GitHub
2. Deploy
   • Click “New Project” → “Deploy from GitHub repo”
   • Select jayantajm1/fun-project
   • Railway auto-detects Node.js
   • Click “Deploy”
3. Get Your URL
   • Go to Settings → Generate Domain
   • Your app will be live at the generated URL

---

Option 3: Deploy to Vercel (Free)

1. Install Vercel CLI (or use their website)

   npm install -g vercel
   

2. Deploy from your project folder

   cd "d:\Freelancing project\fun-project"
   vercel
   

3. Follow the prompts
   • Link to your GitHub account
   • Deploy!

Note: The vercel.json file is already configured for you.

---

Option 4: Local Hosting (For Testing)

If you just want to share with friends locally:

1. Start the server:

   npm start
   

2. Share your local IP:
   • Find your local IP: ipconfig (Windows) or ifconfig (Mac/Linux)
   • Share: http://YOUR_LOCAL_IP:3000
   • Friends on the same WiFi can access it
3. Or use ngrok for public URL:

   # Install ngrok from ngrok.com
   ngrok http 3000
   

   • Ngrok gives you a temporary public URL

---

Environment Variables (If Needed)

For production deployments, you may want to set:

• PORT - The port number (most hosts set this automatically)
• NODE_ENV=production - For production mode

---

Database Persistence

Important: The SQLite database (proposals.db) needs persistent storage:

• Render: Automatically provides persistent disk (Free plan: limited storage)
• Railway: Provides persistent volumes
• Vercel: Serverless - database will reset! Not recommended for this app.

For long-term production, consider upgrading to PostgreSQL or MongoDB with these platforms.

---

Recommended: Render

For this project, Render is the best free option because: ✅ Free tier with persistent disk ✅ Easy GitHub integration ✅ Auto-deploys on git push ✅ Custom domains supported ✅ HTTPS included

---

Quick Deploy Button

You can add this to your README.md:

Just click the button and follow the steps!