Skip to content

πŸ›‘οΈ MTS OS: The unified core of Minimal Technology Solutions. A high-performance monorepo for AI-Driven Security, SaaS development, and agentic intelligence. Built for sovereignty.

License

Notifications You must be signed in to change notification settings

MinimalTechSolutions/app

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

2 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

πŸ’  Minimal DAO - Landing Page

"Complex imagination, minimalist execution."

A high-performance, production-ready landing page for Minimal Technology Solutions (MTS-DAO) - built with Next.js 15, TypeScript, and Tailwind CSS. This project represents the unified core of our community of thinkers focused on solving high-stakes technology problems.

License Next.js TypeScript Tailwind CSS


✨ Features

  • πŸš€ Next.js 15 - Latest App Router with React Server Components
  • πŸ“˜ TypeScript - Strict mode for type safety and better DX
  • 🎨 Tailwind CSS - Utility-first CSS with custom design system
  • β™Ώ Accessible - WCAG 2.1 AA compliant
  • πŸ“± Responsive - Mobile-first design, pixel-perfect on all devices
  • ⚑ Performance - Optimized for Lighthouse score 95+
  • πŸ” SEO Optimized - Comprehensive meta tags, Open Graph, Twitter Cards
  • 🎭 Animations - Smooth scroll reveals and micro-interactions
  • πŸ”’ Secure - Security headers and best practices
  • πŸ“¦ Modular - Clean, maintainable component architecture

πŸ› οΈ Tech Stack

Technology Version Purpose
Next.js 15.1.0 React framework
React 19.0.0 UI library
TypeScript 5.3.3 Type safety
Tailwind CSS 3.4.0 Styling
Framer Motion 11.0.0 Animations
Lucide React 0.263.1 Icons

πŸ“ Project Structure

minimal-dao-landing/
β”‚
β”œβ”€β”€ public/                    # Static assets
β”‚   β”œβ”€β”€ images/               # Images and graphics
β”‚   └── robots.txt            # SEO robots file
β”‚
β”œβ”€β”€ src/
β”‚   β”œβ”€β”€ app/                  # Next.js App Router
β”‚   β”‚   β”œβ”€β”€ layout.tsx        # Root layout
β”‚   β”‚   β”œβ”€β”€ page.tsx          # Homepage
β”‚   β”‚   β”œβ”€β”€ globals.css       # Global styles
β”‚   β”‚   └── [routes]/         # Page routes
β”‚   β”‚
β”‚   β”œβ”€β”€ components/
β”‚   β”‚   β”œβ”€β”€ layout/           # Layout components
β”‚   β”‚   β”‚   β”œβ”€β”€ Header.tsx
β”‚   β”‚   β”‚   β”œβ”€β”€ MobileMenu.tsx
β”‚   β”‚   β”‚   └── Footer.tsx
β”‚   β”‚   β”‚
β”‚   β”‚   β”œβ”€β”€ sections/         # Page sections
β”‚   β”‚   β”‚   β”œβ”€β”€ Hero.tsx
β”‚   β”‚   β”‚   β”œβ”€β”€ PricingCards.tsx
β”‚   β”‚   β”‚   β”œβ”€β”€ Services.tsx
β”‚   β”‚   β”‚   └── CTA.tsx
β”‚   β”‚   β”‚
β”‚   β”‚   └── ui/              # Reusable UI components
β”‚   β”‚
β”‚   β”œβ”€β”€ lib/                 # Utilities and helpers
β”‚   β”‚   β”œβ”€β”€ utils.ts
β”‚   β”‚   └── constants.ts
β”‚   β”‚
β”‚   └── types/               # TypeScript definitions
β”‚       └── index.ts
β”‚
β”œβ”€β”€ .env.example             # Environment variables template
β”œβ”€β”€ next.config.js           # Next.js configuration
β”œβ”€β”€ tailwind.config.ts       # Tailwind configuration
β”œβ”€β”€ tsconfig.json            # TypeScript configuration
└── package.json             # Dependencies

πŸš€ Getting Started

Prerequisites

  • Node.js >= 18.17.0
  • npm >= 9.0.0 (or yarn/pnpm)

Installation

  1. Clone the repository:
git clone https://github.com/MinimalTechSolutions/app.git
cd app
  1. Install dependencies:
npm install
  1. Set up environment variables:
cp .env.example .env.local

Edit .env.local with your configuration.

  1. Run the development server:
npm run dev

Open http://localhost:3000 in your browser.


πŸ“œ Available Scripts

Command Description
npm run dev Start development server
npm run build Build for production
npm start Start production server
npm run lint Run ESLint
npm run type-check Check TypeScript types
npm run format Format code with Prettier

🎨 Design System

Colors

--color-background: #FFFFFF
--color-foreground: #000000
--color-border: #E5E5E5
--color-muted: #737373
--color-accent: #000000

Typography

  • Display Font: Space Grotesk
  • Body Font: Inter
  • Mono Font: JetBrains Mono

Spacing Scale

4px, 8px, 12px, 16px, 24px, 32px, 48px, 64px, 96px, 128px

πŸ”§ Configuration

Next.js Config

The next.config.js includes:

  • Image optimization (AVIF/WebP)
  • Security headers
  • Performance optimizations
  • SWC minification

Tailwind Config

Custom design tokens in tailwind.config.ts:

  • Extended color palette
  • Custom animations
  • Typography utilities
  • Responsive breakpoints

🌐 Deployment

Vercel (Recommended)

  1. Push your code to GitHub
  2. Import to Vercel
  3. Configure environment variables
  4. Deploy!

Deploy with Vercel

Other Platforms

This project can be deployed to any platform that supports Next.js:

  • Netlify
  • AWS Amplify
  • DigitalOcean App Platform
  • Railway

πŸ“ˆ Performance

Target metrics:

  • Lighthouse Score: 95+
  • First Contentful Paint: < 1.5s
  • Largest Contentful Paint: < 2.5s
  • Time to Interactive: < 3.5s
  • Cumulative Layout Shift: < 0.1

β™Ώ Accessibility

  • Semantic HTML5
  • ARIA labels and roles
  • Keyboard navigation support
  • Screen reader friendly
  • Color contrast compliance (WCAG 2.1 AA)
  • Focus indicators

πŸ”’ Security

Security measures implemented:

  • Strict Content Security Policy
  • HSTS headers
  • XSS protection
  • No sensitive data exposure
  • Regular dependency updates

🀝 Contributing

We welcome contributions! Please see our contributing guidelines:

  1. Fork the repository
  2. Create a feature branch (git checkout -b feature/amazing-feature)
  3. Commit your changes (git commit -m 'Add amazing feature')
  4. Push to the branch (git push origin feature/amazing-feature)
  5. Open a Pull Request

πŸ“„ License

This project is licensed under the AGPL-3.0 License - see the LICENSE file for details.


πŸ‘₯ Team

System Architect: Lucas H. Mulato


πŸ™ Acknowledgments

  • Inspired by minimalist design principles
  • Built with the Next.js community's best practices
  • Follows accessibility guidelines from W3C

πŸ“ž Contact


πŸ—ΊοΈ Roadmap

  • Add blog functionality
  • Implement i18n (internationalization)
  • Add dark mode toggle
  • Integrate CMS for content management
  • Add analytics dashboard
  • Implement A/B testing
  • Add newsletter subscription
  • Create case studies section

Built with ❀️ by Minimal Technology Solutions

About

πŸ›‘οΈ MTS OS: The unified core of Minimal Technology Solutions. A high-performance monorepo for AI-Driven Security, SaaS development, and agentic intelligence. Built for sovereignty.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published