Back to the catalog

Open Knowledge Format bundle

Bundle OKF 0.2 · 8 conceitos · adabwana/adabwana.github.io

Open source Repository Open in the app JSON README (API)

About

# Open Knowledge Format bundle

Reusable OKF knowledge and Swarm Forge workflow for this ClojureScript
portfolio project. Copy it into a new project, adapt the local articles,
choose a Swarm Forge pack, and create the first project story before
implementing product behavior.

# Contents

* [README](README.md) - Bundle purpose, minimal adoption, and authority boundary
* [Copy guide](copy-guide.md) - How to turn this bundle into a project-local system
* [Software engineering](software-engineering/) - Pure core, thin hosts, TDD, and quality principles
* [Workflow](workflow/) - Story lifecycle, gates, artifacts, and pack selection
* [Swarm Forge](swarmforge/) - Constitution, role prompts, pack configurations, and backend adapter contract
* [Architecture](architecture/) - Clojure/ClojureScript desktop and browser shape
* [Templates](templates/) - Stories, features, QA procedures, ADRs, and status
* [References](references/) - Observed upstream facts and source links

Details

Kind
OKF bundles
Topic
Finance & crypto
Publisher
adabwana
Origin
okf_github
Category
dados
Version
0.2
Last push
2026-08-17T00:09:21Z
Repository state
ativo
Language
HTML
Added
2026-09-08 16:04:09
Updated
2026-09-08 16:04:09
Origin id
adabwana/adabwana.github.io:.okf/index.md

README

# Professional Data Science Portfolio

This repository contains the source code for my professional data science portfolio website, available at [adabwana.github.io](https://adabwana.github.io).

## Technologies Used

- **ClojureScript**: Functional programming for the frontend
- **shadow-cljs**: Build tooling for ClojureScript
- **Reagent**: React wrapper for ClojureScript
- **reitit**: Routing library for ClojureScript
- **htmx**: HTML extensions for dynamic content
- **Bootstrap 5**: CSS framework for responsive design
- **GitHub Pages**: Hosting and deployment

## Project Structure

- `src/adabwana/core.cljs`: Main ClojureScript file with routing and components
- `public/index.html`: Entry point HTML file
- `public/css/styles.css`: Custom CSS styles
- `public/htmx/`: HTMx components for dynamic content
- `.github/workflows/gh-pages.yml`: GitHub Actions workflow for automatic deployment

## Local Development

1. **Install dependencies**:
   ```
   npm install
   ```

2. **Start development server**:
   ```
   npm run watch
   ```
   This will start a development server at [http://localhost:8080](http://localhost:8080)

3. **Build for production**:
   ```
   npm run release
   ```

## Deployment

The site is automatically deployed to GitHub Pages when changes are pushed to the main branch, using the GitHub Actions workflow defined in `.github/workflows/gh-pages.yml`.

## Features

- Responsive design for all device sizes
- Client-side routing with reitit
- Dynamic content loading with htmx
- Syntax highlighting for code samples
- Integration with external links and resources

## Contact

For any questions or inquiries, please contact me at [adazungu@gmail.com](mailto:adazungu@gmail.com). 

More