Overview

The Lunuc Framework is a full-stack setup that allows developers to build progressive web apps. It provides a range of features and tools such as React for UI, declarative routing, Babel for ECMAScript 2016/2017, Webpack bundler, Jest for testing, Eslint for code quality, and more. The framework also includes features like a MongoDB database-as-a-service, GraphQL API, Express Server, and authentication capabilities. It offers integration with Docker for containerization, push notification support, and AWS Lambda for serverless computing. This article provides installation instructions and usage guidelines for developers looking to use the Lunuc Framework.

Features

• React for UI: The Lunuc Framework provides support for building user interfaces using the React library.
• Declarative routing: Developers can easily configure routing in their apps using a declarative approach.
• Babel for ECMAScript 2016/2017: The framework incorporates Babel to transpile ECMAScript 2016/2017 code to ensure compatibility with older browsers.
• Webpack bundler: Lunuc uses Webpack for bundling and optimizing the app’s assets.
• Jest for testing: Developers can utilize the Jest testing framework to write unit tests for their app.
• Eslint for code quality: Lunuc integrates Eslint for code linting and quality assurance.
• MongoDB database-as-a-service: The framework offers a convenient MongoDB integration with mlap.com’s database-as-a-service.
• GraphQL API: Lunuc includes GraphQL support for building efficient and flexible APIs.
• Express Server: The framework provides an Express server for handling HTTP requests.
• GraphQL Client: Developers can take advantage of the built-in GraphQL client for making API requests to their GraphQL backend.
• Optimistic UI: Lunuc supports optimistic UI, allowing the app to update the UI immediately before receiving a response from the server.
• Persist and Rehydrate / Cache Data: The framework supports data persistence and rehydration to ensure a seamless user experience.
• Authentication: Lunuc includes authentication capabilities to secure user access and protect sensitive data.
• Use of sockets (subscriptions-transport-ws): The framework enables the use of sockets for real-time communication between the client and server.
• Travis yml: Lunuc provides a Travis yml configuration file for seamless continuous integration.
• Deployment to Heroku: The framework offers easy deployment to Heroku, a popular cloud platform.
• Use of Service Worker: Lunuc includes support for Service Workers to enable offline functionality and improve performance.
• Template / Page builder: The framework provides a template and page builder for quickly creating web app components.
• Docker integration: Lunuc seamlessly integrates with Docker for containerization of the app.
• Push notification: The framework includes push notification support, allowing apps to send notifications to users.
• Use of AWS Lambda: Lunuc supports the use of AWS Lambda for serverless computing, allowing developers to run code without provisioning or managing servers.

Installation

To set up the Lunuc Framework, follow the steps below:

1. Setup your environment by ensuring you have Node.js and npm installed.
2. Set the environment variable for the MongoDB database using the following command: export MONGO_URL mongodb://user:password@ds145780.mlab.com:45780/app
3. Run npm install to install the required dependencies.
4. For development, run npm run dev and visit http://localhost:8080 in your browser.
5. For production, run npm start and visit http://localhost:8080 in your browser.
6. To run the app as a Docker container, follow these steps:
   • Build the Docker image using docker build -t axax06/lunuc .
   • Run the Docker image with the MONGO_URL environment variable: docker run -e MONGO_URL=mongodb://user:password@mongodb/ -p 49160:8080 -d axax06/lunuc
   • Access the app through http://localhost:49160

For Ubuntu users, additional installation steps are provided:

• Install the required dependencies using the commands: sudo apt install git-all, sudo apt -y update, sudo apt -y upgrade, curl -sL https://deb.nodesource.com/setup_14.x | sudo bash -, sudo apt-get install -y nodejs, sudo apt install npm.
• Update Node.js by running: sudo n stable.
• Install nvm using the command: apt install curl, curl https://raw.githubusercontent.com/creationix/nvm/master/install.sh | bash, source ~/.profile.
• Clone the repository into /opt using the command: cd /opt, sudo git clone https://github.com/axax/lunuc.git.
• Run the install script: sudo chmod +x /opt/lunuc/shell/install.sh, sudo /opt/lunuc/shell/install.sh.
• Edit the configuration file: sudo vi /etc/lunuc/buildconfig.json.
• Edit the services and environment files: sudo vi /etc/systemd/system/lunuc-api.service, sudo vi /etc/systemd/system/lunuc-client.service.
• Start the services: sudo chmod +x /opt/lunuc/shell/start.sh, sudo chmod +x /opt/lunuc/shell/start-client.sh, sudo chmod +x /opt/lunuc/shell/start-api.sh, sudo chmod 777 /opt/lunuc, sudo /opt/lunuc/shell/start.sh, git checkout HEAD -- /opt/lunuc/shell/start.sh.

For more detailed instructions on installing and configuring MongoDB on Ubuntu, refer to the official documentation.

Summary

The Lunuc Framework is a powerful full-stack setup for building progressive web apps. It offers a wide range of features and tools, including React for UI, GraphQL API, Express Server, authentication capabilities, and much more. The framework’s installation and usage instructions provided in this article guide developers through setting up the environment, installing dependencies, and running the app for development and production. Additionally, Ubuntu users are given specific instructions to install and configure the framework on their system. With Lunuc, developers can efficiently build and deploy web apps with ease.