Giter VIP home page Giter VIP logo

apex-nitro's Introduction


APEX Nitro

Your essential APEX companion

npm Build Status Dependency Status XO code style

APEX developers of all skills inevitably have to write JavaScript and CSS. Do you feel the learning curve to be steep? That is 100% normal. Barely any guidelines exist within APEX to learn the fundamentals of these languages. Let’s fix that.

APEX Nitro takes your front-end development to the next level by reducing mundane tasks, boosting performance, modularizing code, enhancing teamwork and more.

What APEX Nitro is

APEX Nitro is a tool that runs in the background while you develop an APEX application, watching for local static file (e.g. js, css) modifications inside of a given directory, compiling them into a better format and sending them back to your APEX application seamlessly. It makes front-end coding faster by syncing these local files to your APEX application in real-time.

APEX Nitro also establishes clear front-end guidelines and enforces good programming practices. It streamlines JavaScript and CSS by eliminating the bad practice of inline coding, so your APEX application benefits from an efficient 100% file-based approach.

What APEX Nitro does

  • Browser Synchronization
  • File Minification
  • File Concatenation
  • Source Mapping
  • Error Handling
  • CSS Preprocessing
  • CSS Auto-Prefixer
  • Theme Roller Customization

For more info on the features, read the documentation.

Benefits

  • Reduce development time
  • Reduce mundane tasks
  • Increase maintainability
  • Better modularization
  • Performance boost
  • Enhances teamwork
  • Makes responsive development easier

For more info on the benefits, read the documentation.

Quickstart

This following sections show the easiest way to get started with APEX Nitro.

Go to the full documentation to read more about using APEX Nitro.

System Requirements

  • Node.js
  • SQLcl >= v17.2 (optional, used for the publish feature)

Install

Execute this command to install APEX Nitro:

npm install -g apex-nitro

Getting errors? Make sure to read the troubleshooting section.

Project Configuration

Execute this command to configure an APEX Nitro project:

apex-nitro config <project>

A new browser tab will open and you can simply fill the form:

You can read about the different options by hovering the help icons.

APEX Application Setup

APEX Nitro requires to make one small modification to your APEX application to allow real-time synchronization. Head to Shared Components, under Application Processes and create a new application process with the following attributes:

Attribute Value
Name APEX Nitro
Sequence -999
Process Point On Load: Before Header (page template header)
Condition owa_util.get_cgi_env('APEX-Nitro') is not null
Source (PL/SQL) apex_application.g_flow_images := owa_util.get_cgi_env('APEX-Nitro');

Read the documentation for more information.

Launch

apex-nitro launch <project>

Usage

After APEX Nitro is launched, create, edit or delete any file within your project's source folder. Example /my_project/src/:

|-/src/
   |-css
      |-app.css
   |-js
      |-app.js

APEX Nitro will compile your files to a new folder of your choice. Example /my_project/dist/. APEX Nitro will then synchronize the compiled folder (/my_project/dist/) to your APEX application.

Read more about usage.
See common patterns.
Try our examples.

Publish to APEX

When you are done developing, you can upload your files to the Shared Components in APEX.

apex-nitro publish <project>

This feature is optional. Read more to get SQLcl running on your environment.

Troubleshoot

Read more about common issues.

Changelog

See changelog.

Project Sponsors

Insum Solutions

Team

apex-nitro's People

Contributors

emoracle avatar fuzziebrain avatar greenkeeperio-bot avatar krisrice avatar martindsouza avatar tschf avatar vincentmorneau avatar

Watchers

 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.