Guidefox

Guidefox helps app owners build knowledge and user-experience oriented apps. It includes the following features:

• Welcome tours (in progress)
• Popups
• Banners
• Helper links
• Hints

The source code is available under GNU AGPLv3. If you would like to support us, please consider giving it a ⭐ and click on “watch” so you can latest news from us.

Tech stack

• ReactJs
• MUI (React framework)
• Node.js
• PostgreSQL

Installation

1. Make sure Docker is installed to your machine where the server will run.

2. Make sure git is installed to your machine Git.

3. Make sure nginx is installed.

4. Clone GitHub Repository

cd ~
git clone https://github.com/bluewave-labs/guidefox.git
cd bluewave-onboarding

5. Configure Nginx

Open the Nginx configuration file:

sudo nano /etc/nginx/sites-available/guidefox

Add the following configuration. Change YOUR_DOMAIN_NAME with your domain name:

server {
    listen 80;
    server_name YOUR_DOMAIN_NAME;
    return 301 https://$host$request_uri; 
    }

server {
    listen 443 ssl;
    server_name YOUR_DOMAIN_NAME;
    ssl_certificate /etc/letsencrypt/live/YOUR_DOMAIN_NAME/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/YOUR_DOMAIN_NAME/privkey.pem;
    include /etc/letsencrypt/options-ssl-nginx.conf;
    ssl_dhparam /etc/letsencrypt/ssl-dhparams.pem;

    location / {
        proxy_pass http://localhost:4173; # Frontend React app
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }

    location /api/ {
        proxy_pass http://localhost:3000; # Backend API
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
    location /mailhog/ {
        proxy_pass http://localhost:8025; # MailHog web interface
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection 'upgrade';
        proxy_set_header Host $host;
        proxy_cache_bypass $http_upgrade;
    }
}

6. Create a symbolic link to enable the configuration:

sudo ln -s /etc/nginx/sites-available/guidefox /etc/nginx/sites-enabled/

7. Install Certbot and its Nginx plugin:

sudo apt install certbot python3-certbot-nginx

8. Obtain SSL Certificate. Run Certbot to obtain a certificate for your domain:

sudo certbot --nginx

9. Verify the Nginx configuration:

sudo nginx -t

10. Restart Nginx to apply the changes:

sudo systemctl restart nginx

11. Start the project

cd ~/guidefox docker compose up -d

Contributing

We pride ourselves on building strong connections with contributors at every level. Don’t hold back — jump in, contribute and learn with us!

• Star this repo 😃
• Check Contributor’s guideline
• Have a look at our Figma designs here. We encourage you to copy to your own Figma page, then work on it as it is read-only.
• Open an issue if you believe you’ve encountered a bug
• Make a pull request to add new features/make quality-of-life improvements/fix bugs.
• Make sure your send your PRs to develop branch.

Also check other developer and contributor-friendly projects of BlueWave:

• Checkmate, a server and infrastructure monitoring tool
• DataRoom, an secure file sharing application, aka dataroom.
• BlueWave HRM, a complete Human Resource Management platform.
• VerifyWise, the first open source AI governance platform.