Skip to content

warehouseman/meteor-mantra-kickstarter

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

CircleCI Dependency Status devDependency Status Join the chat at https://gitter.im/meteor-mantra-kickstarter/MeteorMantraKickStarter Commitizen friendly

Meteor Mantra Kickstarter

screen register

tl, dr!

This is a starter app for Meteor developers who want to structure their work according to the Mantra Specification.

Please feel welcome to comment on any experience you have with it in the Meteor Forum, but flag with @warehouseman to get my attention. ( for reference, prior discussion venues are available here and, even earlier, here )

Features

You get :

Getting started

My default development, test and run environment is a virtual machine running Xubuntu Xenial Xerus, with 12Gb of disk, 3Gb memory and 2 processors.

If you are in a disposable virtual machine with a recent fresh Ubuntu installation, you can follow the steps below more or less blindly. Please, do NOT do this in a machine that has stuff you care about!

  1. Pull in your GitHub SSH credentials from somewhere, for example a sister VM...

    pushd ~/.ssh;
    scp -r 192.168.122.xxx:/home/you/.ssh .;
    popd;
    
    
  2. Ensure dependencies are clean and up-to-date :

    sudo apt-get -y update && sudo apt-get -y upgrade && sudo apt-get -y dist-upgrade && sudo apt-get -y clean && sudo apt-get -y autoremove;
    
    
  3. Install and configure git :

    sudo apt -y install git;
    git config --global user.name "You Yourself";
    git config --global user.email "[email protected]";
    git config --global credential.helper cache;
    git config --global credential.helper 'cache --timeout=36000';
    git config --global push.default simple;
    
    
  4. Make a parent directory and step into it :

    mkdir -p ~/projects;
    cd ~/projects;
    
    
  5. Clone our repository and step into it :

    git clone [email protected]:warehouseman/meteor-mantra-kickstarter.git;
    cd meteor-mantra-kickstarter;
    
    
  6. Switch over to our branch :

    git checkout AsSub;
    git branch # verify being on AsSub;
    
    
  7. Run the script to set up for development and testing (installs Java, NodeJS, Chimp, Meteor and the project's NodeJS package dependencies) :

    meteor npm run install_all;
    
    
  8. Prepare your settings.json file :

    Using template.settings.json.sh you can generate your settings.json file automatically from environment variables. So, if you edit the file settings.sh and then source it, you will load the entries as environment variables

    cat EXAMPLE_settings.sh;
        export MAILGUN_DOMAIN="";
        export MAILGUN_KEY="";
        export LOGGLY_SUBDOMAIN="";
        export LOGGLY_TOKEN="";
        export PG_DB=""; # PostgreSQL database name
        export PG_UID=""; # PostgreSQL user ID of Meteor app
        export PG_PWD=""; # PostgreSQL user password of Meteor app
        export PG_HST=""; # PostgreSQL server host name
        export PG_BKP=""; # HTTP URL of a PostgreSQL database backup
    
    cp EXAMPLE_settings.sh settings.sh;
    nano settings.sh;
    source settings.sh;
    
    

    You can keep that file out of harm's way, and using template.settings.json.sh when needed to create settings.json just before launching your Meteor app.

    ./template.settings.json.sh > `settings.json`
    
    

    Obviously, you'll need to go get your Mailgun API key. and your Loggly domain token, to set the corresponding values in settings.sh.

    • Note : If you don't care whether password reset works, you don't need Mailgun. In that case, you can use this as your API key ... key-dead0dead0dead0dead0dead0dead000.
  9. Now we can run Meteor and explore at http://localhost:3000 :

    meteor npm run run_development;
    
    

    (The first time through, you may see it terminate with the message killed. Just run it again.)

  10. Open a new terminal window to run linting and unit-tests :

    cd ~/projects/meteor-mantra-kickstarter;
    npm test;
    
    

    A goodly portion of the client side is fully tested using the familiar tools Mocha, Chai and Sinon.

  11. Open another terminal window and run acceptance tests :

    source ~/.profile; # if you haven't logged out since running 'install_all'
    cd ~/projects/meteor-mantra-kickstarter;
    meteor npm run acceptance;
    
    
  12. See the scripts section of package.json for details of other testing and setup commands.

  13. Return to your original terminal window and build for Android :

    export KEYSTORE_PWD="obscuregobbledygook";
    export HOST_SERVER_NAME="http://moon.planet.sun:3000/";
    export ROOT_URL="${HOST_SERVER_NAME}";
    export YOUR_FULLNAME="You Yourself";
    export YOUR_ORGANIZATION_NAME="YourOrg";
    
    meteor npm run build_all;
    meteor npm run run_development;
    
    
  14. Debug in Android in a Xubuntu virtual machine :

    To see how to debug an Android app between two virtual machines watch Meteor / CircleCI Tutorial -- Bonus - Debug your Android App in a Virtual Machine

    Set up server IP address in KitKat machine from the server ...

    you@yours:~$ ifconfig                           # Grab IP address to clipboard
    you@yours:~$ adb connect 192.168.122.174        # Start a connection to KitKat host (as shown in video)
    you@yours:~$ adb devices -l                     # Make sure the host is listed
    you@yours:~$ adb shell                          # Get into the Android terminal shell
    uid=2000(shell)@x86:/ $ su                      ## Get root privileges
    uid=0(root)@x86:/ $ mount -o remount,rw /system ## Allow to write
    uid=0(root)@x86:/ $ vi /system/etc/hosts        ### Edit to add the server (paste in IP addresss and whatever you used for ${HOST_SERVER_NAME})
    uid=0(root)@x86:/ $ mount -o remount,ro /system ## Go back to read-only
    uid=0(root)@x86:/ $ exit                        ## Get out
    uid=2000(shell)@x86:/ $ ping moon.planet.sun    # See if it worked
    
    
  15. Serve up occasional public demos directly from your developer machine via NGrok:

    If you want to see an Android phone running the app from a server on the web, without having to go through all the server setup effort, ngrok makes it easy:

    1. Use you GitHub gredentials to log in through NGrok's login/sign-up page

    2. Download NGrok

    3. Install it somewhere...

      cd ~;
      mkdir -p utilities;
      cd utilities;
      unzip ~/Downloads/ngrok*.zip;
      
    4. Copy Your Tunnel Authtoken from the Auth tab

    5. Install your token :

      ./ngrok authtoken 2RCuUd7C8Qi5qMJJQAmD6_25xo9VDPpfiZXgTk2kY8X;
      
    6. Start an http tunnel to port 3000 :

      ./ngrok http 3000;
      
    7. Return to your project root and build for Android, specifying the ngrok "forwarding" address for the HOST_SERVER_NAME to which remote mobile devices should connect :

      export EXTERNAL_DOMAIN="a9a18d90.ngrok.io";
      export HOST_SERVER_NAME="http://${EXTERNAL_DOMAIN}/";
      
      ./build_all.sh;
      
    8. Start up meteor on localhost:3000 as usual, but specify ROOT_URL to match HOST_SERVER_NAME.

      export ROOT_URL="${HOST_SERVER_NAME}";
      meteor --settings=settings.json;
      

      You should see :

      [[[[[ ~/projects/meteor-mantra-kickstarter ]]]]]
      
      => Started proxy.
      => Started MongoDB.
      => Started your app.
      => App running at: http://a9a18d90.ngrok.io/
      

      You can then tap on the little android robot icon in the menu bar to download the app version for installation in the device.

      Note : You can still access the app locally as before.

Other Notes

For my own use, I keep open at least 4 terminal windows, with these commands, ready to run :

  1. For running Meteor

    cd projects/meteor-mantra-kickstarter/
    meteor --settings=settings.json
    
  2. For running acceptance tests

    cd projects/meteor-mantra-kickstarter/
    meteor npm run acceptance
    
  3. For checking changes in the database

    cd projects/meteor-mantra-kickstarter/
    meteor mongo
    # then
     db.users.findOne({ "emails.address" : "[email protected]" });
     db.getCollection("_colors").find({});
    
  4. For searching for keywords in the code

    cd projects/meteor-mantra-kickstarter/
    grep -R --exclude=\*.{css,txt,min.js} --exclude-dir={.git,.meteor,node_modules} "key" -A 1
    

I tend to use the above commands daily. To get quickly ready to work, I open this README page, open the four terminal windows and cut and paste into them.

About

Kickstart your meteor mantra development

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • JavaScript 62.6%
  • HTML 16.9%
  • Shell 16.3%
  • Gherkin 4.0%
  • CSS 0.2%