BlackOcean es toda una plataforma enfocada en el rápido desarrollo de sitios, blogs, apps, PWA y aplicaciones hechas con tecnologías web. Cubriendo de forma eficiente, tanto las interfaces gráficas, como los servicios que soportaran el funcionamiento de la misma.
Es apto tanto para las aplicaciones más simples, fáciles y rápidas de producir, Como para las aplicaciones mas complejas, con alto grado de escalabilidad y eficiencia. Proporcionando en ambos casos, estructuras modernas de programación junto a una arquitectura limpia, que permite un FrontEnd fácil de programar, mantener y con una robustez insuperable. Y micro servicios javascripts eficientes, con la misma facilidad al crearse y mantenerse.
No es como otras soluciones, con configuraciones dependientes, pesadas y engorrosas arquitecturas. Que dan como resultados aplicaciones enormes y lentas, que tienes que soportar para reutilizar medianamente tu código. BlackOcean es tremendamente eficiente, con resultados ligeros y por ello, altamente escalables, que te permitirán reutilizar cada parte de tu código en diferentes proyectos que incluso son de productos y naturalezas distintas.
¿Por que?
BlackOcean nace por la necesidad de mantener simple el desarrollo UI, BackEnd, FrontEnd y focalizar los esfuerzos personales o empresariales en desarrollos unitarios y 100% reutilizables. Creando componentes que se mantengan simples desde que se desarrollan, hasta que se consumen. Fomentando la programación de pequeñas "clases como unidades", estas "unidades", pueden ser: frontends, servicios o ambos. Que en conjunto, pueden formar sistemas robustos con alto grado de escalabilidad.
Instalación
De momento y para el desarrollo local, todas las utilidades que necesitas para desarrollar en BlackOcean están agrupadas en un paquete: BlackOcean, el cual, te recomiendo que instales de manera global con el manejador de paquetes npm, sin embargo, BlackOcean también se puede instalar en cada proyecto e incluso, puedes trabajar con el desde npx.
Requerimientos previos
- Se requiere que cuentes con conocimientos medios o avanzados sobre html, css, javascript y manejo del DOM, para el uso de la plataforma.
- Para el correcto funcionamiento de BlackOcean, se requiere instalar previamente node v18.9.0 o superior de ser posible.
- Recomiendo descargar e instalar las extensiones de visual studio code: BlackOcean Languages y BlackOcean Icons, para poder colorear la sintaxis de BlackOcean, así como poder visualizar los iconos de las exteriores de los archivos BlackOcean.
Instalación global
Cuando creas y gestionas múltiples proyectos de BlackOcean, lo mas conveniente es instalar el paquete de forma global con el siguiente comando: npm install -g black-ocean, (en lo subsecuente se dará por hecho que BlackOcean esta instalado de forma global).
Inicio rápido
Inicio con plantilla
Similar a "npm init". Para iniciar un proyecto con BlackOcean, solo hay que escribir en una consola (posicionada previamente en el directorio de nuestro proyecto): bo init, si queremos la configuración de default sin necesidad de introducir ningún dato adicional en el inicio, escribimos: bo init -y.
Los comandos anteriores, son en el caso de que se halla instalado BlackOcean de forma global (tal como se recomienda), pero BlackOcean es un paquete que de igual forma se puede usar de forma local o usarse con npx, por ejemplo, para iniciar un proyecto e instalarlo de forma local escribiríamos el siguiente comando: npx black-ocean init -install, lo cual nos iniciaría el proyecto de BlackOcean, según la plantilla e instalando las dependencias necesarias en el mismo proyecto.
Posterior a esto, solo hace falta iniciar el proyecto con el comando: black-ocean -s, y de esta forma podremos visualizar el proyecto.
Proyecto desde 0
Una ves que cuentas con la instalación de BlackOcean en tu equipo, se pueden iniciar los servicios en cualquier carpeta que contenga un archivo bo.conf.
Cualquier archivo con formato BlackOceanHTML, sirve como punto de entrada a la app. Por lo que solo basta con tener un archivo con formato BlackOceanHTML, para poder ver tu sitio/app en el navegador.
"hola mundo"
- Crea una carpeta en la que colocaras tu proyecto.
- Crea un archivo llamado
"index.bh", el cual será nuestro punto de entrada. - Al archivo anterior, colócale el contenido:
h1>hola mundo. - Inicia la consola y abre la carpeta del proyecto.
- Ingresa el comando
bo -s. - Ingresa a la dirección marcada en la consola.
A partir de este punto tu proyecto puede escalar al nivel que necesites.
Este ejercicio sirve para ver, que un proyecto BlackOcean, no requiere de complejas configuraciones y un gran numero de archivos para hacerse posible. Son proyectos simples e increíblemente potentes, por ejemplo: El archivo "index.bh", ya tiene la capacidad de server-side render, pre-render, importación y carga dinámica de componentes, etc. Con este tipo de sistemas/plataformas, nosotros decidimos el nivel de complejidad en nuestro desarrollo y no el framework.
Autores
- mbo - main@blo.dev