AuroraLedger Media Portal

AuroraLedger Media Portal is the Nuxt.js front-end that powers the ALIS content ecosystem. The application enables creators to publish long-form articles, readers to curate what matters, and the broader community to reward quality contributions through blockchain-backed incentives.

---

✨ Highlights

• Community-first publishing: Compose, preview, and schedule multimedia articles with markdown and WYSIWYG editors.
• Trustworthy engagement: Earn, tip, and manage ALIS token rewards with built-in Ethereum wallet flows.
• Personalized discovery: Explore trending topics, follow authors, and receive real-time notifications tailored to your interests.
• Nuxt-driven performance: Server-side rendering, static generation, and lazy-loaded assets deliver fast, accessible experiences across devices.
• Operational confidence: Comprehensive CI/CD, environment isolation, and observability baked in for smooth releases.

---

🗂 Project Structure

app/
  assets/        # styles, icons, media
  components/    # reusable UI components (atoms → organisms)
  layouts/       # shared page layouts
  middleware/    # route guards and interceptors
  pages/         # Nuxt pages mapped to routes
  plugins/       # client/server plugins (axios, editor, etc.)
  static/        # public static assets
  store/         # Vuex modules
server/          # serverless-friendly Nuxt wrapper
tests/           # Jest unit tests and fixtures

---

🚀 Getting Started

1. Install Tooling

Requirement	Notes
Node.js (via nodenv)	Align with .node-version
Yarn	Preferred package manager
direnv	Auto-load environment variables
AWS CLI & Serverless Framework	Deployment tooling

2. Configure Environment

cp -pr .envrc.sample .envrc
# (Optional) use .envrc.sample.develop for local defaults
vi .envrc
direnv allow

3. Install Dependencies

nodenv install     # installs the required Node version if missing
yarn install

4. Run the App

yarn dev           # start dev server at http://localhost:3000
yarn lint          # lint .js and .vue files
yarn test          # run unit tests with Jest

---

🧪 Testing & Quality

• Unit tests: yarn test or yarn test:coverage
• Linting: yarn lint (auto-fix with yarn lint-fix)
• Formatting: yarn format (combines Prettier + ESLint)
• Pre-commit: Git hooks ensure code quality before merging

---

📦 Build & Deployment

yarn build         # optimized production bundle
yarn start         # serve the built app
yarn generate      # create static export (if required)

Automated Pipeline

1. CircleCI validates the branch (lint, test, build).
2. Artifacts deploy via Serverless + AWS Lambda@Edge.
3. serverless.yml orchestrates infrastructure and alerts.

Run manually:

yarn deploy        # wraps build + serverless deploy

---

🛠 Troubleshooting

Symptom	Fix
Error: error:0308010C:digital envelope routines::unsupported	Ensure NODE_OPTIONS='--openssl-legacy-provider' (already in scripts).
direnv: error .envrc is blocked	Run direnv allow once per shell.
CI fails on linting	Execute yarn lf locally before pushing.
AWS deploy fails	Confirm AWS_PROFILE, AWS_REGION, and credentials are configured.

---

🤝 Contributing

1. Fork and clone the repository.
2. Create a feature branch with meaningful naming.
3. Commit using conventional messages when possible.
4. Open a pull request detailing changes, testing, and screenshots (if applicable).

Please review the issue tracker for “good first issue” labels if you are onboarding.

---

📄 License

The project is distributed under the terms of the MIT License. See LICENSE for full details.