Sistemas Edenia Developer Guides

Sistemas Edenia Developers Documentation Site.

About the Project

In this site you will find the resources collected in the day-to-day life of Sistemas Edenia collaborators. Feel free to collaborate, comment and suggest changes / ideas to improve the site.

Table of Contents

1. About The Project
2. Content Table
3. Project Purpose
4. Tech Stack
5. Development Environment
6. File Structure
7. Contributing
8. About Sistemas Edenia

Project Purpose

This project is meant to serve as a tool for assisting with new developer on-boarding. Initially created by a group of university students to facilitate getting up to speed with other team members and contribute to open source projects. It's main purpose is to provide guidance to new team members and accelerate becoming familiar with processes and the culture at Sistemas Edenia.

Tech Stack

• React.js - React 16✨, React Router 5.
• Material-ui/core - React components for faster and easier web development universal-authenticator-library - A library for allowing apps to easily use different auth providers.
• Core - React components for faster and easier web development.
• Lint - ESlint.
• Styles - Material-UI Theme (customizable).
• Docusaurus - Open source tool to build, implement and maintain web documentation.

Getting Started

Prerequisites

• yarn
• git
• node.js

Installation

1. Clone the repository

   git clone https://github.com/edenia/docs.edenia.com.git

2. Move to the appropriate directory

   cd guide.eoscostarica.io.git

3. Install yarn packages

   yarn

4. Run the project

   yarn start

   Running Locally & Language Switching

After installing dependencies, you can build and run the site with support for multiple languages.

1. Build and serve both languages (production build):

    1.1 yarn build && npm run serve
   

This command generates the static files for all available locales (e.g., English and Spanish) and serves them locally, allowing you to switch between / (English) and /es/ (Spanish) in your browser.

2. Development mode – English (default): 2.1 yarn start

     or
   
     2.2 yarn run start --locale en 
   

Runs the site in development mode with hot-reloading, defaulting to English locale.

3. Development mode – Spanish: 3.1 yarn run start --locale es Runs the site in development mode with hot-reloading, with all pages served in Spanish.

File Structure

guide.eoscostarica.io/
├── .github ...................... Version management system
│ ├── workflows .................. Work flow
│ | └── nodejs.yml 
│ └── ISSUE_TEMPLATE.md .......... Templates for requests or reporting problems
│   ├── bug_report.md 
│   └── feature_request.md
├── docs ......................... Markdown files
├── src .......................... React custom components  
│ ├── css ........................ Style sheets
│ | ├── custom.css
│ | └── homepage.css
│ └── pages ...................... Components that form the main structure of the website
│ 	├── styles.module.css
│   ├── index.js
│   └── Footer
├── static ....................... Static directory
│ ├── img
│ └── CNAME
├── .all-contributorsrc .......... Contributors Information
├── .gitignore ................... Determine which files or directories should not be uploaded to Git
├── docusaurus.config.js ......... Docusaurus Configuration
├── package.json ................. History of installed packages and dependency optimization
├── sidebar.js ................... Specify the order of the documents in the side navigation
├── yarn.lock .................... Dependency version history
└── README.md .................... Documentation of guide.eoscostarica.io

Contributing

We use a Kanban-style board. That's were we prioritize the work. Go to Project Board.

If you want to make a contribution, please follow the next steps:

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Add your Changes to Commit (git add <fileName>)
4. Commit your Changes (git commit -m '<type>(<scope>): <subject>')
5. Push to the Branch (git push origin feature/AmazingFeature)
6. Open a Pull Request

Please Read Sistemas Edenia Open Source Contributing Guidelines for more information about programming conventions.

If you find a bug, please report big and small bugs by opening an issue.

About Sistemas Edenia

Sistemas Edenia is an independently-owned, self-funded, bare-metal Genesis block producer that provides stable and secure infrastructure for EOSIO blockchains. We support open source software for our community while offering enterprise blockchain development and custom smart contract development for our clients.

eoscostarica.io